@algorisys/tinyfly 0.93.0 → 0.94.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.
@@ -1,4 +1,5 @@
1
1
  import type { Beat } from './script';
2
+ import type { Cast } from './custom';
2
3
  /**
3
4
  * Checking beat scripts before they are compiled. Beats are often written by
4
5
  * hand or by a language model, and a wrong name must not fail quietly (an
@@ -34,6 +35,10 @@ export declare const SCRIPT_ACTIONS: {
34
35
  stand: {
35
36
  summary: string;
36
37
  };
38
+ go: {
39
+ summary: string;
40
+ needs: "to"[];
41
+ };
37
42
  zip: {
38
43
  summary: string;
39
44
  needs: "to"[];
@@ -72,10 +77,12 @@ export declare const SCRIPT_ACTIONS: {
72
77
  };
73
78
  };
74
79
  export type ScriptActionName = keyof typeof SCRIPT_ACTIONS;
75
- /** Every name `do` accepts: gaits, named poses, gags and the actions above. */
76
- export declare function actionNames(): string[];
80
+ /** Every name `do` accepts: gaits, named poses, gags, the actions above, and a cast's own actions and gaits. */
81
+ export declare function actionNames(cast?: Cast): string[];
82
+ /** Errors in a cast itself: a custom name may not reuse a built-in one (it would be ambiguous which runs). */
83
+ export declare function checkCast(cast?: Cast): string[];
77
84
  /** Every action `do` accepts, with a line each: what a stick figure can do. */
78
- export declare function scriptActionSummaries(): Record<string, string>;
85
+ export declare function scriptActionSummaries(cast?: Cast): Record<string, string>;
79
86
  /** Every field a beat can have. */
80
87
  export declare const BEAT_FIELDS: readonly ["do", "at", "for", "to", "toward", "mood", "say", "pose", "target", "onto"];
