bard-legends-framework 1.11.4 → 1.12.0

package/AGENTS.md

@@ -223,24 +223,71 @@ export class TitleScene extends Scene<void, TitleSceneOutputDTO> {  // <Input, O
 
 ---
 
-## Bootstrap
+## Bootstrap (Electron)
+
+The framework owns the whole Electron shell. A game has four one-liner entry files:
+
+```ts
+// src/main.ts — Electron main process
+import { ElectronApp } from 'bard-legends-framework/main';
+ElectronApp.start({ defaultWindowSize, minWindowSize, maxWindowSize });
+
+// src/preload.ts — context bridge (exposes window.api)
+import { ElectronPreload } from 'bard-legends-framework/preload';
+ElectronPreload.expose();
+```
+
+```js
+// forge.config.mjs — electron-forge build config
+import { ElectronForge } from 'bard-legends-framework/forge';
+export default ElectronForge.createForgeConfig();
+```
 
 ```ts
-import { Game, Service } from 'bard-legends-framework';
+// src/renderer.ts — the game
+import { ElectronGame, Service } from 'bard-legends-framework';
 
 // MANDATORY: register every controller and view via side-effecting import (Vite glob).
+// Globs resolve relative to the importing file, so they must stay in the game's renderer entry.
 import.meta.glob('./**/*.controller.ts', { eager: true });
 import.meta.glob('./**/*.view.ts', { eager: true });
 
-let game = new Game({ devMode, resolution: 2, maxScreenResolution });
-await game.setup({ assetDefinitions: [...SpriteAssets, ...FontAssets], spriteDefinitions: SpriteDefinitions });
+await ElectronGame.start({ resolution: 2 }, { spriteAssetDefinitions, spriteDefinitions, /* fonts, sounds */ });
 Service.get(GameCycleGateway).startGame();   // kick off the first scene via a gateway
 ```
 
+- `ElectronApp.start` runs window management, fullscreen, focus events, encrypted save-file IO and
+  quit over IPC. `ElectronPreload.expose` publishes the typed `window.api` bridge (`ElectronBridge`).
+  `ElectronGame.start` fetches `devMode`/`maxScreenResolution` from the main process, creates the
+  `Game`, awaits `setup` (asset loading), wires window focus → `Game.pause` and tab visibility →
+  `Game.freeze`, and reports the renderer ready.
+- **Custom IPC** (both directions):
+  - renderer → main: pass `ipcHandlers: { channelName: handler }` to `ElectronApp.start` and list
+    the channel in `ElectronPreload.expose({ invokes: ['channelName'] })`; it appears on
+    `window.api` as an async method.
+  - main → renderer: pass `onWindowCreated: mainWindow => { ... }` to `ElectronApp.start` and push
+    with `mainWindow.webContents.send(channel, data)`; list the channel in
+    `ElectronPreload.expose({ events: ['channelName'] })` and it appears on `window.api` as a
+    subscription method `(callback) => unsubscribe`.
+  - Type both by augmenting the `ElectronBridge` interface from any game module:
+    `declare module 'bard-legends-framework' { interface ElectronBridge { channelName(...): ...; } }`
+  - The `Game-Boilerplate` repo demonstrates both (`sendMessageToMain` invoke, `screenSize` event).
+- The `@electron-forge/*` packages (cli, makers, plugin-vite) are **dependencies of the framework**
+  — game projects keep only `electron` and `vite` as devDependencies (forge requires `electron` in
+  the app's own devDependencies).
+- Games never invoke `electron-forge` directly. The framework ships a CLI at `bin/cli.mjs` that
+  forwards to its own `@electron-forge/cli` (so the forge version always matches the framework's,
+  linked or published). Game scripts call it by path, which resolves in both modes:
+  ```json
+  "start": "set \"ENVIRONMENT=dev\" && node node_modules/bard-legends-framework/bin/cli.mjs start",
+  "build": "npm run test-full && node node_modules/bard-legends-framework/bin/cli.mjs package",
+  "build-with-installer": "npm run test-full && node node_modules/bard-legends-framework/bin/cli.mjs make",
+  "deploy": "npm run test-full && node node_modules/bard-legends-framework/bin/cli.mjs publish"
+  ```
 - `Game` is the global singleton: `Game.instance`, `Game.camera`, `Game.time`, `Game.pause`
   (a `Reducer<boolean>` — open an effect to pause), `Game.instance.screenSize`/`screenSizeCenter`
   (`PersistentNotifier<Vector>`), `setResolution`, `screenPositonToStagePosition`.
-- `setup` loads assets and must be awaited before any scene opens.
+- `setup` loads assets and must be awaited before any scene opens (`ElectronGame.start` does both).
 - If you add a module, no manual registration is needed **as long as** files keep the
   `*.controller.ts` / `*.view.ts` suffixes so the globs pick them up.
 

package/bin/cli.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { createRequire } from 'module';
+import path from 'path';
+
+let require = createRequire(import.meta.url);
+let forgePackageJsonPath = require.resolve('@electron-forge/cli/package.json');
+let forgeBinPath = path.join(path.dirname(forgePackageJsonPath), require(forgePackageJsonPath).bin['electron-forge']);
+
+spawn(process.execPath, [forgeBinPath, ...process.argv.slice(2)], { stdio: 'inherit' }).on('exit', code =>
+  process.exit(code ?? 0)
+);

package/dist/electron-main.d.mts

@@ -0,0 +1,18 @@
+import { BrowserWindow } from 'electron';
+
+interface ElectronWindowSize {
+    readonly width: number;
+    readonly height: number;
+}
+interface ElectronAppConfiguration {
+    readonly defaultWindowSize: ElectronWindowSize;
+    readonly minWindowSize: ElectronWindowSize;
+    readonly maxWindowSize: ElectronWindowSize;
+    readonly ipcHandlers?: Readonly<Record<string, (...args: never[]) => unknown>>;
+    readonly onWindowCreated?: (mainWindow: BrowserWindow) => void;
+}
+declare class ElectronApp {
+    static start(configuration: ElectronAppConfiguration): void;
+}
+
+export { ElectronApp, type ElectronAppConfiguration, type ElectronWindowSize };

package/dist/electron-main.d.ts

@@ -0,0 +1,18 @@
+import { BrowserWindow } from 'electron';
+
+interface ElectronWindowSize {
+    readonly width: number;
+    readonly height: number;
+}
+interface ElectronAppConfiguration {
+    readonly defaultWindowSize: ElectronWindowSize;
+    readonly minWindowSize: ElectronWindowSize;
+    readonly maxWindowSize: ElectronWindowSize;
+    readonly ipcHandlers?: Readonly<Record<string, (...args: never[]) => unknown>>;
+    readonly onWindowCreated?: (mainWindow: BrowserWindow) => void;
+}
+declare class ElectronApp {
+    static start(configuration: ElectronAppConfiguration): void;
+}
+
+export { ElectronApp, type ElectronAppConfiguration, type ElectronWindowSize };

package/dist/electron-main.js

@@ -0,0 +1 @@
+'use strict';var electron=require('electron'),T=require('electron-squirrel-startup'),w=require('path'),child_process=require('child_process'),p=require('crypto'),y=require('fs/promises'),V=require('write-file-atomic'),helpersLib=require('helpers-lib');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var T__default=/*#__PURE__*/_interopDefault(T);var w__default=/*#__PURE__*/_interopDefault(w);var p__default=/*#__PURE__*/_interopDefault(p);var y__default=/*#__PURE__*/_interopDefault(y);var V__default=/*#__PURE__*/_interopDefault(V);var v=Object.defineProperty;var n=(d,e)=>v(d,"name",{value:e,configurable:true});var h=class{static{n(this,"SingleAsyncQueue");}constructor(){this.ƀkt=false,this.ƀjf=new helpersLib.Queue;}async enqueue(e){let t=this.ƀjf.empty,a=new Promise((i,r)=>this.ƀjf.add({operation:e,resolve:i,reject:r}));return t&&this.ƀjt(),a}ƀjt(){if(!this.ƀkt){let e=[];for(;this.ƀjf.notEmpty;){let t=this.ƀjf.pop();t&&e.push(t);}e.length>0&&this.ƀju(e);}}ƀju(e){let t=e.pop();if(!t)throw new Error("No executing entry found");this.ƀkt=true,t.operation().then(()=>{e.forEach(a=>a.resolve()),t.resolve(),this.ƀkt=false,this.ƀjt();}).catch(a=>{t.reject(a),e.length>0?this.ƀju(e):(this.ƀkt=false,this.ƀjt());});}};var g=w__default.default.join(electron.app.getPath("userData"),"saves"),_=1,f=p__default.default.scryptSync("gdfgmhur%+/&ty@ertbdf423-secret","ga!sgnwq6^/&(roofvafnl_salt",32),c=class{static{n(this,"MainSaveLoad");}static{this.ƀdq=new Map;}static ƀev(e){let t=this.ƀdq.get(e);return t||(t=new h,this.ƀdq.set(e,t)),t}static async save(e,t){return this.ƀev(t).enqueue(()=>this.ƀlm(e,t))}static async load(e){return this.ƀjj(e)}static async ƀlm(e,t){let a=this.ƀep(),i=w__default.default.join(g,t);if(await y__default.default.mkdir(g,{recursive:true}),!e)await y__default.default.rm(i,{force:true});else {let r=this.ƀdf(e,f),s=this.ƀdf(a,f),u={version:_,data:{initializationVector:r.initializationVector,encrypted:r.encrypted,authTag:r.authTag},machineId:{initializationVector:s.initializationVector,encrypted:s.encrypted,authTag:s.authTag}};await V__default.default(i,JSON.stringify(u),{encoding:"utf-8"});}}static async ƀjj(e){let t=w__default.default.join(g,e),a;try{a=await y__default.default.readFile(t,"utf-8");}catch{return}let i=JSON.parse(a),r={version:i.version,data:{initializationVector:Buffer.from(i.data.initializationVector),encrypted:Buffer.from(i.data.encrypted),authTag:Buffer.from(i.data.authTag)},machineId:{initializationVector:Buffer.from(i.machineId.initializationVector),encrypted:Buffer.from(i.machineId.encrypted),authTag:Buffer.from(i.machineId.authTag)}},s=this.ƀct(r.data.encrypted,f,r.data.initializationVector,r.data.authTag);if(this.ƀct(r.machineId.encrypted,f,r.machineId.initializationVector,r.machineId.authTag)===this.ƀep())return s}static ƀdf(e,t){let a=p__default.default.randomBytes(12),i=p__default.default.createCipheriv("aes-256-gcm",t,a),r=Buffer.concat([i.update(e,"utf8"),i.final()]),s=i.getAuthTag();return {initializationVector:a,encrypted:r,authTag:s}}static ƀct(e,t,a,i){let r=p__default.default.createDecipheriv("aes-256-gcm",t,a);return r.setAuthTag(i),Buffer.concat([r.update(e),r.final()]).toString("utf8")}static ƀep(){return process.platform==="win32"?child_process.execSync("wmic csproduct get uuid /format:value",{encoding:"utf8"}).split("=")[1].trim():process.platform==="darwin"?child_process.execSync("ioreg -rd1 -c IOPlatformExpertDevice | awk '/IOPlatformUUID/{print $3}'",{encoding:"utf8"}).trim().replace(/"/g,""):child_process.execSync("cat /sys/class/dmi/id/product_uuid",{encoding:"utf8"}).trim()}};var I=class{static{n(this,"ElectronApp");}static start(e){process.env.ELECTRON_DISABLE_SECURITY_WARNINGS="true",T__default.default&&electron.app.quit();let t=process.env.ENVIRONMENT==="dev",a=n(()=>{let i=new electron.BrowserWindow({width:e.defaultWindowSize.width,height:e.defaultWindowSize.height,webPreferences:{preload:w__default.default.join(__dirname,"preload.js")},backgroundColor:"#000",show:false,autoHideMenuBar:true});i.once("ready-to-show",()=>{i.show();}),i.setMenu(null),MAIN_WINDOW_VITE_DEV_SERVER_URL?i.loadURL(MAIN_WINDOW_VITE_DEV_SERVER_URL):i.loadFile(w__default.default.join(__dirname,`../renderer/${MAIN_WINDOW_VITE_NAME}/index.html`)),this.ƀkm(i,e,t),e.onWindowCreated?.(i),t&&(i.setSize(1616,1616),i.setPosition(-7,0),i.webContents.openDevTools());},"createWindow");electron.app.on("ready",a),electron.app.on("window-all-closed",()=>{process.platform!=="darwin"&&electron.app.quit();}),electron.app.on("activate",()=>{electron.BrowserWindow.getAllWindows().length===0&&a();});}static ƀkm(e,t,a){electron.ipcMain.handle("save",async(i,r,s)=>{await c.save(r,s);}),electron.ipcMain.handle("load",async(i,r)=>c.load(r)),electron.ipcMain.handle("getOptions",async()=>({devMode:a,maxScreenResolution:t.maxWindowSize})),Object.entries(t.ipcHandlers??{}).forEach(([i,r])=>{electron.ipcMain.handle(i,(s,...u)=>r(...u));}),e.on("focus",()=>{e.webContents.send("onWindowFocus",true);}),e.on("blur",()=>{e.webContents.send("onWindowFocus",false);}),electron.ipcMain.on("rendererReady",()=>{e.webContents.send("onWindowFocus",e.isFocused());}),electron.ipcMain.on("setFullScreen",(i,r)=>{r?(e.setResizable(false),e.setMaximumSize(0,0),e.setFullScreen(true),e.setMovable(false),e.setMaximizable(false),e.setMinimizable(false),e.setMenuBarVisibility(false)):(e.setFullScreen(false),e.setResizable(true),a||(e.setMaximumSize(t.maxWindowSize.width,t.maxWindowSize.height),e.setMinimumSize(t.minWindowSize.width,t.minWindowSize.height),e.setSize(t.defaultWindowSize.width,t.defaultWindowSize.height),e.center()),e.setMovable(true),e.setMaximizable(true),e.setMinimizable(true),e.setMenuBarVisibility(true));}),electron.ipcMain.on("quit",()=>{electron.app.quit();});}};exports.ElectronApp=I;

package/dist/electron-main.mjs

@@ -0,0 +1 @@
+import {app,BrowserWindow,ipcMain}from'electron';import T from'electron-squirrel-startup';import w from'path';import {execSync}from'child_process';import p from'crypto';import y from'fs/promises';import V from'write-file-atomic';import {Queue}from'helpers-lib';var v=Object.defineProperty;var n=(d,e)=>v(d,"name",{value:e,configurable:true});var h=class{static{n(this,"SingleAsyncQueue");}constructor(){this.ƀkt=false,this.ƀjf=new Queue;}async enqueue(e){let t=this.ƀjf.empty,a=new Promise((i,r)=>this.ƀjf.add({operation:e,resolve:i,reject:r}));return t&&this.ƀjt(),a}ƀjt(){if(!this.ƀkt){let e=[];for(;this.ƀjf.notEmpty;){let t=this.ƀjf.pop();t&&e.push(t);}e.length>0&&this.ƀju(e);}}ƀju(e){let t=e.pop();if(!t)throw new Error("No executing entry found");this.ƀkt=true,t.operation().then(()=>{e.forEach(a=>a.resolve()),t.resolve(),this.ƀkt=false,this.ƀjt();}).catch(a=>{t.reject(a),e.length>0?this.ƀju(e):(this.ƀkt=false,this.ƀjt());});}};var g=w.join(app.getPath("userData"),"saves"),_=1,f=p.scryptSync("gdfgmhur%+/&ty@ertbdf423-secret","ga!sgnwq6^/&(roofvafnl_salt",32),c=class{static{n(this,"MainSaveLoad");}static{this.ƀdq=new Map;}static ƀev(e){let t=this.ƀdq.get(e);return t||(t=new h,this.ƀdq.set(e,t)),t}static async save(e,t){return this.ƀev(t).enqueue(()=>this.ƀlm(e,t))}static async load(e){return this.ƀjj(e)}static async ƀlm(e,t){let a=this.ƀep(),i=w.join(g,t);if(await y.mkdir(g,{recursive:true}),!e)await y.rm(i,{force:true});else {let r=this.ƀdf(e,f),s=this.ƀdf(a,f),u={version:_,data:{initializationVector:r.initializationVector,encrypted:r.encrypted,authTag:r.authTag},machineId:{initializationVector:s.initializationVector,encrypted:s.encrypted,authTag:s.authTag}};await V(i,JSON.stringify(u),{encoding:"utf-8"});}}static async ƀjj(e){let t=w.join(g,e),a;try{a=await y.readFile(t,"utf-8");}catch{return}let i=JSON.parse(a),r={version:i.version,data:{initializationVector:Buffer.from(i.data.initializationVector),encrypted:Buffer.from(i.data.encrypted),authTag:Buffer.from(i.data.authTag)},machineId:{initializationVector:Buffer.from(i.machineId.initializationVector),encrypted:Buffer.from(i.machineId.encrypted),authTag:Buffer.from(i.machineId.authTag)}},s=this.ƀct(r.data.encrypted,f,r.data.initializationVector,r.data.authTag);if(this.ƀct(r.machineId.encrypted,f,r.machineId.initializationVector,r.machineId.authTag)===this.ƀep())return s}static ƀdf(e,t){let a=p.randomBytes(12),i=p.createCipheriv("aes-256-gcm",t,a),r=Buffer.concat([i.update(e,"utf8"),i.final()]),s=i.getAuthTag();return {initializationVector:a,encrypted:r,authTag:s}}static ƀct(e,t,a,i){let r=p.createDecipheriv("aes-256-gcm",t,a);return r.setAuthTag(i),Buffer.concat([r.update(e),r.final()]).toString("utf8")}static ƀep(){return process.platform==="win32"?execSync("wmic csproduct get uuid /format:value",{encoding:"utf8"}).split("=")[1].trim():process.platform==="darwin"?execSync("ioreg -rd1 -c IOPlatformExpertDevice | awk '/IOPlatformUUID/{print $3}'",{encoding:"utf8"}).trim().replace(/"/g,""):execSync("cat /sys/class/dmi/id/product_uuid",{encoding:"utf8"}).trim()}};var I=class{static{n(this,"ElectronApp");}static start(e){process.env.ELECTRON_DISABLE_SECURITY_WARNINGS="true",T&&app.quit();let t=process.env.ENVIRONMENT==="dev",a=n(()=>{let i=new BrowserWindow({width:e.defaultWindowSize.width,height:e.defaultWindowSize.height,webPreferences:{preload:w.join(__dirname,"preload.js")},backgroundColor:"#000",show:false,autoHideMenuBar:true});i.once("ready-to-show",()=>{i.show();}),i.setMenu(null),MAIN_WINDOW_VITE_DEV_SERVER_URL?i.loadURL(MAIN_WINDOW_VITE_DEV_SERVER_URL):i.loadFile(w.join(__dirname,`../renderer/${MAIN_WINDOW_VITE_NAME}/index.html`)),this.ƀkm(i,e,t),e.onWindowCreated?.(i),t&&(i.setSize(1616,1616),i.setPosition(-7,0),i.webContents.openDevTools());},"createWindow");app.on("ready",a),app.on("window-all-closed",()=>{process.platform!=="darwin"&&app.quit();}),app.on("activate",()=>{BrowserWindow.getAllWindows().length===0&&a();});}static ƀkm(e,t,a){ipcMain.handle("save",async(i,r,s)=>{await c.save(r,s);}),ipcMain.handle("load",async(i,r)=>c.load(r)),ipcMain.handle("getOptions",async()=>({devMode:a,maxScreenResolution:t.maxWindowSize})),Object.entries(t.ipcHandlers??{}).forEach(([i,r])=>{ipcMain.handle(i,(s,...u)=>r(...u));}),e.on("focus",()=>{e.webContents.send("onWindowFocus",true);}),e.on("blur",()=>{e.webContents.send("onWindowFocus",false);}),ipcMain.on("rendererReady",()=>{e.webContents.send("onWindowFocus",e.isFocused());}),ipcMain.on("setFullScreen",(i,r)=>{r?(e.setResizable(false),e.setMaximumSize(0,0),e.setFullScreen(true),e.setMovable(false),e.setMaximizable(false),e.setMinimizable(false),e.setMenuBarVisibility(false)):(e.setFullScreen(false),e.setResizable(true),a||(e.setMaximumSize(t.maxWindowSize.width,t.maxWindowSize.height),e.setMinimumSize(t.minWindowSize.width,t.minWindowSize.height),e.setSize(t.defaultWindowSize.width,t.defaultWindowSize.height),e.center()),e.setMovable(true),e.setMaximizable(true),e.setMinimizable(true),e.setMenuBarVisibility(true));}),ipcMain.on("quit",()=>{app.quit();});}};export{I as ElectronApp};

package/dist/electron-preload.d.mts

@@ -0,0 +1,9 @@
+interface ElectronCustomChannels {
+    readonly invokes?: readonly string[];
+    readonly events?: readonly string[];
+}
+declare class ElectronPreload {
+    static expose(customChannels?: ElectronCustomChannels): void;
+}
+
+export { type ElectronCustomChannels, ElectronPreload };

package/dist/electron-preload.d.ts

@@ -0,0 +1,9 @@
+interface ElectronCustomChannels {
+    readonly invokes?: readonly string[];
+    readonly events?: readonly string[];
+}
+declare class ElectronPreload {
+    static expose(customChannels?: ElectronCustomChannels): void;
+}
+
+export { type ElectronCustomChannels, ElectronPreload };

package/dist/electron-preload.js

@@ -0,0 +1 @@
+'use strict';var electron=require('electron');var p=Object.defineProperty;var n=(s,o)=>p(s,"name",{value:o,configurable:true});var u=class{static{n(this,"ElectronPreload");}static expose(o={}){let v=Object.fromEntries((o.invokes??[]).map(e=>[e,(...r)=>electron.ipcRenderer.invoke(e,...r)])),a=Object.fromEntries((o.events??[]).map(e=>[e,r=>{let i=n((d,c)=>r(c),"handler");return electron.ipcRenderer.on(e,i),()=>{electron.ipcRenderer.removeListener(e,i);}}]));electron.contextBridge.exposeInMainWorld("api",{...v,...a,save:n(async function(e,r){return electron.ipcRenderer.invoke("save",e,r)},"save"),load:n(async function(e){return electron.ipcRenderer.invoke("load",e)},"load"),getOptions:n(async function(){return electron.ipcRenderer.invoke("getOptions")},"getOptions"),setFullScreen:n(e=>electron.ipcRenderer.send("setFullScreen",e),"setFullScreen"),rendererReady:n(()=>electron.ipcRenderer.send("rendererReady"),"rendererReady"),onWindowFocus:n(e=>{let r=n((i,d)=>e(d),"handler");return electron.ipcRenderer.on("onWindowFocus",r),()=>{electron.ipcRenderer.removeListener("onWindowFocus",r);}},"onWindowFocus"),quit:n(()=>electron.ipcRenderer.send("quit"),"quit")});}};exports.ElectronPreload=u;

package/dist/electron-preload.mjs

@@ -0,0 +1 @@
+import {ipcRenderer,contextBridge}from'electron';var p=Object.defineProperty;var n=(s,o)=>p(s,"name",{value:o,configurable:true});var u=class{static{n(this,"ElectronPreload");}static expose(o={}){let v=Object.fromEntries((o.invokes??[]).map(e=>[e,(...r)=>ipcRenderer.invoke(e,...r)])),a=Object.fromEntries((o.events??[]).map(e=>[e,r=>{let i=n((d,c)=>r(c),"handler");return ipcRenderer.on(e,i),()=>{ipcRenderer.removeListener(e,i);}}]));contextBridge.exposeInMainWorld("api",{...v,...a,save:n(async function(e,r){return ipcRenderer.invoke("save",e,r)},"save"),load:n(async function(e){return ipcRenderer.invoke("load",e)},"load"),getOptions:n(async function(){return ipcRenderer.invoke("getOptions")},"getOptions"),setFullScreen:n(e=>ipcRenderer.send("setFullScreen",e),"setFullScreen"),rendererReady:n(()=>ipcRenderer.send("rendererReady"),"rendererReady"),onWindowFocus:n(e=>{let r=n((i,d)=>e(d),"handler");return ipcRenderer.on("onWindowFocus",r),()=>{ipcRenderer.removeListener("onWindowFocus",r);}},"onWindowFocus"),quit:n(()=>ipcRenderer.send("quit"),"quit")});}};export{u as ElectronPreload};

package/dist/index.d.mts

@@ -1,8 +1,21 @@
 import * as actions_lib from 'actions-lib';
-import { IDAttachable, AttachmentID, Attachable, IdleSingleEvent, IdleSequence, Variable, Reducer, Sequence, SingleNotifier, Notifier, SingleEvent, Action, ClassID, NotifierCallbackFunction, IAttachment } from 'actions-lib';
+import { IdleSingleEvent, IDAttachable, AttachmentID, Attachable, IdleSequence, Variable, Reducer, Sequence, SingleNotifier, Notifier, SingleEvent, Action, ClassID, NotifierCallbackFunction, IAttachment } from 'actions-lib';
 import { Vector, DynamicID, Vec2, RGBColor, Radian, Rectangle, Grid, GridNeighborType, Line } from 'helpers-lib';
-import p2$1 from 'p2';
 import * as Pixi from 'pixi.js';
+import p2$1 from 'p2';
+import { LayoutStyles } from '@pixi/layout';
+
+type AudioAppearTransitionType = 'ease' | 'instant';
+declare const SOUND_TRANSITION_DURATION = 1000;
+declare class Audio {
+    private constructor();
+    setVolumes(volumes: {
+        master: number;
+        music: number;
+        sound: number;
+    }): void;
+    appear(on: boolean, type?: AudioAppearTransitionType): IdleSingleEvent;
+}
 
 /**
  * Binds a controller to its gateway (the class produced by `Gateway<T>()`). The controller must
@@ -158,18 +171,6 @@ declare abstract class View extends IDAttachable {
     update: (time: number, delta: number) => void;
 }
 
-type AudioAppearTransitionType = 'ease' | 'instant';
-declare const SOUND_TRANSITION_DURATION = 1000;
-declare class Audio {
-    private constructor();
-    setVolumes(volumes: {
-        master: number;
-        music: number;
-        sound: number;
-    }): void;
-    appear(on: boolean, type?: AudioAppearTransitionType): IdleSingleEvent;
-}
-
 interface FocusingNewTargetInfo {
     time: number;
     duration: number;
@@ -322,9 +323,14 @@ declare class Game {
     readonly devMode: boolean;
     constructor(partialConfiguration?: Partial<GameConfiguration>);
     setup(setupOptions: GameSetupOptions): Promise<void>;
+    generateTexture(options: Pixi.GenerateTextureOptions | Pixi.Container): Pixi.Texture;
     setResolution(resolution: number): void;
 }
 
+declare class ElectronGame {
+    static start(configuration: Partial<Omit<GameConfiguration, 'devMode' | 'maxScreenResolution'>>, setupOptions: GameSetupOptions): Promise<Game>;
+}
+
 interface SoundOptions {
     readonly time?: number;
     readonly volume?: number;
@@ -407,40 +413,17 @@ declare class MusicPlayer extends IDAttachable {
     close(): IdleSingleEvent;
 }
 
-declare enum ContainerEventType {
-    Click = "click",
-    MouseOver = "mouseover",
-    MouseOut = "mouseout",
-    PointerDown = "pointerdown",
-    PointerUp = "pointerup",
-    PointerUpOutside = "pointerupoutside",
-    PointerMove = "pointermove",
-    PointerCancel = "pointercancel",
-    PointerOver = "pointerover",
-    PointerOut = "pointerout",
-    PointerEnter = "pointerenter",
-    PointerLeave = "pointerleave",
-    Added = "added",
-    Removed = "removed",
-    Update = "update",
-    Change = "change",
-    Wheel = "wheel"
+interface PixiDisplayObject {
+    x: number;
+    y: number;
+    rotation: number;
+    alpha: number;
 }
-type ContainerEventTypeToResultType = {
-    [K in ContainerEventType]: K extends ContainerEventType.Wheel ? {
-        deltaY: number;
-    } : undefined;
-};
-declare enum Cursor {
-    Default = "default",
-    Pointer = "pointer"
-}
-declare abstract class ContainerAttributes extends IDAttachable {
-    protected constructor();
-    get size(): Vector;
-    set size(value: Vector);
-    getSize(): Vector;
-    setSize(value: Vector): this;
+declare abstract class DisplayObjectAttributes extends IDAttachable {
+    protected readonly _pixiDisplayObject: PixiDisplayObject;
+    protected constructor(_pixiDisplayObject: PixiDisplayObject);
+    protected abstract _applyScale(x: number, y: number): void;
+    protected abstract _getHoldFromModifier(holdFrom: Vector): Vector;
     /**
      * @param value The position to set
      * @param options.holdFrom An anchor point to hold the position from
@@ -457,7 +440,6 @@ declare abstract class ContainerAttributes extends IDAttachable {
     set x(value: number);
     get y(): number;
     set y(value: number);
-    on<T extends ContainerEventType>(eventType: T): Sequence<ContainerEventTypeToResultType[T]>;
     setRotation(value: Radian): this;
     get rotation(): Radian;
     set rotation(value: Radian);
@@ -466,38 +448,9 @@ declare abstract class ContainerAttributes extends IDAttachable {
      */
     get rotationValue(): number;
     set rotationValue(value: number);
-    setZIndex(value: number): this;
-    get zIndex(): number;
-    set zIndex(value: number);
-    setSkewX(radian: Radian): this;
-    get skewX(): Radian;
-    set skewX(radian: Radian);
-    setSkewY(radian: Radian): this;
-    get skewY(): Radian;
-    set skewY(radian: Radian);
-    setSortableChildren(value: boolean): this;
-    get sortableChildren(): boolean;
-    set sortableChildren(value: boolean);
     setAlpha(value: number): this;
     get alpha(): number;
     set alpha(value: number);
-    setInteractive(value: boolean): this;
-    get interactive(): boolean;
-    set interactive(value: boolean);
-    /**
-     * Renders this subtree as an isolated render group: its cached render instructions are not
-     * rebuilt when other parts of the scene change, and moving the group only updates one transform.
-     * Use for subtrees that move as a whole (world under a camera) or rarely change (HUD vs world).
-     */
-    setRenderGroup(value?: boolean): this;
-    setCursor(value: Cursor): this;
-    get cursor(): Cursor;
-    set cursor(value: Cursor);
-    protected getMask(): Pixi.Container;
-    setMask(mask: ContainerAttributes | undefined): this;
-    hitTest(stagePosition: Vector): boolean;
-    get boundingBox(): Rectangle;
-    ignoreBounds(value?: boolean): this;
     setMirror(mirror?: boolean): this;
     get mirror(): boolean;
     set mirror(value: boolean);
@@ -572,11 +525,40 @@ declare class Sprite extends Container {
     download(): this;
 }
 
+type LayoutStyle = LayoutStyles;
+declare enum ContainerEventType {
+    Click = "click",
+    MouseOver = "mouseover",
+    MouseOut = "mouseout",
+    PointerDown = "pointerdown",
+    PointerUp = "pointerup",
+    PointerUpOutside = "pointerupoutside",
+    PointerMove = "pointermove",
+    PointerCancel = "pointercancel",
+    PointerOver = "pointerover",
+    PointerOut = "pointerout",
+    PointerEnter = "pointerenter",
+    PointerLeave = "pointerleave",
+    Added = "added",
+    Removed = "removed",
+    Update = "update",
+    Change = "change",
+    Wheel = "wheel"
+}
+type ContainerEventTypeToResultType = {
+    [K in ContainerEventType]: K extends ContainerEventType.Wheel ? {
+        deltaY: number;
+    } : undefined;
+};
+declare enum Cursor {
+    Default = "default",
+    Pointer = "pointer"
+}
 interface SetParentOptions {
     addUnder: boolean;
     cropOverflowingParts: boolean;
 }
-declare class Container extends ContainerAttributes {
+declare class Container extends DisplayObjectAttributes {
     protected static allContainers: Map<number, Container>;
     readonly filters: Filters;
     protected addChildTo: Container;
@@ -584,8 +566,50 @@ declare class Container extends ContainerAttributes {
         addUnder: boolean;
         cropOverflowingParts: boolean;
     };
-    constructor();
+    constructor(pixiContainer?: Pixi.Container);
     destroy(): void;
+    protected _applyScale(x: number, y: number): void;
+    protected _getHoldFromModifier(holdFrom: Vector): Vector;
+    get size(): Vector;
+    set size(value: Vector);
+    getSize(): Vector;
+    setSize(value: Vector): this;
+    /**
+     * Makes this object a flex item of a LayoutContainer parent, treated as a box measured by its bounds.
+     * @param style Optional per-item overrides (alignSelf, margins, width, height...)
+     * @returns this
+     */
+    setLayout(style?: LayoutStyle): this;
+    on<T extends ContainerEventType>(eventType: T): Sequence<ContainerEventTypeToResultType[T]>;
+    setZIndex(value: number): this;
+    get zIndex(): number;
+    set zIndex(value: number);
+    setSkewX(radian: Radian): this;
+    get skewX(): Radian;
+    set skewX(radian: Radian);
+    setSkewY(radian: Radian): this;
+    get skewY(): Radian;
+    set skewY(radian: Radian);
+    setSortableChildren(value: boolean): this;
+    get sortableChildren(): boolean;
+    set sortableChildren(value: boolean);
+    setInteractive(value: boolean): this;
+    get interactive(): boolean;
+    set interactive(value: boolean);
+    /**
+     * Renders this subtree as an isolated render group: its cached render instructions are not
+     * rebuilt when other parts of the scene change, and moving the group only updates one transform.
+     * Use for subtrees that move as a whole (world under a camera) or rarely change (HUD vs world).
+     */
+    setRenderGroup(value?: boolean): this;
+    setCursor(value: Cursor): this;
+    get cursor(): Cursor;
+    set cursor(value: Cursor);
+    protected getMask(): Pixi.Container;
+    setMask(mask: Container | undefined): this;
+    hitTest(stagePosition: Vector): boolean;
+    get boundingBox(): Rectangle;
+    ignoreBounds(value?: boolean): this;
     getBoundingMask(): Sprite;
     displayParent(parent: Container | number, partialOptions?: Partial<SetParentOptions>): this;
 }
@@ -982,6 +1006,16 @@ declare class ScrollMaskUI extends Container {
     constructor(container: Container, size: Vector, padding: number, direction?: ScrollDirection);
 }
 
+/**
+ * A flexbox container.
+ */
+declare class LayoutContainer extends Container {
+    constructor(style?: LayoutStyle);
+    setLayout(style: LayoutStyle): this;
+    debug(): this;
+    debugBackground(): this;
+}
+
 interface KeyboardKeyInfo {
     readonly key: string;
     readonly code: string;
@@ -1342,4 +1376,26 @@ declare abstract class MovablePhysicsEntity extends PhysicsEntity {
     convertToDTO(): PhysicsBodyDTO;
 }
 
-export { AdvancedSound, type AdvancedSoundOptions, AnimationFlicker, AnimationInterpolationFunctions, type AnimationOptions, Animations, AnimationsCompletionHandlingType, Animator, type AnimatorAnimation, type AssetDefinition, type AudioAppearTransitionType, BORDER_MATERIAL_NAME, BardLegendsTestingHelper, type BlendMode, type BorderProperties, Camera, CameraGateway, type CircleShapeData, ClosestAvailableSpaceHelper, type CollisionDetails, type CollisionReport, Container, ContainerEventType, ControllerDecorator, type CreateDashedLineOptions, type CreatePhysicsWorldRequestDTO, Cursor, DEFAULT_SHADER_RESOLUTION, DeltaTime, DisplayObjectArray, type DisplayObjectArrayOptions, type DropShadowOptions, Entity, EntityDecorator, type EntityID, type ExplosionHit, FadeInContent, type FadeInContentOptions, FocusingAnimation, Game, Gateway, type GlowEffectOptions, type GlowOptions, type GlowingShapeDefinition, Graphics, type HitTestOptions, ImmovablePhysicsEntity, type InteractingBodyGroups, type KeyboardKeyInfo, KeyboardService, type MapSizeDTO, type MaterialContactDefinition, type MaterialDefinition, MenuEntity, type MenuOptions, MenuUI, MenuView, MouseService, MouseTargetFocusService, MovableEntity, MovablePhysicsEntity, Music, MusicPlayer, type MusicPlayerOptions, type PartialTextOptions, PathFinder, type PathFinderResult, type PhysicsBodyDTO, PhysicsEntity, type PhysicsEntityDefinition, type PhysicsExplosionOptions, PhysicsGateway, PhysicsShapeType, type PhysicsWorldID, Placeholder, type PolygonDefinition, type PolygonShapeData, ROTATIONAL_SPEED_LIMIT, type RayCast, type RayCastHit, ReAnimateHandlingType, type RectangleShapeData, RichText, type RichTextOptions, type RichTextRectangleCut, type RichTextStyles, SOUND_TRANSITION_DURATION, SPEED_LIMIT, Scene, SceneDecorator, ScrollAreaUI, ScrollDirection, type ScrollInContentOptions, ScrollMaskUI, Service, ServiceDecorator, type SetParentOptions, type ShapeDefinition, SingletonEntity, SlideInContent, SlideInContentByIndex, SlideStateAnimation, SlideStateAnimationState, Sound, type SoundDefinition, type SoundID, type SoundIDRegistry, type SoundOptions, Sprite, type SpriteDefinition, type SpriteID, type SpriteIDRegistry, StateAnimation, type StateAnimationOptions, type StateAnimationState, Text, type TextAlignment, type TextOptions, ThroughEmptyStateAnimation, UpdatableContainer, UpdateCycle, VectorFieldPathFinder, VectorSet, View, ViewDecorator, type ViewDecoratorMeta };
+interface ElectronAppOptions {
+    readonly devMode: boolean;
+    readonly maxScreenResolution: {
+        readonly width: number;
+        readonly height: number;
+    } | undefined;
+}
+interface ElectronBridge {
+    save(data: string | undefined, fileName: string): Promise<void>;
+    load(fileName: string): Promise<string | undefined>;
+    getOptions(): Promise<ElectronAppOptions>;
+    setFullScreen(fullScreen: boolean): void;
+    rendererReady(): void;
+    onWindowFocus(callback: (focused: boolean) => void): () => void;
+    quit(): void;
+}
+declare global {
+    interface Window {
+        api: ElectronBridge;
+    }
+}
+
+export { AdvancedSound, type AdvancedSoundOptions, AnimationFlicker, AnimationInterpolationFunctions, type AnimationOptions, Animations, AnimationsCompletionHandlingType, Animator, type AnimatorAnimation, type AssetDefinition, type AudioAppearTransitionType, BORDER_MATERIAL_NAME, BardLegendsTestingHelper, type BlendMode, type BorderProperties, Camera, CameraGateway, type CircleShapeData, ClosestAvailableSpaceHelper, type CollisionDetails, type CollisionReport, Container, ContainerEventType, ControllerDecorator, type CreateDashedLineOptions, type CreatePhysicsWorldRequestDTO, Cursor, DEFAULT_SHADER_RESOLUTION, DeltaTime, DisplayObjectArray, type DisplayObjectArrayOptions, type DropShadowOptions, type ElectronAppOptions, type ElectronBridge, ElectronGame, Entity, EntityDecorator, type EntityID, type ExplosionHit, FadeInContent, type FadeInContentOptions, FocusingAnimation, Game, Gateway, type GlowEffectOptions, type GlowOptions, type GlowingShapeDefinition, Graphics, type HitTestOptions, ImmovablePhysicsEntity, type InteractingBodyGroups, type KeyboardKeyInfo, KeyboardService, LayoutContainer, type LayoutStyle, type MapSizeDTO, type MaterialContactDefinition, type MaterialDefinition, MenuEntity, type MenuOptions, MenuUI, MenuView, MouseService, MouseTargetFocusService, MovableEntity, MovablePhysicsEntity, Music, MusicPlayer, type MusicPlayerOptions, type PartialTextOptions, PathFinder, type PathFinderResult, type PhysicsBodyDTO, PhysicsEntity, type PhysicsEntityDefinition, type PhysicsExplosionOptions, PhysicsGateway, PhysicsShapeType, type PhysicsWorldID, Placeholder, type PolygonDefinition, type PolygonShapeData, ROTATIONAL_SPEED_LIMIT, type RayCast, type RayCastHit, ReAnimateHandlingType, type RectangleShapeData, RichText, type RichTextOptions, type RichTextRectangleCut, type RichTextStyles, SOUND_TRANSITION_DURATION, SPEED_LIMIT, Scene, SceneDecorator, ScrollAreaUI, ScrollDirection, type ScrollInContentOptions, ScrollMaskUI, Service, ServiceDecorator, type SetParentOptions, type ShapeDefinition, SingletonEntity, SlideInContent, SlideInContentByIndex, SlideStateAnimation, SlideStateAnimationState, Sound, type SoundDefinition, type SoundID, type SoundIDRegistry, type SoundOptions, Sprite, type SpriteDefinition, type SpriteID, type SpriteIDRegistry, StateAnimation, type StateAnimationOptions, type StateAnimationState, Text, type TextAlignment, type TextOptions, ThroughEmptyStateAnimation, UpdatableContainer, UpdateCycle, VectorFieldPathFinder, VectorSet, View, ViewDecorator, type ViewDecoratorMeta };