@algorisys/tinyfly 0.127.1 → 0.129.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/llms-full.txt CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  Key facts:
6
6
 
7
- - Package: `@algorisys/tinyfly` on npm (`npm install @algorisys/tinyfly`). Entry points: `@algorisys/tinyfly` (engine), `/player`, `/export` (CSS, Lottie, GIF, video exporters), `/adapters` (DOM, Canvas, SVG, WebGL), `/gsap-compat` (GSAP-style API), `/drivers` (scroll, visibility, smooth scroll), `/interaction` (Observer, Draggable), `/teach` (lesson steps and diagram primitives), `/math` (maths figures, a TeX subset, equation steps, lesson embeds and explorables), `/embed` (teaching embeds), `/characters` (poseable stick figure with facial expressions), `/headless` (render scenes to MP4 and PNG stills in Node), `/react`, `/vue`, `/svelte`, `/solid` (framework wrappers), and `/browser` (the GSAP-style runtime plus engine, player, drivers, interaction and the stick figure — no exporters — for script tags). A CLI: `npx @algorisys/tinyfly capabilities`, `check`, `validate`, `render` and `video`.
7
+ - Package: `@algorisys/tinyfly` on npm (`npm install @algorisys/tinyfly`). Entry points: `@algorisys/tinyfly` (engine), `/player`, `/export` (CSS, Lottie, GIF, video exporters), `/adapters` (DOM, Canvas, SVG, WebGL), `/gsap-compat` (GSAP-style API), `/drivers` (scroll, visibility, smooth scroll), `/interaction` (Observer, Draggable), `/teach` (lesson steps and diagram primitives), `/math` (maths figures, a TeX subset, equation steps, lesson embeds and explorables), `/embed` (teaching embeds), `/present` (presentations: a deck stepped with a clicker, a scene per slide, a presenter window), `/characters` (poseable stick figure with facial expressions), `/headless` (render scenes to MP4 and PNG stills in Node), `/react`, `/vue`, `/svelte`, `/solid` (framework wrappers), and `/browser` (the GSAP-style runtime plus engine, player, drivers, interaction and the stick figure — no exporters — for script tags). A CLI: `npx @algorisys/tinyfly capabilities`, `check`, `validate`, `render`, `video` and `present`.
8
8
  - Script tag: `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v{version}/cdn/tinyfly.iife.js` defines a global `tinyfly`, e.g. `tinyfly.to('.box', { x: 200, duration: 1 })`. Replace `{version}` with a release tag.
9
9
  - The GSAP-style `live` API covers `scrollTrigger` (scrub, pin, toggleActions), `splitText` (chars, words, lines, masks), `drawSVG`, `spring`, `morphSVG`, `motionPath`, text/scramble, inertia and Draggable, Flip (including shared elements by `data-flip-id`), plain-object targets and `live.ticker`.
10
10
  - Times in JSON timelines are milliseconds; durations in the GSAP-style API are seconds, as in GSAP.
@@ -591,7 +591,7 @@ with a GSAP-style call (durations are in seconds here):
591
591
  ```html
592
592
  <div class="box" style="width:60px;height:60px;background:#4a9eff"></div>
593
593
 
594
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.127.1/cdn/tinyfly.iife.js"></script>
594
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.129.0/cdn/tinyfly.iife.js"></script>
595
595
  <script>
596
596
  tinyfly.to('.box', { x: 200, duration: 1 })
597
597
  </script>
@@ -799,7 +799,7 @@ Without a build step, the all-in-one bundle exposes the same functions on a
799
799
  global — `tinyfly.to()`, `tinyfly.timeline()` and so on:
800
800
 
801
801
  ```html
802
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.127.1/cdn/tinyfly.iife.js"></script>
802
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.129.0/cdn/tinyfly.iife.js"></script>
803
803
  <script>
804
804
  tinyfly.to('.box', { x: 200, duration: 1 })
805
805
  </script>
@@ -2725,7 +2725,7 @@ For simple website embedding without a build system.
2725
2725
  </html>
2726
2726
  ```
2727
2727
 
2728
- 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.127.1/cdn/tinyfly-player.iife.js`.
2728
+ 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.129.0/cdn/tinyfly-player.iife.js`.
2729
2729
 
2730
2730
  ---
2731
2731
 
@@ -7079,7 +7079,7 @@ The dialog shows the generated HTML/JavaScript code with a **Copy Code** button.
7079
7079
  **Steps to embed:**
7080
7080
  1. Build the player: `npm run build:player`
7081
7081
  2. Copy `lib/player/tinyfly-player.iife.js` to your project (or load
7082
- `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.127.1/cdn/tinyfly-player.iife.js`
7082
+ `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.129.0/cdn/tinyfly-player.iife.js`
7083
7083
  instead; see [Deployment](DEPLOYMENT.md))
7084
7084
  3. Copy the generated code into your HTML
7085
7085
  4. Adjust the script `src` path if needed
@@ -8209,6 +8209,8 @@ scenery and where the props stand) and `buildScene` builds it into targets:
8209
8209
  of the afternoon against the city: houses, a car, a tree), `office` (a room
8210
8210
  with a desk, a chair and a door) and `home` (a room at night with a bed, a
8211
8211
  chair and a door). The Park Day card plays a day over the park.
8212
+ `buildScene(name, { width, height, ink: '#111', lineWidth: 5 })` outlines
8213
+ every prop in that ink and width, so the set matches heavily inked characters.
8212
8214
 
8213
8215
  ## In 3D scenes
8214
8216
 
@@ -8456,8 +8458,9 @@ not a `look` value. It uses the same expressions, blink, gaze and turn fields.
8456
8458
  White outlined stick figures are `figure: 'bean'` (presets `beanMan`, `beanWoman`,
8457
8459
  `beanKid`, `beanBoss`, `beanDetective`, `beanStick` in `BEAN_CAST`): seamless outlined noodle limbs or bare
8458
8460
  lines (`bean: { limbs: 'tube' | 'line' }`), a shaped body (`bean.torso` fullness), big oval eyes
8459
- (`face.style: 'oval'`, usable on any figure), `hands: 'mitten'` and cartoon shoes; colours from
8460
- `bean: { shirt, sleeves, trousers, shoes }` or an `outfit`; detective gear `bean: { coat, fedora, shades: true }`
8461
+ (`face.style: 'oval'`, usable on any figure; `face: { eyeScale: 1.2, eyeAspect: 0.8 }` makes them bigger
8462
+ and rounder), `hands: 'mitten'` and cartoon shoes; colours from
8463
+ `bean: { shirt, sleeves, trousers, shoes, tie }` or an `outfit` (its tie too); detective gear `bean: { coat, fedora, shades: true }`
8461
8464
  (aviators replace the eyes, brows still show); `halo` gives line limbs a pale edge. A bean is always drawn clean.
8462
8465
  Household clothes on a bean: `bean: { skirt: '#c2410c' }` (a sari to the ankle) or
8463
8466
  `skirt: { color, length: 0.45 }` (a kurta hem; pair it with `trousers`), `drape` (a pallu or dupatta sash)
@@ -8600,6 +8603,9 @@ scriptTracks: 2 problem(s) in the beats:
8600
8603
  - **Code panels** reject unknown languages and remove styles. `token()` throws
8601
8604
  when a line doesn't have the word.
8602
8605
  - **Teaching timelines**: `npx @algorisys/tinyfly validate timeline.json --markup figure.svg`.
8606
+ - **Presentations** ([presenting.md](presenting.md)): `npx @algorisys/tinyfly present index.html -o Talk.html`
8607
+ fails when the page would still load a file or the network. Check moments
8608
+ with `deck.seek(slide, step, ms)`.
8603
8609
 
8604
8610
  ## 4. Look at it
8605
8611
 
@@ -8741,7 +8747,7 @@ path for all of that:
8741
8747
  </figure>
8742
8748
 
8743
8749
  <!-- once, anywhere on the page (a site-wide footer is fine) -->
8744
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.127.1/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
8750
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.129.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
8745
8751
  ```
