@wasm-gaming/fbneo-wasm 0.1.0

package/dist/fbneo/fbneo.manifest.d.ts

@@ -0,0 +1,4 @@
+import type { EngineManifest } from '@wasm-gaming/engine-specs';
+export declare const manifest: EngineManifest;
+export default manifest;
+//# sourceMappingURL=fbneo.manifest.d.ts.map

package/dist/fbneo/fbneo.manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fbneo.manifest.d.ts","sourceRoot":"","sources":["../../src/fbneo.manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,eAAO,MAAM,QAAQ,EAAE,cAgCtB,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/fbneo/fbneo.manifest.js

@@ -0,0 +1,33 @@
+import { FBNEO_OPTIONS_SCHEMA } from './fbneo.options.js';
+export const manifest = {
+    id: 'fbneo',
+    version: '0.1.0',
+    name: 'FinalBurn Neo (WebAssembly)',
+    description: 'FBNeo arcade emulator (Capcom CPS-1/2/3, SNK Neo Geo, Sega System 16, and more) compiled to WebAssembly.',
+    artifacts: {
+        wasm: 'fbneo/fbneo.wasm',
+        js: 'fbneo/fbneo.js',
+    },
+    assets: [
+        {
+            key: 'rom',
+            mountPath: '/roms/game.zip',
+            required: true,
+            accept: ['.zip', '.7z'],
+            description: 'Arcade ROM set (zip) written to Emscripten MEMFS. FBNeo identifies the game by the zip filename.',
+        },
+        {
+            key: 'bios',
+            mountPath: '/roms/neogeo.zip',
+            required: false,
+            accept: ['.zip'],
+            description: 'Optional system BIOS set (e.g. neogeo.zip for Neo Geo, or a CPS-3 BIOS). Required only by ROM sets that depend on it.',
+        },
+    ],
+    input: 'fbneo',
+    video: { baseWidth: 384, baseHeight: 224, aspect: '4:3' },
+    options: FBNEO_OPTIONS_SCHEMA,
+    capabilities: { saveStates: false, sram: false, coreSelectable: false },
+};
+export default manifest;
+//# sourceMappingURL=fbneo.manifest.js.map

package/dist/fbneo/fbneo.manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fbneo.manifest.js","sourceRoot":"","sources":["../../src/fbneo.manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,EAAE,EAAE,OAAO;IACX,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,0GAA0G;IAC5G,SAAS,EAAE;QACT,IAAI,EAAE,kBAAkB;QACxB,EAAE,EAAE,gBAAgB;KACrB;IACD,MAAM,EAAE;QACN;YACE,GAAG,EAAE,KAAK;YACV,SAAS,EAAE,gBAAgB;YAC3B,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;YACvB,WAAW,EACT,kGAAkG;SACrG;QACD;YACE,GAAG,EAAE,MAAM;YACX,SAAS,EAAE,kBAAkB;YAC7B,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,CAAC,MAAM,CAAC;YAChB,WAAW,EACT,uHAAuH;SAC1H;KACF;IACD,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE;IACzD,OAAO,EAAE,oBAAoB;IAC7B,YAAY,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE;CACxE,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/fbneo/fbneo.options.d.ts

@@ -0,0 +1,27 @@
+import type { JSONSchema } from '@wasm-gaming/engine-specs';
+export interface FbneoOptions {
+    /**
+     * Filename used when writing the ROM zip bytes to Emscripten MEMFS.
+     * FBNeo identifies a game by the zip filename (without extension), so this
+     * should match the driver's expected ROM set name (e.g. "mslug" for Metal Slug).
+     */
+    romFileName?: string;
+    /**
+     * The FBNeo driver/game name to load (e.g. "mslug", "sf2", "kof98").
+     * If omitted, the driver is inferred from `romFileName` (without extension).
+     */
+    driver?: string;
+    /** Canvas scaling filter: `pixelated` for crisp pixels, `smooth` for linear filtering. */
+    renderFilter?: 'pixelated' | 'smooth';
+    /** Target audio sample rate in Hz. FBNeo defaults to 44100. */
+    audioSampleRate?: number;
+    /** Enable vertical sync. Defaults to true. */
+    vsync?: boolean;
+    /** Use integer scaling (no fractional stretching). Defaults to false. */
+    integerScale?: boolean;
+    /** Window scale multiplier for the internal render resolution. Defaults to 2. */
+    windowScale?: number;
+}
+export declare const DEFAULT_FBNEO_OPTIONS: Required<FbneoOptions>;
+export declare const FBNEO_OPTIONS_SCHEMA: JSONSchema;
+//# sourceMappingURL=fbneo.options.d.ts.map