81
88
  export interface BeatProblem {
@@ -90,6 +97,6 @@ export interface BeatProblem {
90
97
  * that go backwards. Errors make `scriptTracks` throw; warnings are things
91
98
  * that compile but probably do not do what was meant.
92
99
  */
93
- export declare function checkBeats(beats: unknown): BeatProblem[];
100
+ export declare function checkBeats(beats: unknown, cast?: Cast): BeatProblem[];
94
101
  /** Throws one error listing every error in the beats (warnings are left to `checkBeats`). */
95
- export declare function assertBeats(beats: unknown): void;
102
+ export declare function assertBeats(beats: unknown, cast?: Cast, context?: string): void;
@@ -0,0 +1,66 @@
1
+ import type { Gait } from '../gaits';
2
+ import type { StickPose } from '../stick-figure';
3
+ import type { GagStep } from './gags';
4
+ import type { Beat } from './script';
5
+ /**
6
+ * Your own behaviours, as plain values passed where they are used: there is
7
+ * no global registry. An action is either built from other beats (a macro:
8
+ * `nervousPoint` is a tremble, then a point) or written as timed pose steps
9
+ * from the pose it starts on (like a gag: `facepalm`). A gait is data, like
10
+ * the built-in ones. Hand them to `scriptTracks` (and `checkBeats`, and the
11
+ * figure that draws them) as a cast, or bundle them in a `character()`.
12
+ *
13
+ * ```ts
14
+ * const facepalm = defineAction({
15
+ * summary: 'Drops its face into its hand.',
16
+ * steps: (from) => [
17
+ * { after: 250, pose: { rightShoulder: 150, rightElbow: 150, headTilt: from.headTilt - 12, bend: 12 } },
18
+ * { after: 900, pose: { headTilt: from.headTilt - 16 } },
19
+ * ],
20
+ * })
21
+ * const limp = defineGait({ swing: 14, knee: 10, arm: 10, elbow: 6, lean: 6, sway: 6, cycle: 1400 })
22
+ * scriptTracks('hero', [{ do: 'limp', to: 400 }, { do: 'facepalm' }], { actions: { facepalm }, gaits: { limp } })
23
+ * ```
24
+ */
25
+ interface ActionBase {
26
+ /** One line: what the figure does (the catalog and `describeTarget` show it) */
27
+ summary: string;
28
+ /** Beat fields it needs (checked like the built-in actions') */
29
+ needs?: Array<keyof Beat>;
30
+ /** Beat fields it reads */
31
+ uses?: Array<keyof Beat>;
32
+ }
33
+ /** An action written as timed pose steps from the pose it starts on, like a gag. */
34
+ export interface StepsAction extends ActionBase {
35
+ steps: (from: StickPose, beat: Beat) => GagStep[];
36
+ }
37
+ /** An action built from other beats (which may be custom actions too). */
38
+ export interface BeatsAction extends ActionBase {
39
+ beats: (beat: Beat) => Beat[];
40
+ }
41
+ export type ActionDefinition = StepsAction | BeatsAction;
42
+ /** A gait, and how long one cycle (two steps) takes. */
43
+ export interface GaitDefinition extends Gait {
44
+ /** One cycle (two steps), ms (default 1000) */
45
+ cycle?: number;
46
+ /** One line about it */
47
+ summary?: string;
48
+ }
49
+ /** Your actions and gaits, by the names beats use. */
50
+ export interface Cast {
51
+ actions?: Record<string, ActionDefinition>;
52
+ gaits?: Record<string, GaitDefinition>;
53
+ }
54
+ /** An action, checked: it is either steps or beats, and says what it does. */
55
+ export declare function defineAction(definition: ActionDefinition): ActionDefinition;
56
+ /** A gait, checked: every swing is a number. */
57
+ export declare function defineGait(definition: GaitDefinition): GaitDefinition;
58
+ /**
59
+ * Beats with every action built from beats replaced by the beats it builds,
60
+ * all the way down. The first beat of an expansion keeps the original's `at`,
61
+ * and a `mood` or `say` on the original is given to the first beat that has none.
62
+ */
63
+ export declare function expandBeats(beats: Beat[], actions?: Record<string, ActionDefinition>, depth?: number): Beat[];
64
+ /** How long a steps action takes, ms. */
65
+ export declare function stepsDuration(steps: GagStep[]): number;
66
+ export {};
@@ -50,5 +50,15 @@ export interface GagOptions {
50
50
  }
51
51
  /** The keys of a gag, starting at `at` on the pose it starts from; splice them into a key list. */
52
52
  export declare function gag(name: GagName, options: GagOptions): PoseKey[];
53
+ /**
54
+ * Timed steps (a gag's, or a custom action's) as pose keys from `at`: each
55
+ * step changes the pose from the one before. The move onto the starting pose
56
+ * is acted like any other; the steps are taken as written (`act: false`).
57
+ */
58
+ export declare function stepsToKeys(steps: GagStep[], options: {
59
+ at: number;
60
+ from: StickPose;
61
+ speed?: number;
62
+ }): PoseKey[];
53
63
  /** How long a gag lasts at a speed, ms. */
54
64
  export declare function gagDuration(name: GagName, speed?: number): number;
@@ -1,5 +1,6 @@
1
1
  import type { Track } from '../../engine/types';
2
2
  import { type StickSide, type StickStyle } from '../stick-figure';
3
+ import type { Cast } from './custom';
3
4
  /**
4
5
  * Where a stick figure's hand is over a stretch of time, scene px, sampled
5
6
  * from its tracks: a path for something it carries to follow (a word it
@@ -17,6 +18,8 @@ export interface HandPathOptions {
17
18
  y: number;
18
19
  /** The style it is drawn with (its height and look move the hand) */
19
20
  style?: StickStyle;
21
+ /** Its cast, when it walks in a gait of its own */
22
+ cast?: Cast;
20
23
  /** From and to, ms */
21
24
  start: number;
22
25
  end: number;
@@ -12,3 +12,5 @@ export * from './lip-sync';
12
12
  export * from './script';
13
13
  export * from './hand-path';
14
14
  export * from './beat-check';
15
+ export * from './custom';
16
+ export * from './persona';
@@ -0,0 +1,93 @@
1
+ import { type ExpressionName, type PoseName, type StickFigureTarget, type StickPose, type StickStyle } from '../stick-figure';
2
+ import { type ActingOptions } from './acting';
3
+ import { type BeatProblem } from './beat-check';
4
+ import type { Cast } from './custom';
5
+ import { handPath, type HandPathOptions } from './hand-path';
6
+ import { type Beat, type ScriptResult } from './script';
7
+ import type { Track } from '../../engine/types';
8
+ /**
9
+ * A persona: one stick figure's look, acting and habits, in one value. Its
10
+ * figures look like it, its scripts act like it (its acting style, its gait
11
+ * for `go`, its usual face and stance, which `stand` returns to), and its own
12
+ * actions and gaits are known to its scripts, its checks and `describeTarget`.
13
+ *
14
+ * ```ts
15
+ * const junior = persona({
16
+ * name: 'Junior',
17
+ * summary: 'A nervous junior developer',
18
+ * look: { color: '#2563eb', rubber: 0.6 },
19
+ * acting: 'full', gait: 'sneak', mood: 'worried',
20
+ * actions: { facepalm },
21
+ * })
22
+ * const hero = junior.figure({ x: 600, y: 300 })
23
+ * const script = junior.script('hero', [{ do: 'go', to: 300 }, { do: 'facepalm' }, { do: 'stand' }], { from: 600, ground: 300 })
24
+ * ```
25
+ *
26
+ * Personas are plain values: make as many as the story needs, and put each
27
+ * one's figures in the scene under their own ids.
28
+ */
29
+ export interface PersonaOptions extends Cast {
30
+ name: string;
31
+ /** One line: who this is */
32
+ summary?: string;
33
+ /** Feet to top of head, px (default 120) */
34
+ height?: number;
35
+ /** How it looks (the stick figure's style, without its height) */
36
+ look?: Omit<StickStyle, 'height'>;
37
+ /** How it acts: an acting style (default snappy) */
38
+ acting?: ActingOptions['style'];
39
+ /** How it walks when told to `go` somewhere: a built-in gait or one of its own (default walk) */
40
+ gait?: string;
41
+ /** Its usual face */
42
+ mood?: ExpressionName;
43
+ /** How it stands at rest: a named pose or joints (default the rest pose); `stand` returns here */
44
+ stance?: PoseName | Partial<StickPose>;
45
+ /** How much it moves its mouth when it talks (lip-sync energy, default 1) */
46
+ energy?: number;
47
+ }
48
+ export interface Persona {
49
+ readonly name: string;
50
+ readonly summary: string;
51
+ /** Its own actions and gaits */
52
+ readonly cast: Cast;
53
+ /** Its resting pose, with its usual face */
54
+ readonly rest: StickPose;
55
+ readonly height: number;
56
+ /** A figure that looks like it, feet at x, y */
57
+ figure(at: {
58
+ x: number;
59
+ y: number;
60
+ facing?: 1 | -1;
61
+ }): StickFigureTarget;
62
+ /** Beats compiled the way it acts (`from` and `ground` are where its figure was placed) */
63
+ script(target: string, beats: Beat[], options?: {
64
+ from?: number;
65
+ ground?: number;
66
+ facing?: 1 | -1;
67
+ }): ScriptResult;
68
+ /** Problems in beats written for it (its own actions count as known) */
69
+ check(beats: unknown): BeatProblem[];
70
+ /** Where its hand is over time, for things it carries */
71
+ handPath(target: string, tracks: Track[], options: Omit<HandPathOptions, 'style' | 'cast'>): ReturnType<typeof handPath>;
72
+ /** Who it is and what it can do, as data */
73
+ describe(): PersonaDescription;
74
+ }
75
+ export interface PersonaDescription {
76
+ name: string;
77
+ summary: string;
78
+ habits: {
79
+ height: number;
80
+ acting: string;
81
+ gait: string;
82
+ mood?: string;
83
+ stance: string;
84
+ };
85
+ /** Every action its beats can use, built-in and its own, a line each */
86
+ actions: Record<string, string>;
87
+ /** Its own actions and gaits, by name */
88
+ own: {
89
+ actions: string[];
90
+ gaits: string[];
91
+ };
92
+ }
93
+ export declare function persona(options: PersonaOptions): Persona;
@@ -3,6 +3,7 @@ import { type ExpressionName, type PoseKey, type PoseName, type StickPose } from
3
3
  import { type GaitName } from '../gaits';
4
4
  import { type GagName } from './gags';
5
5
  import { type SpokenLine } from './lip-sync';
6
+ import { type Cast } from './custom';
6
7
  import type { ActingOptions } from './acting';
7
8
  /**
8
9
  * Beat scripts: a story written as what a character does, compiled into
@@ -46,7 +47,7 @@ import type { ActingOptions } from './acting';
46
47
  /** The ways to get somewhere. */
47
48
  export type GaitAction = GaitName;
48
49
  /** Everything a beat can do. */
49
- export type Action = GaitAction | PoseName | GagName | 'look' | 'say' | 'hold' | 'stand' | 'face' | 'zip' | 'leap' | 'swipe' | 'grab' | 'throw' | 'kick' | 'put' | 'write' | 'push';
50
+ export type Action = GaitAction | PoseName | GagName | 'look' | 'say' | 'hold' | 'stand' | 'face' | 'zip' | 'leap' | 'swipe' | 'grab' | 'throw' | 'kick' | 'put' | 'write' | 'push' | 'go';
50
51
  /** Something in the scene a beat acts on: a point, or a box (a `CodeBox` fits). */
51
52
  export interface BeatTarget {
52
53
  /** The centre, scene px */
@@ -57,8 +58,8 @@ export interface BeatTarget {
57
58
  right?: number;
58
59
  }
59
60
  export interface Beat {
60
- /** What happens */
61
- do: Action;
61
+ /** What happens: a built-in action, or one of the cast's own actions and gaits */
62
+ do: Action | (string & {});
62
63
  /** When it starts, ms (default: when the beat before ends) */
63
64
  at?: number;
64
65
  /** How long it takes, ms (default: the action's own length) */
@@ -85,7 +86,11 @@ export interface Beat {
85
86
  */
86
87
  onto?: number;
87
88
  }
88
- export interface ScriptOptions extends ActingOptions {
89
+ export interface ScriptOptions extends ActingOptions, Cast {
90
+ /** The gait `go` walks in (a built-in or one of `gaits`; default walk) */
91
+ gait?: string;
92
+ /** The stance `stand` returns to (default rest) */
93
+ rest?: StickPose;
89
94
  /** Scene x the figure was placed at (its `x` track is an offset from here; default 0) */
90
95
  from?: number;
91
96
  /** Scene y of its feet as placed (its `y` track is an offset from here; default 0) */
@@ -150,4 +155,4 @@ export declare function speechDuration(text: string): number;
150
155
  * beat has an unknown action, mood, joint or field, or misses a field its
151
156
  * action needs: the message names what was probably meant (see `checkBeats`).
152
157
  */
153
- export declare function scriptTracks(target: string, beats: Beat[], options?: ScriptOptions): ScriptResult;
158
+ export declare function scriptTracks(target: string, written: Beat[], options?: ScriptOptions): ScriptResult;
@@ -1,4 +1,5 @@
1
1
  import { type PropertyInfo } from '../adapters/canvas/target-properties';
2
+ import type { Cast } from './acting/custom';
2
3
  export interface Capabilities {
3
4
  version?: string;
4
5
  timing: string;
@@ -30,6 +31,15 @@ export interface Capabilities {
30
31
  handShapes: string[];
31
32
  mudras: string[];
32
33
  };
34
+ /** Making your own: actions, gaits and personas */
35
+ custom: {
36
+ api: Record<string, string>;
37
+ actions: Record<string, {
38
+ summary: string;
39
+ needs?: string[];
40
+ }>;
41
+ gaits: Record<string, string>;
42
+ };
33
43
  character: {
34
44
  poses: string[];
35
45
  expressions: string[];
@@ -45,6 +55,7 @@ export interface Capabilities {
45
55
  teach: Record<string, string>;
46
56
  cli: Record<string, string>;
47
57
  }
48
- export declare function capabilities(version?: string): Capabilities;
58
+ /** The catalog; pass a cast (or a persona's `cast`) to list its own actions and gaits too. */
59
+ export declare function capabilities(version?: string, cast?: Cast): Capabilities;
49
60
  /** The catalog as markdown, for people and language models. */
50
- export declare function capabilitiesMarkdown(version?: string): string;
61
+ export declare function capabilitiesMarkdown(version?: string, cast?: Cast): string;
@@ -5,7 +5,8 @@
5
5
  * The acting module registers the list here when it loads (the characters
6
6
  * entry always loads it), and the figure's `about.actions` reads it then.
7
7
  */
8
+ import type { Cast } from './acting/custom';
8
9
  /** Called once by the acting module. */
9
- export declare function provideFigureActions(list: () => Record<string, string>): void;
10
- /** The actions a stick figure can be given, with a line each (empty until the acting module has loaded). */
11
- export declare function figureActions(): Record<string, string>;
10
+ export declare function provideFigureActions(list: (cast?: Cast) => Record<string, string>): void;
11
+ /** The actions a stick figure can be given (with a cast's own), a line each (empty until the acting module has loaded). */
12
+ export declare function figureActions(cast?: Cast): Record<string, string>;
@@ -1,3 +1,4 @@
1
+ import type { Cast } from './acting/custom';
1
2
  import type { CustomTarget } from '../adapters/canvas';
2
3
  import type { FrameInfo } from '../headless/video-scene';
3
4
  import type { EasingType, Track } from '../engine/types';
@@ -411,9 +412,9 @@ export type Dancer = (beat: number) => DanceFrame;
411
412
  * cycle (by `walking`), a dance (by `dancing`) and the chatter of `talk`
412
413
  * folded in, and the dance's hand shapes.
413
414
  */
414
- export declare function resolveStickFrame(props: StickFigureProps, time: number, dance?: Dancer): DanceFrame;
415
+ export declare function resolveStickFrame(props: StickFigureProps, time: number, dance?: Dancer, gaits?: Cast['gaits']): DanceFrame;
415
416
  /** The pose of {@link resolveStickFrame}. */
416
- export declare function resolveStickPose(props: StickFigureProps, time: number, dance?: Dancer): StickPose;
417
+ export declare function resolveStickPose(props: StickFigureProps, time: number, dance?: Dancer, gaits?: Cast['gaits']): StickPose;
417
418
  /** Prop names for a hand's pose fields on a stick-figure target: `hand.left.index.curl`, … */
418
419
  export declare const handProp: (side: StickSide, field: string) => string;
419
420
  export interface StickFigureTargetOptions {
@@ -428,6 +429,8 @@ export interface StickFigureTargetOptions {
428
429
  * (see `dancer()` and `danceTracks()`). Its hand shapes show when the style has `hands`.
429
430
  */
430
431
  dance?: Dancer;
432
+ /** Your own actions and gaits (see `defineAction`, `defineGait`): it draws the gaits, and lists the actions in `about` */
433
+ cast?: Cast;
431
434
  }
432
435
  /** A `custom` target made by {@link stickFigureTarget}. */
433
436
  export interface StickFigureTarget extends CustomTarget {
@@ -435,6 +438,8 @@ export interface StickFigureTarget extends CustomTarget {
435
438
  readonly figureStyle: StickStyle;
436
439
  /** The dance it plays, if any */
437
440
  readonly figureDance?: Dancer;
441
+ /** Its cast's own gaits, if any */
442
+ readonly figureGaits?: Cast['gaits'];
438
443
  }
439
444
  /**
440
445
  * A `custom` canvas target that draws a stick figure. Its props are the pose
package/llms-full.txt CHANGED
@@ -204,7 +204,7 @@ with a GSAP-style call (durations are in seconds here):
204
204
  ```html
205
205
  <div class="box" style="width:60px;height:60px;background:#4a9eff"></div>
206
206
 
207
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.93.0/cdn/tinyfly.iife.js"></script>
207
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.94.0/cdn/tinyfly.iife.js"></script>
208
208
  <script>
209
209
  tinyfly.to('.box', { x: 200, duration: 1 })
210
210
  </script>
@@ -412,7 +412,7 @@ Without a build step, the all-in-one bundle exposes the same functions on a
412
412
  global — `tinyfly.to()`, `tinyfly.timeline()` and so on:
413
413
 
414
414
  ```html
415
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.93.0/cdn/tinyfly.iife.js"></script>
415
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.94.0/cdn/tinyfly.iife.js"></script>
416
416
  <script>
417
417
  tinyfly.to('.box', { x: 200, duration: 1 })
418
418
  </script>
@@ -2278,7 +2278,7 @@ For simple website embedding without a build system.
2278
2278
  </html>
2279
2279
  ```
2280
2280
 
2281
- 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.93.0/cdn/tinyfly-player.iife.js`.
2281
+ 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.94.0/cdn/tinyfly-player.iife.js`.
2282
2282
 
2283
2283
  ---
2284
2284
 
@@ -6464,7 +6464,7 @@ The dialog shows the generated HTML/JavaScript code with a **Copy Code** button.
6464
6464
  **Steps to embed:**
6465
6465
  1. Build the player: `npm run build:player`
6466
6466
  2. Copy `lib/player/tinyfly-player.iife.js` to your project (or load
6467
- `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.93.0/cdn/tinyfly-player.iife.js`
6467
+ `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.94.0/cdn/tinyfly-player.iife.js`
6468
6468
  instead; see [Deployment](DEPLOYMENT.md))
6469
6469
  3. Copy the generated code into your HTML
6470
6470
  4. Adjust the script `src` path if needed
@@ -7364,6 +7364,14 @@ It is also the last part of `llms-full.txt`.
7364
7364
  From code, the same catalog is `capabilities()` (and `capabilitiesMarkdown()`)
7365
7365
  in `@algorisys/tinyfly/characters`.
7366
7366
 
7367
+ ## Your own behaviours
7368
+
7369
+ Write new actions with `defineAction()` (from beats, or as timed pose steps),
7370
+ new gaits with `defineGait()`, and characters with `persona()`. Pass them where
7371
+ they are used; `persona.describe()` and `capabilities(version, cast)` list them,
7372
+ and the checks accept them. See "Your own actions, gaits and personas" in
7373
+ `docs/acting.md`.
7374
+
7367
7375
  ## 2. Ask a target what it can do
7368
7376
 
7369
7377
  ```js
@@ -7491,7 +7499,7 @@ path for all of that:
7491
7499
  </figure>
7492
7500
 
7493
7501
  <!-- once, anywhere on the page (a site-wide footer is fine) -->
7494
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.93.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
7502
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.94.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
7495
7503
  ```
7496
7504
 
7497
7505
  Every `[data-tinyfly-embed]` mounts when the page is ready, with no per-post
@@ -8566,8 +8574,8 @@ On a page with no build step, load the maps add-on after the browser bundle; it
8566
8574
  adds to the same `tinyfly` global:
8567
8575
 
8568
8576
  ```html
8569
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.93.0/cdn/tinyfly.iife.js"></script>
8570
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.93.0/cdn/tinyfly-maps.iife.js"></script>
8577
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.94.0/cdn/tinyfly.iife.js"></script>
8578
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.94.0/cdn/tinyfly-maps.iife.js"></script>
8571
8579
  ```
8572
8580
 
8573
8581
  It is a separate script because the offline world map it carries adds about
@@ -9027,6 +9035,69 @@ leaves, with a time, a scene x and y and a length, ready for `drawDustPuff`.
9027
9035
  Any beat can also take `onto` (a scene y): the figure is carried to that floor
9028
9036
  over the beat, as when the line it stands on moves up.
9029
9037
 
9038
+ ## Your own actions, gaits and personas
9039
+
9040
+ Behaviours of your own are plain values passed where they are used; nothing
9041
+ is registered globally.
9042
+
9043
+ **Actions** come in two kinds. Built from other beats (a macro):
9044
+
9045
+ ```js
9046
+ const nervousPoint = defineAction({
9047
+ summary: 'Trembles, then points at the target.',
9048
+ needs: ['target'],
9049
+ beats: (beat) => [{ do: 'tremble' }, { do: 'point', target: beat.target }],
9050
+ })
9051
+ ```
9052
+
9053
+ Or written as timed pose steps from the pose it starts on, like a gag:
9054
+
9055
+ ```js
9056
+ const facepalm = defineAction({
9057
+ summary: 'Drops its face into its hand.',
9058
+ steps: (from) => [
9059
+ { after: 220, pose: { rightShoulder: 150, rightElbow: 155, headTilt: from.headTilt - 10 }, easing: 'ease-out' },
9060
+ { after: 900, pose: { headTilt: from.headTilt - 16 } },
9061
+ ],
9062
+ })
9063
+ ```
9064
+
9065
+ **Gaits** are data, like the built-in ones: `defineGait({ swing, knee, arm,
9066
+ elbow, lean, cycle?, sway?, … })` (degrees; `cycle` is ms per two steps).
9067
+
9068
+ Pass them to `scriptTracks(id, beats, { actions, gaits })`, `checkBeats(beats,
9069
+ { actions, gaits })` and the figure that draws them
9070
+ (`stickFigureTarget({ …, cast: { actions, gaits } })`, which lists them in
9071
+ `describeTarget`). A custom name may not reuse a built-in one. A beats action's
9072
+ first beat keeps the original's `at`, and its `mood` and `say` go to the first
9073
+ beat that has none; the expanded beats are checked too.
9074
+
9075
+ **Personas** bundle a character: its look, acting style, gait, usual face,
9076
+ stance and own actions.
9077
+
9078
+ ```js
9079
+ const junior = persona({
9080
+ name: 'Junior', summary: 'A nervous junior developer',
9081
+ look: { color: '#89b4fa', rubber: 0.7 }, height: 92,
9082
+ acting: 'full', gait: 'sneak', mood: 'worried', stance: 'rest',
9083
+ actions: { facepalm },
9084
+ })
9085
+ const hero = junior.figure({ x: 600, y: 300, facing: -1 })
9086
+ const script = junior.script('hero', [
9087
+ { do: 'go', to: 300 }, // walks in its own gait
9088
+ { do: 'facepalm', say: 'Oh no.' },
9089
+ { do: 'stand' }, // back to its stance and usual face
9090
+ ], { from: 600, ground: 300, facing: -1 })
9091
+ junior.check(beats) // its own actions count as known
9092
+ junior.describe() // { name, summary, habits, actions, own }
9093
+ junior.handPath('hero', script.tracks, { x: 600, y: 300, start, end })
9094
+ ```
9095
+
9096
+ `go` is a built-in action: it walks in the persona's gait (in `walk` without
9097
+ one). Scripts are deterministic, so two personas can be timed against each
9098
+ other by reading one's `beats` before writing the other's (the **Code Review**
9099
+ example does).
9100
+
9030
9101
  ## Acting on code
9031
9102
 
9032
9103
  `codePanel()` makes a code listing a scene object. Its layout is plain
@@ -12301,7 +12372,7 @@ magnet.addEventListener('pointerleave', () => {
12301
12372
 
12302
12373
  <!-- capabilities: generated from the library -->
12303
12374
 
12304
- # tinyfly capabilities (v0.93.0)
12375
+ # tinyfly capabilities (v0.94.0)
12305
12376
 
12306
12377
  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).
12307
12378
 
@@ -12481,7 +12552,8 @@ With `style.hands`, each hand has `hand.left.<field>` / `hand.right.<field>` pro
12481
12552
  | `face` | | Turns the whole figure toward a scene x (turning round if needed), `viewer`, `ahead` or `back`. |
12482
12553
  | `say` | `say` | Lip-syncs the `say` line with small nods; the beat lasts as long as the line. |
12483
12554
  | `hold` | | Holds the pose (the acting pass drifts long holds). |
12484
- | `stand` | | Back to the rest pose, keeping the way it is turned. |
12555
+ | `stand` | | Back to its resting stance (a character’s own, else the rest pose), keeping the way it is turned. |
12556
+ | `go` | `to` | Walks to `to` in its own gait (a character’s, else walk). |
12485
12557
  | `zip` | `to` | The cartoon exit: winds up, wheels its legs in place, then shoots off to `to`, leaving dust. |
12486
12558
  | `leap` | | Crouches, springs, arcs and lands squashed at `to`, on the floor `onto` (a scene y). |
12487
12559
  | `swipe` | | Winds an arm up, then slides along the target with the arm out so the hand crosses it edge to edge. |
@@ -12500,6 +12572,17 @@ Beats that touch something report `contact` (and `release`) times in `result.bea
12500
12572
 
12501
12573
  **Hand shapes**: `relaxed`, `open`, `spread`, `flat`, `fist`, `point`, `thumbsUp`, `peace`, `ok`, `pinch`, `cupped`, `wave`, `pencilGrip`, `hold`. **Mudras**: `pataka`, `tripataka`, `alapadma`, `mushti`, `shikhara`, `hamsasya`, `katakamukha`.
12502
12574
 
12575
+ ### Your own actions, gaits and personas
12576
+
12577
+ Nothing is registered globally: pass your definitions where they are used.
12578
+
12579
+ - `defineAction({ summary, needs?, steps: (from, beat) => [{ after, pose, easing? }] })`: a new action written as timed pose steps from the current pose, like a gag
12580
+ - `defineAction({ summary, needs?, beats: (beat) => [beats] })`: a new action built from other beats (which may be custom too)
12581
+ - `defineGait({ swing, knee, arm, elbow, lean, cycle?, … })`: a new gait (the Gait fields in degrees; cycle is ms per two steps)
12582
+ - `scriptTracks(id, beats, { actions, gaits })`: beats may then use those names; checkBeats(beats, { actions, gaits }) knows them
12583
+ - `stickFigureTarget({ …, cast: { actions, gaits } })`: a figure that draws the gaits and lists the actions in describeTarget
12584
+ - `persona({ name, summary?, height?, look?, acting?, gait?, mood?, stance?, energy?, actions?, gaits? })`: a character’s look, acting style and habits: .figure({ x, y }), .script(id, beats, { from, ground }), .check(beats), .handPath(…), .describe(); `go` walks in its gait, `stand` returns to its stance and face
12585
+
12503
12586
  ## Character (v2 human)
12504
12587
 
12505
12588
  Poses: `rest`, `wave`, `cheer`, `point`, `handsOnHips`, `think`, `shrug`, `sit`, `kneel`, `crouch`, `crawl`, `lieDown`. Expressions: `neutral`, `happy`, `joyful`, `sad`, `crying`, `surprised`, `shocked`, `angry`, `furious`, `worried`, `scared`, `confused`, `skeptical`, `thinking`, `sleepy`, `disgusted`, `smug`, `wink`. Gags: `take`, `doubleTake`, `windUp`, `land`, `tremble`, `deflate`.
package/llms.txt CHANGED
@@ -13,45 +13,45 @@ 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.93.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.94.0/llms-full.txt)
17
17
 
18
18
  ## Start here
19
19
 
20
- - [Getting Started](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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.93.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.93.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.
23
- - [Building Animations with an LLM](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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.94.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.94.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.94.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.
23
+ - [Building Animations with an LLM](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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.93.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.93.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.94.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.94.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.93.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.93.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.93.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.93.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.93.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.93.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.93.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.94.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.94.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.94.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.94.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.94.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.94.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.94.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
- - [Scroll Animation](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.0/docs/scroll-animation.md): Scroll-driven and play-when-visible animation with ScrollDriver and VisibilityDriver.
43
- - [Teaching Animations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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.
44
- - [Rendering Video from Code](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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.
45
- - [Animated Maps](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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.
46
- - [Cartoon Hands](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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.
47
- - [Cartoon Acting](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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; 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.
48
- - [Dance and Flips](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.0/docs/dance.md): The stick figure dances disco, hip hop, breaking, jazz, K-pop, Bollywood, Bhangra, Bharatanatyam (with mudras), the Charleston, tap (with tap sounds) and popping (side glide, moonwalk), and does front, back, layout and scissor flips, cartwheels, handsprings, split leaps and full splits: wrists, ankles, turn-out, spin and rise as pose fields; moves keyed in beats; styles, grooves and routines as plain data.
49
- - [3D Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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 scenes, dancing, in their pen looks or as solid figures, seen by any camera.
50
- - [3D Transforms and Rotations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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.
51
- - [Extending tinyfly](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.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.
52
- - [Deployment](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.0/docs/DEPLOYMENT.md): Building and hosting the editor, and serving the player bundles.
42
+ - [Scroll Animation](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.0/docs/scroll-animation.md): Scroll-driven and play-when-visible animation with ScrollDriver and VisibilityDriver.
43
+ - [Teaching Animations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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.
44
+ - [Rendering Video from Code](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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.
45
+ - [Animated Maps](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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.
46
+ - [Cartoon Hands](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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.
47
+ - [Cartoon Acting](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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.
48
+ - [Dance and Flips](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.0/docs/dance.md): The stick figure dances disco, hip hop, breaking, jazz, K-pop, Bollywood, Bhangra, Bharatanatyam (with mudras), the Charleston, tap (with tap sounds) and popping (side glide, moonwalk), and does front, back, layout and scissor flips, cartwheels, handsprings, split leaps and full splits: wrists, ankles, turn-out, spin and rise as pose fields; moves keyed in beats; styles, grooves and routines as plain data.
49
+ - [3D Scenes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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 scenes, dancing, in their pen looks or as solid figures, seen by any camera.
50
+ - [3D Transforms and Rotations](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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.
51
+ - [Extending tinyfly](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.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.
52
+ - [Deployment](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.0/docs/DEPLOYMENT.md): Building and hosting the editor, and serving the player bundles.
53
53
 
54
54
  ## Optional
55
55
 
56
- - [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.0/README.md): Feature overview, project layout and development setup.
57
- - [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.93.0/release-notes/README.md): What changed in each version.
56
+ - [README](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.0/README.md): Feature overview, project layout and development setup.
57
+ - [Release notes](https://raw.githubusercontent.com/algorisys-oss/tinyfly/v0.94.0/release-notes/README.md): What changed in each version.