core2d 2.10.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Diogo Eichert
+
+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,62 @@
+![core2d logo](./core2d.jpg)
+
+# About
+Core2D is the powerhouse used by [Maragato マラガト](https://maragato.itch.io) apps, among others. It is the evolution of Videogame, which in turn was the evolution of Quick. In its current form, it adopts [JavaScript modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules), leveraging the full power of [Object-oriented programming](https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/Object-oriented_programming).
+
+## Concept
+Apps created with Core2D are made of one or more [scenes](src/Scene.mjs), which may contain one or more [sprites](src/Sprite.mjs). These objects have properties that can be customized to shape their behavior. It's that simple.
+
+# Get Started
+[Download](https://github.com/dgchrt/core2d-skel/archive/refs/heads/main.zip) or clone/fork the [skeleton project](https://github.com/dgchrt/core2d-skel/) to start building your app. Alternatively, the library can be also installed to your existing/new project:
+```shell
+npm install core2d
+```
+
+## Learn
+The best way to learn is by doing, and you can see what Core2D is capable of through existing open-sourced apps. Check the [Hall of Fame](#hall-of-fame) below for some source code.
+
+## Support
+Please consider joining the [Discussions](https://github.com/dgchrt/core2d/discussions) for collaboration and support.
+
+# Features
+
+## Collision Detection
+Translated to callbacks, to keep update logic clean.
+
+## Assets Caching
+Assets and their transformations are reused automatically to keep a solid performance.
+
+## User Input
+Human interaction is unified via abstractions, so that apps will just work, regardless of the devices in use.
+
+### Controllers
+![controllers](controller.png)
+
+Gamepads or keyboard. When using a keyboard, sensible defaults (minding accessibility) are used, as seen in [KeyMap.mjs](https://github.com/dgchrt/core2d/blob/main/src/KeyMap.mjs).
+
+### Pointers
+![pointer](pointer.png)
+
+Mice or touch screen.
+
+## Virtual Resolution
+Internal geometry frees the app logic from displays, i.e. your app can have an internal logic resolution of 800x600, while running on any display size.
+
+# Contributing
+The core of the library (under `src/`) should remain agnostic and lean. Updates to the core library are usually related to technology developments in the platform (web API advances), while staying true to the basic concepts of the library, which are common to all apps.
+
+Opinionated functionality should be implemented in the form of a plugin (under `src/plugin/`). Plugins can add features that are domain driven, such as elements that can be reused by multiple apps, but not necessarily by every app.
+
+# Hall of Fame
+Apps created with Core2D:
+- [Asteroids Remake](https://chamun.github.io/asteroids-remake/) ([source](https://github.com/chamun/asteroids-remake))
+- [Cityscape](https://puter.com/app/cityscape) - Single-player arcade survival game
+- [Cucurbita's Halloween](https://www.kongregate.com/games/bbastudios/cucurbitas-halloween)
+- [Dragonfire](http://staudt.github.io/dragonfire) ([source](https://github.com/staudt/dragonfire))
+- [Missile Commander](https://dgchrt.github.io/missile-commander/) ([source](https://github.com/dgchrt/missile-commander))
+- [Ms. Starship](https://puter.com/app/ms-starship) - Multi-player arcade shoot'em up
+- [Mythology](https://puter.com/app/mythology) - Single-player arcade pinball
+- [Raycaster](https://staudt.github.io/raycaster/) ([source](https://github.com/staudt/raycaster))
+- [Starship](https://puter.com/app/starship) - Single-player arcade shoot'em up
+- [Super Breakout Bros.](https://staudt.github.io/SuperBreakoutBros/) ([source](https://github.com/staudt/SuperBreakoutBros))
+- [Tower Defense](https://danielcolnaghi.github.io/towerdefense) ([source](https://github.com/danielcolnaghi/towerdefense))

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "core2d",
+	"type": "module",
+	"version": "2.10.2",
+	"description": "Multiplatform 2D interaction engine",
+	"files": [
+		"src"
+	],
+	"scripts": {
+		"lint": "eslint",
+		"prepublishOnly": "git checkout main && git pull --rebase && npm test && git push && git push --tags",
+		"test": "npm run lint && for test in ./test/*.mjs; do node $test; done"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/diogoeichert/core2d.git"
+	},
+	"keywords": [
+		"2d",
+		"core",
+		"core2d",
+		"engine",
+		"game",
+		"game-engine",
+		"gamepad",
+		"interaction",
+		"keyboard",
+		"mouse",
+		"multi-platform",
+		"multimedia",
+		"object-oriented",
+		"sprites",
+		"scenes",
+		"touch"
+	],
+	"author": "Diogo Eichert",
+	"license": "MIT",
+	"bugs": {
+		"url": "https://github.com/diogoeichert/core2d/issues"
+	},
+	"funding": {
+		"url": "https://github.com/sponsors/diogoeichert"
+	},
+	"homepage": "https://diogoeichert.github.io/core2d/",
+	"devDependencies": {
+		"@eslint/js": "^9.30.1",
+		"eslint": "^9.30.1",
+		"globals": "^16.3.0"
+	}
+}

package/src/ACL.mjs

@@ -0,0 +1,72 @@
+"use strict";
+
+/**
+ * Sets up the environment based on its runtime (browser or not).
+ */
+if (typeof(global) != "undefined") {
+	global.addEventListener = () => {};
+
+	global.document = {
+		createElement: (name) => {
+			if (name == "canvas") {
+				return {
+					getContext: () => {
+						return {
+							measureText: (text) => {
+								return {
+									width: text.length,
+								};
+							},
+						};
+					},
+				};
+			}
+		},
+		getElementById: (id) => {
+			if (id == "app") {
+				return {
+					focus: () => {},
+					getContext: () => {
+						return {
+							fillRect: () => {},
+						};
+					},
+					height: 400,
+					offsetLeft: 0,
+					offsetTop: 0,
+					style: {},
+					width: 640,
+				};
+			}
+
+			return {};
+		},
+		getElementsByTagName: () => {
+			return [];
+		}
+	};
+
+	global.localStorage = {};
+
+	/**
+	 * For older Node.js versions.
+	 */
+	if (!global.navigator) {
+		global.navigator = {};
+	}
+
+	global.window = {
+		focus: () => {},
+		innerHeight: 600,
+		innerWidth: 800,
+		requestAnimationFrame: () => true
+	};
+}
+
+/**
+ * Anti-Corruption Layer, to be used instead of direct API calls.
+ */
+export const ACL = {
+	document,
+	window,
+};

package/src/Animation.mjs

@@ -0,0 +1,56 @@
+"use strict";
+
+import { Frame } from "./Frame.mjs";
+
+export class Animation {
+	constructor(frames) {
+		this._frames = frames;
+		this._index = 0;
+		this._tick = 0;
+	}
+
+	static fromImages(images, duration) {
+		return new this(images.map(image => new Frame(image, duration)));
+	}
+
+	get image() {
+		return this._frames[this._index].image;
+	}
+
+	get width() {
+		return this._frames[this._index].width;
+	}
+
+	get height() {
+		return this._frames[this._index].height;
+	}
+
+	setFrameIndex(index) {
+		if (index < this._frames.length) {
+			this._index = index;
+			this._tick = 0;
+		}
+	}
+
+	set frameIndex(index) {
+		this.setFrameIndex(index);
+	}
+
+	sync() {
+		const DURATION = this._frames[this._index].duration;
+		let hasLooped = false;
+
+		if (DURATION && ++this._tick >= DURATION) {
+			let index = this._index + 1;
+
+			if (index == this._frames.length) {
+				hasLooped = true;
+				index = 0;
+			}
+
+			this.setFrameIndex(index);
+		}
+
+		return hasLooped;
+	}
+}

package/src/Axis.mjs

@@ -0,0 +1,10 @@
+"use strict";
+
+import { Static } from "./Static.mjs";
+
+export const Axis = Static.makeEnum([
+	"LEFT_X",
+	"LEFT_Y",
+	"RIGHT_X",
+	"RIGHT_Y",
+]);

package/src/ButtonLayout.mjs

@@ -0,0 +1,43 @@
+"use strict";
+
+import { Static } from "./Static.mjs";
+
+export const ButtonLayout = {
+	reversed: Static.makeEnum([
+		"B",
+		"A",
+		"Y",
+		"X",
+		"L1",
+		"R1",
+		"L2",
+		"R2",
+		"SELECT",
+		"START",
+		"L3",
+		"R3",
+		"UP",
+		"DOWN",
+		"LEFT",
+		"RIGHT",
+	]),
+
+	standard: Static.makeEnum([
+		"A",
+		"B",
+		"X",
+		"Y",
+		"L1",
+		"R1",
+		"L2",
+		"R2",
+		"SELECT",
+		"START",
+		"L3",
+		"R3",
+		"UP",
+		"DOWN",
+		"LEFT",
+		"RIGHT",
+	])
+};

package/src/ButtonLayoutMap.mjs

@@ -0,0 +1,5 @@
+"use static";
+
+export const ButtonLayoutMap = {
+	"8bitdo s": "reversed"
+};

package/src/Color.mjs

@@ -0,0 +1,154 @@
+"use strict";
+
+import { Static } from "./Static.mjs";
+
+export const Color = Static.makeHash([
+	"AliceBlue",
+	"AntiqueWhite",
+	"Aqua",
+	"Aquamarine",
+	"Azure",
+	"Beige",
+	"Bisque",
+	"Black",
+	"BlanchedAlmond",
+	"Blue",
+	"BlueViolet",
+	"Brown",
+	"BurlyWood",
+	"CadetBlue",
+	"Chartreuse",
+	"Chocolate",
+	"Coral",
+	"CornflowerBlue",
+	"Cornsilk",
+	"Crimson",
+	"Cyan",
+	"DarkBlue",
+	"DarkCyan",
+	"DarkGoldenRod",
+	"DarkGray",
+	"DarkGreen",
+	"DarkGrey",
+	"DarkKhaki",
+	"DarkMagenta",
+	"DarkOliveGreen",
+	"Darkorange",
+	"DarkOrchid",
+	"DarkRed",
+	"DarkSalmon",
+	"DarkSeaGreen",
+	"DarkSlateBlue",
+	"DarkSlateGray",
+	"DarkSlateGrey",
+	"DarkTurquoise",
+	"DarkViolet",
+	"DeepPink",
+	"DeepSkyBlue",
+	"DimGray",
+	"DimGrey",
+	"DodgerBlue",
+	"FireBrick",
+	"FloralWhite",
+	"ForestGreen",
+	"Fuchsia",
+	"Gainsboro",
+	"GhostWhite",
+	"Gold",
+	"GoldenRod",
+	"Gray",
+	"Green",
+	"GreenYellow",
+	"Grey",
+	"HoneyDew",
+	"HotPink",
+	"IndianRed",
+	"Indigo",
+	"Ivory",
+	"Khaki",
+	"Lavender",
+	"LavenderBlush",
+	"LawnGreen",
+	"LemonChiffon",
+	"LightBlue",
+	"LightCoral",
+	"LightCyan",
+	"LightGoldenRodYellow",
+	"LightGray",
+	"LightGreen",
+	"LightGrey",
+	"LightPink",
+	"LightSalmon",
+	"LightSeaGreen",
+	"LightSkyBlue",
+	"LightSlateGray",
+	"LightSlateGrey",
+	"LightSteelBlue",
+	"LightYellow",
+	"Lime",
+	"LimeGreen",
+	"Linen",
+	"Magenta",
+	"Maroon",
+	"MediumAquaMarine",
+	"MediumBlue",
+	"MediumOrchid",
+	"MediumPurple",
+	"MediumSeaGreen",
+	"MediumSlateBlue",
+	"MediumSpringGreen",
+	"MediumTurquoise",
+	"MediumVioletRed",
+	"MidnightBlue",
+	"MintCream",
+	"MistyRose",
+	"Moccasin",
+	"NavajoWhite",
+	"Navy",
+	"OldLace",
+	"Olive",
+	"OliveDrab",
+	"Orange",
+	"OrangeRed",
+	"Orchid",
+	"PaleGoldenRod",
+	"PaleGreen",
+	"PaleTurquoise",
+	"PaleVioletRed",
+	"PapayaWhip",
+	"PeachPuff",
+	"Peru",
+	"Pink",
+	"Plum",
+	"PowderBlue",
+	"Purple",
+	"RebeccaPurple",
+	"Red",
+	"RosyBrown",
+	"RoyalBlue",
+	"SaddleBrown",
+	"Salmon",
+	"SandyBrown",
+	"SeaGreen",
+	"SeaShell",
+	"Sienna",
+	"Silver",
+	"SkyBlue",
+	"SlateBlue",
+	"SlateGray",
+	"SlateGrey",
+	"Snow",
+	"SpringGreen",
+	"SteelBlue",
+	"Tan",
+	"Teal",
+	"Thistle",
+	"Tomato",
+	"Turquoise",
+	"Violet",
+	"Wheat",
+	"White",
+	"WhiteSmoke",
+	"Yellow",
+	"YellowGreen",
+]);

package/src/Command.mjs

@@ -0,0 +1,16 @@
+"use strict";
+
+import { Static } from "./Static.mjs";
+
+export const Command = Static.makeEnum([
+	"UP",
+	"DOWN",
+	"LEFT",
+	"RIGHT",
+	"A",
+	"B",
+	"X",
+	"Y",
+	"SELECT",
+	"START",
+]);

package/src/CompositeOperations.mjs

@@ -0,0 +1,15 @@
+"use strict";
+
+export const CompositeOperations = {
+	COPY: "copy",
+	DESTINATION_ATOP: "destination-atop",
+	DESTINATION_IN: "destination-in",
+	DESTINATION_OUT: "destination-out",
+	DESTINATION_OVER: "destination-over",
+	LIGHTER: "lighter",
+	SOURCE_ATOP: "source-atop",
+	SOURCE_IN: "source-in",
+	SOURCE_OUT: "source-out",
+	SOURCE_OVER: "source-over",
+	XOR: "xor",
+};

package/src/Controller.mjs

@@ -0,0 +1,67 @@
+"use strict";
+
+import { Command } from "./Command.mjs";
+
+export class Controller {
+	constructor() {
+		this.tolerance = 0;
+		this._active = {};
+		this._device = null;
+		this._hold = {};
+		this._sequence = [];
+		this._tick = 0;
+	}
+
+	didPerform(commands) {
+		for (let i = 1; i <= commands.length; ++i) {
+			if (this._sequence[this._sequence.length - i] != commands[commands.length - i]) {
+				return false;
+			}
+		}
+
+		this._sequence = [];
+		return true;
+	}
+
+	keyDown(command) {
+		return this._active[command];
+	}
+
+	keyPush(command) {
+		return this._active[command] && !this._hold[command];
+	}
+
+	setDevice(device) {
+		this._device = device;
+	}
+
+	update() {
+		if (!this._device) {
+			return;
+		}
+
+		this._hold = {};
+		const LAST = this._active;
+		this._active = this._device.commands;
+
+		for (let i in this._active) {
+			if (LAST[i]) {
+				this._hold[i] = true;
+			}
+		}
+
+		if (this.tolerance && ++this._tick > this.tolerance) {
+			this._sequence = [];
+			this._tick = 0;
+		}
+
+		for (let i in Command) {
+			const COMMAND = Command[i];
+
+			if (this.keyPush(COMMAND)) {
+				this._sequence.push(COMMAND);
+				this._tick = 0;
+			}
+		}
+	}
+}