package/dist/fbneo/fbneo.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fbneo.options.d.ts","sourceRoot":"","sources":["../../src/fbneo.options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IACtC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAQxD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,UA8ClC,CAAC"}

package/dist/fbneo/fbneo.options.js

@@ -0,0 +1,56 @@
+export const DEFAULT_FBNEO_OPTIONS = {
+    romFileName: 'game.zip',
+    driver: '',
+    renderFilter: 'pixelated',
+    audioSampleRate: 44100,
+    vsync: true,
+    integerScale: false,
+    windowScale: 2,
+};
+export const FBNEO_OPTIONS_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        romFileName: {
+            type: 'string',
+            default: 'game.zip',
+            description: 'ROM zip filename written to Emscripten MEMFS when loading a game.',
+        },
+        driver: {
+            type: 'string',
+            default: '',
+            description: 'FBNeo driver/game name to load (e.g. "mslug"). If empty, inferred from romFileName without extension.',
+        },
+        renderFilter: {
+            type: 'string',
+            enum: ['pixelated', 'smooth'],
+            default: 'pixelated',
+            description: 'Canvas scaling filter: pixelated for crisp pixels, smooth for linear filtering.',
+        },
+        audioSampleRate: {
+            type: 'integer',
+            default: 44100,
+            minimum: 11025,
+            maximum: 96000,
+            description: 'Target audio sample rate in Hz.',
+        },
+        vsync: {
+            type: 'boolean',
+            default: true,
+            description: 'Enable vertical sync.',
+        },
+        integerScale: {
+            type: 'boolean',
+            default: false,
+            description: 'Use integer scaling (no fractional stretching).',
+        },
+        windowScale: {
+            type: 'integer',
+            default: 2,
+            minimum: 1,
+            maximum: 8,
+            description: 'Window scale multiplier for the internal render resolution.',
+        },
+    },
+};
+//# sourceMappingURL=fbneo.options.js.map

package/dist/fbneo/fbneo.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fbneo.options.js","sourceRoot":"","sources":["../../src/fbneo.options.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,EAAE;IACV,YAAY,EAAE,WAAW;IACzB,eAAe,EAAE,KAAK;IACtB,KAAK,EAAE,IAAI;IACX,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAe;IAC9C,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,UAAU;YACnB,WAAW,EAAE,mEAAmE;SACjF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,EAAE;YACX,WAAW,EACT,uGAAuG;SAC1G;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;YAC7B,OAAO,EAAE,WAAW;YACpB,WAAW,EAAE,iFAAiF;SAC/F;QACD,eAAe,EAAE;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,iCAAiC;SAC/C;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,uBAAuB;SACrC;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,iDAAiD;SAC/D;QACD,WAAW,EAAE;YACX,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,6DAA6D;SAC3E;KACF;CACF,CAAC"}

package/dist/fbneo/fbneo.sdk.d.ts

@@ -0,0 +1,10 @@
+import type { EngineConfig, EngineInstance } from '@wasm-gaming/engine-specs';
+import { manifest } from './fbneo.manifest.js';
+export { manifest };
+export declare function load(config: EngineConfig): Promise<EngineInstance>;
+declare const _default: {
+    manifest: import("@wasm-gaming/engine-specs").EngineManifest;
+    load: typeof load;
+};
+export default _default;
+//# sourceMappingURL=fbneo.sdk.d.ts.map

package/dist/fbneo/fbneo.sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fbneo.sdk.d.ts","sourceRoot":"","sources":["../../src/fbneo.sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAEZ,cAAc,EAGf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,OAAO,EAAE,QAAQ,EAAE,CAAC;AAyGpB,wBAAsB,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAyIxE;;;;;AAED,wBAAkC"}

package/dist/fbneo/fbneo.sdk.js

