@algorisys/tinyfly 0.77.0 → 0.79.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 +9 -5
- package/lib/addons/characters.js +1139 -793
- package/lib/addons/maps.js +442 -0
- package/lib/browser/tinyfly-maps.iife.js +1 -0
- package/lib/browser/tinyfly.iife.js +4 -4
- package/lib/browser/tinyfly.js +2235 -1889
- package/lib/browser/tinyfly.umd.js +4 -4
- package/lib/types/characters/character.d.ts +19 -0
- package/lib/types/characters/hand.d.ts +57 -4
- package/lib/types/characters/hands/draw-cartoon-hand.d.ts +39 -0
- package/lib/types/characters/hands/hand-rig.d.ts +116 -0
- package/lib/types/characters/hands/index.d.ts +3 -0
- package/lib/types/characters/index.d.ts +1 -0
- package/lib/types/maps/cities.d.ts +13 -0
- package/lib/types/maps/index.d.ts +12 -0
- package/lib/types/maps/map-target.d.ts +125 -0
- package/lib/types/maps/projection.d.ts +66 -0
- package/lib/types/maps/tiles.d.ts +67 -0
- package/lib/types/maps/world-110m.d.ts +13 -0
- package/lib/types/maps/world.d.ts +53 -0
- package/package.json +6 -2
package/README.md
CHANGED
|
@@ -50,9 +50,12 @@ 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
|
+
- **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
|
|
53
54
|
- **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
|
|
54
|
-
- **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
|
|
55
|
+
- **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
|
|
55
56
|
- **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
|
|
57
|
+
- **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)
|
|
58
|
+
- **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
|
|
56
59
|
- **Captions** - `toSRT()` / `toWebVTT()` from narration cues or from a timeline's markers
|
|
57
60
|
|
|
58
61
|
### Render Adapters
|
|
@@ -172,6 +175,7 @@ for what you import:
|
|
|
172
175
|
| `@algorisys/tinyfly/embed` | Teaching embeds: the player with step controls, captions, scenarios and one-script `[data-tinyfly-embed]` mounting; `validateEmbed`, `validateScenarios`, `renderFrame` | Browser (tools anywhere) |
|
|
173
176
|
| `@algorisys/tinyfly/teach` | `lesson()` step builder and diagram primitives (cells, pointer, stack, queue, table, pipeline) | Anywhere |
|
|
174
177
|
| `@algorisys/tinyfly/react`, `@algorisys/tinyfly/vue`, `@algorisys/tinyfly/svelte`, `@algorisys/tinyfly/solid` | `useTinyfly` hooks, a Svelte action and a Solid primitive: `live` animations scoped to a component and reverted on unmount | Browser (frameworks are optional peer dependencies) |
|
|
178
|
+
| `@algorisys/tinyfly/maps` | Animated maps: OpenStreetMap tiles or an offline world outline, places, routes that draw on, a camera that flies (`mapTarget`, `mapFlyTracks`, `fitView`, `WORLD_CITIES`) | Anywhere with a Canvas 2D context (tiles need a network) |
|
|
175
179
|
| `@algorisys/tinyfly/characters` | Poseable stick figure: `stickFigureTarget`, `poseTracks`, `POSES`, `blendPose`, `walkPose`, `drawStickFigure`; `stickFigureJoints` and `layers` for costumes, hair and props; `turn`, `sit` and ground contact; an organic look by default (`classic` keeps the old one); **characters v2**: `character()` / `characterTarget()`, turnarounds front to back, contact, reaching, clean / pencil / silhouette looks | Anywhere with a Canvas 2D context |
|
|
176
180
|
| `@algorisys/tinyfly/headless` | `renderVideo`, `renderStills`, `FrameRenderer`: render a scene to MP4 or PNGs (see [Rendering Video from Code](docs/video-rendering.md)) | Node (`@napi-rs/canvas` optional peer, ffmpeg) |
|
|
177
181
|
| `@algorisys/tinyfly/browser` | One script-tag bundle (`tinyfly.iife.js`): the engine, player, drivers, interaction, the GSAP-style `live` / `tf` facades, teaching-embed controls and mounting, and the `characters` stick figure. Not included: `export`, `adapters`, `teach`, the framework hooks, `headless` | Browser |
|
|
@@ -220,7 +224,7 @@ GSAP-shaped functions at the top level. Teaching embeds are included: add
|
|
|
220
224
|
itself.
|
|
221
225
|
|
|
222
226
|
```html
|
|
223
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
227
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.79.0/cdn/tinyfly.iife.js"></script>
|
|
224
228
|
<script>
|
|
225
229
|
tinyfly.to('.box', { x: 200, rotate: 90, duration: 1, ease: 'power2.out' })
|
|
226
230
|
|
|
@@ -256,7 +260,7 @@ A teaching figure needs no code at all:
|
|
|
256
260
|
<script type="application/json" data-tinyfly-timeline>{ …timeline JSON with markers… }</script>
|
|
257
261
|
<figcaption>Appending to a full slice</figcaption>
|
|
258
262
|
</figure>
|
|
259
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
263
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.79.0/cdn/tinyfly.iife.js" data-tinyfly-auto></script>
|
|
260
264
|
```
|
|
261
265
|
|
|
262
266
|
See [Teaching Animations](docs/teaching.md).
|
|
@@ -355,7 +359,7 @@ Without a build step, the player bundle puts the same functions on a `tinyfly` g
|
|
|
355
359
|
<div data-tinyfly="box" style="width: 60px; height: 60px; background: #4a9eff;"></div>
|
|
356
360
|
</div>
|
|
357
361
|
|
|
358
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
362
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.79.0/cdn/tinyfly-player.iife.js"></script>
|
|
359
363
|
<script>
|
|
360
364
|
tinyfly.play('#animation', './animation.json', { loop: -1 })
|
|
361
365
|
</script>
|
|
@@ -464,7 +468,7 @@ Or skip the code entirely with declarative embeds (see [Teaching Animations](doc
|
|
|
464
468
|
<svg viewBox="0 0 720 200">…</svg>
|
|
465
469
|
<script type="application/json" data-tinyfly-timeline>{ …timeline JSON… }</script>
|
|
466
470
|
</figure>
|
|
467
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
471
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.79.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
|
|
468
472
|
```
|
|
469
473
|
|
|
470
474
|
### Audio / Video Sync
|