kaplay 3000.1.17

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2021 Replit
+
+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

@@ -0,0 +1,209 @@
+# KAPLAY
+
+![kaplay](https://github.com/marklovers/kaplay/raw/master/assets/kaplay.png)
+
+> Kaplay is the spiritual successor (and fork) of Kaboom, a JavaScript library that helps you make games fast and fun!
+> For now, there's links to the Kaboom documentation and examples, but in the future, they will be linked
+> to our own site.
+
+[**Kaplay**](https://kaplaydocs.pages.dev/) is a JavaScript library that helps you make games fast and fun!
+
+Start playing around with it in the [Kaplayground](https://kaplay.pages.dev/)
+
+## Examples
+
+```js
+// initialize context
+kaboom();
+
+// define gravity
+setGravity(2400);
+
+// load a sprite called "bean"
+loadSprite("bean", "sprites/bean.png");
+
+// compose the player game object from multiple components and add it to the game
+const bean = add([
+    sprite("bean"),
+    pos(80, 40),
+    area(),
+    body(),
+]);
+
+// press space to jump
+onKeyPress("space", () => {
+    // this method is provided by the "body" component above
+    bean.jump();
+});
+```
+
+kaplay uses a powerful component system to compose game objects and behaviors.
+
+```js
+// add a game obj to the scene from a list of component
+const player = add([
+    // it renders as a sprite
+    sprite("bean"),
+    // it has a position
+    pos(100, 200),
+    // it has a collider
+    area(),
+    // it is a physical body which will respond to physics
+    body(),
+    // it has 8 of health
+    health(8),
+    // or give it tags for easier group behaviors
+    "player",
+    "friendly",
+    // plain objects fields are directly assigned to the game obj
+    {
+        dir: vec2(-1, 0),
+        dead: false,
+        speed: 240,
+    },
+]);
+```
+
+Blocky imperative syntax for describing behaviors
+
+```js
+// .onCollide() comes from "area" component
+player.onCollide("enemy", () => {
+    // .hurt() comes from "health" component
+    player.hurt(1);
+});
+
+// check fall death
+player.onUpdate(() => {
+    if (player.pos.y >= height()) {
+        destroy(player);
+        gameOver();
+    }
+});
+
+// if 'player' onCollide with any object with tag "enemy", run the callback
+player.onCollide("enemy", () => {
+    player.hp -= 1;
+});
+
+// all objects with tag "enemy" will move towards 'player' every frame
+onUpdate("enemy", (e) => {
+    e.move(player.pos.sub(e.pos).unit().scale(e.speed));
+});
+
+// move up 100 pixels per second every frame when "w" key is held down
+onKeyDown("w", () => {
+    player.move(0, 100);
+});
+```
+
+## Usage
+
+### Start a Project With `create-kaboom`
+
+The fastest way to start a Kaboom game is with [`create-kaboom`](https://github.com/replit/kaboom/tree/master/pkgs/create)
+
+```sh
+$ npm init kaboom mygame
+```
+
+This will create a directory called `mygame` for you, containing all the files we need
+
+```sh
+$ cd mygame
+$ npm run dev
+```
+
+Then open http://localhost:5173 and edit `src/game.js`
+
+### Install as NPM Package
+
+```sh
+$ npm install kaplay
+```
+
+```js
+import kaboom from "kaplay";
+
+kaboom();
+
+add([
+    text("oh hi"),
+    pos(80, 40),
+]);
+```
+
+also works with CommonJS
+
+```js
+const kaboom = require("kaplay");
+```
+
+Note that you'll need to use a bundler like `esbuild` or `webpack` to use Kaboom with NPM
+
+### Browser CDN
+
+This exports a global `kaboom` function
+
+```html
+<script src="https://unpkg.com/kaplay@3001/dist/kaboom.js"></script>
+<script>
+kaboom()
+</script>
+```
+
+or use with es modules
+
+```html
+<script type="module">
+import kaboom from "https://unpkg.com/kaplay@3001/dist/kaboom.mjs"
+kaboom()
+</script>
+```
+
+works all CDNs that supports NPM packages, e.g. jsdelivr, skypack
+
+## Documentation
+
+- **v3001**: https://kaplaydocs.pages.dev/
+- **v3000**: https://kaboomjs.com/
+- **v2000**: https://2000.kaboomjs.com/
+- **v0.5.0**: https://legacy.kaboomjs.com/
+
+## Dev
+
+1. `npm install` to install dev packages
+1. `npm run dev` to start dev server
+1. go to http://localhost:8000/ and pick an example
+1. edit examples in `examples/` to test
+
+Check out [CONTRIBUTION.md](CONTRIBUTING.md) for full info.
+
+## Community
+
+- [Discord Server](https://discord.gg/aQ6RuQm3TF)
+- [GitHub Discussions](https://github.com/marklovers/kaplay/discussions)
+- [Twitter](https://twitter.com/Kaboomjs)
+
+### Games
+
+Collection of games made with Kaboom, selected by Kaboom, [here](https://itch.io/c/2645141/made-in-kaboom).
+
+- [on Itch.io](https://itch.io/games/tag-kaboomjs)
+- [on Replit](https://replit.com/apps/kaboom)
+- [on Newgrounds](https://www.newgrounds.com/search/conduct/games?tags=kaboomjs)
+
+## Misc
+
+- This project has no relation to Activision's game [Kaboom!](https://en.wikipedia.org/wiki/Kaboom!_(video_game))
+- Thanks to [tga](https://space55.xyz) for all his work on the original Kaboom.js
+- Thanks to [abrudz](https://github.com/abrudz) for the amazing [APL386 font](https://abrudz.github.io/APL386/)
+- Thanks to [Polyducks](http://polyducks.co.uk/) for the amazing [kitchen sink font](https://polyducks.itch.io/kitchen-sink-textmode-font) font
+- Thanks to [0x72](https://0x72.itch.io/) for the amazing [Dungeon Tileset](https://0x72.itch.io/dungeontileset-ii)
+- Thanks to [Kenney](https://kenney.nl/) for the amazing [1-Bit Platformer Pack](https://kenney.nl/assets/1-bit-platformer-pack)
+- Thanks to [mulfok](https://twitter.com/MulfoK) for the amazing [mulfok32](https://lospec.com/palette-list/mulfok32) color palette
+- Find bitmap fonts: [Oldschool PC Font](https://int10h.org/oldschool-pc-fonts)
+- Featured on [Console 50](https://console.substack.com/p/console-50)
+- Thanks to [Umayr](https://github.com/umayr) for kindly offering the "kaboom" npm package name
+- Please buy fireworks on [kaboom.com](http://www.kaboom.com/)
+- [How to do a KABOOM on a Trampoline](https://www.youtube.com/watch?v=3CemcWdc_Hc)

package/dist/global.d.ts

@@ -0,0 +1,237 @@
+import { KaboomCtx } from "./kaboom"
+declare global {
+	const add: KaboomCtx["add"]
+	const make: KaboomCtx["make"]
+	const readd: KaboomCtx["readd"]
+	const get: KaboomCtx["get"]
+	const destroy: KaboomCtx["destroy"]
+	const destroyAll: KaboomCtx["destroyAll"]
+	const pos: KaboomCtx["pos"]
+	const scale: KaboomCtx["scale"]
+	const rotate: KaboomCtx["rotate"]
+	const color: KaboomCtx["color"]
+	const opacity: KaboomCtx["opacity"]
+	const sprite: KaboomCtx["sprite"]
+	const text: KaboomCtx["text"]
+	const polygon: KaboomCtx["polygon"]
+	const rect: KaboomCtx["rect"]
+	const circle: KaboomCtx["circle"]
+	const uvquad: KaboomCtx["uvquad"]
+	const area: KaboomCtx["area"]
+	const anchor: KaboomCtx["anchor"]
+	const z: KaboomCtx["z"]
+	const outline: KaboomCtx["outline"]
+	const body: KaboomCtx["body"]
+	const doubleJump: KaboomCtx["doubleJump"]
+	const move: KaboomCtx["move"]
+	const offscreen: KaboomCtx["offscreen"]
+	const follow: KaboomCtx["follow"]
+	const shader: KaboomCtx["shader"]
+	const timer: KaboomCtx["timer"]
+	const fixed: KaboomCtx["fixed"]
+	const stay: KaboomCtx["stay"]
+	const health: KaboomCtx["health"]
+	const lifespan: KaboomCtx["lifespan"]
+	const state: KaboomCtx["state"]
+	const fadeIn: KaboomCtx["fadeIn"]
+	const mask: KaboomCtx["mask"]
+	const drawon: KaboomCtx["drawon"]
+	const tile: KaboomCtx["tile"]
+	const agent: KaboomCtx["agent"]
+	const on: KaboomCtx["on"]
+	const onUpdate: KaboomCtx["onUpdate"]
+	const onDraw: KaboomCtx["onDraw"]
+	const onAdd: KaboomCtx["onAdd"]
+	const onDestroy: KaboomCtx["onDestroy"]
+	const onLoad: KaboomCtx["onLoad"]
+	const onLoading: KaboomCtx["onLoading"]
+	const onError: KaboomCtx["onError"]
+	const onResize: KaboomCtx["onResize"]
+	const onCleanup: KaboomCtx["onCleanup"]
+	const onGamepadConnect: KaboomCtx["onGamepadConnect"]
+	const onGamepadDisconnect: KaboomCtx["onGamepadDisconnect"]
+	const onCollide: KaboomCtx["onCollide"]
+	const onCollideUpdate: KaboomCtx["onCollideUpdate"]
+	const onCollideEnd: KaboomCtx["onCollideEnd"]
+	const onClick: KaboomCtx["onClick"]
+	const onHover: KaboomCtx["onHover"]
+	const onHoverUpdate: KaboomCtx["onHoverUpdate"]
+	const onHoverEnd: KaboomCtx["onHoverEnd"]
+	const onKeyDown: KaboomCtx["onKeyDown"]
+	const onKeyPress: KaboomCtx["onKeyPress"]
+	const onKeyPressRepeat: KaboomCtx["onKeyPressRepeat"]
+	const onKeyRelease: KaboomCtx["onKeyRelease"]
+	const onCharInput: KaboomCtx["onCharInput"]
+	const onMouseDown: KaboomCtx["onMouseDown"]
+	const onMousePress: KaboomCtx["onMousePress"]
+	const onMouseRelease: KaboomCtx["onMouseRelease"]
+	const onMouseMove: KaboomCtx["onMouseMove"]
+	const onTouchStart: KaboomCtx["onTouchStart"]
+	const onTouchMove: KaboomCtx["onTouchMove"]
+	const onTouchEnd: KaboomCtx["onTouchEnd"]
+	const onScroll: KaboomCtx["onScroll"]
+	const onHide: KaboomCtx["onHide"]
+	const onShow: KaboomCtx["onShow"]
+	const onGamepadButtonDown: KaboomCtx["onGamepadButtonDown"]
+	const onGamepadButtonPress: KaboomCtx["onGamepadButtonPress"]
+	const onGamepadButtonRelease: KaboomCtx["onGamepadButtonRelease"]
+	const onGamepadStick: KaboomCtx["onGamepadStick"]
+	const onSceneLeave: KaboomCtx["onSceneLeave"]
+	const loadRoot: KaboomCtx["loadRoot"]
+	const loadSprite: KaboomCtx["loadSprite"]
+	const loadSpriteAtlas: KaboomCtx["loadSpriteAtlas"]
+	const loadAseprite: KaboomCtx["loadAseprite"]
+	const loadPedit: KaboomCtx["loadPedit"]
+	const loadBean: KaboomCtx["loadBean"]
+	const loadJSON: KaboomCtx["loadJSON"]
+	const loadSound: KaboomCtx["loadSound"]
+	const loadFont: KaboomCtx["loadFont"]
+	const loadBitmapFont: KaboomCtx["loadBitmapFont"]
+	const loadShader: KaboomCtx["loadShader"]
+	const loadShaderURL: KaboomCtx["loadShaderURL"]
+	const load: KaboomCtx["load"]
+	const loadProgress: KaboomCtx["loadProgress"]
+	const getSprite: KaboomCtx["getSprite"]
+	const getSound: KaboomCtx["getSound"]
+	const getFont: KaboomCtx["getFont"]
+	const getBitmapFont: KaboomCtx["getBitmapFont"]
+	const getShader: KaboomCtx["getShader"]
+	const getAsset: KaboomCtx["getAsset"]
+	const Asset: KaboomCtx["Asset"]
+	const SpriteData: KaboomCtx["SpriteData"]
+	const SoundData: KaboomCtx["SoundData"]
+	const width: KaboomCtx["width"]
+	const height: KaboomCtx["height"]
+	const center: KaboomCtx["center"]
+	const dt: KaboomCtx["dt"]
+	const time: KaboomCtx["time"]
+	const isFocused: KaboomCtx["isFocused"]
+	const isTouchscreen: KaboomCtx["isTouchscreen"]
+	const mousePos: KaboomCtx["mousePos"]
+	const mouseDeltaPos: KaboomCtx["mouseDeltaPos"]
+	const isKeyDown: KaboomCtx["isKeyDown"]
+	const isKeyPressed: KaboomCtx["isKeyPressed"]
+	const isKeyPressedRepeat: KaboomCtx["isKeyPressedRepeat"]
+	const isKeyReleased: KaboomCtx["isKeyReleased"]
+	const isMouseDown: KaboomCtx["isMouseDown"]
+	const isMousePressed: KaboomCtx["isMousePressed"]
+	const isMouseReleased: KaboomCtx["isMouseReleased"]
+	const isMouseMoved: KaboomCtx["isMouseMoved"]
+	const isGamepadButtonPressed: KaboomCtx["isGamepadButtonPressed"]
+	const isGamepadButtonDown: KaboomCtx["isGamepadButtonDown"]
+	const isGamepadButtonReleased: KaboomCtx["isGamepadButtonReleased"]
+	const getGamepadStick: KaboomCtx["getGamepadStick"]
+	const charInputted: KaboomCtx["charInputted"]
+	const shake: KaboomCtx["shake"]
+	const camPos: KaboomCtx["camPos"]
+	const camScale: KaboomCtx["camScale"]
+	const camRot: KaboomCtx["camRot"]
+	const toScreen: KaboomCtx["toScreen"]
+	const toWorld: KaboomCtx["toWorld"]
+	const setGravity: KaboomCtx["setGravity"]
+	const getGravity: KaboomCtx["getGravity"]
+	const setBackground: KaboomCtx["setBackground"]
+	const getBackground: KaboomCtx["getBackground"]
+	const getGamepads: KaboomCtx["getGamepads"]
+	const setCursor: KaboomCtx["setCursor"]
+	const getCursor: KaboomCtx["getCursor"]
+	const setCursorLocked: KaboomCtx["setCursorLocked"]
+	const isCursorLocked: KaboomCtx["isCursorLocked"]
+	const setFullscreen: KaboomCtx["setFullscreen"]
+	const isFullscreen: KaboomCtx["isFullscreen"]
+	const wait: KaboomCtx["wait"]
+	const loop: KaboomCtx["loop"]
+	const play: KaboomCtx["play"]
+	const burp: KaboomCtx["burp"]
+	const volume: KaboomCtx["volume"]
+	const audioCtx: KaboomCtx["audioCtx"]
+	const rand: KaboomCtx["rand"]
+	const randi: KaboomCtx["randi"]
+	const randSeed: KaboomCtx["randSeed"]
+	const vec2: KaboomCtx["vec2"]
+	const rgb: KaboomCtx["rgb"]
+	const hsl2rgb: KaboomCtx["hsl2rgb"]
+	const quad: KaboomCtx["quad"]
+	const choose: KaboomCtx["choose"]
+	const chance: KaboomCtx["chance"]
+	const lerp: KaboomCtx["lerp"]
+	const tween: KaboomCtx["tween"]
+	const easings: KaboomCtx["easings"]
+	const map: KaboomCtx["map"]
+	const mapc: KaboomCtx["mapc"]
+	const wave: KaboomCtx["wave"]
+	const deg2rad: KaboomCtx["deg2rad"]
+	const rad2deg: KaboomCtx["rad2deg"]
+	const clamp: KaboomCtx["clamp"]
+	const testLinePoint: KaboomCtx["testLinePoint"]
+	const testLineLine: KaboomCtx["testLineLine"]
+	const testLineCircle: KaboomCtx["testLineCircle"]
+	const testRectRect: KaboomCtx["testRectRect"]
+	const testRectLine: KaboomCtx["testRectLine"]
+	const testRectPoint: KaboomCtx["testRectPoint"]
+	const testCirclePolygon: KaboomCtx["testCirclePolygon"]
+	const Line: KaboomCtx["Line"]
+	const Rect: KaboomCtx["Rect"]
+	const Circle: KaboomCtx["Circle"]
+	const Polygon: KaboomCtx["Polygon"]
+	const Vec2: KaboomCtx["Vec2"]
+	const Color: KaboomCtx["Color"]
+	const Mat4: KaboomCtx["Mat4"]
+	const Quad: KaboomCtx["Quad"]
+	const RNG: KaboomCtx["RNG"]
+	const scene: KaboomCtx["scene"]
+	const go: KaboomCtx["go"]
+	const addLevel: KaboomCtx["addLevel"]
+	const getData: KaboomCtx["getData"]
+	const setData: KaboomCtx["setData"]
+	const drawSprite: KaboomCtx["drawSprite"]
+	const drawText: KaboomCtx["drawText"]
+	const drawRect: KaboomCtx["drawRect"]
+	const drawLine: KaboomCtx["drawLine"]
+	const drawLines: KaboomCtx["drawLines"]
+	const drawTriangle: KaboomCtx["drawTriangle"]
+	const drawCircle: KaboomCtx["drawCircle"]
+	const drawEllipse: KaboomCtx["drawEllipse"]
+	const drawPolygon: KaboomCtx["drawPolygon"]
+	const drawUVQuad: KaboomCtx["drawUVQuad"]
+	const drawFormattedText: KaboomCtx["drawFormattedText"]
+	const drawMasked: KaboomCtx["drawMasked"]
+	const drawSubtracted: KaboomCtx["drawSubtracted"]
+	const pushTransform: KaboomCtx["pushTransform"]
+	const popTransform: KaboomCtx["popTransform"]
+	const pushTranslate: KaboomCtx["pushTranslate"]
+	const pushScale: KaboomCtx["pushScale"]
+	const pushRotate: KaboomCtx["pushRotate"]
+	const pushMatrix: KaboomCtx["pushMatrix"]
+	const usePostEffect: KaboomCtx["usePostEffect"]
+	const formatText: KaboomCtx["formatText"]
+	const makeCanvas: KaboomCtx["makeCanvas"]
+	const debug: KaboomCtx["debug"]
+	const plug: KaboomCtx["plug"]
+	const screenshot: KaboomCtx["screenshot"]
+	const download: KaboomCtx["download"]
+	const downloadText: KaboomCtx["downloadText"]
+	const downloadJSON: KaboomCtx["downloadJSON"]
+	const downloadBlob: KaboomCtx["downloadBlob"]
+	const record: KaboomCtx["record"]
+	const addKaboom: KaboomCtx["addKaboom"]
+	const ASCII_CHARS: KaboomCtx["ASCII_CHARS"]
+	const LEFT: KaboomCtx["LEFT"]
+	const RIGHT: KaboomCtx["RIGHT"]
+	const UP: KaboomCtx["UP"]
+	const DOWN: KaboomCtx["DOWN"]
+	const RED: KaboomCtx["RED"]
+	const GREEN: KaboomCtx["GREEN"]
+	const BLUE: KaboomCtx["BLUE"]
+	const YELLOW: KaboomCtx["YELLOW"]
+	const MAGENTA: KaboomCtx["MAGENTA"]
+	const CYAN: KaboomCtx["CYAN"]
+	const WHITE: KaboomCtx["WHITE"]
+	const BLACK: KaboomCtx["BLACK"]
+	const canvas: KaboomCtx["canvas"]
+	const quit: KaboomCtx["quit"]
+	const Event: KaboomCtx["Event"]
+	const EventHandler: KaboomCtx["EventHandler"]
+	const EventController: KaboomCtx["EventController"]
+	const VERSION: KaboomCtx["VERSION"]
+}