@@ -0,0 +1,199 @@
+import { manifest } from './fbneo.manifest.js';
+import { DEFAULT_FBNEO_OPTIONS } from './fbneo.options.js';
+export { manifest };
+const scriptLoadCache = new Map();
+function loadClassicScriptOnce(src) {
+    const cached = scriptLoadCache.get(src);
+    if (cached)
+        return cached;
+    const p = new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        script.src = src;
+        script.async = true;
+        script.onload = () => resolve();
+        script.onerror = () => reject(new Error(`fbneo: failed to load script: ${src}`));
+        document.head.appendChild(script);
+    });
+    scriptLoadCache.set(src, p);
+    return p;
+}
+function toUint8(x) {
+    if (x == null)
+        return null;
+    if (typeof x === 'string')
+        return new TextEncoder().encode(x);
+    if (x instanceof Uint8Array)
+        return x;
+    if (x instanceof ArrayBuffer)
+        return new Uint8Array(x);
+    if (ArrayBuffer.isView(x))
+        return new Uint8Array(x.buffer, x.byteOffset, x.byteLength);
+    throw new TypeError('fbneo: asset must be Uint8Array | ArrayBuffer | string');
+}
+/** Strip a directory and extension from a zip filename to get the FBNeo driver name. */
+function driverFromFileName(fileName) {
+    const base = fileName.replace(/^.*[\\/]/, '');
+    return base.replace(/\.(zip|7z)$/i, '');
+}
+/**
+ * Resolve the render canvas from the contract's `EngineConfig`.
+ * The contract is a union: hosts pass either `canvasEl` (a render target) or
+ * `attachTo` (a container the SDK mounts its own canvas into). Legacy `canvas`
+ * is still accepted as a defensive fallback for hosts built against 0.1.x.
+ */
+function resolveCanvas(config) {
+    const c = config.canvasEl ??
+        config.canvas;
+    if (c)
+        return c;
+    const attachTo = config.attachTo;
+    if (attachTo) {
+        const existing = attachTo.querySelector('canvas');
+        if (existing)
+            return existing;
+        const created = document.createElement('canvas');
+        attachTo.appendChild(created);
+        return created;
+    }
+    throw new Error('fbneo: config.canvasEl or config.attachTo is required');
+}
+/**
+ * Ensure the canvas used by FBNeo has `id="canvas"`.
+ * Emscripten SDL2 queries `document.querySelector('#canvas')` to locate its render target.
+ */
+function prepareCanvas(canvas, renderFilter) {
+    if (canvas.id !== 'canvas')
+        canvas.id = 'canvas';
+    if (!canvas.width)
+        canvas.width = manifest.video.baseWidth;
+    if (!canvas.height)
+        canvas.height = manifest.video.baseHeight;
+    // SDL2's Emscripten backend measures getBoundingClientRect() (borders/padding
+    // included) to detect external CSS sizing; decoration on the canvas itself
+    // makes it create a tiny window. Host pages should decorate a wrapper instead.
+    canvas.style.border = '0';
+    canvas.style.padding = '0';
+    canvas.style.imageRendering = renderFilter === 'pixelated' ? 'pixelated' : 'auto';
+    return canvas;
+}
+export async function load(config) {
+    const { assets, onEvent } = config;
+    const emit = (e) => {
+        try {
+            onEvent?.(e);
+        }
+        catch {
+            // host callback must not break the engine runtime
+        }
+    };
+    // Generic hosts (e.g. the engine-specs demo shell) pass the picked file's name
+    // as `options.fileName`; treat it as an alias for `romFileName` so the driver
+    // can be inferred from the ROM's filename without a FBNeo-specific option.
+    const rawOptions = config.options;
+    const opts = {
+        ...DEFAULT_FBNEO_OPTIONS,
+        ...rawOptions,
+        romFileName: rawOptions?.romFileName ??
+            rawOptions?.fileName ??
+            DEFAULT_FBNEO_OPTIONS.romFileName,
+    };
+    const romBytes = toUint8(assets?.rom ?? assets?.data);
+    if (!romBytes) {
+        throw new Error('fbneo: no ROM bytes provided — pass assets.rom (an arcade ROM zip)');
+    }
+    const biosBytes = toUint8(assets?.bios);
+    const canvas = prepareCanvas(resolveCanvas(config), opts.renderFilter);
+    // FBNeo boots a game by its ROM-set short name ("driver", e.g. "mslug") and
+    // searches its ROM paths for a matching `<driver>.zip`. Prefer an explicit
+    // `options.driver`; otherwise derive it from the ROM filename (stripping the
+    // extension). Whatever the source, the zip is mounted as `<driver>.zip` so the
+    // name FBNeo looks up and the name on disk always agree.
+    const driver = (opts.driver || driverFromFileName(opts.romFileName)).trim();
+    if (!driver || driver === 'game') {
+        throw new Error('fbneo: could not determine the ROM-set name. Pass options.driver (the FBNeo ' +
+            'short name, e.g. "mslug") or name the ROM file after it (e.g. mslug.zip).');
+    }
+    const romFileName = `${driver}.zip`;
+    const jsUrl = config.jsUrl ?? new URL('./fbneo.js', import.meta.url).href;
+    const wasmUrl = config.wasmUrl ?? new URL('./fbneo.wasm', jsUrl).href;
+    let modRef = null;
+    let readyResolve = () => { };
+    const readyPromise = new Promise((resolve) => {
+        readyResolve = resolve;
+    });
+    // FBNeo's default ROM search paths (src/burner/sdl/drv.cpp) are the absolute
+    // "/usr/local/share/roms/" and the cwd-relative "roms/". Under Emscripten the
+    // cwd is not guaranteed to be "/", so write to the absolute path (always
+    // searched) as well as "/roms/". FBNeo matches ROM files inside each zip by
+    // name/CRC, so the zip must be named after the driver.
+    const romDirs = ['/usr/local/share/roms', '/roms'];
+    const writeRoms = (mod) => {
+        for (const dir of romDirs) {
+            mod.FS.mkdirTree(dir);
+            mod.FS.writeFile(`${dir}/${romFileName}`, romBytes);
+            if (biosBytes)
+                mod.FS.writeFile(`${dir}/neogeo.zip`, biosBytes);
+        }
+    };
+    const moduleOverrides = {
+        canvas,
+        noInitialRun: true,
+        locateFile(path) {
+            if (path.endsWith('.wasm'))
+                return wasmUrl;
+            return new URL(path, jsUrl).href;
+        },
+    };
+    await loadClassicScriptOnce(jsUrl);
+    const g = globalThis;
+    // Our build is a MODULARIZE factory (createFbneoModule). The factory promise
+    // resolves *after* the runtime is initialized and FS is available, so this is
+    // the correct point to populate MEMFS — write the ROMs before callMain().
+    if (typeof g.createFbneoModule === 'function') {
+        modRef = await g.createFbneoModule(moduleOverrides);
+    }
+    else if (g.Module) {
+        modRef = g.Module;
+    }
+    else {
+        throw new Error('fbneo: unable to initialize runtime module from fbneo.js');
+    }
+    writeRoms(modRef);
+    readyResolve();
+    await readyPromise;
+    let running = false;
+    const boot = () => {
+        if (running)
+            return;
+        running = true;
+        // FBNeo SDL takes the ROM set short name and searches its rom paths for it.
+        modRef.callMain([driver]);
+        emit({ type: 'ready' });
+    };
+    const setInput = (_map) => {
+        // Input is handled by the Emscripten SDL2 event loop; no external override yet.
+    };
+    return {
+        start() {
+            boot();
+        },
+        pause() {
+            modRef?.pauseMainLoop?.();
+        },
+        resume() {
+            modRef?.resumeMainLoop?.();
+        },
+        reset() {
+            // FBNeo does not expose a soft-reset hook through this WASM build.
+            throw new Error('fbneo: reset is not supported by this build');
+        },
+        setInput,
+        destroy() {
+            modRef?.pauseMainLoop?.();
+            running = false;
+            emit({ type: 'exit' });
+        },
+    };
+}
+export default { manifest, load };
+//# sourceMappingURL=fbneo.sdk.js.map

