@algorisys/tinyfly 0.113.0 → 0.115.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.
@@ -0,0 +1,86 @@
1
+ import type { BodyProfilePoint } from './organic-body';
2
+ /**
3
+ * A body described by tape-measure girths, as a tailor or a size chart gives
4
+ * them. Any unit works (cm, inches) as long as `height` uses the same one:
5
+ * only the ratios matter. The organic figure turns these into the torso's
6
+ * front width and its front and back depth, so the shape reads correctly from
7
+ * the front, the side and everywhere between.
8
+ */
9
+ export interface BodyMeasurements {
10
+ /** Standing height, in the same unit as the girths */
11
+ height: number;
12
+ /** Bust (or chest) girth at its fullest */
13
+ bust: number;
14
+ /** Ribcage girth just under the bust (default 0.86 × bust); the difference is how far the bust projects */
15
+ underbust?: number;
16
+ /** Natural waist girth, at its narrowest */
17
+ waist: number;
18
+ /** Hip girth at the fullest part of the seat */
19
+ hip: number;
20
+ }
21
+ /**
22
+ * The common body-shape families from size charts, as measurements of a
23
+ * 165 cm figure. Every shape suits any character; they are starting points,
24
+ * changed field by field like any other option.
25
+ */
26
+ export declare const BODY_SHAPES: {
27
+ hourglass: {
28
+ height: number;
29
+ bust: number;
30
+ underbust: number;
31
+ waist: number;
32
+ hip: number;
33
+ };
34
+ pear: {
35
+ height: number;
36
+ bust: number;
37
+ underbust: number;
38
+ waist: number;
39
+ hip: number;
40
+ };
41
+ rectangle: {
42
+ height: number;
43
+ bust: number;
44
+ underbust: number;
45
+ waist: number;
46
+ hip: number;
47
+ };
48
+ invertedTriangle: {
49
+ height: number;
50
+ bust: number;
51
+ underbust: number;
52
+ waist: number;
53
+ hip: number;
54
+ };
55
+ round: {
56
+ height: number;
57
+ bust: number;
58
+ underbust: number;
59
+ waist: number;
60
+ hip: number;
61
+ };
62
+ };
63
+ export type BodyShapeName = keyof typeof BODY_SHAPES;
64
+ /** Torso profiles along the spine (hip 0 to neck 1), each a fraction of the height. */
65
+ export interface BodyShapeProfiles {
66
+ /** Half-width seen from the front */
67
+ torso: BodyProfilePoint[];
68
+ /** Depth from the spine line toward the chest and belly, seen from the side */
69
+ torsoFront: BodyProfilePoint[];
70
+ /** Depth from the spine line toward the back and seat, seen from the side */
71
+ torsoBack: BodyProfilePoint[];
72
+ /** Half-width of the hips at their fullest, for placing the legs */
73
+ hipHalfWidth: number;
74
+ }
75
+ /** The named shape's measurements, or the measurements as given; validated. */
76
+ export declare function resolveMeasurements(measurements: BodyMeasurements | BodyShapeName): Required<BodyMeasurements>;
77
+ /**
78
+ * Turn measurements into torso profiles. A pure function: the same
79
+ * measurements always give the same shape. `shoulder` is the half-width at
80
+ * the shoulders that the rest of the figure already uses.
81
+ */
82
+ export declare function bodyShapeProfiles(measurements: BodyMeasurements | BodyShapeName, shoulder: number): BodyShapeProfiles;
83
+ /** Thighs fill out with the hips: their half-width at the top. */
84
+ export declare function measuredThighWidth(hipHalfWidth: number): number;
85
+ /** Half the spacing of the hip joints for these measurements: each thigh's outside meets the hip line. */
86
+ export declare function measuredHipWidth(measurements: BodyMeasurements | BodyShapeName): number;
@@ -1,3 +1,4 @@
1
+ import { type BodyMeasurements, type BodyShapeName } from './body-shape';
1
2
  /** A contour's half-width as a share of character height, at 0..1 along it. */
