@algorisys/tinyfly 0.104.0 → 0.105.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 +10 -4
- package/docs/api-reference.md +19 -0
- package/docs/character-appearance.md +65 -1
- package/docs/editor-guide.md +5 -2
- package/docs/examples.md +11 -1
- package/docs/getting-started.md +1 -1
- package/docs/gsap-compat.md +1 -1
- package/docs/llm-guide.md +13 -0
- package/docs/maps.md +2 -2
- package/docs/teaching.md +1 -1
- package/lib/addons/characters.js +3055 -2907
- package/lib/browser/tinyfly.iife.js +13 -13
- package/lib/browser/tinyfly.js +4347 -4199
- package/lib/browser/tinyfly.umd.js +13 -13
- package/lib/types/characters/capabilities.d.ts +1 -0
- package/lib/types/characters/cast.d.ts +326 -2
- package/lib/types/characters/head/face.d.ts +10 -0
- package/lib/types/characters/head/hair.d.ts +45 -0
- package/lib/types/characters/head/head-shape.d.ts +7 -0
- package/lib/types/characters/head/index.d.ts +1 -1
- package/lib/types/characters/index.d.ts +1 -1
- package/lib/types/characters/stick-figure.d.ts +2 -0
- package/llms-full.txt +124 -12
- package/llms.txt +29 -29
- package/package.json +1 -1
- package/skills/tinyfly/SKILL.md +7 -0
|
@@ -13,8 +13,8 @@ import type { CharacterOptions } from './character';
|
|
|
13
13
|
export interface CastMember {
|
|
14
14
|
/** What to call them in a picker */
|
|
15
15
|
label: string;
|
|
16
|
-
/** A family, occupation,
|
|
17
|
-
group: 'family' | 'work' | 'anime';
|
|
16
|
+
/** A family, occupation, colour anime or young adult manga preset. */
|
|
17
|
+
group: 'family' | 'work' | 'anime' | 'manga';
|
|
18
18
|
/** Height next to an adult (1) */
|
|
19
19
|
scale: number;
|
|
20
20
|
/** Everything else about them */
|
|
@@ -289,7 +289,331 @@ export declare const ANIME_CAST: {
|
|
|
289
289
|
};
|
|
290
290
|
};
|
|
291
291
|
export type AnimeCastName = keyof typeof ANIME_CAST;
|
|
292
|
+
/** Original young adult manga archetypes; every feature remains plain editable character options. */
|
|
293
|
+
export declare const MANGA_CAST: {
|
|
294
|
+
mangaYoungMan: {
|
|
295
|
+
label: string;
|
|
296
|
+
group: "manga";
|
|
297
|
+
scale: number;
|
|
298
|
+
options: {
|
|
299
|
+
figure: "fluid";
|
|
300
|
+
look: "clean";
|
|
301
|
+
proportions: "thin";
|
|
302
|
+
build: "tall";
|
|
303
|
+
headSize: number;
|
|
304
|
+
lineWidth: number;
|
|
305
|
+
skin: string;
|
|
306
|
+
ink: string;
|
|
307
|
+
ears: true;
|
|
308
|
+
hands: "cartoon";
|
|
309
|
+
handStyle: "natural";
|
|
310
|
+
hair: {
|
|
311
|
+
style: "mangaSpikes";
|
|
312
|
+
color: string;
|
|
313
|
+
};
|
|
314
|
+
face: {
|
|
315
|
+
style: "anime";
|
|
316
|
+
shape: "angular";
|
|
317
|
+
jawWidth: number;
|
|
318
|
+
chinWidth: number;
|
|
319
|
+
eyeScale: number;
|
|
320
|
+
eyeAspect: number;
|
|
321
|
+
iris: string;
|
|
322
|
+
lashes: false;
|
|
323
|
+
nose: true;
|
|
324
|
+
};
|
|
325
|
+
outfit: {
|
|
326
|
+
shirt: string;
|
|
327
|
+
trousers: string;
|
|
328
|
+
sleeves: "long";
|
|
329
|
+
collar: true;
|
|
330
|
+
shoes: "boots";
|
|
331
|
+
};
|
|
332
|
+
};
|
|
333
|
+
};
|
|
334
|
+
mangaYoungWoman: {
|
|
335
|
+
label: string;
|
|
336
|
+
group: "manga";
|
|
337
|
+
scale: number;
|
|
338
|
+
options: {
|
|
339
|
+
figure: "fluid";
|
|
340
|
+
look: "clean";
|
|
341
|
+
proportions: "thin";
|
|
342
|
+
build: "slim";
|
|
343
|
+
headSize: number;
|
|
344
|
+
lineWidth: number;
|
|
345
|
+
skin: string;
|
|
346
|
+
ink: string;
|
|
347
|
+
ears: true;
|
|
348
|
+
hands: "cartoon";
|
|
349
|
+
handStyle: "natural";
|
|
350
|
+
hair: {
|
|
351
|
+
style: "mangaSweep";
|
|
352
|
+
color: string;
|
|
353
|
+
};
|
|
354
|
+
face: {
|
|
355
|
+
style: "anime";
|
|
356
|
+
shape: "angular";
|
|
357
|
+
jawWidth: number;
|
|
358
|
+
chinWidth: number;
|
|
359
|
+
eyeScale: number;
|
|
360
|
+
eyeAspect: number;
|
|
361
|
+
iris: string;
|
|
362
|
+
nose: true;
|
|
363
|
+
};
|
|
364
|
+
outfit: {
|
|
365
|
+
shirt: string;
|
|
366
|
+
trousers: string;
|
|
367
|
+
sleeves: "long";
|
|
368
|
+
shoes: "boots";
|
|
369
|
+
};
|
|
370
|
+
};
|
|
371
|
+
};
|
|
372
|
+
mangaRival: {
|
|
373
|
+
label: string;
|
|
374
|
+
group: "manga";
|
|
375
|
+
scale: number;
|
|
376
|
+
options: {
|
|
377
|
+
figure: "fluid";
|
|
378
|
+
look: "clean";
|
|
379
|
+
proportions: "thin";
|
|
380
|
+
build: "broad";
|
|
381
|
+
headSize: number;
|
|
382
|
+
lineWidth: number;
|
|
383
|
+
skin: string;
|
|
384
|
+
ink: string;
|
|
385
|
+
ears: true;
|
|
386
|
+
hands: "cartoon";
|
|
387
|
+
handStyle: "natural";
|
|
388
|
+
hair: {
|
|
389
|
+
style: "mangaSpikes";
|
|
390
|
+
color: string;
|
|
391
|
+
volume: number;
|
|
392
|
+
};
|
|
393
|
+
face: {
|
|
394
|
+
style: "anime";
|
|
395
|
+
shape: "angular";
|
|
396
|
+
jawWidth: number;
|
|
397
|
+
chinWidth: number;
|
|
398
|
+
eyeScale: number;
|
|
399
|
+
eyeAspect: number;
|
|
400
|
+
iris: string;
|
|
401
|
+
lashes: false;
|
|
402
|
+
nose: true;
|
|
403
|
+
};
|
|
404
|
+
outfit: {
|
|
405
|
+
shirt: string;
|
|
406
|
+
trousers: string;
|
|
407
|
+
sleeves: "long";
|
|
408
|
+
over: "hoodie";
|
|
409
|
+
shoes: "boots";
|
|
410
|
+
};
|
|
411
|
+
};
|
|
412
|
+
};
|
|
413
|
+
mangaHeroine: {
|
|
414
|
+
label: string;
|
|
415
|
+
group: "manga";
|
|
416
|
+
scale: number;
|
|
417
|
+
options: {
|
|
418
|
+
figure: "fluid";
|
|
419
|
+
look: "clean";
|
|
420
|
+
proportions: "thin";
|
|
421
|
+
build: "tall";
|
|
422
|
+
headSize: number;
|
|
423
|
+
lineWidth: number;
|
|
424
|
+
skin: string;
|
|
425
|
+
ink: string;
|
|
426
|
+
ears: true;
|
|
427
|
+
hands: "cartoon";
|
|
428
|
+
handStyle: "natural";
|
|
429
|
+
hair: {
|
|
430
|
+
style: "highPonytail";
|
|
431
|
+
color: string;
|
|
432
|
+
texture: "spiky";
|
|
433
|
+
textureAmount: number;
|
|
434
|
+
};
|
|
435
|
+
face: {
|
|
436
|
+
style: "anime";
|
|
437
|
+
shape: "angular";
|
|
438
|
+
jawWidth: number;
|
|
439
|
+
chinWidth: number;
|
|
440
|
+
eyeScale: number;
|
|
441
|
+
eyeAspect: number;
|
|
442
|
+
iris: string;
|
|
443
|
+
nose: true;
|
|
444
|
+
};
|
|
445
|
+
outfit: {
|
|
446
|
+
shirt: string;
|
|
447
|
+
trousers: string;
|
|
448
|
+
sleeves: "long";
|
|
449
|
+
collar: true;
|
|
450
|
+
shoes: "boots";
|
|
451
|
+
};
|
|
452
|
+
};
|
|
453
|
+
};
|
|
454
|
+
};
|
|
455
|
+
export type MangaCastName = keyof typeof MANGA_CAST;
|
|
292
456
|
export declare const CHARACTER_CAST: {
|
|
457
|
+
mangaYoungMan: {
|
|
458
|
+
label: string;
|
|
459
|
+
group: "manga";
|
|
460
|
+
scale: number;
|
|
461
|
+
options: {
|
|
462
|
+
figure: "fluid";
|
|
463
|
+
look: "clean";
|
|
464
|
+
proportions: "thin";
|
|
465
|
+
build: "tall";
|
|
466
|
+
headSize: number;
|
|
467
|
+
lineWidth: number;
|
|
468
|
+
skin: string;
|
|
469
|
+
ink: string;
|
|
470
|
+
ears: true;
|
|
471
|
+
hands: "cartoon";
|
|
472
|
+
handStyle: "natural";
|
|
473
|
+
hair: {
|
|
474
|
+
style: "mangaSpikes";
|
|
475
|
+
color: string;
|
|
476
|
+
};
|
|
477
|
+
face: {
|
|
478
|
+
style: "anime";
|
|
479
|
+
shape: "angular";
|
|
480
|
+
jawWidth: number;
|
|
481
|
+
chinWidth: number;
|
|
482
|
+
eyeScale: number;
|
|
483
|
+
eyeAspect: number;
|
|
484
|
+
iris: string;
|
|
485
|
+
lashes: false;
|
|
486
|
+
nose: true;
|
|
487
|
+
};
|
|
488
|
+
outfit: {
|
|
489
|
+
shirt: string;
|
|
490
|
+
trousers: string;
|
|
491
|
+
sleeves: "long";
|
|
492
|
+
collar: true;
|
|
493
|
+
shoes: "boots";
|
|
494
|
+
};
|
|
495
|
+
};
|
|
496
|
+
};
|
|
497
|
+
mangaYoungWoman: {
|
|
498
|
+
label: string;
|
|
499
|
+
group: "manga";
|
|
500
|
+
scale: number;
|
|
501
|
+
options: {
|
|
502
|
+
figure: "fluid";
|
|
503
|
+
look: "clean";
|
|
504
|
+
proportions: "thin";
|
|
505
|
+
build: "slim";
|
|
506
|
+
headSize: number;
|
|
507
|
+
lineWidth: number;
|
|
508
|
+
skin: string;
|
|
509
|
+
ink: string;
|
|
510
|
+
ears: true;
|
|
511
|
+
hands: "cartoon";
|
|
512
|
+
handStyle: "natural";
|
|
513
|
+
hair: {
|
|
514
|
+
style: "mangaSweep";
|
|
515
|
+
color: string;
|
|
516
|
+
};
|
|
517
|
+
face: {
|
|
518
|
+
style: "anime";
|
|
519
|
+
shape: "angular";
|
|
520
|
+
jawWidth: number;
|
|
521
|
+
chinWidth: number;
|
|
522
|
+
eyeScale: number;
|
|
523
|
+
eyeAspect: number;
|
|
524
|
+
iris: string;
|
|
525
|
+
nose: true;
|
|
526
|
+
};
|
|
527
|
+
outfit: {
|
|
528
|
+
shirt: string;
|
|
529
|
+
trousers: string;
|
|
530
|
+
sleeves: "long";
|
|
531
|
+
shoes: "boots";
|
|
532
|
+
};
|
|
533
|
+
};
|
|
534
|
+
};
|
|
535
|
+
mangaRival: {
|
|
536
|
+
label: string;
|
|
537
|
+
group: "manga";
|
|
538
|
+
scale: number;
|
|
539
|
+
options: {
|
|
540
|
+
figure: "fluid";
|
|
541
|
+
look: "clean";
|
|
542
|
+
proportions: "thin";
|
|
543
|
+
build: "broad";
|
|
544
|
+
headSize: number;
|
|
545
|
+
lineWidth: number;
|
|
546
|
+
skin: string;
|
|
547
|
+
ink: string;
|
|
548
|
+
ears: true;
|
|
549
|
+
hands: "cartoon";
|
|
550
|
+
handStyle: "natural";
|
|
551
|
+
hair: {
|
|
552
|
+
style: "mangaSpikes";
|
|
553
|
+
color: string;
|
|
554
|
+
volume: number;
|
|
555
|
+
};
|
|
556
|
+
face: {
|
|
557
|
+
style: "anime";
|
|
558
|
+
shape: "angular";
|
|
559
|
+
jawWidth: number;
|
|
560
|
+
chinWidth: number;
|
|
561
|
+
eyeScale: number;
|
|
562
|
+
eyeAspect: number;
|
|
563
|
+
iris: string;
|
|
564
|
+
lashes: false;
|
|
565
|
+
nose: true;
|
|
566
|
+
};
|
|
567
|
+
outfit: {
|
|
568
|
+
shirt: string;
|
|
569
|
+
trousers: string;
|
|
570
|
+
sleeves: "long";
|
|
571
|
+
over: "hoodie";
|
|
572
|
+
shoes: "boots";
|
|
573
|
+
};
|
|
574
|
+
};
|
|
575
|
+
};
|
|
576
|
+
mangaHeroine: {
|
|
577
|
+
label: string;
|
|
578
|
+
group: "manga";
|
|
579
|
+
scale: number;
|
|
580
|
+
options: {
|
|
581
|
+
figure: "fluid";
|
|
582
|
+
look: "clean";
|
|
583
|
+
proportions: "thin";
|
|
584
|
+
build: "tall";
|
|
585
|
+
headSize: number;
|
|
586
|
+
lineWidth: number;
|
|
587
|
+
skin: string;
|
|
588
|
+
ink: string;
|
|
589
|
+
ears: true;
|
|
590
|
+
hands: "cartoon";
|
|
591
|
+
handStyle: "natural";
|
|
592
|
+
hair: {
|
|
593
|
+
style: "highPonytail";
|
|
594
|
+
color: string;
|
|
595
|
+
texture: "spiky";
|
|
596
|
+
textureAmount: number;
|
|
597
|
+
};
|
|
598
|
+
face: {
|
|
599
|
+
style: "anime";
|
|
600
|
+
shape: "angular";
|
|
601
|
+
jawWidth: number;
|
|
602
|
+
chinWidth: number;
|
|
603
|
+
eyeScale: number;
|
|
604
|
+
eyeAspect: number;
|
|
605
|
+
iris: string;
|
|
606
|
+
nose: true;
|
|
607
|
+
};
|
|
608
|
+
outfit: {
|
|
609
|
+
shirt: string;
|
|
610
|
+
trousers: string;
|
|
611
|
+
sleeves: "long";
|
|
612
|
+
collar: true;
|
|
613
|
+
shoes: "boots";
|
|
614
|
+
};
|
|
615
|
+
};
|
|
616
|
+
};
|
|
293
617
|
animeBoy: {
|
|
294
618
|
label: string;
|
|
295
619
|
group: "anime";
|
|
@@ -27,6 +27,16 @@ export interface FaceOptions {
|
|
|
27
27
|
style?: 'simple' | 'anime';
|
|
28
28
|
/** Anime iris colour (default blue); plain data, including in scene JSON. */
|
|
29
29
|
iris?: string;
|
|
30
|
+
/** Head outline: round (default) or angular cheeks, jaw and chin. */
|
|
31
|
+
shape?: 'round' | 'angular';
|
|
32
|
+
/** Angular jaw half-width in head radii, 0.55..0.95 (default 0.74). */
|
|
33
|
+
jawWidth?: number;
|
|
34
|
+
/** Angular chin half-width in head radii, 0.03..0.35 (default 0.14). */
|
|
35
|
+
chinWidth?: number;
|
|
36
|
+
/** Anime eye size, 0.5..1.2 (default 1). */
|
|
37
|
+
eyeScale?: number;
|
|
38
|
+
/** Anime eye height relative to width, 0.45..1.2 (default 1). */
|
|
39
|
+
eyeAspect?: number;
|
|
30
40
|
/** Anime outer lashes (default true). */
|
|
31
41
|
lashes?: boolean;
|
|
32
42
|
/** Subtle eye and smile creases, 0..1 (default 0); independent of expression and posture. */
|
|
@@ -41,6 +41,16 @@ export declare function hairHangs(hair: Hair): boolean;
|
|
|
41
41
|
export type HairTexture = 'smooth' | 'spiky' | 'curly' | 'wavy' | 'locs';
|
|
42
42
|
/** Detail lines drawn on the hair: none, a parting, strands swept from a parting, combed back, hanging strands, a few thin strands */
|
|
43
43
|
export type HairStrands = 'none' | 'part' | 'sweep' | 'combed' | 'hanging' | 'thin';
|
|
44
|
+
/** A pointed 3D tuft anchored on the scalp. All dimensions are head radii. */
|
|
45
|
+
export interface HairSpike {
|
|
46
|
+
/** Degrees around the head from the face. */
|
|
47
|
+
around: number;
|
|
48
|
+
/** Height on the scalp, -1..1. */
|
|
49
|
+
up: number;
|
|
50
|
+
/** Length beyond the scalp and base radius. */
|
|
51
|
+
length: number;
|
|
52
|
+
width: number;
|
|
53
|
+
}
|
|
44
54
|
export interface HairTie {
|
|
45
55
|
kind: 'ponytail' | 'bun' | 'braid';
|
|
46
56
|
/** Where it is tied: on top, high at the back, low at the back, or over one ear (the character's left or right) */
|
|
@@ -83,6 +93,8 @@ export interface Hair {
|
|
|
83
93
|
/** `solid` filled hair; `stipple` close-cropped hair drawn as dots on the scalp */
|
|
84
94
|
fill: 'solid' | 'stipple';
|
|
85
95
|
ties: HairTie[];
|
|
96
|
+
/** Optional pointed tufts; their silhouette follows every head turn. */
|
|
97
|
+
spikes?: HairSpike[];
|
|
86
98
|
/** Hair falls over the ears, so the ears are hidden */
|
|
87
99
|
coversEars: boolean;
|
|
88
100
|
}
|
|
@@ -186,6 +198,39 @@ export declare const HAIR_STYLES: {
|
|
|
186
198
|
back: number;
|
|
187
199
|
};
|
|
188
200
|
};
|
|
201
|
+
mangaSpikes: {
|
|
202
|
+
volume: number;
|
|
203
|
+
texture: "spiky";
|
|
204
|
+
textureAmount: number;
|
|
205
|
+
hairline: {
|
|
206
|
+
front: number;
|
|
207
|
+
side: number;
|
|
208
|
+
back: number;
|
|
209
|
+
};
|
|
210
|
+
spikes: {
|
|
211
|
+
around: number;
|
|
212
|
+
up: number;
|
|
213
|
+
length: number;
|
|
214
|
+
width: number;
|
|
215
|
+
}[];
|
|
216
|
+
};
|
|
217
|
+
mangaSweep: {
|
|
218
|
+
volume: number;
|
|
219
|
+
texture: "spiky";
|
|
220
|
+
textureAmount: number;
|
|
221
|
+
sweep: number;
|
|
222
|
+
hairline: {
|
|
223
|
+
front: number;
|
|
224
|
+
side: number;
|
|
225
|
+
back: number;
|
|
226
|
+
};
|
|
227
|
+
spikes: {
|
|
228
|
+
around: number;
|
|
229
|
+
up: number;
|
|
230
|
+
length: number;
|
|
231
|
+
width: number;
|
|
232
|
+
}[];
|
|
233
|
+
};
|
|
189
234
|
undercut: {
|
|
190
235
|
volume: number;
|
|
191
236
|
quiff: number;
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { Point } from '../../adapters/canvas/sketch';
|
|
2
|
+
import { type SolvedHead } from '../rig/skeleton';
|
|
3
|
+
import type { FaceOptions } from './face';
|
|
4
|
+
/** Project a tapered 3D head, then take its silhouette: the jaw follows turn, nod and roll. */
|
|
5
|
+
export declare function angularHeadOutline(head: SolvedHead, face: FaceOptions): Point[];
|
|
6
|
+
/** Monotone chain. Dropping interior points preserves sharp jaw corners at any view. */
|
|
7
|
+
export declare function convexHull(points: Point[]): Point[];
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { HAIR_STYLES, HAIR_COLORS, HAIR_STILL, resolveHair, hairlineAt, hairHangs, hairMotionOf, type Hair, type HairMotion, type HairSpec, type HairStyleName, type HairTexture, type HairStrands, type HairTie } from './hair';
|
|
1
|
+
export { HAIR_STYLES, HAIR_COLORS, HAIR_STILL, resolveHair, hairlineAt, hairHangs, hairMotionOf, type Hair, type HairMotion, type HairSpec, type HairStyleName, type HairTexture, type HairStrands, type HairTie, type HairSpike } from './hair';
|
|
2
2
|
export { FACIAL_HAIR_STYLES, resolveFacialHair, type FacialHair, type FacialHairSpec, type FacialHairStyleName, type MoustacheStyle, type BeardStyle } from './facial-hair';
|
|
3
3
|
export { GLASSES_STYLES, resolveGlasses, type Glasses, type GlassesSpec, type GlassesStyle } from './glasses';
|
|
4
4
|
export { HAT_STYLES, resolveHat, type Hat, type HatSpec, type HatStyle } from './hats';
|
|
@@ -28,7 +28,7 @@ export * from '../adapters/canvas/polyline';
|
|
|
28
28
|
export * from './hand';
|
|
29
29
|
export * from './character';
|
|
30
30
|
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';
|
|
31
|
-
export { CHARACTER_CAST, ANIME_CAST, castMember, type CastMember, type CastName, type AnimeCastName } from './cast';
|
|
31
|
+
export { CHARACTER_CAST, ANIME_CAST, MANGA_CAST, castMember, type CastMember, type CastName, type AnimeCastName, type MangaCastName } from './cast';
|
|
32
32
|
export type { FaceOptions, PupilCircle } from './head/face';
|
|
33
33
|
export { meetHands, meetingSpacing, HAND_MEETINGS, embrace, embraceSpacing, EMBRACE, helpUp, helpUpSpacing, HELP_UP, type HandMeeting, type HandsMeet, type MeetingPartner, type MeetHandsOptions, type Embrace, type EmbraceOptions, type HelpUp, type HelpUpOptions } from './interactions';
|
|
34
34
|
export * from './species/human-motion';
|
|
@@ -190,6 +190,8 @@ export interface StickStyle {
|
|
|
190
190
|
* takes its room from the torso: the feet and hips stay where they are.
|
|
191
191
|
*/
|
|
192
192
|
headSize?: number;
|
|
193
|
+
/** Both upper arms and forearms, as a multiplier of the usual length (default 1). Hands keep their size. */
|
|
194
|
+
armLength?: number;
|
|
193
195
|
/** Head fill; `none` leaves it see-through (default white) */
|
|
194
196
|
headFill?: string;
|
|
195
197
|
/** 1 faces right, -1 faces left: mirrors the figure and turns the eyes */
|