package/dist/fbneo/fbneo.sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fbneo.sdk.js","sourceRoot":"","sources":["../../src/fbneo.sdk.ts"],"names":[],"mappings":"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"}

package/dist/manifest.json

@@ -0,0 +1,91 @@
+{
+  "id": "fbneo",
+  "version": "0.1.0",
+  "name": "FinalBurn Neo (WebAssembly)",
+  "description": "FBNeo arcade emulator (Capcom CPS-1/2/3, SNK Neo Geo, Sega System 16, and more) compiled to WebAssembly.",
+  "artifacts": {
+    "wasm": "fbneo/fbneo.wasm",
+    "js": "fbneo/fbneo.js"
+  },
+  "assets": [
+    {
+      "key": "rom",
+      "mountPath": "/roms/game.zip",
+      "required": true,
+      "accept": [
+        ".zip",
+        ".7z"
+      ],
+      "description": "Arcade ROM set (zip) written to Emscripten MEMFS. FBNeo identifies the game by the zip filename."
+    },
+    {
+      "key": "bios",
+      "mountPath": "/roms/neogeo.zip",
+      "required": false,
+      "accept": [
+        ".zip"
+      ],
+      "description": "Optional system BIOS set (e.g. neogeo.zip for Neo Geo, or a CPS-3 BIOS). Required only by ROM sets that depend on it."
+    }
+  ],
+  "input": "fbneo",
+  "video": {
+    "baseWidth": 384,
+    "baseHeight": 224,
+    "aspect": "4:3"
+  },
+  "options": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "romFileName": {
+        "type": "string",
+        "default": "game.zip",
+        "description": "ROM zip filename written to Emscripten MEMFS when loading a game."
+      },
+      "driver": {
+        "type": "string",
+        "default": "",
+        "description": "FBNeo driver/game name to load (e.g. \"mslug\"). If empty, inferred from romFileName without extension."
+      },
+      "renderFilter": {
+        "type": "string",
+        "enum": [
+          "pixelated",
+          "smooth"
+        ],
+        "default": "pixelated",
+        "description": "Canvas scaling filter: pixelated for crisp pixels, smooth for linear filtering."
+      },
+      "audioSampleRate": {
+        "type": "integer",
+        "default": 44100,
+        "minimum": 11025,
+        "maximum": 96000,
+        "description": "Target audio sample rate in Hz."
+      },
+      "vsync": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable vertical sync."
+      },
+      "integerScale": {
+        "type": "boolean",
+        "default": false,
+        "description": "Use integer scaling (no fractional stretching)."
+      },
+      "windowScale": {
+        "type": "integer",
+        "default": 2,
+        "minimum": 1,
+        "maximum": 8,
+        "description": "Window scale multiplier for the internal render resolution."
+      }
+    }
+  },
+  "capabilities": {
+    "saveStates": false,
+    "sram": false,
+    "coreSelectable": false
+  }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@wasm-gaming/fbneo-wasm",
+  "version": "0.1.0",
+  "description": "FBNeo (FinalBurn Neo arcade emulator) compiled to WebAssembly via Emscripten, with a JS SDK conforming to the wasm-gaming engine contract.",
+  "type": "module",
+  "main": "./dist/fbneo/fbneo.sdk.js",
+  "types": "./dist/fbneo/fbneo.sdk.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/fbneo/fbneo.sdk.d.ts",
+      "import": "./dist/fbneo/fbneo.sdk.js"
+    },
+    "./options": {
+      "types": "./dist/fbneo/fbneo.options.d.ts",
+      "import": "./dist/fbneo/fbneo.options.js"
+    },
+    "./manifest": "./dist/manifest.json"
+  },
+  "files": [
+    "dist/fbneo/",
+    "dist/manifest.json",
+    "src/fbneo.manifest.ts",
+    "src/fbneo.options.ts",
+    "src/fbneo.sdk.ts",
+    "README.md"
+  ],
+  "comment:scripts": "Build logic lives in the Makefile, not here (make build / build-sdk / build-wasm / preview).",
+  "scripts": {},
+  "peerDependencies": {
+    "@wasm-gaming/engine-specs": "*"
+  },
+  "peerDependenciesMeta": {
+    "@wasm-gaming/engine-specs": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@wasm-gaming/engine-specs": "^0.2.3",
+    "typescript": "^5.5.0"
+  },
+  "engineContract": "https://github.com/wasm-gaming/engine-specs",
+  "license": "MIT"
+}