8746
8752
 
8747
8753
  Every `[data-tinyfly-embed]` mounts when the page is ready, with no per-post
@@ -9065,6 +9071,269 @@ refuses to play it, with an error saying to update, rather than playing it wrong
9065
9071
 
9066
9072
  ---
9067
9073
 
9074
+ <!-- docs/presenting.md -->
9075
+
9076
+ # Presentations
9077
+
9078
+ A talk given from a tinyfly page instead of a slide deck: the presenter steps
9079
+ through with a clicker, and on each click a scene plays to its next beat while the
9080
+ slide's text appears. `@algorisys/tinyfly/present` is the part that makes a page a
9081
+ deck:
9082
+
9083
+ | Piece | What it gives you |
9084
+ |---|---|
9085
+ | **`createDeck()`** | Slides from plain markup, steps, a scene per slide, keys and clicker, a stage that scales to any screen |
9086
+ | **Scenes** | `{ marks, draw }`: one scene time per click; the deck plays the clock from mark to mark |
9087
+ | **Presenter window** | Notes, the clock, time left of the slot, and what the next press will do |
9088
+ | **Countdowns** | `<button data-timer="30">` for polls and QR codes; scenes are told while one runs |
9089
+ | **`DeckState`** | The same deck with no page: plain state driven by explicit times |
9090
+ | **`tinyfly present`** | One HTML file that works offline from `file://` |
9091
+
9092
+ ## Quick start
9093
+
9094
+ ```html
9095
+ <main id="deck">
9096
+ <section data-slide="hello" data-title="Hello">
9097
+ <h1>A deck made with tinyfly</h1>
9098
+ <aside data-notes>Welcome everyone. Wait for the wave.</aside>
9099
+ </section>
9100
+
9101
+ <section data-slide="points" data-title="Three points">
9102
+ <ul>
9103
+ <li data-step="1">Shown on the first click</li>
9104
+ <li data-step="2">Shown on the second</li>
9105
+ <li data-step="3" data-reveal="pop">Shown on the third</li>
9106
+ </ul>
9107
+ </section>
9108
+ </main>
9109
+
9110
+ <script src="vendor/tinyfly.iife.js"></script>
9111
+ <script src="scenes.js"></script>
9112
+ <script>
9113
+ tinyfly.createDeck('#deck', { scenes: window.SCENES, slotMinutes: 30 })
9114
+ </script>
9115
+ ```
9116
+
9117
+ With a bundler: `import { createDeck } from '@algorisys/tinyfly/present'`. The
9118
+ entry imports nothing else from tinyfly, so it adds only itself.
9119
+
9120
+ A complete deck with stick figures is in
9121
+ [`examples/present-deck`](../examples/present-deck).
9122
+
9123
+ ## Markup
9124
+
9125
+ | Markup | What it is |
9126
+ |---|---|
9127
+ | `[data-slide="id"]` | A slide. `data-title` names it in the presenter window |
9128
+ | `[data-step="k"]` | Appears on click `k` and stays. `data-reveal` is `pop`, `fade` or `none` (default: it rises into place) |
9129
+ | `[data-notes]` | Speaker notes. Never shown on the slide; several are joined |
9130
+ | `<button data-timer="30">` | A countdown of 30 seconds on the step of the `[data-step]` around it |
9131
+ | `canvas[data-scene]` | Where the slide's scene draws. Added for you when the slide has none |
9132
+
9133
+ The deck is a fixed stage, 1920 × 1080 unless you pass `width` and `height`, scaled
9134
+ to fit the window. Lay slides out in those pixels with your own CSS; the same
9135
+ layout then holds on a laptop and a projector.
9136
+
9137
+ The deck adds classes you can style: `tf-current` on the slide being shown,
9138
+ `tf-on` on a fragment from its step on, `tf-now` on the fragment of the current
9139
+ step, and `data-current-step` on the slide. Its own look comes from custom
9140
+ properties on the deck element: `--tf-deck-bg`, `--tf-deck-accent`,
9141
+ `--tf-deck-panel`, `--tf-deck-done`, `--tf-deck-font`.
9142
+
9143
+ ## Scenes
9144
+
9145
+ `scenes` maps a slide id to a factory. It is called once, the first time the
9146
+ slide (or the one before it) is shown, and returns the scene:
9147
+
9148
+ ```js
9149
+ window.SCENES = {
9150
+ points({ width, height, el }) {
9151
+ return {
9152
+ // marks[0]: where the entrance ends. marks[k]: where click k ends.
9153
+ marks: [1200, 2600, 4100, 5800],
9154
+ draw(ctx, frame) {
9155
+ // frame.time plays up to the current mark and waits there.
9156
+ drawEverythingAt(ctx, frame.time)
9157
+ },
9158
+ }
9159
+ },
9160
+ }
9161
+ ```
9162
+
9163
+ | `frame` field | Meaning |
9164
+ |---|---|
9165
+ | `time` | The slide's scene clock in ms. It plays to the current step's mark and stops |
9166
+ | `clock` | A clock in ms that never stops, for motion that loops while the scene waits |
9167
+ | `step` | The current step, 0 until the first click |
9168
+ | `timer` | `{ state, elapsed, seconds, sinceEnd }` while a countdown runs and after it ends, else `null` |
9169
+ | `width`, `height` | The stage size |
9170
+
9171
+ - **`draw(ctx, frame)`** paints the slide's canvas, which is cleared first.
9172
+ - **`update(frame)`** is for everything else: an SVG, DOM elements, or a tinyfly
9173
+ timeline you seek to `frame.time`. A scene may have both.
9174
+ - **Steps** are the larger of the scene's marks and the highest `data-step` on
9175
+ the slide. A slide with no scene steps through its fragments alone.
9176
+ - **Back** shows a step as it ends; it does not play backwards.
9177
+ - A scene that throws is logged and stopped. The deck carries on.
9178
+
9179
+ ### Marks from a beat script
9180
+
9181
+ A stick figure's script compiles to tracks with a `duration`. The mark for a
9182
+ click is the duration of the script up to the last beat that click plays:
9183
+
9184
+ ```js
9185
+ const beats = [
9186
+ { do: 'walk', to: 1380, mood: 'happy' }, // entrance
9187
+ { do: 'point', toward: 800, for: 900 }, // click 1
9188
+ { do: 'cheer', mood: 'joyful', for: 1200 }, // click 2
9189
+ ]
9190
+ const options = { from: 2050, ground: 900, height: 300 }
9191
+ const marks = [1, 2, 3].map((count) => tinyfly.scriptTracks('guide', beats.slice(0, count), options).duration)
9192
+ ```
9193
+
9194
+ ## Keys
9195
+
9196
+ | Key | Does |
9197
+ |---|---|
9198
+ | `→` `↓` `PageDown` `Space` `Enter` `N`, or a click | Next step |
9199
+ | `←` `↑` `PageUp` `Backspace`, or a right click | Back |
9200
+ | digits then `Enter` | Go to that slide |
9201
+ | `Home` / `End` | First slide / last slide at its last step |
9202
+ | `B` or `.` / `W` or `,` | Black / white screen |
9203
+ | `F` | Full screen |
9204
+ | `R` | Play the current step again |
9205
+ | `T` | Start or end the countdown |
9206
+ | `P` | Presenter window |
9207
+ | `?` or `H` | The key list |
9208
+
9209
+ Clickers send `PageDown` and `PageUp` (some send the arrows), and `B` or `.` for
9210
+ their blank button.
9211
+
9212
+ **A second press never skips a step.** If Next arrives while a step is still
9213
+ playing, the scene jumps to that step's end and stays. A nervous double press
9214
+ shows the point at once; it does not move on to the next one.
9215
+
9216
+ ## Countdowns
9217
+
9218
+ ```html
9219
+ <div data-step="2">
9220
+ <img src="assets/poll-qr.png" alt="">
9221
+ <button data-timer="30"></button>
9222
+ </div>
9223
+ ```
9224
+
9225
+ On that step, Next (or the button, or `T`) starts the countdown. Next while it
9226
+ runs ends it early. Next after it ends moves on; the deck never moves on by
9227
+ itself. Going back or jumping resets it. The button gets `data-state`
9228
+ (`idle`, `running`, `done`) and the fragment around it gets `data-timer-state`,
9229
+ for your CSS.
9230
+
9231
+ Scenes see the countdown as `frame.timer`, so a figure can act while the room
9232
+ votes:
9233
+
9234
+ ```js
9235
+ const dancing = frame.timer?.state === 'running'
9236
+ const pose = dancing ? tinyfly.danceFrame('bhangra', (frame.timer.elapsed / 60000) * 120).pose : undefined
9237
+ ```
9238
+
9239
+ ## Presenter window
9240
+
9241
+ `P` opens a second window with the elapsed time, the time left of `slotMinutes`,
9242
+ the wall clock, the slide's title, its clicks, its notes, and what the next press
9243
+ will do ("Next: start the 30s timer"). Its buttons and keys drive the deck. It is
9244
+ written into a blank window, so it works from `file://` and needs no second file;
9245
+ the browser must allow pop-ups for the page.
9246
+
9247
+ ## Options
9248
+
9249
+ | Option | Default | |
9250
+ |---|---|---|
9251
+ | `scenes` | `{}` | Scene factories by slide id |
9252
+ | `width`, `height` | `1920`, `1080` | Stage size in px |
9253
+ | `slotMinutes` | none | The talk's length, for the presenter's countdown |
9254
+ | `title` | page title | Names the presenter window |
9255
+ | `labels` | English | Every visible word; see `DEFAULT_DECK_LABELS` |
9256
+ | `hash` | `true` | Keep the place in the URL (`#5.2`) and start from it |
9257
+ | `keyboard` | `true` | Listen for keys on the window |
9258
+ | `fit` | `true` | Scale the stage to its container, or to the window when that is `<body>` |
9259
+ | `autoStart` | `true` | Run the frame loop. With `false`, call `deck.render(now)` |
9260
+ | `onChange` | none | Called after every change of slide, step or countdown |
9261
+
9262
+ ## The deck object
9263
+
9264
+ ```js
9265
+ const deck = tinyfly.createDeck('#deck', options)
9266
+ deck.next() // as the clicker does
9267
+ deck.prev()
9268
+ deck.goTo(5) // slide 5 (the first is 1), playing its entrance
9269
+ deck.goTo(5, 2) // playing into its second click
9270
+ deck.seek(5, 2) // exactly as click 2 ends
9271
+ deck.seek(5, 2, 3400) // at scene time 3400 ms
9272
+ deck.replay()
9273
+ deck.toggleTimer()
9274
+ deck.blank('black')
9275
+ deck.openPresenter()
9276
+ deck.state // the DeckState
9277
+ deck.destroy()
9278
+ ```
9279
+
9280
+ `seek` is for rehearsal and for checking a moment: set it, take a screenshot, and
9281
+ see that every speech bubble and label sits inside its box.
9282
+
9283
+ ## DeckState: the deck without a page
9284
+
9285
+ `DeckState` holds the slides, steps, scene clocks and countdowns, and reads no
9286
+ clock itself. Every call that depends on time takes `now`, so the same calls give
9287
+ the same state. Use it to test a deck's flow, or to drive a deck on something
9288
+ other than a web page.
9289
+
9290
+ ```js
9291
+ import { DeckState } from '@algorisys/tinyfly/present'
9292
+
9293
+ const state = new DeckState([
9294
+ { id: 'hello', marks: [1000] },
9295
+ { id: 'poll', marks: [500, 2000], timers: [{ step: 1, seconds: 30 }] },
9296
+ ])
9297
+ state.next(0) // 'slide'
9298
+ state.advance(16, 16) // move the scene clock on by 16 ms
9299
+ state.next(600) // 'snap' while the entrance plays, then 'step', 'timer-start', …
9300
+ state.hint() // { kind: 'timer-start', seconds: 30 }
9301
+ ```
9302
+
9303
+ ## One file for the venue
9304
+
9305
+ ```sh
9306
+ npx @algorisys/tinyfly present player/index.html -o Talk.html
9307
+ ```
9308
+
9309
+ This writes one HTML file with every script and stylesheet inlined and every
9310
+ image, font and media file as a data URI. It opens from `file://` with no network,
9311
+ so venue Wi-Fi cannot break the talk.
9312
+
9313
+ The command exits 1 and writes nothing when the page would still need something:
9314
+
9315
+ - a local file that is missing;
9316
+ - a script, stylesheet, image or font loaded from the network (`--allow-remote`
9317
+ keeps these and only warns);
9318
+ - something it cannot inline: `srcset`, `@import`, a module script that imports
9319
+ other files (bundle it first), or a file type it does not know.
9320
+
9321
+ Links (`<a href>`) are left alone. Load tinyfly from a copy beside the deck
9322
+ (`vendor/tinyfly.iife.js`), not from a CDN, so the build is the version you
9323
+ rehearsed with.
9324
+
9325
+ `inlineDeck(html, { readText, readBase64 })` is the same step as a function. It
9326
+ reads no files itself, so it runs in any build script.
9327
+
9328
+ ## Before the day
9329
+
9330
+ - Walk the built file with the keyboard: every step in order, back, a jump to a
9331
+ slide number, and the presenter window.
9332
+ - Check each slide with `deck.seek()` at the size of the room's screen.
9333
+ - Keep a copy of the talk in another format in case the laptop is not yours.
9334
+
9335
+ ---
9336
+
9068
9337
  <!-- docs/math.md -->
