@algorisys/tinyfly 0.78.0 → 0.81.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 CHANGED
@@ -50,10 +50,13 @@ A lightweight, API-driven animation engine and visual editor for creating high-p
50
50
  - **Immediate mode too** - A scene's `background` and `draw(ctx, { time })` functions paint each frame directly, Cairo/Processing-style, and mix freely with timeline targets
51
51
  - **Timing from narration** - `planNarration()` lays spoken lines out from their clip lengths (lead, gap, tail) into cues, scene spans and markers; `voiceNarration()` measures recorded clips with ffmpeg and writes the sample-aligned narration WAV
52
52
  - **Characters** - A poseable stick figure (`@algorisys/tinyfly/characters`): named poses, facial expressions (brows, eyes that widen, close and look around, mouth shapes), squash and stretch, rubber-hose limbs, blending, walk cycles and talking, all driven by timeline tracks. **Characters v2**: one skeleton in 3D drawn flat, turning front to side to back, resting on whatever touches the ground, reaching for points, in clean, pencil or silhouette looks, and a 🧍 Character element in the editor you pose and keyframe
53
+ - **Dance and flips** - The stick figure dances disco, hip hop, breaking toprock, jazz, K-pop, Bollywood, Bhangra, Bharatanatyam (with mudras), the Charleston and tap (foot strikes as data, for tap sounds), and does front, back, layout, scissor and side flips, cartwheels, back handsprings, split leaps, toe touches and full splits. Wrists, ankles, foot turn-out, whole-body `spin` and `rise` are pose fields; moves are keyed in beats, so any tempo plays them; styles, grooves and routines are plain JSON (`danceFrame()`, `danceTracks()`, `flipPose()`, `flipTracks()`). In the editor a 🧍 Character dances from the playhead, in time with the music: an Audio element's tempo is detected (`detectTempo()`) or tapped, the timeline shows its beats and bars, and keyframes snap to them. See [docs/dance.md](docs/dance.md)
53
54
  - **Maps** - Animated maps on OpenStreetMap tiles or an offline world outline (also in pencil): the camera flies in, pins drop, routes draw themselves while a marker travels them; a 🗺 Map element in the editor with a one-click trip
54
55
  - **Pencil sketch style** - Hand-drawn strokes with line boil (`sketch` style, `sketchPen`) for a pencil-test, Pencilmation-like look, on the stick figure and on canvas rect / circle / line / path shapes (also from the editor's Properties panel); a `drawOn` track draws any of those shapes on; the wobble is seeded by time, so renders stay deterministic
55
- - **The drawing hand** - `drawnPathTarget()` draws a sketched stroke on from a `draw` track while a cartoon hand holds the pencil at its end; the same hand can hold the eraser
56
+ - **The drawing hand** - `drawnPathTarget()` draws a sketched stroke on from a `draw` track while a cartoon hand holds the pencil at its end in a writing grip; the same hand can hold the eraser. `handAt()` gives one hand for a whole scene: it follows each stroke, lifts and glides to the next, and enters and leaves the page
56
57
  - **Erasing** - An eraser rubs out part of a target (`erasable()`, animated by an `erase` track) or of anything drawn in code (`withErased()`); clip-based, so it works in the browser and headless alike
58
+ - **Cartoon hands** - A hand rig in 3D, drawn flat: thumb and fingers posed by numbers (`index.curl`, `thumb.across`, `spread`, `turn`), ready-made shapes (fist, point, thumbs-up, peace, OK, pinch, wave, pencil grip…), left and right, four or five fingers, in every look; the animator's hand and (opt-in) character gloves are built on it. See [docs/cartoon-hands.md](docs/cartoon-hands.md)
59
+ - **Pencil story example** - `examples/pencil-story-hindi/index.html` tells a short Hindi story (प्यासा राहगीर, the thirsty traveller) Pencilmation-style with the browser bundle alone: the hand draws the scene and writes the narration, then rubs out the pot
57
60
  - **Captions** - `toSRT()` / `toWebVTT()` from narration cues or from a timeline's markers
58
61
 
59
62
  ### Render Adapters
@@ -222,7 +225,7 @@ GSAP-shaped functions at the top level. Teaching embeds are included: add
222
225
  itself.
223
226
 
224
227
  ```html
225
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.78.0/cdn/tinyfly.iife.js"></script>
228
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.81.0/cdn/tinyfly.iife.js"></script>
226
229
  <script>
227
230
  tinyfly.to('.box', { x: 200, rotate: 90, duration: 1, ease: 'power2.out' })
228
231
 
@@ -258,7 +261,7 @@ A teaching figure needs no code at all:
258
261
  <script type="application/json" data-tinyfly-timeline>{ …timeline JSON with markers… }</script>
259
262
  <figcaption>Appending to a full slice</figcaption>
260
263
  </figure>
261
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.78.0/cdn/tinyfly.iife.js" data-tinyfly-auto></script>
264
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.81.0/cdn/tinyfly.iife.js" data-tinyfly-auto></script>
262
265
  ```
263
266
 
264
267
  See [Teaching Animations](docs/teaching.md).
@@ -357,7 +360,7 @@ Without a build step, the player bundle puts the same functions on a `tinyfly` g
357
360
  <div data-tinyfly="box" style="width: 60px; height: 60px; background: #4a9eff;"></div>
358
361
  </div>
359
362
 
360
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.78.0/cdn/tinyfly-player.iife.js"></script>
363
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.81.0/cdn/tinyfly-player.iife.js"></script>
361
364
  <script>
362
365
  tinyfly.play('#animation', './animation.json', { loop: -1 })
363
366
  </script>
@@ -466,7 +469,7 @@ Or skip the code entirely with declarative embeds (see [Teaching Animations](doc
466
469
  <svg viewBox="0 0 720 200">…</svg>
467
470
  <script type="application/json" data-tinyfly-timeline>{ …timeline JSON… }</script>
468
471
  </figure>
469
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.78.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
472
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.81.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
470
473
  ```
471
474
 
472
475
  ### Audio / Video Sync