package/src/fbneo.manifest.ts

@@ -0,0 +1,38 @@
+import type { EngineManifest } from '@wasm-gaming/engine-specs';
+import { FBNEO_OPTIONS_SCHEMA } from './fbneo.options.js';
+
+export const manifest: EngineManifest = {
+  id: 'fbneo',
+  version: '0.1.0',
+  name: 'FinalBurn Neo (WebAssembly)',
+  description:
+    'FBNeo arcade emulator (Capcom CPS-1/2/3, SNK Neo Geo, Sega System 16, and more) compiled to WebAssembly.',
+  artifacts: {
+    wasm: 'fbneo/fbneo.wasm',
+    js: 'fbneo/fbneo.js',
+  },
+  assets: [
+    {
+      key: 'rom',
+      mountPath: '/roms/game.zip',
+      required: true,
+      accept: ['.zip', '.7z'],
+      description:
+        'Arcade ROM set (zip) written to Emscripten MEMFS. FBNeo identifies the game by the zip filename.',
+    },
+    {
+      key: 'bios',
+      mountPath: '/roms/neogeo.zip',
+      required: false,
+      accept: ['.zip'],
+      description:
+        'Optional system BIOS set (e.g. neogeo.zip for Neo Geo, or a CPS-3 BIOS). Required only by ROM sets that depend on it.',
+    },
+  ],
+  input: 'fbneo',
+  video: { baseWidth: 384, baseHeight: 224, aspect: '4:3' },
+  options: FBNEO_OPTIONS_SCHEMA,
+  capabilities: { saveStates: false, sram: false, coreSelectable: false },
+};
+
+export default manifest;

