@algorisys/tinyfly 0.109.0 → 0.111.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 +7 -7
- package/docs/character-appearance.md +5 -2
- package/docs/cricket.md +119 -5
- 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 +32 -1
- package/docs/maps.md +2 -2
- package/docs/teaching.md +1 -1
- package/lib/addons/characters.js +1419 -1415
- package/lib/addons/{cricket-camera-BWByoNgz.js → cricket-markings-KbMjP7r6.js} +1855 -1748
- package/lib/addons/sports.js +312 -288
- package/lib/browser/tinyfly.iife.js +12 -12
- package/lib/browser/tinyfly.js +6242 -6118
- package/lib/browser/tinyfly.umd.js +12 -12
- package/lib/types/characters/capabilities.d.ts +5 -1
- package/lib/types/sports/cricket/cricket-camera.d.ts +2 -0
- package/lib/types/sports/cricket/cricket-markings.d.ts +35 -0
- package/lib/types/sports/cricket/cricket-motion.d.ts +7 -0
- package/lib/types/sports/cricket/cricket-types.d.ts +33 -1
- package/lib/types/sports/cricket/index.d.ts +3 -2
- package/llms-full.txt +169 -17
- package/llms.txt +30 -30
- package/package.json +1 -1
- package/skills/tinyfly/SKILL.md +32 -1
package/README.md
CHANGED
|
@@ -54,11 +54,11 @@ A lightweight, API-driven animation engine and visual editor for creating high-p
|
|
|
54
54
|
- **Code-drawn targets** - A `custom` canvas target draws with code (characters, charts, props) while the timeline animates its position, opacity and its own `props`, so drawing stays code and timing stays JSON
|
|
55
55
|
- **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
|
|
56
56
|
- **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
|
|
57
|
-
- **Cricket stories** - Public `@algorisys/tinyfly/sports` builders create an organic adult/child cast, standard pitch, full fielding side, wickets and boundary. Sixteen authored plays cover deliveries, strokes, running, boundaries, catches, fielding, throws, dismissals, no-balls and wides for Test, ODI and T20. Exact contact keys, captions and results are JSON; eight camera views include a 360° ground orbit and ball follow. Try [Cricket Stories](https://tinyfly.app/examples/live-cricket-story), download its scene/action/camera JSON, or render the headless example. See [the cricket guide](docs/cricket.md).
|
|
57
|
+
- **Cricket stories** - Public `@algorisys/tinyfly/sports` builders create an organic adult/child cast, standard pitch, full fielding side, wickets and boundary. Sixteen authored plays cover deliveries, strokes, running, boundaries, catches, fielding, throws, dismissals, no-balls and wides for Test, ODI and T20. Exact contact keys, captions and results are JSON; eight camera views include a 360° ground orbit and ball follow, with 25%–400% review zoom and reset. Select MCC, ICC men or ICC women field markings. ICC ODI/T20 restriction areas use wicket-centred capsule outlines; optional public setup markers classify the field. Fielders watch the bowler, track the incoming delivery through its bounce, then follow the struck ball. Body turns stay continuous from strokes into batter runs, into collection runs and while following return throws. A side-on right-handed stance and Adults/Men/Children/Mixed casts reuse the organic rig. Keeper-bound misses clear the native legs and intact stumps before palm collection. Public `CRICKET_FIELDING_POSITIONS` labels name all eleven stock fielders, including Extra cover; the Teams and field positions guide explains the two on-field batters, nine waiting teammates and mid-on/long-on. Playback, scrubbing and camera controls sit beside the scene (above it on phones). Try [Cricket Stories](https://tinyfly.app/examples/live-cricket-story), download its scene/action/camera JSON, or render the headless example. See [the cricket guide](docs/cricket.md).
|
|
58
58
|
Wide camera clipping scales for boundaries up to 250 m, and ball-follow generation reads only ball channels. Local full-page previews include add-ons before publication; copied pages keep their versioned CDN bundles.
|
|
59
59
|
Defensive blocks meet the blade with both hands on the bat. Keeper-bound deliveries pass outside the off stump with clearance for the displayed ball before collection.
|
|
60
60
|
|
|
61
|
-
- **Soft cartoon story characters** - Opt-in `figure: 'organic'` adds filled shoulders, chest/waist/hip contours, supple limbs, small posed hands and deterministic cel shading on the existing rig. JSON body profiles keep anatomy independent of outline width; one skin colour covers body, face and hands under scene lighting and fog, and cel shading respects inherited opacity. Foreground arms stay over waist garments in 2D and globally sorted 3D scenes, with only foreground arms promoted to garment depths so leaning head, neck, torso and legs retain world-object occlusion. Transparent organic skin keeps exposed body, head and both hand variants outline-only in every look. Editor Skin and Line controls resolve and edit imported body colour overrides. Leaf garment options are validated and copied at construction. Actor names are checked at runtime, and each head contour is reused for filling, shading and face clipping within a draw. Editable adult and child `softCartoonCharacter` presets, flowing hair, editable everyday/formal/casual/leaf clothing and the existing script, reach and lip-sync APIs support original stories. Try [**Soft Cartoon Characters**](https://tinyfly.app/examples/live-organic-characters): adults, children or an adult and child, with seven actions, face/hair controls and independent outfit editing. `outfitPreset()` supplies JSON wardrobe defaults; shirts, T-shirts, blouses, dresses, trousers, jeans, cargo, shorts, skirts, sleeves, collars, ties and colours remain editable. See [the appearance guide](docs/character-appearance.md).
|
|
61
|
+
- **Soft cartoon story characters** - Opt-in `figure: 'organic'` adds filled shoulders, chest/waist/hip contours, supple limbs, small posed hands and deterministic cel shading on the existing rig. JSON body profiles keep anatomy independent of outline width; one skin colour covers body, face and hands under scene lighting and fog, and cel shading respects inherited opacity. Rear scalp hair and hats stay with the head through camera-sorted turns and nods. Foreground arms stay over waist garments in 2D and globally sorted 3D scenes, with only foreground arms promoted to garment depths so leaning head, neck, torso and legs retain world-object occlusion. Transparent organic skin keeps exposed body, head and both hand variants outline-only in every look. Editor Skin and Line controls resolve and edit imported body colour overrides. Leaf garment options are validated and copied at construction. Actor names are checked at runtime, and each head contour is reused for filling, shading and face clipping within a draw. Editable adult and child `softCartoonCharacter` presets, flowing hair, editable everyday/formal/casual/leaf clothing and the existing script, reach and lip-sync APIs support original stories. Try [**Soft Cartoon Characters**](https://tinyfly.app/examples/live-organic-characters): adults, children or an adult and child, with seven actions, face/hair controls and independent outfit editing. `outfitPreset()` supplies JSON wardrobe defaults; shirts, T-shirts, blouses, dresses, trousers, jeans, cargo, shorts, skirts, sleeves, collars, ties and colours remain editable. See [the appearance guide](docs/character-appearance.md).
|
|
62
62
|
- **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. **Character appearance**: 41 hairstyles, including soft sweeps, flowing bobs and cascading waves with scalp-attached curved locks and individual flexibility, 20 facial-hair styles, glasses, hats and ears as plain data on the head (they turn with it through all eight views), builds from toddler to tall, a recurring cast (`castMember`), 30 expressions with blush, tears and sweat, and hair that swings after a turn or a run and settles (`hairFollowTracks` keys the lag from the character's own tracks, so drawing stays stateless); four-legged animals' ears lay back on a run the way their tails already trail. Clothes are data too (`outfit.over`: an apron, a lab coat, a hoodie, a cardigan, overalls, a sari; boots), a mouth opens on teeth and a tongue, feet come in shapes, two people hug and help each other up (`embrace`, `helpUp`), and a cane in the hand or a wheelchair to ride are accessories any character can have, not part of an age ([guide](docs/character-appearance.md))
|
|
63
63
|
- **Dance and flips** - The stick figure dances disco, hip hop, breaking toprock, jazz, K-pop, Bollywood, Bhangra, Bharatanatyam (with mudras), the Charleston, tap (foot strikes as data, for tap sounds) and popping (side glide, moonwalk, forward glide, which travel with the planted foot staying put), 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. Native v2 garba (two/three clap) and dandiya add body-local poses, circle formations with planted toes, paired stick-tip contacts, and timed full spins (`humanDanceFrame`, `danceCircleTracks`, `meetDandiya`, `characterScript3D`). Sparse custom keys keep numeric hand and pose values through JSON playback; rolled circles preserve native yaw-before-roll and foot grounding. Foot IK preserves authored hip turn-out for ankle and toe plants. Scripted dance entry preserves relaxed or explicitly posed hands through preceding holds. Script action boundaries retain preceding easing; festive examples solve contacts with their rendered body options. See [docs/dance.md](docs/dance.md)
|
|
64
64
|
- **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
|
|
@@ -233,7 +233,7 @@ for what you import:
|
|
|
233
233
|
| `@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) |
|
|
234
234
|
| `@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; `hair`, `facialHair`, `glasses`, `hat`, `ears`, `face`, `feet`, `build`, `outfit` as data, `castMember()`, `HUMAN_EXPRESSIONS` with face marks; `embrace`, `helpUp`, `scenery` | Anywhere with a Canvas 2D context |
|
|
235
235
|
| `@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) |
|
|
236
|
-
| `@algorisys/tinyfly/sports` | `cricketPlayer`, `cricketField`, `cricketAction`, `cricketClip`, `cricketCameraTracks`, `cricketEventAt`, shared `ballFlightTracks`; authored organic cricket stories and a 360° ground camera | Browser, Worker, Node; scene rendering through adapters |
|
|
236
|
+
| `@algorisys/tinyfly/sports` | `cricketPlayer`, `cricketField`, `cricketAction`, `cricketClip`, `cricketCameraTracks`, `cricketEventAt`, field marking profiles/classification/overlays, shared `ballFlightTracks`; authored organic cricket stories and a 360° ground camera | Browser, Worker, Node; scene rendering through adapters |
|
|
237
237
|
| `@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 |
|
|
238
238
|
|
|
239
239
|
```js
|
|
@@ -280,7 +280,7 @@ GSAP-shaped functions at the top level. Teaching embeds are included: add
|
|
|
280
280
|
itself.
|
|
281
281
|
|
|
282
282
|
```html
|
|
283
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
283
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.111.0/cdn/tinyfly.iife.js"></script>
|
|
284
284
|
<script>
|
|
285
285
|
tinyfly.to('.box', { x: 200, rotate: 90, duration: 1, ease: 'power2.out' })
|
|
286
286
|
|
|
@@ -316,7 +316,7 @@ A teaching figure needs no code at all:
|
|
|
316
316
|
<script type="application/json" data-tinyfly-timeline>{ …timeline JSON with markers… }</script>
|
|
317
317
|
<figcaption>Appending to a full slice</figcaption>
|
|
318
318
|
</figure>
|
|
319
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
319
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.111.0/cdn/tinyfly.iife.js" data-tinyfly-auto></script>
|
|
320
320
|
```
|
|
321
321
|
|
|
322
322
|
See [Teaching Animations](docs/teaching.md).
|
|
@@ -415,7 +415,7 @@ Without a build step, the player bundle puts the same functions on a `tinyfly` g
|
|
|
415
415
|
<div data-tinyfly="box" style="width: 60px; height: 60px; background: #4a9eff;"></div>
|
|
416
416
|
</div>
|
|
417
417
|
|
|
418
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
418
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.111.0/cdn/tinyfly-player.iife.js"></script>
|
|
419
419
|
<script>
|
|
420
420
|
tinyfly.play('#animation', './animation.json', { loop: -1 })
|
|
421
421
|
</script>
|
|
@@ -524,7 +524,7 @@ Or skip the code entirely with declarative embeds (see [Teaching Animations](doc
|
|
|
524
524
|
<svg viewBox="0 0 720 200">…</svg>
|
|
525
525
|
<script type="application/json" data-tinyfly-timeline>{ …timeline JSON… }</script>
|
|
526
526
|
</figure>
|
|
527
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
527
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.111.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
|
|
528
528
|
```
|
|
529
529
|
|
|
530
530
|
### Audio / Video Sync
|
|
@@ -187,8 +187,11 @@ off the head, how far it hangs), drawn wherever the head's `turn`, `head.turn`,
|
|
|
187
187
|
shoulders seen from the front, and a bob shows beside the face;
|
|
188
188
|
- the part facing the viewer is drawn over the head, so a fringe crosses the
|
|
189
189
|
forehead and, from behind, the hair covers the whole head;
|
|
190
|
-
- turned away (past about `turn` 1.2),
|
|
191
|
-
over an arm at the side;
|
|
190
|
+
- in a whole-figure 2D draw, turned away (past about `turn` 1.2), hair is
|
|
191
|
+
drawn after the body, over an arm at the side;
|
|
192
|
+
- in a camera-sorted 3D scene, rear hair and hats draw with the head's own
|
|
193
|
+
part, after its skin. They remain attached through independent head turns
|
|
194
|
+
and nods, without another body's draw order exposing the scalp;
|
|
192
195
|
- a parting, a side ponytail or a braid stays on the character's own side
|
|
193
196
|
through a turn: left and right are the character's, never mirrored.
|
|
194
197
|
|
package/docs/cricket.md
CHANGED
|
@@ -34,15 +34,19 @@ See [getting started](getting-started.md) for the versioned CDN URLs.
|
|
|
34
34
|
| API | Result |
|
|
35
35
|
| --- | --- |
|
|
36
36
|
| `cricketPlayer({ id, role, preset?, format?, height?, position?, color?, headwear?, appearance? })` | An owned JSON `character` scene object. Roles: batter, bowler, keeper, fielder, umpire. Presets include youngMan, youngWoman, childBoy, childGirl. |
|
|
37
|
-
| `cricketField({ id?, format?, cast?, boundaryRadius?, battingColor?, fieldingColor? })` | `scene`, `format`, `boundaryRadius`, `landmarks
|
|
37
|
+
| `cricketField({ id?, format?, cast?, boundaryRadius?, markingProfile?, battingColor?, fieldingColor? })` | `scene`, `format`, `boundaryRadius`, `landmarks`, `markingProfile`, `fieldingArea`; stock fielders have human-readable JSON `name` labels. A 20.12 × 3.05 metre pitch, standard creases, wickets/bails, two bats, ball, boundary, eleven fielding players, two batters and two umpires. |
|
|
38
|
+
| `cricketFieldingAreaContains(field, point)` | `true` inside/on the ideal restriction-area capsule, `false` outside, `null` without region metadata. Uses x/z; point height is ignored. |
|
|
39
|
+
| `cricketFieldingPositions(field)` | Owned setup-position data for stock fielders: `id`, `name`, `position`, `inside`. |
|
|
40
|
+
| `cricketFieldingOverlay(field)` | Optional static JSON line markers, green inside/orange outside. Append to scene objects without changing motion. |
|
|
38
41
|
| `cricketAction(field, { action?, duration?, every? })` | A JSON timeline, timed events/captions and declared example result. Does not modify the field. |
|
|
39
42
|
| `cricketClip(options)` | Combines field and action; default T20, adult cast, pace bowling, 6000 ms. |
|
|
40
|
-
| `cricketCameraTracks(clip, { view?, yaw?, every? })` | Ordinary scene camera tracks. Merge these with the action tracks. |
|
|
43
|
+
| `cricketCameraTracks(clip, { view?, yaw?, zoom?, every? })` | Ordinary scene camera tracks. Merge these with the action tracks. |
|
|
41
44
|
| `cricketEventAt(events, time)` | Most recent event at that time, including when seeking backward. |
|
|
42
45
|
| `ballFlightPoint(options, time)`, `ballFlightTracks(options)` | Shared sampled arcs for other sports too. `from`, `to`, `arc`, `curve`, `start`, `end`, `target`; exact endpoints. |
|
|
43
46
|
|
|
44
|
-
Units are metres, milliseconds and degrees. `cast` is `adults`, `children` or
|
|
45
|
-
`mixed`; `
|
|
47
|
+
Units are metres, milliseconds and degrees. `cast` is `adults`, `men`, `children` or
|
|
48
|
+
`mixed`; `CRICKET_CASTS` exports their labels. `men` uses the existing youngMan
|
|
49
|
+
organic preset for every role; adults/children/mixed retain their varied casts; `format` is `test`, `odi` or `t20`. `boundaryRadius` defaults to 64 m
|
|
46
50
|
and accepts 24–250 m. A boundary is venue dependent. Sampling defaults to 40 ms,
|
|
47
51
|
accepts 16–1000 ms and always includes play contact events. Durations accept
|
|
48
52
|
4000–60000 ms; changing duration scales the whole play. Player height accepts
|
|
@@ -54,6 +58,114 @@ The standard action builder expects the named actors/equipment from
|
|
|
54
58
|
scale. It owns poses and paths for that layout. Customize appearance and
|
|
55
59
|
uniforms before compiling; author your own scene tracks for a different layout.
|
|
56
60
|
|
|
61
|
+
Fielders watch the bowler during the run-up, smoothly pick up the moving ball
|
|
62
|
+
after release, track its flight and bounce, then follow it after contact or a miss. Head turns
|
|
63
|
+
use the rig's neck frame, including torso lean, and are independent of the
|
|
64
|
+
camera. Stationary fielders turn their bodies toward the play; running players
|
|
65
|
+
face their travel and collectors keep their catch/throw poses. The striker uses
|
|
66
|
+
a side-on right-handed guard: left shoulder and front foot toward the bowler,
|
|
67
|
+
soft knees, both feet supported, left hand above the right on the handle and a
|
|
68
|
+
bat resting near the back foot. These authored poses also fit the child rig.
|
|
69
|
+
|
|
70
|
+
The live example keeps cast/action/camera selection and playback/scrubbing in a
|
|
71
|
+
panel beside the scene, or above it on narrow screens. Select **Men** in Cast for
|
|
72
|
+
the male team; individual players remain editable through `cricketPlayer`.
|
|
73
|
+
|
|
74
|
+
## Teams and stock field positions
|
|
75
|
+
|
|
76
|
+
Each team has eleven players. `cricketField` shows all eleven of the fielding
|
|
77
|
+
XI, two on-field batters (striker and non-striker) and two umpires. The other
|
|
78
|
+
nine members of the batting XI wait off-field.
|
|
79
|
+
|
|
80
|
+
`CRICKET_FIELDING_POSITIONS` exports the stock actor IDs and labels as plain
|
|
81
|
+
JSON data. Each corresponding scene object also carries the label in `name`:
|
|
82
|
+
Bowler, Wicketkeeper, Extra cover (`fielder`, the collecting actor), Slip,
|
|
83
|
+
Point, Cover, Mid-off, Mid-on, Square leg, Fine leg and Third man. IDs used by
|
|
84
|
+
action tracks remain stable. These are illustrative placements, not a roster
|
|
85
|
+
or automatic field-setting system.
|
|
86
|
+
|
|
87
|
+
For this right-handed striker, the off side is in front of the chest (+x),
|
|
88
|
+
and the on or leg side is behind the back (−x). Mid-on stands on the leg side
|
|
89
|
+
closer to the pitch toward the bowler; long-on is its deeper boundary
|
|
90
|
+
alternative. Long-on is not an additional stock fielder. Choose a different
|
|
91
|
+
layout by authoring your own scene and tracks.
|
|
92
|
+
|
|
93
|
+
Wicketkeeper and slip stand behind the striker. Their attention follows the
|
|
94
|
+
actual delivery through its flight and bounce rather than turning to the batter
|
|
95
|
+
before the ball arrives. Their native head poses aim at world targets,
|
|
96
|
+
independently of their body yaw and camera selection. The live example's
|
|
97
|
+
**Teams and field positions** disclosure uses the scene's JSON labels.
|
|
98
|
+
|
|
99
|
+
## Field marking profiles
|
|
100
|
+
|
|
101
|
+
`markingProfile` is `icc-men` (default), `icc-women` or `mcc`, independent of
|
|
102
|
+
`cast`. `CRICKET_MARKING_PROFILES` exports their names, dimensions and summaries.
|
|
103
|
+
These select field markings only; venue boundaries, player eligibility,
|
|
104
|
+
powerplay phases and the rest of a competition's conditions require separate
|
|
105
|
+
checks. A caller-selected small boundary remains an illustrative venue.
|
|
106
|
+
|
|
107
|
+
| Profile | Popping crease painted on each side | ODI/T20 restriction area |
|
|
108
|
+
| --- | --- | --- |
|
|
109
|
+
| `icc-men` | 7.5 m | Wicket-centred semicircles of radius 27.43 m, joined by straight sides |
|
|
110
|
+
| `icc-women` | 7.5 m | Wicket-centred semicircles of radius 23 m, joined by straight sides |
|
|
111
|
+
| `mcc` | 1.83 m minimum | None prescribed by the base Laws |
|
|
112
|
+
|
|
113
|
+
Test has no restriction-area line for any profile. All profiles retain the
|
|
114
|
+
20.12 m pitch, the 1.22 m popping-crease offset and the return-crease positions.
|
|
115
|
+
The painted popping crease is a finite visual mark; the actual crease is
|
|
116
|
+
considered unlimited in length. The existing object ID `fielding-circle` is
|
|
117
|
+
retained for the corrected capsule outline. For ICC men its extrema are
|
|
118
|
+
x = ±27.43 m and z = ±37.49 m; the two arc centres are z = ±10.06 m.
|
|
119
|
+
|
|
120
|
+
The dimensions follow MCC 2026 Law 7.3 and ICC October 2026 clauses 7.3/28.7.
|
|
121
|
+
Sources: [MCC Laws](https://www.lords.org/getmedia/a4ef9f77-2a25-4f5b-a286-4601f08e6334/Laws-of-Cricket-2017-Code-4th-Edition-%282026%29_5.pdf),
|
|
122
|
+
[ICC men Test](https://images.icc-cricket.com/image/upload/prd/a8114zro5tkioifz0jqg.pdf),
|
|
123
|
+
[ODI](https://images.icc-cricket.com/image/upload/prd/bxkzkcyvfn6tvi70zh0w.pdf),
|
|
124
|
+
[T20I](https://images.icc-cricket.com/image/upload/prd/bsxcho7ufe2pjban0wjp.pdf),
|
|
125
|
+
[ICC women Test](https://images.icc-cricket.com/image/upload/prd/hbwwi78pugzpdwft0v4v.pdf),
|
|
126
|
+
[ODI](https://images.icc-cricket.com/image/upload/prd/qunpw1kfh3ibxlz58jlw.pdf) and
|
|
127
|
+
[T20I](https://images.icc-cricket.com/image/upload/prd/o3vhm0zw7pppoxpgopke.pdf).
|
|
128
|
+
|
|
129
|
+
```ts
|
|
130
|
+
import { cricketField, cricketFieldingAreaContains, cricketFieldingPositions,
|
|
131
|
+
cricketFieldingOverlay } from '@algorisys/tinyfly/sports'
|
|
132
|
+
|
|
133
|
+
const field = cricketField({ format: 't20', markingProfile: 'icc-women' })
|
|
134
|
+
const inside = cricketFieldingAreaContains(field, [0, 0, 30]) // true
|
|
135
|
+
const setup = cricketFieldingPositions(field)
|
|
136
|
+
const outside = setup.filter(player => player.inside === false)
|
|
137
|
+
const sceneWithMarkers = { ...field.scene,
|
|
138
|
+
objects: [...field.scene.objects, ...cricketFieldingOverlay(field)] }
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
Classification uses the ideal capsule rather than a midpoint circle. Points on
|
|
142
|
+
its boundary count as inside, with a 1 nm numeric tolerance. `null` distinguishes
|
|
143
|
+
an absent area from an outside point, including older/custom JSON fields with
|
|
144
|
+
no `fieldingArea` metadata. The query accepts world-ground x/z reference points;
|
|
145
|
+
it does not judge whole-player/foot placement or whether a field is legal.
|
|
146
|
+
The setup helpers read the stock players' unparented scene positions. Markers
|
|
147
|
+
stay there during playback. Both ICC stock layouts have nine reference points
|
|
148
|
+
inside and two outside (Fine leg and Third man), useful for a powerplay placement
|
|
149
|
+
illustration; this is not automatic umpiring.
|
|
150
|
+
|
|
151
|
+
Select **Markings** and **Setup field markers** in the example, then choose an
|
|
152
|
+
overhead/whole-ground camera. Profile and overlay changes preserve current
|
|
153
|
+
story time and playback; selected zoom is retained. Downloaded JSON includes
|
|
154
|
+
the profile, analytic region metadata, corrected line and optional markers.
|
|
155
|
+
|
|
156
|
+
## Review zoom
|
|
157
|
+
|
|
158
|
+
Pass `zoom` to `cricketCameraTracks(clip, { view: 'batter', zoom: 2 })` for
|
|
159
|
+
2× magnification. All eight views support 0.25–4 (default 1), including orbit
|
|
160
|
+
and ball follow. Zoom changes the field of view while preserving camera position,
|
|
161
|
+
look target, clipping distances, player motion and current story time. Invalid
|
|
162
|
+
or non-finite zoom values throw. The generated camera tracks are ordinary JSON.
|
|
163
|
+
|
|
164
|
+
The example provides a 25%–400% slider, zoom-in/out buttons and **Reset**.
|
|
165
|
+
Zoom persists while choosing another play, cast or view, and downloaded story
|
|
166
|
+
JSON includes the selected magnification. Native range controls support keyboard
|
|
167
|
+
and touch review; zooming does not seek, pause or restart playback.
|
|
168
|
+
|
|
57
169
|
## Plays and cameras
|
|
58
170
|
|
|
59
171
|
`CRICKET_ACTIONS` contains sixteen plays:
|
|
@@ -75,7 +187,9 @@ ball and fielder keyed to the same palm contact.
|
|
|
75
187
|
Defensive blocks retain their downward two-hand bat pose and emit the `contact`
|
|
76
188
|
event with the “Bat contact” label. Pace, spin, no-ball and stumping deliveries
|
|
77
189
|
pass outside the off stump on the side away from the batter, allowing for the
|
|
78
|
-
displayed ball and stump radii before collection.
|
|
190
|
+
displayed ball and stump radii before collection. Their positive-x clearance
|
|
191
|
+
path also avoids both native legs throughout the delivery, including the
|
|
192
|
+
striker’s movement during stumping. Bowled keeps its intentional
|
|
79
193
|
wicket collision; stumping keeps the later hand-held wicket break.
|
|
80
194
|
|
|
81
195
|
`CRICKET_VIEWS` offers `pitch`, `batter`, `bowler`, `keeper`, `field`, `overhead`,
|
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.111.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.111.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.111.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.111.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
|
@@ -91,7 +91,7 @@ bakes. See `docs/dance.md`.
|
|
|
91
91
|
For cricket tutorials, import `cricketClip`, `cricketCameraTracks` and
|
|
92
92
|
`cricketEventAt` from `@algorisys/tinyfly/sports`. The clip is an owned scene,
|
|
93
93
|
JSON timeline, timed captions and declared result. Choose `test | odi | t20`,
|
|
94
|
-
`adults | children | mixed`, and a play from `CRICKET_ACTIONS`. Merge camera
|
|
94
|
+
`adults | men | children | mixed`, and a play from `CRICKET_ACTIONS`. Merge camera
|
|
95
95
|
tracks with action tracks; render with scene-3d plus `[characterObjects]`.
|
|
96
96
|
The UI is a consumer of these APIs. `orbit` covers the full ground in 360°;
|
|
97
97
|
`follow-ball` keys against the same ball tracks. Contacts are sampled exactly,
|
|
@@ -100,6 +100,37 @@ demonstrations, not collision-based umpiring or an innings simulator. Do not
|
|
|
100
100
|
infer new outcomes from the illustrative arcs. See `docs/cricket.md` and
|
|
101
101
|
`examples/headless-video/cricket-story.mjs`; `/examples/live-cricket-story`
|
|
102
102
|
has event seeking and downloadable scene/action/camera JSON.
|
|
103
|
+
Choose `markingProfile: 'icc-men' | 'icc-women' | 'mcc'` explicitly when
|
|
104
|
+
teaching field geography; default ICC men is independent of cast. These are
|
|
105
|
+
marking dimensions, not full competition profiles. ODI/T20 ICC areas are
|
|
106
|
+
wicket-centred capsules (27.43/23 m radii); Test/MCC have no restriction line.
|
|
107
|
+
ICC popping-crease marks extend 7.5 m on either side; MCC minimum is 1.83 m.
|
|
108
|
+
`cricketFieldingAreaContains(field, point)` returns true/false/null, with null
|
|
109
|
+
for absent metadata/areas. `cricketFieldingPositions`/`cricketFieldingOverlay`
|
|
110
|
+
provide owned static setup markers. Do not count null as outside or interpret
|
|
111
|
+
point classification as legal whole-player placement. Markers stay at setup
|
|
112
|
+
positions; append them to the scene and preserve them in exported JSON.
|
|
113
|
+
`CRICKET_FIELDING_POSITIONS` maps the eleven stock fielding IDs to public labels;
|
|
114
|
+
scene objects carry them in `name`. `fielder` is Extra cover. Keep eleven fielders,
|
|
115
|
+
two on-field batters and two umpires; nine batting teammates wait off-field.
|
|
116
|
+
Mid-on is closer to the pitch; long-on is its deeper boundary alternative, not
|
|
117
|
+
an extra stock player. For the right-handed striker, +x is off side and −x is
|
|
118
|
+
on/leg side. Keeper/slip stand behind the striker; track the actual incoming delivery,
|
|
119
|
+
never force their heads toward a screen direction or the camera.
|
|
120
|
+
`cricketCameraTracks(clip, { view, zoom })` supports optical zoom 0.25–4
|
|
121
|
+
(default 1) for every view, preserving the camera path and story state. Merge
|
|
122
|
+
the returned field-of-view track into exported JSON; do not CSS-scale the canvas.
|
|
123
|
+
In camera-sorted character rendering, rear hair and hats belong to the head
|
|
124
|
+
pass; attaching them to the final body part lets the skin paint over them.
|
|
125
|
+
`CRICKET_CASTS` supplies cast labels; `men` uses the existing youngMan organic
|
|
126
|
+
preset for every role. Standard actions include camera-independent fielding
|
|
127
|
+
attention: bowler during run-up, moving delivery after release and through the
|
|
128
|
+
bounce, then the ball after contact/miss. Do not switch to the batter early.
|
|
129
|
+
The right-handed guard is side-on with the left hand above the right; preserve
|
|
130
|
+
these world-facing poses instead of rotating players toward the camera.
|
|
131
|
+
Keeper-bound misses pass on positive x, clear of the native legs and stumps
|
|
132
|
+
through every ball segment, including sparse keys and scaled durations. Keep
|
|
133
|
+
keeper palm contacts and intentional LBW pad contact.
|
|
103
134
|
Wide cameras support the full 24–250 m boundary range; equivalent yaw angles
|
|
104
135
|
use identical geometry. Ball-follow cameras sample only ball position channels.
|
|
105
136
|
Render the headless example with `tinyfly video <scene.mjs> -o <output.mp4>`.
|
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.111.0/cdn/tinyfly.iife.js"></script>
|
|
18
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.111.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/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.111.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
|