@algorisys/tinyfly 0.97.0 → 0.98.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.
Files changed (37) hide show
  1. package/README.md +7 -7
  2. package/docs/character-appearance.md +281 -0
  3. package/docs/editor-guide.md +14 -6
  4. package/docs/examples.md +1 -1
  5. package/docs/getting-started.md +1 -1
  6. package/docs/gsap-compat.md +1 -1
  7. package/docs/llm-guide.md +21 -1
  8. package/docs/maps.md +2 -2
  9. package/docs/props.md +8 -6
  10. package/docs/teaching.md +1 -1
  11. package/lib/addons/characters.js +5720 -4476
  12. package/lib/browser/tinyfly.iife.js +15 -15
  13. package/lib/browser/tinyfly.js +7928 -6684
  14. package/lib/browser/tinyfly.umd.js +15 -15
  15. package/lib/types/characters/capabilities.d.ts +15 -0
  16. package/lib/types/characters/cast.d.ts +284 -0
  17. package/lib/types/characters/character.d.ts +22 -4
  18. package/lib/types/characters/hands/held-items.d.ts +88 -0
  19. package/lib/types/characters/hands/index.d.ts +1 -0
  20. package/lib/types/characters/head/ears.d.ts +10 -0
  21. package/lib/types/characters/head/facial-hair.d.ts +118 -0
  22. package/lib/types/characters/head/glasses.d.ts +24 -0
  23. package/lib/types/characters/head/hair.d.ts +560 -0
  24. package/lib/types/characters/head/hats.d.ts +58 -0
  25. package/lib/types/characters/head/head-look.d.ts +53 -0
  26. package/lib/types/characters/head/index.d.ts +5 -0
  27. package/lib/types/characters/head/shell.d.ts +64 -0
  28. package/lib/types/characters/index.d.ts +4 -1
  29. package/lib/types/characters/interactions.d.ts +69 -0
  30. package/lib/types/characters/props/families/animals.d.ts +6 -0
  31. package/lib/types/characters/species/human-motion.d.ts +5 -2
  32. package/lib/types/characters/species/human.d.ts +111 -4
  33. package/lib/types/characters/wardrobe/basic-outfit.d.ts +19 -5
  34. package/llms-full.txt +355 -27
  35. package/llms.txt +29 -28
  36. package/package.json +1 -1
  37. package/skills/tinyfly/SKILL.md +10 -1
@@ -15,7 +15,8 @@ Run `npx @algorisys/tinyfly capabilities` (add `--json` for data) and read it
15
15
  before writing anything. It is generated from the installed library: easings,
16
16
  track kinds, every canvas property with units and ranges, the stick figure's
17
17
  joints, poses, expressions (moods), gags, gaits, beat actions (and the fields
18
- each needs), dances, flips, hand shapes, the code panel's languages, every surface's
18
+ each needs), dances, flips, hand shapes, the v2 character's builds, hairstyles,
19
+ facial hair, glasses, hats, cast and expressions, the code panel's languages, every surface's
19
20
  anchors and edits (code, board, chart), camera shots, teaching helpers.
20
21
 
21
22
  For the how-to, read the docs shipped with the package, at the installed
@@ -66,6 +67,14 @@ names.
66
67
  `rotation: [0, deg, 0]` (`rotateY` is a track) and script them with
67
68
  `propScript3D` (`to: [x, z]` metres), not `propScript` (screen px);
68
69
  characters there with `characterScript3D`, riders with `propRide3D`.
70
+ - Give a v2 `character()` its look as options, not drawing code: `build`,
71
+ `hair` (`'bob'` or `{ style, color, length }`), `facialHair`, `glasses`,
72
+ `hat`, `ears: true`, `outfit: { shirt, trousers }`; or start from
73
+ `castMember('grandma', height)`. Hair and hats turn with the head, so one
74
+ description serves every view. Faces are `HUMAN_EXPRESSIONS` plus the pose
75
+ fields `blush`, `tears`, `sweat` (0–1). Items in hands: `holding`
76
+ (`held.<side>` lets go); hands that meet: `meetHands(kind, a, b)` at
77
+ `meetingSpacing`. See `docs/character-appearance.md`.
69
78
  - For recurring characters, make a `persona()` (look, acting, gait, mood,
70
79
  stance) and use `persona.script()`; for a move the catalog lacks, write it
71
80
  with `defineAction()` rather than hand-keying joints in many places.