2
3
  export interface BodyProfilePoint {
3
4
  at: number;
@@ -14,6 +15,19 @@ export interface SkinShading {
14
15
  export interface OrganicBodyOptions {
15
16
  /** Hip to neck: hips, waist, chest and shoulders. */
16
17
  torso?: BodyProfilePoint[];
18
+ /**
19
+ * Seen from the side, the torso's depth from the spine line toward the
20
+ * chest and belly (front) and toward the back and seat (back). Default:
21
+ * `torso` × `depth` each way.
22
+ */
23
+ torsoFront?: BodyProfilePoint[];
24
+ torsoBack?: BodyProfilePoint[];
25
+ /**
26
+ * The torso from tape-measure girths, or a named shape (`hourglass`, `pear`,
27
+ * `rectangle`, `invertedTriangle`, `round`; see BODY_SHAPES). Sets each of
28
+ * `torso`, `torsoFront`, `torsoBack` and the thighs that is not given too.
29
+ */
30
+ measurements?: BodyMeasurements | BodyShapeName;
17
31
  /** Shoulder to wrist: upper arm, elbow, forearm and wrist. */
18
32
  arm?: BodyProfilePoint[];
19
33
  /** Hip to ankle: thigh, knee, calf and ankle. */
@@ -33,6 +47,8 @@ export interface OrganicBodyOptions {
33
47
  /** Resolved, owned JSON data. Profiles are copied once when making a character. */
34
48
  export interface OrganicBody {
35
49
  torso: BodyProfilePoint[];
50
+ torsoFront: BodyProfilePoint[];
51
+ torsoBack: BodyProfilePoint[];
36
52
  arm: BodyProfilePoint[];
37
53
  leg: BodyProfilePoint[];
38
54
  neck: BodyProfilePoint[];
@@ -5,6 +5,7 @@ import type { FrameInfo } from '../headless/video-scene';
5
5
  import type { BodyPlan, Pose, Vec3 } from './rig/body-plan';
6
6
  import { type SolvedHead, type ViewProjection } from './rig/skeleton';
7
7
  import { type Look, type Pen, type PencilOptions } from './look/pen';
8
+ import { type IllustratedOptions, type ResolvedIllustration } from './look/illustrated-pen';
8
9
  import { type OrganicBody, type OrganicBodyOptions } from './body/organic-body';
9
10
  import { type OrganicBodyContours } from './body/organic-geometry';
10
11
  import { type FaceOptions } from './head/face';
@@ -63,6 +64,8 @@ export interface CharacterOptions extends HeadLookOptions {
63
64
  /** Opt-in organic contours, skin material and independent outline settings. */
64
65
  body?: OrganicBodyOptions;
65
66
  look?: Look;
67
+ /** The `illustrated` look's ink weight, taper, shadow and highlight (light defaults to the body's skin light) */
68
+ illustrated?: IllustratedOptions;
66
69
  /** Feet to top of head, px (default 300) */
67
70
  height?: number;
68
71
  /** `bold` (default): head 30% of the height, line 4.5%. `thin`: head 24%, line 2.2%, as the reference sheets */
@@ -111,6 +114,7 @@ export interface Character {
111
114
  figure: FigureStyle;
112
115
  body?: OrganicBody;
113
116
  look: Look;
117
+ illustrated: ResolvedIllustration;
114
118
  height: number;
115
119
  lineWidth: number;
116
120
  ink: string;
@@ -31,6 +31,7 @@ export { leafOutfit, leafOutfitContours, type LeafOutfitOptions, type LeafOutfit
31
31
  export { softCartoonCharacter, SOFT_CARTOON_CAST, type SoftCartoonName } from './soft-cartoon-cast';
32
32
  export { resolveOrganicBody, bodyProfileWidth, type OrganicBody, type OrganicBodyOptions, type BodyProfilePoint, type SkinShading } from './body/organic-body';
33
33
  export { organicBodyContours, organicCenterLine, type OrganicBodyContours, type OrganicContour, type OrganicSample } from './body/organic-geometry';
34
+ export { BODY_SHAPES, bodyShapeProfiles, measuredHipWidth, resolveMeasurements, type BodyMeasurements, type BodyShapeName, type BodyShapeProfiles } from './body/body-shape';
34
35
  export { humanPlan, humanPose, mirrorHumanPose, humanFieldLabel, HUMAN_REST, HUMAN_POSES, HUMAN_EXPRESSIONS, HUMAN_BUILDS, FOOT_SHAPES, type FootShape, type HumanBuild, type HumanBuildName, type HumanPoseName, type HumanExpressionName } from './species/human';
35
36
  export { CHARACTER_CAST, ANIME_CAST, MANGA_CAST, castMember, type CastMember, type CastName, type AnimeCastName, type MangaCastName } from './cast';
36
37
  export type { FaceOptions, PupilCircle } from './head/face';
@@ -38,6 +39,8 @@ export { meetHands, meetingSpacing, HAND_MEETINGS, embrace, embraceSpacing, EMBR
38
39
  export * from './species/human-motion';
39
40
  export type { BodyPlan, ChainSpec, BoneSpec, BoneAngles, ContactSpec, HeadSpec, Pose as CharacterPose, Vec3 } from './rig/body-plan';
40
41
  export { createPen, ellipsePoints, type Pen, type Look, type PencilOptions, type PenOptions } from './look/pen';
42
+ export { resolveIllustration, type IllustratedOptions, type ResolvedIllustration } from './look/illustrated-pen';
43
+ export { illustrationTones, type IllustrationTones } from './look/illustration-color';
41
44
  export { basicOutfit, type BasicOutfitOptions } from './wardrobe/basic-outfit';
42
45
  export { outfitPreset, OUTFIT_PRESETS, type OutfitCategory } from './wardrobe/outfit-preset';
43
46
  export * from './head';
@@ -0,0 +1,36 @@
1
+ import { type Pen } from './pen';
2
+ /**
3
+ * The `illustrated` look: a clean pen drawn the way an illustrator inks and
4
+ * paints, from the same shapes every other look draws.
5
+ *
6
+ * - Ink has weight: an outline thickens on the side turned from the light and
7
+ * thins on the lit side, and open strokes (brows, mouths, folds, strands)
8
+ * taper at their ends like a brush.
9
+ * - Filled shapes are painted with form: a soft shadow band and a narrower
10
+ * core shadow on the side away from the light, and a highlight on the lit
11
+ * side, in tones mixed from the fill itself (see illustrationTones).
12
+ *
13
+ * Deterministic: everything follows from the points, the fill and the light.
14
+ */
15
+ export interface IllustratedOptions {
16
+ /** Toward the light, screen space (default [-0.8, -0.6]: from the upper left) */
17
+ light?: [number, number];
18
+ /** How much ink thickens on the shadow side and thins on the lit side, 0..1 (default 0.6) */
19
+ weight?: number;
20
+ /** How much open strokes taper toward their ends, 0..1 (default 0.7) */
21
+ taper?: number;
22
+ /** Strength of the shadow and core-shadow bands, 0..1 (default 1) */
23
+ shadow?: number;
24
+ /** Strength of the lit-side highlight, 0..1 (default 0.6) */
25
+ highlight?: number;
26
+ }
27
+ export interface ResolvedIllustration {
28
+ light: [number, number];
29
+ weight: number;
30
+ taper: number;
31
+ shadow: number;
32
+ highlight: number;
33
+ }
34
+ /** Every option filled in and checked; `light` defaults to the given one (a body's skin light). */
35
+ export declare function resolveIllustration(options?: IllustratedOptions, light?: [number, number]): ResolvedIllustration;
36
+ export declare function createIllustratedPen(ctx: CanvasRenderingContext2D, ink: string, lineWidth: number, style: ResolvedIllustration): Pen;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Painted tones for one fill colour, as an illustrator mixes them: shadows
3
+ * are not the fill with black added but deeper, more saturated and shifted
4
+ * toward red-violet (warm skin shades into rose, not grey); highlights are
5
+ * lighter and shifted toward a warm yellow. Pure functions of the colour.
6
+ */
7
+ export interface IllustrationTones {
8
+ shadow: string;
9
+ core: string;
10
+ highlight: string;
11
+ }
12
+ /** The shadow, core-shadow and highlight tones for a fill; undefined for a fill that is not a colour. */
13
+ export declare function illustrationTones(fill: string): IllustrationTones | undefined;
@@ -1,4 +1,5 @@
1
1
  import { type Point } from '../../adapters/canvas/sketch';
2
+ import { type ResolvedIllustration } from './illustrated-pen';
2
3
  /**
3
4
  * The pen every part of a character is drawn with: its body, face, hair,
4
5
  * clothes and props. A look is a pen, so whatever draws through it (the
@@ -9,11 +10,14 @@ import { type Point } from '../../adapters/canvas/sketch';
9
10
  * few times a second, pressure that thins and thickens along each stroke,
10
11
  * faint construction guides, and the odd rubbed-out earlier attempt.
11
12
  * - `silhouette`: everything filled solid in the ink, for a readability check.
13
+ * - `illustrated`: inked and painted. Line weight follows the light, strokes
14
+ * taper like a brush, and fills get shadow, core shadow and highlight tones
15
+ * mixed from their own colour (see illustrated-pen.ts).
12
16
  *
13
17
  * Deterministic: the pencil's wobble and pressure are seeded by the seed, the
14
18
  * boil frame and the stroke's place in the drawing order, never Math.random.
15
19
  */
16
- export type Look = 'clean' | 'pencil' | 'silhouette';
20
+ export type Look = 'clean' | 'pencil' | 'silhouette' | 'illustrated';
17
21
  export interface PencilOptions {
18
22
  /** Largest wobble, px (default: 12% of the line width, at least 1) */
19
23
  roughness?: number;
@@ -33,10 +37,18 @@ export interface Pen {
33
37
  readonly ink: string;
34
38
  /** A stroke through `points` whose width runs from `from` to `to` px */
35
39
  limb(points: Point[], from: number, to: number): void;
36
- /** An even stroke */
37
- line(points: Point[], width: number): void;
38
- /** A closed shape: filled with `fill` (none when null) and outlined (not when `outline` is 0) */
39
- shape(points: Point[], fill: string | null, outline: number): void;
40
+ /**
41
+ * An even stroke. `outside` says which side of it is the outside of a
42
+ * shape (+1 the right of the direction of travel, −1 the left), for looks
43
+ * whose ink weight follows the light; others ignore it.
44
+ */
45
+ line(points: Point[], width: number, outside?: 1 | -1): void;
46
+ /**
47
+ * A closed shape: filled with `fill` (none when null) and outlined (not when
48
+ * `outline` is 0). `flat` keeps a look that paints form into fills from
49
+ * painting this one (an eye, a mouth: features with their own shading).
50
+ */
51
+ shape(points: Point[], fill: string | null, outline: number, flat?: boolean): void;
40
52
  /** An ellipse: filled with `fill` (none when null) and outlined */
41
53
  ellipse(cx: number, cy: number, rx: number, ry: number, angle: number, fill: string | null, outline: number): void;
42
54
  /** A filled dot in the ink */
@@ -53,6 +65,7 @@ export interface PenOptions {
53
65
  seed: number;
54
66
  time: number;
55
67
  pencil?: PencilOptions;
68
+ illustrated?: ResolvedIllustration;
56
69
  }
57
70
  /** Points around an ellipse, from `start` radians, `turns` of a full turn. */
58
71
  export declare function ellipsePoints(cx: number, cy: number, rx: number, ry: number, angle: number, start?: number, turns?: number, samples?: number): Point[];
@@ -44,6 +44,13 @@ export declare const SOFT_CARTOON_CAST: {
44
44
  at: number;
45
45
  width: number;
46
46
  }[];
47
+ measurements: {
48
+ height: number;
49
+ bust: number;
50
+ underbust: number;
51
+ waist: number;
52
+ hip: number;
53
+ };
47
54
  };
48
55
  hair: {
49
56
  style: "flowingBob";
package/llms-full.txt CHANGED
@@ -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.113.0/cdn/tinyfly.iife.js"></script>
594
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.115.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.113.0/cdn/tinyfly.iife.js"></script>
802
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.115.0/cdn/tinyfly.iife.js"></script>
803
803
  <script>
804
804
  tinyfly.to('.box', { x: 200, duration: 1 })
805
805
  </script>
@@ -2714,7 +2714,7 @@ For simple website embedding without a build system.
2714
2714
  </html>
2715
2715
  ```
2716
2716
 
2717
- 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.113.0/cdn/tinyfly-player.iife.js`.
2717
+ 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.115.0/cdn/tinyfly-player.iife.js`.
2718
2718
 
2719
2719
  ---
2720
2720
 
@@ -7067,7 +7067,7 @@ The dialog shows the generated HTML/JavaScript code with a **Copy Code** button.
7067
7067
  **Steps to embed:**
7068
7068
  1. Build the player: `npm run build:player`
7069
7069
  2. Copy `lib/player/tinyfly-player.iife.js` to your project (or load
7070
- `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.113.0/cdn/tinyfly-player.iife.js`
7070
+ `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.115.0/cdn/tinyfly-player.iife.js`
7071
7071
  instead; see [Deployment](DEPLOYMENT.md))
7072
7072
  3. Copy the generated code into your HTML
7073
7073
  4. Adjust the script `src` path if needed
@@ -8386,7 +8386,12 @@ lets hair occlude them, with a flatter profile facial plane and a nose above
8386
8386
  the mouth; classic `cartoon` projection remains available. Foreground organic
8387
8387
  arms/hands draw together over lower garments, preserving the wrist at the waist.
8388
8388
  `body` owns JSON half-width profiles (`torso`, `arm`, `leg`, `neck`): increasing
8389
- arrays of `{ at: 0..1, width: fractionOfHeight }` spanning 0 to 1. Set `skin`
8389
+ arrays of `{ at: 0..1, width: fractionOfHeight }` spanning 0 to 1. For a body
8390
+ in proportion, prefer `body.measurements`: a shape name (`hourglass`, `pear`,
8391
+ `rectangle`, `invertedTriangle`, `round`) or girths `{ height, bust, underbust?,
8392
+ waist, hip }` in one unit. It sets the front width, the side depth (bust forward,
8393
+ seat back) and the leg spacing, so the figure reads correctly at every `turn`.
8394
+ Don't hand-tune `torso` to fake a side view; `torsoFront`/`torsoBack` set depth. Set `skin`
8390
8395
  once for exposed body, head and hands; `body.fill` overrides it.
8391
8396
  Use `body.fill: 'none'` for outline-only exposed skin, including both hand
8392
8397
  variants in every look. In 3D, only foreground arms use garment depths for
@@ -8432,6 +8437,8 @@ from. The eight presets in `ANIME_CAST` (`animeBoy`, `animeGirl`,
8432
8437
  Use `face: { style: 'anime', iris: '#4b7fce', lashes: true, ageLines: 0.6 }`
8433
8438
  for coloured expressive eyes and optional creases; this is a face style,
8434
8439
  not a `look` value. It uses the same expressions, blink, gaze and turn fields.
8440
+ The `look` values are `clean`, `pencil`, `silhouette` and `illustrated`
8441
+ (inked and painted, tuned with `illustrated: { light, weight, taper, shadow, highlight }`).
8435
8442
  Age is proportions, hair, creases and clothes, never a stoop; a `cane` in a hand or
8436
8443
  a `wheelchair()` to ride (`RIDING_POSES.wheeling`) is an accessory any
8437
8444
  character can have. Expressions come from `HUMAN_EXPRESSIONS`
@@ -8656,7 +8663,7 @@ path for all of that:
8656
8663
  </figure>
8657
8664
 
8658
8665
  <!-- once, anywhere on the page (a site-wide footer is fine) -->
8659
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.113.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
8666
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.115.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
8660
8667
  ```
8661
8668
 
8662
8669
  Every `[data-tinyfly-embed]` mounts when the page is ready, with no per-post
@@ -9928,8 +9935,8 @@ On a page with no build step, load the maps add-on after the browser bundle; it
9928
9935
  adds to the same `tinyfly` global:
9929
9936
 
9930
9937
  ```html
9931
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.113.0/cdn/tinyfly.iife.js"></script>
9932
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.113.0/cdn/tinyfly-maps.iife.js"></script>
9938
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.115.0/cdn/tinyfly.iife.js"></script>
9939
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.115.0/cdn/tinyfly-maps.iife.js"></script>
9933
9940
  ```
9934
9941
 
9935
9942
  It is a separate script because the offline world map it carries adds about
@@ -10211,6 +10218,32 @@ height. Torso positions run hip to neck, arms shoulder to wrist, and legs
10211
10218
  hip to ankle. Cubic centerlines pass through native elbow/knee joints with
10212
10219
  interpolated width profiles. Options are copied at construction and can
10213
10220
  travel as JSON. `body.depth` (0.2–1, default 0.55) sets torso side thickness.
10221
+ `body.torsoFront` and `body.torsoBack` (same format) set the torso's side
10222
+ view directly: its depth from the spine line toward the chest and belly, and
10223
+ toward the back and seat. They default to `torso × depth` each way.
10224
+
10225
+ ### Body shape and measurements
10226
+
10227
+ `body.measurements` describes the torso the way a size chart does, so women,
10228
+ men and children of every build can be drawn in proportion:
10229
+
10230
+ ```ts
10231
+ character({ figure: 'organic', body: { measurements: 'hourglass' } })
10232
+ character({ figure: 'organic', body: { measurements: { height: 165, bust: 94, underbust: 76, waist: 70, hip: 98 } } })
10233
+ ```
10234
+
10235
+ The girths can be in any unit, as long as `height` uses the same one. `underbust`
10236
+ defaults to 0.86 × `bust`, and the difference between the two is how far the bust
10237
+ projects. Named shapes (`BODY_SHAPES`) are `hourglass`, `pear`, `rectangle`,
10238
+ `invertedTriangle` and `round`. Measurements set the front width, the side depth
10239
+ (the bust forward, the seat back, and a belly when the waist is close to the hips)
10240
+ and the hip and thigh spacing. Because each torso section is projected from both
10241
+ its width and its depth, the shape reads correctly at every `turn`, not only from
10242
+ the front. Clothing follows the same contour. Any explicit `torso`, `torsoFront`,
10243
+ `torsoBack` or `hipWidth` still wins. `softCartoonCharacter` drops its preset torso
10244
+ when you pass new measurements. The shapes are kept as stylised silhouettes, in
10245
+ proportion with the rest of the cast. In the editor, organic characters have a
10246
+ **Body shape** picker.
10214
10247
  `body.fill` overrides `skin` for all exposed body, face and palms; omit it
10215
10248
  to keep one `skin` colour control. The editor's Skin and Line controls show
10216
10249
  the resolved fill and outline colour; editing them also updates any existing
@@ -10243,6 +10276,31 @@ accepts `mode: 'cel' | 'none'`, screen-space `light: [x, y]`, `shadow`,
10243
10276
  Pencil and silhouette use their existing pens. Artist-authored painted
10244
10277
  meshes remain a separate future capability.
10245
10278
 
10279
+ ### The illustrated look
10280
+
10281
+ `look: 'illustrated'` inks and paints the same shapes the clean look draws:
10282
+
10283
+ - Outlines are heavier on the side turned away from the light and thinner on
10284
+ the lit side; open strokes (brows, mouth lines, folds, hair strands) taper
10285
+ at their ends like a brush.
10286
+ - Skin, clothes and hair are painted with a soft shadow, a narrower core
10287
+ shadow and a highlight, mixed from each fill's own colour: shadows lean
10288
+ toward red-violet, highlights toward warm yellow, greys shade cool
10289
+ (`illustrationTones(colour)` returns the three tones).
10290
+ - Faces get heavier arched brows, a lid shadow and crease, an iris glow, a
10291
+ soft lower lip and cheek warmth.
10292
+
10293
+ ```ts
10294
+ character({
10295
+ look: 'illustrated',
10296
+ illustrated: { light: [-0.8, -0.6], weight: 0.6, taper: 0.7, shadow: 1, highlight: 0.6 },
10297
+ })
10298
+ ```
10299
+
10300
+ Every option is optional. `light` points toward the light in screen space
10301
+ and defaults to the body's `shading.light`; the others run 0..1. Drawing is
10302
+ deterministic: the same character, pose and options give the same pixels.
10303
+
10246
10304
  Set `body.fill: 'none'` (or `skin: 'none'` without a body fill override) for
10247
10305
  outline-only exposed body, head and hands in every look. Dot and articulated
10248
10306
  hands omit skin fills and shading; clothing retains its own material.
@@ -10400,7 +10458,7 @@ Every style is the same few fields (`resolveHair(spec)` fills them all in):
10400
10458
  | `ties` | Ponytails, buns and braids: `{ kind: 'ponytail' \| 'bun' \| 'braid', at: 'top' \| 'high' \| 'low' \| 'left' \| 'right', length?, size? }` |
10401
10459
  | `locks` | Curved sections: `{ path, width, follow? }`; `width` is in head radii; `follow` scales their flex (default 1, 0 pins a lock) |
10402
10460
  | `fall` | Hanging mass: `{ taper, wave }`, narrowing toward the ends (0..1 head radii) and a soft uneven hem (nonnegative head radii) |
10403
- | `shine` | Soft highlight opacity on the locks, 0..1 (default 0); drawn in the clean look |
10461
+ | `shine` | Soft highlight opacity on the locks, 0..1 (default 0); drawn in the clean and illustrated looks |
10404
10462
  | `coversEars` | The hair hides the ears |
10405
10463
 
10406
10464
  A style stays a starting point: any style suits anyone.
@@ -10611,7 +10669,7 @@ coloured irises and highlights. `iris` sets their colour (default `#4b7fce`),
10611
10669
  `lashes` enables outer lashes (default true), and `ageLines` sets subtle eye
10612
10670
  and smile creases from 0 to 1 (default 0). `style: 'simple'` is the original
10613
10671
  face and remains the default. Face style is separate from the pen's `look`
10614
- (`clean`, `pencil`, or `silhouette`); `look: 'anime'` is not a pen style.
10672
+ (`clean`, `pencil`, `silhouette` or `illustrated`); `look: 'anime'` is not a pen style.
10615
10673
 
10616
10674
  The existing `eye.left`, `eye.right`, `blink`, `lookX`, `lookY`, `pupil`, `lid`,
10617
10675
  `bulge`, brows and mouth fields animate both styles. The coloured eye opening
@@ -15107,7 +15165,7 @@ magnet.addEventListener('pointerleave', () => {
15107
15165
 
15108
15166
  <!-- capabilities: generated from the library -->
15109
15167
 
15110
- # tinyfly capabilities (v0.113.0)
15168
+ # tinyfly capabilities (v0.115.0)
15111
15169
 
15112
15170
  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).
15113
15171
 
@@ -15392,7 +15450,10 @@ Appearance options of `character({ … })`, all plain data that turns with the h
15392
15450
 
15393
15451
  - `build`: `standard`, `slim`, `tall`, `short`, `broad`, `curvy`, `stocky`, `kid`, `child`, `toddler`
15394
15452
  - `figure`: `fluid`, `stick`, `organic`
15453
+ - `look`: `clean` (default), `pencil`, `silhouette`, `illustrated` (inked and painted: line weight follows the light, brush-tapered strokes, shadow/core/highlight tones from each fill; `illustrated: { light: [x, y], weight, taper, shadow, highlight }`, each 0–1)
15395
15454
  - `body.torso · body.arm · body.leg · body.neck`: Organic half-width profiles: [{ at: 0..1, width: fractionOfHeight }], increasing from 0 to 1; independent of ink width.
15455
+ - `body.measurements`: Organic torso from tape-measure girths { height, bust, underbust?, waist, hip } in any one unit, or a named shape (hourglass | pear | rectangle | invertedTriangle | round). Sets the front width, the side depth (bust forward, seat back, belly) and the hip and thigh spacing; reads correctly at every turn. An explicit torso / torsoFront / torsoBack / hipWidth still wins.
15456
+ - `body.torsoFront · body.torsoBack`: Organic side-view depth from the spine line toward the chest/belly and toward the back/seat, same profile format; default torso × depth.
15396
15457
  - `body.fill · body.outline · body.shading`: Shared skin fill, outline { color, width }, cel material { mode: cel | none, light: [x,y], shadow, opacity, highlight }.
15397
15458
  - `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.
15398
15459
  - `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.
package/llms.txt CHANGED
@@ -13,48 +13,48 @@ 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.113.0/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.115.0/llms-full.txt)
17
17
 
18
18
  ## Start here
19
19
 
20
- - [Getting Started](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.113.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.113.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.113.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.
20
+ - [Getting Started](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.115.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.115.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.115.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.113.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.113.0/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.115.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.115.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.113.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.113.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.113.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.113.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.113.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.113.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.113.0/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.115.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.115.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.115.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.115.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.115.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.115.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.115.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.113.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.113.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.113.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.113.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
- - [Rendering Video from Code](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.
47
- - [Animated Maps](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.
48
- - [Cartoon Hands](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.
49
- - [Character Appearance](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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).
50
- - [Cartoon Acting](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.
51
- - [Dance and Flips](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.
52
- - [3D Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.
53
- - [3D Transforms and Rotations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.
54
- - [Extending tinyfly](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.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.
55
- - [Deployment](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.0/docs/DEPLOYMENT.md): Building and hosting the editor, and serving the player bundles.
42
+ - [Cricket Stories](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.115.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.115.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.115.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
+ - [Rendering Video from Code](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.
47
+ - [Animated Maps](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.
48
+ - [Cartoon Hands](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.
49
+ - [Character Appearance](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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).
50
+ - [Cartoon Acting](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.
51
+ - [Dance and Flips](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.
52
+ - [3D Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.
53
+ - [3D Transforms and Rotations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.
54
+ - [Extending tinyfly](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.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.
55
+ - [Deployment](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.0/docs/DEPLOYMENT.md): Building and hosting the editor, and serving the player bundles.
56
56
 
57
57
  ## Optional
58
58
 
59
- - [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.0/README.md): Feature overview, project layout and development setup.
60
- - [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.113.0/release-notes/README.md): What changed in each version.
59
+ - [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.0/README.md): Feature overview, project layout and development setup.
60
+ - [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.115.0/release-notes/README.md): What changed in each version.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@algorisys/tinyfly",
3
- "version": "0.113.0",
3
+ "version": "0.115.0",
4
4
  "type": "module",
5
5
  "description": "Lightweight, API-driven animation engine and editor. The engine is framework-agnostic and runs in browsers, Web Workers, and Node.",
6
6
  "license": "MIT",
@@ -34,7 +34,9 @@ names.
34
34
  - Colour anime characters: use `castMember('animeYoungWoman', height)` or any
35
35
  of the eight age presets in `ANIME_CAST`. For a custom character use
36
36
  `face: { style: 'anime', iris: '#4b7fce', lashes: true, ageLines: 0.6 }`.
37
- Keep `look` as `clean`, `pencil` or `silhouette`; anime is a face style.
37
+ Keep `look` as `clean`, `pencil`, `silhouette` or `illustrated` (inked and
38
+ painted: light-weighted lines, shadow and highlight tones, tuned with
39
+ `illustrated: { light, weight, taper, shadow, highlight }`); anime is a face style.
38
40
  The same `HUMAN_EXPRESSIONS`, blink, gaze, turn, acting and dance fields apply.
39
41
 
40
42
  - Prefer the high-level builders: `scriptTracks()` beats for characters
@@ -134,7 +136,11 @@ names.
134
136
  profile face and a nose projecting from above the mouth;
135
137
  `face.projection: 'cartoon'` keeps the classic face slide. Optional JSON
136
138
  `body` profiles (`torso`, `arm`, `leg`, `neck`) use increasing `{ at, width }`
137
- from 0 to 1, with half-width fractions of height. Use `skin` for the whole exposed character;
139
+ from 0 to 1, with half-width fractions of height. For realistic proportions
140
+ use `body.measurements`: `'hourglass' | 'pear' | 'rectangle' |
141
+ 'invertedTriangle' | 'round'` or `{ height, bust, underbust?, waist, hip }`
142
+ in any one unit. It shapes width and side depth (bust/seat/belly) at every turn,
143
+ and `torsoFront`/`torsoBack` override the depth. Use `skin` for the whole exposed character;
138
144
  `body.fill` overrides it; `'none'` makes exposed body/head/hands outline-only
139
145
  in every look. Organic 3D painter ordering promotes only foreground arms to
140
146
  torso/leg garment depths, leaving other parts at physical depths.