Merge pull request #1343 from melonjs/refactor/bootstrap-module

Move boot() to system/bootstrap.ts, auto-bootstrap from Application

Author: obiot

packages/examples/src/examples/helloWorld/ExampleHelloWorld.tsx

@@ -1,15 +1,19 @@
-import { game, Text, video } from "melonjs";
+import { Application, Text } from "melonjs";
 import { createExampleComponent } from "../utils";
 
 export const ExampleHelloWorld = createExampleComponent(() => {
-	// Initialize the video.
-	video.init(1218, 562, { parent: "screen", scale: "auto" });
+	// create a new Application instance
+	const app = new Application(1218, 562, {
+		parent: "screen",
+		scale: "auto",
+		backgroundColor: "#202020",
+	});
 
 	// set a gray background color
-	game.world.backgroundColor.parseCSS("#202020");
+	app.world.backgroundColor.parseCSS("#202020");
 
 	// add a text object in the center of the display
-	game.world.addChild(
+	app.world.addChild(
 		new Text(609, 281, {
 			font: "Arial",
 			size: 160,

packages/melonjs/CHANGELOG.md

@@ -8,16 +8,25 @@
 - Tiled: `detectObjectType()` now checks `settings.class` and `settings.name` against the factory registry before falling through to structural detection, enabling class-based dispatch for custom types
 
 ### Changed
+- Application: `new Application(width, height, options)` now auto-calls `boot()` if the engine hasn't been initialized, making it a valid standalone entry point
+- Application: `boot()` moved to `system/bootstrap.ts` — decoupled from `index.js`
+- Application: `game` singleton decoupled from barrel `index.js` — internal modules no longer import from the barrel
+- Application: new `canvas` getter, `resize()`, and `destroy()` convenience methods
+- Application: `GAME_INIT` event now passes the Application instance as parameter
+- Stage: `onResetEvent(app, ...args)` now receives the Application instance as first parameter, followed by any extra arguments from `state.change()`
 - EventEmitter: native context parameter support — `addListener(event, fn, context)` and `addListenerOnce(event, fn, context)` now accept an optional context, eliminating `.bind()` closure overhead and enabling proper `removeListener()` by original function reference
 - EventEmitter: `event.on()` and `event.once()` no longer create `.bind()` closures when a context is provided
 
 ### Fixed
+- Application: `Object.assign(defaultApplicationSettings, options)` mutated the shared defaults object in both `Application.init()` and `video.init()` — creating multiple Application instances would corrupt settings. Fixed with object spread.
+- Application: prevent white flash on load by setting a black background on the parent element when no background is defined
 - WebGLRenderer: `setBlendMode()` now tracks the `premultipliedAlpha` flag — previously only the mode name was checked, causing incorrect GL blend function when mixing PMA and non-PMA textures with the same blend mode
 - TMX: fix crash in `getObjects(false)` when a map contains an empty object group (Container.children lazily initialized)
 - EventEmitter: `removeAllListeners()` now correctly clears once-listeners (previously only cleared regular listeners)
 - Loader: fix undefined `crossOrigin` variable in script parser, unsafe regex match in video parser, missing error parameter in video/fontface error callbacks, `fetchData` Promise constructor antipattern and silent error swallowing
 
 ### Chore
+- Converted `index.js` to `index.ts` — no internal modules import from the barrel anymore
 - Minimum Node.js version is now 24.0.0 (Node 18/20 EOL, Node 22 in maintenance)
 - CI: upgrade to Node.js 24 and pnpm/action-setup v5
 - TypeScript: 5.9 → 6.0 (added explicit `rootDir` to all tsconfig.build.json)

packages/melonjs/package.json

@@ -80,8 +80,8 @@
 		"lint": "eslint src tests",
 		"build": "pnpm lint && tsx scripts/build.js && pnpm types",
 		"dist": "pnpm clean && pnpm lint && pnpm vitest run && pnpm build && pnpm doc && cp ../../README.md .",
-		"doc": "typedoc src/index.js --tsconfig tsconfig.build.json --readme DOC_README.md --hideGenerator --name 'melonJS' --navigation.includeCategories true --categorizeByGroup false",
-		"doc:watch": "typedoc src/index.js --tsconfig tsconfig.build.json --readme DOC_README.md --hideGenerator --name 'melonJS' --navigation.includeCategories true --categorizeByGroup false --watch --skipErrorChecking --preserveWatchOutput --logLevel Error",
+		"doc": "typedoc src/index.ts --tsconfig tsconfig.build.json --readme DOC_README.md --hideGenerator --name 'melonJS' --navigation.includeCategories true --categorizeByGroup false",
+		"doc:watch": "typedoc src/index.ts --tsconfig tsconfig.build.json --readme DOC_README.md --hideGenerator --name 'melonJS' --navigation.includeCategories true --categorizeByGroup false --watch --skipErrorChecking --preserveWatchOutput --logLevel Error",
 		"serve": "serve docs",
 		"prepublishOnly": "pnpm dist",
 		"clean": "tsx scripts/clean.ts",

packages/melonjs/scripts/build.ts

@@ -12,7 +12,7 @@ const banner = [
 ].join("\n");
 
 const buildOptions = {
-	entryPoints: ["src/index.js"],
+	entryPoints: ["src/index.ts"],
 	loader: {
 		".png": "dataurl",
 		".vert": "text",