package/src/fbneo.options.ts

@@ -0,0 +1,83 @@
+import type { JSONSchema } from '@wasm-gaming/engine-specs';
+
+export interface FbneoOptions {
+  /**
+   * Filename used when writing the ROM zip bytes to Emscripten MEMFS.
+   * FBNeo identifies a game by the zip filename (without extension), so this
+   * should match the driver's expected ROM set name (e.g. "mslug" for Metal Slug).
+   */
+  romFileName?: string;
+  /**
+   * The FBNeo driver/game name to load (e.g. "mslug", "sf2", "kof98").
+   * If omitted, the driver is inferred from `romFileName` (without extension).
+   */
+  driver?: string;
+  /** Canvas scaling filter: `pixelated` for crisp pixels, `smooth` for linear filtering. */
+  renderFilter?: 'pixelated' | 'smooth';
+  /** Target audio sample rate in Hz. FBNeo defaults to 44100. */
+  audioSampleRate?: number;
+  /** Enable vertical sync. Defaults to true. */
+  vsync?: boolean;
+  /** Use integer scaling (no fractional stretching). Defaults to false. */
+  integerScale?: boolean;
+  /** Window scale multiplier for the internal render resolution. Defaults to 2. */
+  windowScale?: number;
+}
+
+export const DEFAULT_FBNEO_OPTIONS: Required<FbneoOptions> = {
+  romFileName: 'game.zip',
+  driver: '',
+  renderFilter: 'pixelated',
+  audioSampleRate: 44100,
+  vsync: true,
+  integerScale: false,
+  windowScale: 2,
+};
+
+export const FBNEO_OPTIONS_SCHEMA: JSONSchema = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    romFileName: {
+      type: 'string',
+      default: 'game.zip',
+      description: 'ROM zip filename written to Emscripten MEMFS when loading a game.',
+    },
+    driver: {
+      type: 'string',
+      default: '',
+      description:
+        'FBNeo driver/game name to load (e.g. "mslug"). If empty, inferred from romFileName without extension.',
+    },
+    renderFilter: {
+      type: 'string',
+      enum: ['pixelated', 'smooth'],
+      default: 'pixelated',
+      description: 'Canvas scaling filter: pixelated for crisp pixels, smooth for linear filtering.',
+    },
+    audioSampleRate: {
+      type: 'integer',
+      default: 44100,
+      minimum: 11025,
+      maximum: 96000,
+      description: 'Target audio sample rate in Hz.',
+    },
+    vsync: {
+      type: 'boolean',
+      default: true,
+      description: 'Enable vertical sync.',
+    },
+    integerScale: {
+      type: 'boolean',
+      default: false,
+      description: 'Use integer scaling (no fractional stretching).',
+    },
+    windowScale: {
+      type: 'integer',
+      default: 2,
+      minimum: 1,
+      maximum: 8,
+      description: 'Window scale multiplier for the internal render resolution.',
+    },
+  },
+};