9069
9338
 
9070
9339
  # Maths Animations
@@ -9327,7 +9596,7 @@ lesson's step options (`duration`, `easing`, `delay`).
9327
9596
  <figcaption>The determinant is the area of the unit square after the map.</figcaption>
9328
9597
  </figure>
9329
9598
 
9330
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.127.1/cdn/tinyfly-math.iife.js" data-tinyfly-auto></script>
9599
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.129.0/cdn/tinyfly-math.iife.js" data-tinyfly-auto></script>
9331
9600
  ```
9332
9601
 
9333
9602
  The figure draws itself into an SVG and redraws from the timeline whenever the
@@ -10461,8 +10730,8 @@ On a page with no build step, load the maps add-on after the browser bundle; it
10461
10730
  adds to the same `tinyfly` global:
10462
10731
 
10463
10732
  ```html
10464
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.127.1/cdn/tinyfly.iife.js"></script>
10465
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.127.1/cdn/tinyfly-maps.iife.js"></script>
10733
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.129.0/cdn/tinyfly.iife.js"></script>
10734
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.129.0/cdn/tinyfly-maps.iife.js"></script>
10466
10735
  ```
10467
10736
 
10468
10737
  It is a separate script because the offline world map it carries adds about
@@ -11516,7 +11785,7 @@ const stick = character(castMember('beanStick', 400)) // bare line limbs
11516
11785
  skirt over both), the neck, the body (with its drape, and coat), the near
11517
11786
  arm and the head (and fedora). A limb reaching toward the viewer
11518
11787
  (hands on the knees, seated thighs) draws over the body.
11519
- - `bean: { limbs, torso, limbWidth, lineWidth, outlineWidth, fill, shirt, sleeves, trousers, shoes }`:
11788
+ - `bean: { limbs, torso, limbWidth, lineWidth, outlineWidth, fill, shirt, sleeves, trousers, shoes, tie }`:
11520
11789
  `limbs: 'tube'` (default, outlined noodles) or `'line'` (bare round-capped
11521
11790
  ink lines for the arms, legs and neck; the body, eyes, mittens and shoes
11522
11791
  stay; `halo: '#f5f5f4'` adds a pale edge so they read on a dark set); the
@@ -11524,9 +11793,14 @@ const stick = character(castMember('beanStick', 400)) // bare line limbs
11524
11793
  (1; 1.3 chubby, 0.85 thin); widths as fractions of the height (0.024 tube,
11525
11794
  0.017 line, 0.0105 outline; `lineWidth` on the character also sets the
11526
11795
  outline); `fill` (white); a `shirt` colour with `sleeves: 'short' | 'long' | 'none'`;
11527
- `trousers`; `shoes` (the fill; a dark shoe gets a shine and a dark sole).
11528
- An `outfit`'s `shirt`, `trousers` and `sleeves` colour the bean too (its
11796
+ `trousers`; `shoes` (the fill; a dark shoe gets a shine and a dark sole);
11797
+ `tie` (a necktie down the chest: a knot at the collar and a pointed blade,
11798
+ sliding toward the side the body turns to and hidden from behind; under a coat).
11799
+ An `outfit`'s `shirt`, `trousers`, `sleeves` and `tie` colour the bean too (its
11529
11800
  layers are not used).
11801
+ - Bigger comedy eyes: `face: { eyeScale: 1.2, eyeAspect: 0.8 }` makes the oval
11802
+ eyes larger and rounder (scale 0.5–1.2, aspect 0.45–1.2); they move apart as
11803
+ they grow, so they still nearly touch, and glasses grow round them.
11530
11804
  - Detective gear: `coat` (a trench coat in that colour: lapels, a belt and
11531
11805
  buckle, double-breasted buttons, a hem at the knee and sleeves to the
11532
11806
  wrist), `fedora` (a brim, a pinched crown and a band) and `shades: true`
@@ -16062,7 +16336,7 @@ magnet.addEventListener('pointerleave', () => {
16062
16336
 
16063
16337
  <!-- capabilities: generated from the library -->
16064
16338
 
16065
- # tinyfly capabilities (v0.127.1)
16339
+ # tinyfly capabilities (v0.129.0)
16066
16340
 
16067
16341
  Generated from the library itself: every name below is accepted, and names not listed are rejected (beat scripts, code panels and `checkTracks` say which name was probably meant).
16068
16342
 
@@ -16302,7 +16576,7 @@ A prop is a 3D rig of simple parts drawn with the characters’ pens (clean, pen
16302
16576
 
16303
16577
  Prop beat fields: `do`, `at`, `for`, `to`, `toward`, `speed`, `open`, `on`, `height`, `wind`. Every prop has the controls `turn`, `tilt`, `pitch`, `roll`, `squash`, `lift`, `lean`, `size` and the actions `hold`, `turn`, `pop`, `vanish`.
16304
16578
 
16305
- Scenery: `scenery({ x, y, width, height, kind: sky | room, hour, clouds, wind, rain, snow, horizon: hills | city | flat })` is a canvas target whose values `hour` (0–24), `clouds`, `rain`, `snow` (0–1) and `wind` (−1..1) are tracks (`set(prop, { at, value, duration })`, `tracks(id)`; `anchor('sun' | 'moon' | 'horizon' | 'ground', time)`); the same `wind` streams hair (`hairFollowTracks(…, { wind })`). `scenePreset('park' | 'street' | 'office' | 'home', { width, height })` lays out scenery and props as data; `buildScene` builds them into targets.
16579
+ Scenery: `scenery({ x, y, width, height, kind: sky | room, hour, clouds, wind, rain, snow, horizon: hills | city | flat })` is a canvas target whose values `hour` (0–24), `clouds`, `rain`, `snow` (0–1) and `wind` (−1..1) are tracks (`set(prop, { at, value, duration })`, `tracks(id)`; `anchor('sun' | 'moon' | 'horizon' | 'ground', time)`); the same `wind` streams hair (`hairFollowTracks(…, { wind })`). `scenePreset('park' | 'street' | 'office' | 'home', { width, height })` lays out scenery and props as data; `buildScene` builds them into targets (`ink` and `lineWidth` outline its props to match the characters).
16306
16580
 
16307
16581
  | Preset | Family | Actions (needs) | Controls | Anchors |
16308
16582
  |---|---|---|---|---|
@@ -16355,7 +16629,7 @@ Appearance options of `character({ … })`, all plain data that turns with the h
16355
16629
  - `softCartoonCharacter(name, options?)`: Original youngMan / youngWoman / childBoy / childGirl story presets. Children have larger head proportions, shorter limbs and rounded torsos; every face, hair, build, hand, clothing and material option can be overridden.
16356
16630
  - `face.projection`: Organic default volume follows the head axes, keeps both eyes in three-quarter views and projects a small nose above the mouth; opaque hair covers features. cartoon keeps the classic face slide.
16357
16631
  - `outfitPreset(category, overrides?)`: Fresh JSON Everyday / Formal / Casual wardrobe defaults for every actor; top: tshirt | shirt | blouse | dress, trouserStyle: plain | jeans | cargo, colours, sleeves, bottoms, collar and tie are editable.
16358
- - `figure: 'bean'`: The white outlined stick figure: one smooth stroked outline per limb (no seams at elbows, knees or the front arm's shoulder), a shaped body (rounded shoulders, slight waist, fuller hips), big oval eyes, mittens and cartoon shoes; every pose, gait, dance and turn works. Always drawn clean; the near arm is in front of the body in both limb modes. `bean: { limbs: tube | line, halo (a pale edge on line limbs), torso, limbWidth, lineWidth, outlineWidth, fill, shirt, sleeves: short | long | none, trousers, shoes (a dark shoe gets a shine), coat (a trench coat: lapels, belt and buckle, buttons, knee hem, sleeves to the wrist), fedora, shades (aviators in place of the eyes; brows still show) }`; an `outfit`'s shirt, trousers and sleeves colour it. `castMember('beanMan' | 'beanWoman' | 'beanKid' | 'beanBoss' | 'beanDetective' | 'beanStick', h)`.
16632
+ - `figure: 'bean'`: The white outlined stick figure: one smooth stroked outline per limb (no seams at elbows, knees or the front arm's shoulder), a shaped body (rounded shoulders, slight waist, fuller hips), big oval eyes, mittens and cartoon shoes; every pose, gait, dance and turn works. Always drawn clean; the near arm is in front of the body in both limb modes. `bean: { limbs: tube | line, halo (a pale edge on line limbs), torso, limbWidth, lineWidth, outlineWidth, fill, shirt, sleeves: short | long | none, trousers, shoes (a dark shoe gets a shine), tie (a necktie down the chest), coat (a trench coat: lapels, belt and buckle, buttons, knee hem, sleeves to the wrist), fedora, shades (aviators in place of the eyes; brows still show) }`; an `outfit`'s shirt, trousers, sleeves and tie colour it. `castMember('beanMan' | 'beanWoman' | 'beanKid' | 'beanBoss' | 'beanDetective' | 'beanStick', h)`.
16359
16633
  - `hands`: `dot` | `cartoon` (with `handStyle: glove | natural`) | `mitten` (a plain oval mitten; the bean figure's default)
16360
16634
  - `leafOutfit`: Organic-only JSON garment { top?, color?, accent?, length? }; curved leaves follow torso/thighs at native part depths. Everyday basicOutfit also follows organic contours.
16361
16635
  - `hair`: `softSweep`, `flowingBob`, `cascadingWaves`, `bald`, `buzzCut`, `crewCut`, `short`, `sidePart`, `sideSwept`, `slickBack`, `quiff`, `spiky`, `mangaSpikes`, `mangaSweep`, `undercut`, `curlyCrop`, `afro`, `wavyCrop`, `shortLocs`, `flatTop`, `receding`, `thinning`, `pixie`, `bob`, `longBob`, `wavyBob`, `shoulderStraight`, `shoulderWaves`, `longStraight`, `longWaves`, `longCurls`, `longLocs`, `lowPonytail`, `highPonytail`, `ponytail`, `sidePonytail`, `topBun`, `lowBun`, `singleBraid`, `twinBraids`, `braids` (colours: `black`, `brown`, `chestnut`, `auburn`, `blond`, `ginger`, `gray`, `white` in `HAIR_COLORS`)
@@ -16365,7 +16639,7 @@ Appearance options of `character({ … })`, all plain data that turns with the h
16365
16639
  - `outfit`: `{ top: tshirt | shirt | blouse | dress, trouserStyle: plain | jeans | cargo, shirt: top colour, trousers: bottom colour, sleeves: short | long | none, bottom: trousers | shorts | skirt, collar, tie: colour, over: apron | labCoat | hoodie | cardigan | overalls | sari, overColor, shoes: boots, shoeColor }`
16366
16640
  - `castMember(name, height)`: `boy`, `girl`, `youngMan`, `youngWoman`, `man`, `woman`, `grandpa`, `grandma`, `doctor`, `cook`, `builder`, `courier`, `teacher`, `farmer`, `animeBoy`, `animeGirl`, `animeYoungMan`, `animeYoungWoman`, `animeMan`, `animeWoman`, `animeOlderMan`, `animeOlderWoman`, `mangaYoungMan`, `mangaYoungWoman`, `mangaRival`, `mangaHeroine`, `beanMan`, `beanWoman`, `beanKid`, `beanBoss`, `beanDetective`, `beanStick`, `beanSari`
16367
16641
  - Face marks (pose fields, 0–1): `blush`, `tears`, `sweat`; close-up fields `pupil` (size, 1 usual), `lid` (upper lids lowered, 0–1), `bulge` (eyes out of the head, 0–1); `face: { nose: true, inPupil(ctx, pupil) }`; `drawCharacterHead(ctx, who, pose, { x, y, radius })` draws just the head big
16368
- - Face styles: `simple`, `anime`, `oval`; `face: { style: 'anime', iris: '#4b7fce', lashes: true, ageLines: 0.8 }` uses coloured eyes and the same expressions, blinks and gaze. `ANIME_CAST` contains eight age presets, also available through `castMember`. `face: { style: 'oval' }` (the bean figure's default) draws big white oval eyes with small pupils that follow `lookX`/`lookY`, lids for `lid`, `blink` and half-open eyes, and heavy brows for `brow.*`/`browTilt`; glasses grow to fit round them.
16642
+ - Face styles: `simple`, `anime`, `oval`; `face: { style: 'anime', iris: '#4b7fce', lashes: true, ageLines: 0.8 }` uses coloured eyes and the same expressions, blinks and gaze. `ANIME_CAST` contains eight age presets, also available through `castMember`. `face: { style: 'oval' }` (the bean figure's default) draws big white oval eyes with small pupils that follow `lookX`/`lookY`, lids for `lid`, `blink` and half-open eyes, and heavy brows for `brow.*`/`browTilt`; glasses grow to fit round them. `eyeScale` (0.5–1.2) and `eyeAspect` (0.45–1.2, below 1 rounder) size oval eyes too, for big googly comedy eyes.
16369
16643
  - Face shapes: `round`, `angular`; `face: { shape: 'angular', jawWidth: 0.74, chinWidth: 0.14, eyeScale: 0.8, eyeAspect: 0.65 }` sets a tapered 3D jaw and narrower anime eyes; `jawRoundness: 1` softens the cheek/chin corners (default 0 keeps sharp jaws). `MANGA_CAST` contains four original young adult presets; hair styles `mangaSpikes` and `mangaSweep` remain editable.
16370
16644
  - Hair in motion (pose fields): `hair.swing` (degrees round the head, + toward its left), `hair.trail` (head radii back), `hair.lift` (head radii up); key them with `hairFollowTracks(target, tracks, who)` after the character's tracks, or `hairFollow` + `hairMotionAt` when posing per frame
16371
16645
  - `holding`: `mug` (left or right), `phone` (left or right), `book` (one hand or both), `bag` (left or right), `briefcase` (left or right), `umbrella` (left or right), `broom` (left or right), `cane` (left or right), `parcel` (both); pose fields `held.left`, `held.right`, `held.both` (below 0.5 lets go); `handGrip(joints, side)`
@@ -16665,3 +16939,4 @@ TeX subset: ^ _ \frac \sqrt \vec \hat \bar, \sum \prod \int with limits, \sin \l
16665
16939
  - `tinyfly validate <timeline.json> [--markup file]`: check a timeline against its markup
16666
16940
  - `tinyfly render <timeline.json> <markup> [--at …]`: a frame as static markup
16667
16941
  - `tinyfly video <scene.mjs> [--stills dir --times …]`: MP4, or PNG stills to look at
16942
+ - `tinyfly present <deck.html> [-o out.html]`: a presentation as one offline HTML file
package/llms.txt CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  Key facts:
6
6
 
7
- - Package: `@algorisys/tinyfly` on npm (`npm install @algorisys/tinyfly`). Entry points: `@algorisys/tinyfly` (engine), `/player`, `/export` (CSS, Lottie, GIF, video exporters), `/adapters` (DOM, Canvas, SVG, WebGL), `/gsap-compat` (GSAP-style API), `/drivers` (scroll, visibility, smooth scroll), `/interaction` (Observer, Draggable), `/teach` (lesson steps and diagram primitives), `/math` (maths figures, a TeX subset, equation steps, lesson embeds and explorables), `/embed` (teaching embeds), `/characters` (poseable stick figure with facial expressions), `/headless` (render scenes to MP4 and PNG stills in Node), `/react`, `/vue`, `/svelte`, `/solid` (framework wrappers), and `/browser` (the GSAP-style runtime plus engine, player, drivers, interaction and the stick figure — no exporters — for script tags). A CLI: `npx @algorisys/tinyfly capabilities`, `check`, `validate`, `render` and `video`.
7
+ - Package: `@algorisys/tinyfly` on npm (`npm install @algorisys/tinyfly`). Entry points: `@algorisys/tinyfly` (engine), `/player`, `/export` (CSS, Lottie, GIF, video exporters), `/adapters` (DOM, Canvas, SVG, WebGL), `/gsap-compat` (GSAP-style API), `/drivers` (scroll, visibility, smooth scroll), `/interaction` (Observer, Draggable), `/teach` (lesson steps and diagram primitives), `/math` (maths figures, a TeX subset, equation steps, lesson embeds and explorables), `/embed` (teaching embeds), `/present` (presentations: a deck stepped with a clicker, a scene per slide, a presenter window), `/characters` (poseable stick figure with facial expressions), `/headless` (render scenes to MP4 and PNG stills in Node), `/react`, `/vue`, `/svelte`, `/solid` (framework wrappers), and `/browser` (the GSAP-style runtime plus engine, player, drivers, interaction and the stick figure — no exporters — for script tags). A CLI: `npx @algorisys/tinyfly capabilities`, `check`, `validate`, `render`, `video` and `present`.
8
8
  - Script tag: `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v{version}/cdn/tinyfly.iife.js` defines a global `tinyfly`, e.g. `tinyfly.to('.box', { x: 200, duration: 1 })`. Replace `{version}` with a release tag.
9
9
  - The GSAP-style `live` API covers `scrollTrigger` (scrub, pin, toggleActions), `splitText` (chars, words, lines, masks), `drawSVG`, `spring`, `morphSVG`, `motionPath`, text/scramble, inertia and Draggable, Flip (including shared elements by `data-flip-id`), plain-object targets and `live.ticker`.
10
10
  - Times in JSON timelines are milliseconds; durations in the GSAP-style API are seconds, as in GSAP.
@@ -13,51 +13,52 @@ Key facts:
13
13
  - For language models: read the capability catalog first (`npx @algorisys/tinyfly capabilities`, or the end of llms-full.txt). It is generated from the library, so every name in it (poses, expressions, gags, gaits, beat actions, canvas properties, code-panel edits) is accepted, and names not in it are rejected with the name probably meant. Check beat scripts with `npx @algorisys/tinyfly check beats.json`, tracks with `checkTracks(tracks, targets)`, and ask any target what it animates with `describeTarget(target)`. The npm package ships `docs/`, `llms.txt`, `llms-full.txt` and an agent skill (`skills/tinyfly/SKILL.md`); `docs/llm-guide.md` describes the workflow.
14
14
  - Source: https://github.com/algorisys-oss/tinyfly. License: MIT.
15
15
 
16
- All documentation and the interactive course in a single file: [llms-full.txt](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/llms-full.txt)
16
+ All documentation and the interactive course in a single file: [llms-full.txt](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/llms-full.txt)
17
17
 
18
18
  ## Start here
19
19
 
20
- - [Getting Started](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/getting-started.md): What tinyfly is, making a first animation in the editor, and using it from code, a script tag or the CDN.
21
- - [GSAP Compatibility](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/gsap-compat.md): The GSAP-style API (`live.to`, `tf.timeline`): supported vars, motion paths, morphSVG, text, inertia, Draggable, Flip, and where it differs from GSAP.
22
- - [Code Examples](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/examples.md): Recipes with the engine API: fades, loops, colour and bezier easing, loading JSON, canvas and SVG rendering, multi-scene sequences, motion paths and script-tag embeds; a festive garba/dandiya scene with partner contacts, circle travel and spins, also rendered to video.
23
- - [Building Animations with an LLM](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/llm-guide.md): For assistants and the people setting them up: read the capability catalog (`tinyfly capabilities`), ask targets what they animate (`describeTarget`), check beats and tracks with did-you-mean errors (`tinyfly check`, `checkTracks`), render stills to look at, and the agent skill shipped in the package.
20
+ - [Getting Started](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/getting-started.md): What tinyfly is, making a first animation in the editor, and using it from code, a script tag or the CDN.
21
+ - [GSAP Compatibility](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/gsap-compat.md): The GSAP-style API (`live.to`, `tf.timeline`): supported vars, motion paths, morphSVG, text, inertia, Draggable, Flip, and where it differs from GSAP.
22
+ - [Code Examples](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/examples.md): Recipes with the engine API: fades, loops, colour and bezier easing, loading JSON, canvas and SVG rendering, multi-scene sequences, motion paths and script-tag embeds; a festive garba/dandiya scene with partner contacts, circle travel and spins, also rendered to video.
23
+ - [Building Animations with an LLM](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/llm-guide.md): For assistants and the people setting them up: read the capability catalog (`tinyfly capabilities`), ask targets what they animate (`describeTarget`), check beats and tracks with did-you-mean errors (`tinyfly check`, `checkTracks`), render stills to look at, and the agent skill shipped in the package.
24
24
 
25
25
  ## Reference
26
26
 
27
- - [API Reference](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/api-reference.md): Every public engine, player and adapter API: Timeline, tracks, keyframes, easing, drivers, serialization and exports.
28
- - [File Format](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/file-format.md): The JSON animation format: timelines, every track kind, keyframes, easing and the project file — for generating or consuming animations.
27
+ - [API Reference](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/api-reference.md): Every public engine, player and adapter API: Timeline, tracks, keyframes, easing, drivers, serialization and exports.
28
+ - [File Format](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/file-format.md): The JSON animation format: timelines, every track kind, keyframes, easing and the project file — for generating or consuming animations.
29
29
 
30
30
  ## Editor features
31
31
 
32
- - [Editor Guide](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/editor-guide.md): Every panel and feature of the visual editor, from elements and keyframes to text and inertia tracks, preview and export.
33
- - [Shape Morphing](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/shape-morph.md): Tweening one path into another, including shapes with different point counts and several subpaths.
34
- - [Pen Tool](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/pen-tool.md): Drawing custom paths point by point with straight segments and bezier curves.
35
- - [Polygons & Stars](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/polygon-star.md): Parametric polygon and star shapes that stay editable while animating like any path.
36
- - [Grid & Snapping](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/grid-and-snapping.md): The grid overlay, snapping to grid, elements and artboard centre, and alignment guides.
37
- - [Onion Skinning](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/onion-skinning.md): Ghost frames before and after the playhead for judging arcs and easing.
38
- - [Sprite-sheet Export](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/sprite-sheet-export.md): Exporting frames as a PNG grid plus JSON metadata for game engines and canvas players.
32
+ - [Editor Guide](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/editor-guide.md): Every panel and feature of the visual editor, from elements and keyframes to text and inertia tracks, preview and export.
33
+ - [Shape Morphing](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/shape-morph.md): Tweening one path into another, including shapes with different point counts and several subpaths.
34
+ - [Pen Tool](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/pen-tool.md): Drawing custom paths point by point with straight segments and bezier curves.
35
+ - [Polygons & Stars](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/polygon-star.md): Parametric polygon and star shapes that stay editable while animating like any path.
36
+ - [Grid & Snapping](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/grid-and-snapping.md): The grid overlay, snapping to grid, elements and artboard centre, and alignment guides.
37
+ - [Onion Skinning](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/onion-skinning.md): Ghost frames before and after the playhead for judging arcs and easing.
38
+ - [Sprite-sheet Export](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/sprite-sheet-export.md): Exporting frames as a PNG grid plus JSON metadata for game engines and canvas players.
39
39
 
40
40
  ## Guides
41
41
 
42
- - [Cricket Stories](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/cricket.md): Reusable sports APIs, organic adult/child players, sixteen cricket plays, Test/ODI/T20 facts, contact-keyed JSON, captions, headless video and a 360° ground camera.
43
- - [Scroll Animation](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/scroll-animation.md): Scroll-driven and play-when-visible animation with ScrollDriver and VisibilityDriver.
44
- - [Props: Everyday Objects with Behaviours](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/props.md): Cars, trucks, buses, tractors, carts, train carriages, bikes, motorbikes, trees, houses, a helicopter and a plane: 3D rigs drawn with the characters’ pens (clean, pencil) that turn toward the camera, with beats acted through the 12 principles (anticipation, squash and stretch, follow-through, an exaggeration dial), wheels that roll exactly, effects, and figures riding them.
45
- - [Teaching Animations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/teaching.md): Step-through explanatory figures: markers, captions in several languages, the teaching player, step controls, one-script declarative embeds, tinyfly/teach diagram primitives, and validate / render for build pipelines.
46
- - [Maths Animations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/math.md): tinyfly/math: figures as JSON (grids a matrix warps, vectors, function plots, polygons, eigenlines, TeX labels and equations that rewrite step by step), animated by plain tracks, played in lesson-page embeds, explorables and videos from one layout; a built-in TeX subset and ready linear algebra figures.
47
- - [Rendering Video from Code](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/video-rendering.md): Rendering a scene to MP4 without a browser: `tinyfly video`, custom canvas targets drawn by code, timing from narration and recorded voice-over, the stick-figure character, SRT/WebVTT captions, stills, porting Cairo scripts, and a benchmark against pycairo.
48
- - [Animated Maps](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/maps.md): Maps that animate: a camera that flies in to a city, pins that drop in, routes that draw themselves while a marker travels them, on OpenStreetMap tiles or an offline world outline (also in pencil), in the browser and in headless video.
49
- - [Cartoon Hands](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/cartoon-hands.md): A hand you can pose: a palm and five fingers in 3D, posed by numbers (curls, thumb, spread, wrist turn), ready-made shapes from a fist to a pencil grip, left and right, four or five fingers, in clean, pencil and silhouette looks; the animator's hand and character gloves are built on it.
50
- - [Noir and Detective Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/noir-detective.md): A canvas kit for detective stories: rain in a window, light through blinds, darkness with torch beams and holes, glow, vignette, lightning and a flickering bulb; the red clue magnifier, an evidence folder, a clock and time chip, a freeze-frame suspect name card, a typed narration box and speech bubbles; and a case board as data (pinned photo and note cards, red string, marker cross-outs, strikes, scribble-outs and rings drawn on over time, with the marker nib for a hand). Deterministic from time; text and fonts are yours.
51
- - [Cosmic Explainer Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/cosmic-explainer.md): A canvas kit for animated science explainers: saturated gradient skies, parallax dust and bokeh, flat-shaded shapes (a sphere with a shadow crescent, an isometric cube, a probability haze), zooming through scale in growing portals (drawZoomLevels, depthAt, zoomAt), burned-in short captions two words at a time and label chips; plus sound effects made from numbers (whoosh, pop, thud, shimmer, tick, click, an ambient pad) that renderMix takes as samples. Deterministic from time.
52
- - [Character Appearance](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/character-appearance.md): Hair (34 styles), facial hair (20), glasses, hats and ears for the v2 character as plain data on the head, so they turn with it through all eight views; builds (child, tall, short…), a recurring cast (castMember), expressions with blush, tears and sweat, everyday poses, held items (mug, phone, bags, umbrella, parcel) and two characters’ hands meeting (meetHands: handshake, high five, hand-over).
53
- - [Cartoon Acting](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/acting.md): actTracks(): the same key poses, acted: anticipation, overshoot and settle, overlapping joints, eyes that lead and blink, moving holds and jump squash, in full, snappy or limited styles; gags as data (take, double take, wind-up); a line of action (bend); gaits with personality; lip-sync from text (Latin and Devanagari); beat scripts compiled to acted tracks; your own actions (defineAction), gaits (defineGait) and personas (persona()); acting on code (codePanel lines and words as anchors: leap onto a line, point at it, swipe it away wiped, knocked off or blurred; grab, throw, kick, carry and drop words, push them along their line, write new text in by hand; ride a line as gaps close); camera shots (push in, cut, shake, follow); the cartoon zip; speed lines, dust puffs and impact stars; drawing on twos (a timeline setting); acting, gags, walks and lines in the editor.
54
- - [Dance and Flips](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/dance.md): The stick figure dances disco, hip hop, breaking, jazz, K-pop, Bollywood, Bhangra, Bharatanatyam (with mudras), the Charleston, tap and popping, and does flips, leaps and splits; native v2 garba (two/three clap) and dandiya add body-local routines, circle formations, world foot plants, paired stick-tip contacts and signed spins; JSON bakes, timing, contact limits and editor menus.
55
- - [3D Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/scene-3d.md): @algorisys/tinyfly/scene-3d: cameras, lights and meshes as JSON, in metres, animated by tracks at <scene>/<object> (cuts with activeCamera), drawn on a 2D canvas with flat, smooth or toon shading, ink outlines and fog, in browsers, Workers and Node (MP4 with tinyfly video); v2 characters in pen or solid looks, scripted native dances, timed signed spins and circle formations with foot contacts.
56
- - [3D Transforms and Rotations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/3d-rotations.md): CSS-style 3D for flat elements in every renderer (rotateX, rotateY, z, perspective, backface visibility; true perspective on Canvas and WebGL, matching CSS within a pixel), one documented transform order, the editor's 3D fields; smooth quaternion rotations with interpolation: "slerp"; the vec3, quat and mat4 helpers; format version 2.
57
- - [Extending tinyfly](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/extending.md): Writing a render adapter, animating any object with live and the ticker, custom and parametric eases, stagger offsets, adding a track kind, and contributing gallery examples.
58
- - [Deployment](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/docs/DEPLOYMENT.md): Building and hosting the editor, and serving the player bundles.
42
+ - [Cricket Stories](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/cricket.md): Reusable sports APIs, organic adult/child players, sixteen cricket plays, Test/ODI/T20 facts, contact-keyed JSON, captions, headless video and a 360° ground camera.
43
+ - [Scroll Animation](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/scroll-animation.md): Scroll-driven and play-when-visible animation with ScrollDriver and VisibilityDriver.
44
+ - [Props: Everyday Objects with Behaviours](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/props.md): Cars, trucks, buses, tractors, carts, train carriages, bikes, motorbikes, trees, houses, a helicopter and a plane: 3D rigs drawn with the characters’ pens (clean, pencil) that turn toward the camera, with beats acted through the 12 principles (anticipation, squash and stretch, follow-through, an exaggeration dial), wheels that roll exactly, effects, and figures riding them.
45
+ - [Teaching Animations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/teaching.md): Step-through explanatory figures: markers, captions in several languages, the teaching player, step controls, one-script declarative embeds, tinyfly/teach diagram primitives, and validate / render for build pipelines.
46
+ - [Presentations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/presenting.md): A talk from a tinyfly page: tinyfly/present turns slide markup into a deck stepped with a clicker, with a scene per slide that plays from mark to mark, a presenter window with notes and a clock, countdowns for polls, and `tinyfly present` to build one offline HTML file.
47
+ - [Maths Animations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/math.md): tinyfly/math: figures as JSON (grids a matrix warps, vectors, function plots, polygons, eigenlines, TeX labels and equations that rewrite step by step), animated by plain tracks, played in lesson-page embeds, explorables and videos from one layout; a built-in TeX subset and ready linear algebra figures.
48
+ - [Rendering Video from Code](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/video-rendering.md): Rendering a scene to MP4 without a browser: `tinyfly video`, custom canvas targets drawn by code, timing from narration and recorded voice-over, the stick-figure character, SRT/WebVTT captions, stills, porting Cairo scripts, and a benchmark against pycairo.
49
+ - [Animated Maps](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/maps.md): Maps that animate: a camera that flies in to a city, pins that drop in, routes that draw themselves while a marker travels them, on OpenStreetMap tiles or an offline world outline (also in pencil), in the browser and in headless video.
50
+ - [Cartoon Hands](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/cartoon-hands.md): A hand you can pose: a palm and five fingers in 3D, posed by numbers (curls, thumb, spread, wrist turn), ready-made shapes from a fist to a pencil grip, left and right, four or five fingers, in clean, pencil and silhouette looks; the animator's hand and character gloves are built on it.
51
+ - [Noir and Detective Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/noir-detective.md): A canvas kit for detective stories: rain in a window, light through blinds, darkness with torch beams and holes, glow, vignette, lightning and a flickering bulb; the red clue magnifier, an evidence folder, a clock and time chip, a freeze-frame suspect name card, a typed narration box and speech bubbles; and a case board as data (pinned photo and note cards, red string, marker cross-outs, strikes, scribble-outs and rings drawn on over time, with the marker nib for a hand). Deterministic from time; text and fonts are yours.
52
+ - [Cosmic Explainer Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/cosmic-explainer.md): A canvas kit for animated science explainers: saturated gradient skies, parallax dust and bokeh, flat-shaded shapes (a sphere with a shadow crescent, an isometric cube, a probability haze), zooming through scale in growing portals (drawZoomLevels, depthAt, zoomAt), burned-in short captions two words at a time and label chips; plus sound effects made from numbers (whoosh, pop, thud, shimmer, tick, click, an ambient pad) that renderMix takes as samples. Deterministic from time.
53
+ - [Character Appearance](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/character-appearance.md): Hair (34 styles), facial hair (20), glasses, hats and ears for the v2 character as plain data on the head, so they turn with it through all eight views; builds (child, tall, short…), a recurring cast (castMember), expressions with blush, tears and sweat, everyday poses, held items (mug, phone, bags, umbrella, parcel) and two characters’ hands meeting (meetHands: handshake, high five, hand-over).
54
+ - [Cartoon Acting](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/acting.md): actTracks(): the same key poses, acted: anticipation, overshoot and settle, overlapping joints, eyes that lead and blink, moving holds and jump squash, in full, snappy or limited styles; gags as data (take, double take, wind-up); a line of action (bend); gaits with personality; lip-sync from text (Latin and Devanagari); beat scripts compiled to acted tracks; your own actions (defineAction), gaits (defineGait) and personas (persona()); acting on code (codePanel lines and words as anchors: leap onto a line, point at it, swipe it away wiped, knocked off or blurred; grab, throw, kick, carry and drop words, push them along their line, write new text in by hand; ride a line as gaps close); camera shots (push in, cut, shake, follow); the cartoon zip; speed lines, dust puffs and impact stars; drawing on twos (a timeline setting); acting, gags, walks and lines in the editor.
55
+ - [Dance and Flips](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/dance.md): The stick figure dances disco, hip hop, breaking, jazz, K-pop, Bollywood, Bhangra, Bharatanatyam (with mudras), the Charleston, tap and popping, and does flips, leaps and splits; native v2 garba (two/three clap) and dandiya add body-local routines, circle formations, world foot plants, paired stick-tip contacts and signed spins; JSON bakes, timing, contact limits and editor menus.
56
+ - [3D Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/scene-3d.md): @algorisys/tinyfly/scene-3d: cameras, lights and meshes as JSON, in metres, animated by tracks at <scene>/<object> (cuts with activeCamera), drawn on a 2D canvas with flat, smooth or toon shading, ink outlines and fog, in browsers, Workers and Node (MP4 with tinyfly video); v2 characters in pen or solid looks, scripted native dances, timed signed spins and circle formations with foot contacts.
57
+ - [3D Transforms and Rotations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/3d-rotations.md): CSS-style 3D for flat elements in every renderer (rotateX, rotateY, z, perspective, backface visibility; true perspective on Canvas and WebGL, matching CSS within a pixel), one documented transform order, the editor's 3D fields; smooth quaternion rotations with interpolation: "slerp"; the vec3, quat and mat4 helpers; format version 2.
58
+ - [Extending tinyfly](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/extending.md): Writing a render adapter, animating any object with live and the ticker, custom and parametric eases, stagger offsets, adding a track kind, and contributing gallery examples.
59
+ - [Deployment](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/docs/DEPLOYMENT.md): Building and hosting the editor, and serving the player bundles.
59
60
 
60
61
  ## Optional
61
62
 
62
- - [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/README.md): Feature overview, project layout and development setup.
63
- - [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.127.1/release-notes/README.md): What changed in each version.
63
+ - [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/README.md): Feature overview, project layout and development setup.
64
+ - [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.129.0/release-notes/README.md): What changed in each version.