fruta 0.0.3 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Jhornan Colina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,48 +1,389 @@
-# Fruta 🍒 - Game Framework
+# Fruta 🍒
 
-FrutaJs is a 2D game engine based on Canvas and WebGL that allows you to create animations, dynamic elements, and video games. Its main objective is to provide an easy-to-understand and dynamic syntax, which helps people to easily enter the world of development.
+[![npm version](https://img.shields.io/npm/v/fruta?color=cb3837&logo=npm)](https://www.npmjs.com/package/fruta)
+[![TypeScript](https://img.shields.io/badge/TypeScript-first-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![types included](https://img.shields.io/badge/types-included-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+![ESM only](https://img.shields.io/badge/module-ESM-f7df1e?logo=javascript&logoColor=black)
+![size](https://img.shields.io/badge/min-~74%20KB-brightgreen)
+![NPM License](https://img.shields.io/npm/l/fruta)
 
-The idea behind FrutaJs is to provide an additional layer on top of the existing functionalities of Canvas and WebGL, making it easier to use and allowing developers to focus on creating games and animations without having to deal with the technical complexity of these underlying technologies.
+**A tiny, semantic 2D graphics & game engine for the web.** One friendly object,
+intent-named calls, sensible defaults. The goal: easier to learn than Phaser or Pixi,
+while doing *real* games — sprites, tilemaps, **physics, pathfinding, collision, pooling**,
+camera, scenes, audio, particles, entities, charts, and WebGL shaders.
 
-# Install
+> **Written in TypeScript, types ship with the package** — every call, option and return value
+> is typed, so your editor autocompletes the whole API and catches mistakes before you run.
+> <picture><img alt="TypeScript" src="https://img.shields.io/badge/-3178C6?logo=typescript&logoColor=white" height="14"></picture>
 
-```npm
-npm i fruta
+```ts
+import Fruta from 'fruta'
+
+const fruta = Fruta({ width: 500, height: 500 }).mount()
+
+fruta.loop((dt, t) => {
+  fruta.background('#111')
+  fruta.circle({ x: fruta.mouse.x, y: fruta.mouse.y, r: 24, fill: 'tomato' })
+})
+```
+
+- **One object.** `const fruta = Fruta(...)` — everything hangs off it, fully typed.
+- **Semantic.** `fruta.circle({ x, y, r, fill })`, not `ctx.beginPath()…`.
+- **Immediate by default, retained when you want it** (`fruta.add(...)`).
+- **Two backends, one API.** Canvas2D for the richest features; `Fruta.gl(...)` (WebGL) for tens of thousands of sprites — same sugar.
+- **No build lock-in.** Bring your own `<canvas>` — works in React/Vue/Svelte or plain HTML.
+
+> See it all running: clone the repo and `bun run dev` for the demo playground (platformers,
+> a bullet-hell scale test, a Terraria-like chunked world, a Noita-like falling-sand sim, a
+> Factorio-like factory, a level editor, an animation editor, and more — see **What you can build**).
+> Recipes: [EXAMPLES.MD](EXAMPLES.MD) · Changes: [CHANGELOG.md](CHANGELOG.md).
+
+---
+
+## Install
+
+```bash
+npm i fruta      # or: bun add fruta
+```
+
+ESM-only, zero dependencies, tree-shakeable (`sideEffects: false`), types bundled.
+
+## Setup
+
+```ts
+const fruta = Fruta({ width, height, background?, clear?, mount?, canvas? })
+
+fruta.mount(parent?)   // append the canvas (defaults to <body>)
+fruta.canvas           // the HTMLCanvasElement
+fruta.context          // the raw CanvasRenderingContext2D (escape hatch)
+fruta.destroy()        // stop the loop + remove listeners (call on unmount)
 ```
 
-# Usage
+Pass `{ canvas: el }` (element or CSS selector) to use your own canvas — the clean path for
+frameworks. Omit it and Fruta makes one you `.mount()` yourself, or pass `{ mount: el }` to
+attach it on creation.
 
+If you set `background`, Fruta **repaints it at the start of every frame**, so your `loop`
+body is just the scene. For trails or manual fades, opt out with `{ clear: false }`.
+
+## The loop
+
+`loop(fn)` runs every frame. `dt` is seconds since the last frame (multiply movement by it
+and speed is identical on any screen); `t` is seconds since start.
+
+```ts
+let x = 0
+fruta.loop((dt, t) => {
+  fruta.background('#111')
+  x += 200 * dt            // 200 px/second
+  fruta.rect({ x, y: 100, w: 40, h: 40, fill: 'deepskyblue' })
+})
+fruta.stop()
+
+fruta.timeScale = 0.2     // global slow-mo / freeze (0 = frozen) — hit-stop, bullet-time, Bash
 ```
-import Fruta from "fruta"
 
-const config = {
-  scene: {
-    w: 500,
-    h: 500,
-    id: 'main',
-  },
-}
+## Drawing
+
+Every shape takes a typed options object with sensible defaults (no `fill`/`stroke` → black fill).
+
+```ts
+fruta.rect({ x, y, w, h, fill, stroke, strokeWidth, radius, rotation })  // rotation in degrees
+fruta.circle({ x, y, r, fill, stroke, strokeWidth })                     // x,y = center
+fruta.ellipse({ x, y, rx, ry, rotation, fill, stroke, strokeWidth })
+fruta.line({ x1, y1, x2, y2, stroke, strokeWidth })
+fruta.polygon({ points: [{ x, y }, …], fill, stroke, strokeWidth, close })
+fruta.text('hello', { x, y, fill, size, font, align, baseline, stroke, strokeWidth })
+fruta.image('/pic.png', { x, y, w, h })   // cached + async; call inside loop()
+fruta.background(color) · fruta.clear()
+```
+
+**Gradients** (usable anywhere a `fill`/`stroke` goes), and **transforms** (`push`/`pop`,
+nestable — translate, rotate in degrees, scale, fade):
+
+```ts
+fruta.radialGradient(x, y, r, [[0, '#fff'], [1, 'navy']])
+fruta.linearGradient(x1, y1, x2, y2, [[0, 'red'], [1, 'gold']])
+
+fruta.push({ x: 250, y: 250, rotate: angle, scale: 1.5, alpha: 0.8 })
+fruta.circle({ x: 120, y: 0, r: 12, fill: 'deepskyblue' })
+fruta.pop()
+```
+
+## Animation
+
+```ts
+// tween any numeric props (and colours!) over time → handle: pause()/resume()/cancel()
+fruta.tween(obj, { to: { x: 300, fill: 'gold' }, duration: 0.8, ease: 'bounce',
+                   delay, repeat, yoyo, onUpdate, onComplete })
 
-const { FontCreator, ShapeCreator, Game } = Fruta(config)
+fruta.stagger(items, { to, duration, ease, each })   // animate a group, offset by `each`s
+
+fruta.timeline()
+  .to(a, { to: { x: 100 }, duration: 1 })
+  .to(b, { to: { y: 50 }, duration: 0.5 }, { at: 0 })   // { at } = absolute time (parallel)
+  .call(fn)
+
+// named sprite-animation states
+const anim = fruta.anim({ idle: { frames: [0], fps: 1 }, walk: { frames: [1, 2], fps: 9 } })
+anim.play('walk', t)
+fruta.frameAt(t, 8, 4)   // quick looping frame: floor(t*fps) % count
+```
+
+**Easings:** `linear`, plus `easeIn/Out/InOut` and the families `quad · cubic · quart · sine ·
+expo · circ · back · bounce · elastic` each as `…In` / `…Out` / `…InOut`. Or pass your own `(t) => number`.
+
+## Input
+
+```ts
+fruta.keyDown('ArrowRight')           // true while held (poll in loop)
+fruta.onKey('Space', () => { … })     // on each press
+
+fruta.mouse                           // { x, y } in canvas coords (correct under CSS scaling)
+fruta.mouseDown
+fruta.onClick(p => …) · fruta.onPress(p => …) · fruta.onRelease(p => …) · fruta.onMove(p => …)
+
+const pad = fruta.gamepad({ buttons: { jump: 'A', shoot: 'X' }, deadzone: 0.12 })
+pad.down('jump') · pad.pressed('jump') · pad.value('LT') · pad.stick('left')
+```
+
+> Game keys (Space, arrows, Page/Home/End) no longer scroll the page — Fruta `preventDefault`s
+> them (unless you're typing in a form field).
+
+## Audio
+
+Web Audio under the hood — low latency, overlapping playback, and a synth `beep` so you can make
+sound with **zero asset files**. Auto-unlocks on first input.
+
+```ts
+await fruta.load({ jump: 'jump.mp3' })
+fruta.play('jump', { volume: 0.5, loop, rate })     // → handle: stop()/volume()
+fruta.beep({ freq: 440, duration: 0.15, type: 'square', volume: 0.3 })
+fruta.volume(0.8) · fruta.mute()
+```
+
+## Collision & physics
+
+**Detection** — overlap tests for rects (`{x,y,w,h}` top-left) and circles (`{x,y,r}` center), auto-detected:
+
+```ts
+fruta.hits(a, b)                       // overlap?
+fruta.inside(point, shape)
+fruta.overlap(a, b, (a, b) => { … })   // a/b each one thing or a list; callback per overlapping pair
+```
+
+**Response** — push a moving body out of a solid (the arcade collision behind platformers):
+
+```ts
+// fruta.solve(body, solid) → 'x' | 'y' | null; zeroes velocity into the surface, sets body.onGround
+player.vy += GRAVITY * dt
+player.x += player.vx * dt; player.y += player.vy * dt
+player.onGround = false
+for (const wall of solids) fruta.solve(player, wall)
+```
+
+**A real physics world** — `fruta.physics()` gives a `World`: AABB + circle bodies, gravity, and
+body-vs-body collision (impulse solver with **friction + restitution + Baumgarte** stabilisation,
+so stacks settle). The sugar: `world.add(obj)` **attaches physics to any object in place**.
+
+```ts
+const world = fruta.physics({ gravity: 1400 })
+world.static(0, H - 20, W, 20)              // walls/floors (mass 0)
+const box  = world.box(100, 0, 30, 30, { friction: 0.5, restitution: 0.2 })
+const ball = world.circle(200, 0, 16, { restitution: 0.6 })
+world.add(myPlayer, { mass: 1 })            // give physics to YOUR object
+
+fruta.loop((dt) => { world.step(dt); for (const b of world.bodies) draw(b) })
+```
 
-// Code :)
+## Pathfinding (A*)
 
+```ts
+import { findPath } from 'fruta'
+const path = findPath({ x: 0, y: 0 }, { x: 9, y: 6 }, cols, rows, (x, y) => isWall(x, y))
+// or on a tilemap, around solid tiles:
+const route = map.path({ x: 2, y: 2 }, { x: 18, y: 9 })   // → [{x,y}, …] | null
 ```
 
-# Current Short Doc
+## Scale: pooling & spatial hashing
+
+The two patterns behind thousands of bullets/enemies at 60 fps — no per-frame allocation, near-O(n) collision.
+
+```ts
+import { Pool, SpatialHash } from 'fruta'
+
+const bullets = new Pool(2000, () => ({ x: 0, y: 0, vx: 0, vy: 0, dead: false }))
+const b = bullets.spawn()                    // next free slot (or null when full); reset its fields
+bullets.kill(i)                              // swap-remove the active body at index i
+
+const hash = new SpatialHash(32)             // cell size
+hash.clear(); for (const e of enemies) hash.insert(e.x, e.y, e)
+const near: Enemy[] = []
+hash.query(b.x, b.y, 12, near)               // only the enemies in nearby cells
+```
+
+## Curves & hex grids
+
+```ts
+import { cubicBezier, bezierPath, hexToPixel, pixelToHex, hexNeighbors } from 'fruta'
+
+cubicBezier(p0, p1, p2, p3, t)               // a point on a cubic Bézier
+const pts = bezierPath(p0, p1, p2, p3, 32)   // sample it to a polyline (path / motion curve)
+
+hexToPixel(q, r, size)                       // pointy-top axial → pixel
+pixelToHex(x, y, size)                       // pixel → { q, r } (rounded)
+hexNeighbors(q, r)                           // the 6 surrounding hexes
+```
+
+## Sprites & assets
+
+```ts
+await fruta.load({ hero: '/hero.png' })      // preload → loading screen
+fruta.addImage('hero', imageOrCanvas)        // register an image/canvas (e.g. a generated sheet)
+fruta.sprite('hero', { x, y, w, h, frame, frameW, frameH, cols, rotation, anchor: 'center', flipX })
+```
+
+## Camera
+
+Draw the world between `begin()`/`end()`; draw HUD after (screen space).
+
+```ts
+fruta.camera.follow(player, 0.14)            // smooth follow (1 = instant)
+fruta.camera.clamp(0, 0, world.w, world.h)
+fruta.camera.zoom = 1.5
+fruta.camera.begin(); /* world drawing */ fruta.camera.end()
+fruta.camera.screenToWorld(fruta.mouse.x, fruta.mouse.y)
+fruta.camera.shake(12, 0.3)                  // strength px, duration s
+```
+
+## Tilemaps & platformer physics
+
+A grid level that draws itself and resolves arcade collisions against solid tiles.
+
+```ts
+const map = fruta.tilemap({
+  size: 32,
+  data: ['   o ', '#####'],                            // rows of chars
+  tiles: { '#': { solid: true, color: '#7d4a26' } },   // or { sprite, frame }
+  bevel: true,                                          // edge light/shadow for depth (autotiling-lite)
+})
+map.draw()
+map.move(player, dt)                          // moves by vx/vy, resolves vs tiles, sets player.onGround
+map.path({ x: 1, y: 1 }, { x: 9, y: 3 })      // A* around solid tiles
+map.isSolid(tx, ty) · map.at/set(tx, ty)
+```
+
+## Scenes, particles, timers, save
+
+```ts
+fruta.scene('game', { enter() { reset() }, update(dt, t) { … }, leave() { … } })
+fruta.start('game', 0.4)                      // switch with a 0.4s fade
+
+fruta.burst({ x, y, count: 30, color: ['#ff5', '#5cf'], speed: [40, 200], spread: 360, life: 1, gravity: 250 })
+const trail = fruta.emit({ x, y, rate: 60, color: '#6cf', life: 0.6 }); trail.x = fruta.mouse.x
+fruta.drawParticles()
+
+fruta.after(2, () => { … })                   // once → handle.cancel()
+fruta.every(0.5, () => { … })                 // repeating
+fruta.store('highscore', 9000); fruta.stored('highscore', 0)   // persist (localStorage, JSON)
+```
+
+## Entities (opt-in retained mode)
+
+Register an entity and the engine moves it (velocity + gravity + its own `update()`).
+
+```ts
+const ball = fruta.add({
+  shape: 'circle', x, y, r: 10, vx: 80, gravity: 520, color: 'tomato',
+  bounds: 'bounce',                           // 'bounce' off walls or 'wrap' across them
+  update(self, dt, t) { if (self.y > 400) self.vy *= -0.8 },
+})
+fruta.drawEntities() · fruta.all · ball.remove()
+```
+
+## Live debug & charts
+
+```ts
+fruta.debug(true)                             // overlay: FPS, entity/particle/tween counts, mouse
+fruta.watch('player.x', player.x)
+
+fruta.barChart({ data: [{ label: 'Mon', value: 40 }, …], max: 100 })
+fruta.lineChart({ series: [{ name: 'Revenue', data: [...] }], points: true, legend: true })
+fruta.pieChart({ data: [...], donut: 0.55 }) · fruta.radar({ axes, series }) · fruta.legend({ … })
+```
+
+Charts handle scales/axes/legend; pass `progress` (0..1) for an animated reveal.
+
+## WebGL: same sugar, GPU speed, shaders
+
+For thousands of objects, switch to the WebGL renderer — **identical API**, GPU-batched:
+
+```ts
+const gl = Fruta.gl({ width: 800, height: 600, background: '#0a0a14' }).mount()
+gl.loop((dt) => { gl.background(); for (const b of balls) gl.circle({ x: b.x, y: b.y, r: b.r, fill: b.color }) })
+```
+
+`Fruta.gl` mirrors the full Canvas2D engine — draw, camera, input, **entities, tilemap + physics,
+collision, particles, scenes, timers, save, audio, animation, `timeScale`, `solve`, `physics`** —
+all GPU-batched. Plus **shaders, Fruta-style**:
+
+```ts
+const bg = gl.shader(`void main(){ gl_FragColor = vec4(0.5+0.5*cos(uTime+gl_FragCoord.xyx), 1.0); }`)
+gl.loop(() => bg.draw())
+
+// post-processing: ~25 presets, one call
+gl.effect('crt') · gl.effect('vignette', { intensity: 0.7 }) · gl.effect('chromatic') · gl.effect(null)
+// or your own fragment (samples uScene at vUV):
+gl.effect('uniform vec2 uCenter;void main(){ /* a custom shockwave */ }', { uCenter: [0.5, 0.5] })
+```
+
+**~25 post presets:** color (`grayscale invert sepia tint brightness posterize threshold`),
+retro (`scanlines crt vhs pixelate noise glitch`), distortion (`chromatic wave fisheye mirror
+shockwave`), blur/glow (`blur sharpen bloom dream edge`), special (`vignette nightvision`).
+
+> Canvas2D and WebGL can't share a canvas, so `Fruta.gl` is its own object. Both are full engines —
+> pick Canvas2D for the richest 2D, WebGL for raw throughput. `WebGLBatch`/`Shader`/`PostFX` are exported.
+
+## Going lower-level
+
+```ts
+fruta.context     // raw CanvasRenderingContext2D
+fruta.shapes      // chainable Canvas wrappers
+fruta.fonts       // chainable text wrappers
+fruta.state       // context save/restore
+```
+
+## What you can build
+
+Fruta is small, but it's been stress-tested against a suite of real game/app slices (in the
+playground) — these are the genres it comfortably handles today:
 
-The documentation I have to offer is somewhat early, basically explaining the return of each wrapper made for each method in the canvas.
+| You want… | Fruta gives you |
+|---|---|
+| **Platformers** (Ori-style) | `solve` collision, `timeScale` (hit-stop), tilemaps, camera, shaders for game-feel |
+| **Bullet-hell / survivors** (thousands of entities) | `Pool` + `SpatialHash` + the GL batch renderer — 60 fps at thousands |
+| **Top-down / colony sims** | `findPath` (A*) NPC AI, state machines, day/night, save/load |
+| **Terraria-likes** (huge worlds) | chunked tile streaming, dynamic lighting, simple liquids, mining, procedural gen |
+| **Noita-likes** (pixel physics) | cellular automata over a grid blitted as one texture (`context` + `drawImage`) |
+| **Factorio-likes** (sim at scale) | a fixed-timestep loop + data-oriented machines (belts, inserters, recipes) |
+| **Editor apps** (level / animation / node) | `onPress/onMove/onRelease/onKey` + `context` — zoom/pan, gizmos, undo/redo, timelines |
+| **Data viz & dashboards** | one-call `barChart/lineChart/pieChart/radar` |
 
-It also includes examples where you can understand why things were done the way they were, even though we still need to continue improving what we have. 👽
+The playground (`bun run dev`) ships runnable versions of all of these.
 
-[Shape, Font and Image Methods](https://github.com/karttofer/Fruta/blob/FEATURE/readme/DOCUMENTATION.MD)
+## TypeScript
 
-# Important
+Fruta is **written in TypeScript and ships its own `.d.ts`** — no `@types/fruta` needed. Every
+option object, return value and exported helper (`World`, `Pool`, `SpatialHash`, `findPath`,
+`cubicBezier`, `hexToPixel`, `Vec`, `Hex`, …) is typed, so you get full autocomplete and
+compile-time checks. It works just as well from plain JavaScript.
 
-I am working hard to have a version one of all this ready, and also to create an API to make it easier to dive into what we are doing.
+## Status
 
-So, don't despair, we will have more soon 😮
+`0.1.0` — alpha, the API is settling but solid. Canvas2D is draw-call bound (fine into the low
+thousands); `Fruta.gl` (WebGL, batched) is the throughput path for tens of thousands. See
+[CHANGELOG.md](CHANGELOG.md) and [ROADMAP.md](ROADMAP.md).
 
-# License
+## License
 
-This project was released under the [MIT license](https://opensource.org/license/mit/)
+[MIT](https://opensource.org/license/mit/)

package/dist/animation/anim.d.ts

@@ -0,0 +1,13 @@
+export interface AnimState {
+    frames: number[];
+    fps: number;
+}
+export declare class Anim {
+    private readonly states;
+    private current;
+    private startAt;
+    constructor(states: Record<string, AnimState>);
+    play(name: string, time: number): void;
+    frame(time: number): number;
+    get state(): string;
+}

package/dist/animation/animate.d.ts

@@ -0,0 +1,101 @@
+export type EaseFn = (t: number) => number;
+export interface Updatable {
+    update(dt: number): boolean;
+}
+export declare const EASES: {
+    linear: (t: number) => number;
+    easeIn: (t: number) => number;
+    easeOut: (t: number) => number;
+    easeInOut: (t: number) => number;
+    quadIn: (t: number) => number;
+    quadOut: (t: number) => number;
+    quadInOut: (t: number) => number;
+    cubicIn: (t: number) => number;
+    cubicOut: (t: number) => number;
+    cubicInOut: (t: number) => number;
+    quartIn: (t: number) => number;
+    quartOut: (t: number) => number;
+    quartInOut: (t: number) => number;
+    sineIn: (t: number) => number;
+    sineOut: (t: number) => number;
+    sineInOut: (t: number) => number;
+    expoIn: (t: number) => number;
+    expoOut: (t: number) => number;
+    expoInOut: (t: number) => number;
+    circIn: (t: number) => number;
+    circOut: (t: number) => number;
+    circInOut: (t: number) => number;
+    backIn: (t: number) => number;
+    backOut: (t: number) => number;
+    backInOut: (t: number) => number;
+    bounceIn: (t: number) => number;
+    bounceOut: EaseFn;
+    bounceInOut: (t: number) => number;
+    elasticIn: (t: number) => number;
+    elasticOut: EaseFn;
+    elasticInOut: (t: number) => number;
+    bounce: EaseFn;
+    elastic: EaseFn;
+};
+export type EaseName = keyof typeof EASES;
+export type RGBA = [number, number, number, number];
+export declare function parseColor(c: string): RGBA;
+export declare function lerpColor(a: RGBA, b: RGBA, t: number): string;
+export interface TweenSpec {
+    to: Record<string, number>;
+    duration: number;
+    ease: EaseFn;
+    delay: number;
+    repeat: number;
+    yoyo: boolean;
+    onUpdate?: (target: Record<string, number>, progress: number) => void;
+    onComplete?: () => void;
+}
+export declare class Tween implements Updatable {
+    private readonly target;
+    private readonly spec;
+    private from;
+    private captured;
+    private elapsed;
+    private cancelled;
+    private paused;
+    constructor(target: Record<string, number>, spec: TweenSpec);
+    update(dt: number): boolean;
+    cancel(): void;
+    pause(): void;
+    resume(): void;
+}
+type TweenFactory = (target: Record<string, number>, opts: {
+    to?: Record<string, number | string>;
+    duration: number;
+    ease?: EaseName | EaseFn;
+    delay?: number;
+    repeat?: number;
+    yoyo?: boolean;
+    onUpdate?: (t: any, p: number) => void;
+    onComplete?: () => void;
+}, absoluteDelay: number) => Tween;
+export interface TimelinePlace {
+    at?: number;
+}
+export declare class Timeline implements Updatable {
+    private readonly factory;
+    private children;
+    private cursor;
+    private finishedCb?;
+    constructor(factory: TweenFactory);
+    to(target: Record<string, number>, opts: {
+        to: Record<string, number | string>;
+        duration: number;
+        ease?: EaseName | EaseFn;
+        delay?: number;
+        repeat?: number;
+        yoyo?: boolean;
+        onUpdate?: (t: any, p: number) => void;
+        onComplete?: () => void;
+    }, place?: TimelinePlace): this;
+    call(fn: () => void, place?: TimelinePlace): this;
+    then(fn: () => void): this;
+    update(dt: number): boolean;
+}
+export {};

package/dist/audio/audio.d.ts

@@ -0,0 +1,29 @@
+export interface PlayOptions {
+    volume?: number;
+    loop?: boolean;
+    rate?: number;
+}
+export interface BeepOptions {
+    freq?: number;
+    duration?: number;
+    type?: OscillatorType;
+    volume?: number;
+}
+export interface Sound {
+    stop(): void;
+    volume(v: number): void;
+}
+export declare class AudioManager {
+    private ctx;
+    private master;
+    private buffers;
+    private muted;
+    private level;
+    private ensure;
+    resume(): void;
+    loadSound(name: string, src: string): Promise<void>;
+    play(name: string, opts?: PlayOptions): Sound;
+    beep(opts?: BeepOptions): void;
+    volume(v: number): void;
+    mute(on?: boolean): void;
+}