@wasm-gaming/mgba-wasm 0.1.0

package/dist/mgba/mgba.options.js

@@ -0,0 +1,273 @@
+export const DEFAULT_MGBA_OPTIONS = {
+    system: 'auto',
+    gbModel: 'auto',
+    idleOptimization: 'remove',
+    skipBios: true,
+    allowOpposingDirections: false,
+    renderFilter: 'pixelated',
+    aspect: 'native',
+    interframeBlending: false,
+    volume: 1.0,
+    gamepads: true,
+    logLevel: 'error',
+    escMenu: true,
+};
+/** Platform ids consumed by `mgbawasm_setup()` (mPLATFORM_* in core/core.h). */
+export const MGBA_PLATFORM_IDS = {
+    auto: -1,
+    gba: 0,
+    gb: 1,
+};
+/** Values mGBA's `gb.model` config key takes; `auto` means "leave unset". */
+export const MGBA_GB_MODEL_VALUES = {
+    auto: null,
+    dmg: 'DMG',
+    sgb: 'SGB',
+    cgb: 'CGB',
+    agb: 'AGB',
+};
+export const MGBA_LOG_LEVEL_IDS = {
+    off: 0,
+    error: 1,
+    debug: 2,
+};
+export const MGBA_OPTION_GROUPS = [
+    {
+        id: 'video',
+        label: 'Video',
+        options: [
+            {
+                key: 'renderFilter',
+                label: 'Image filtering',
+                description: 'Scaling filter applied when the picture is stretched to the canvas. Pixelated keeps pixel art crisp; smooth softens it.',
+                type: 'enum',
+                default: DEFAULT_MGBA_OPTIONS.renderFilter,
+                values: [
+                    { value: 'pixelated', label: 'Pixelated' },
+                    { value: 'smooth', label: 'Smooth' },
+                ],
+            },
+            {
+                key: 'aspect',
+                label: 'Aspect ratio',
+                description: 'Native is square pixels, as the handheld LCDs had them: 3:2 on GBA, 10:9 on Game Boy. 4:3 stretches the picture into a TV-shaped frame.',
+                type: 'enum',
+                default: DEFAULT_MGBA_OPTIONS.aspect,
+                values: [
+                    { value: 'native', label: 'Native' },
+                    { value: '4:3', label: '4:3' },
+                ],
+            },
+            {
+                key: 'interframeBlending',
+                label: 'Interframe blending',
+                description: 'Blend each frame with the previous one, approximating the ghosting of the original unlit LCD. Restores transparency effects that games drew by flickering sprites every other frame.',
+                type: 'boolean',
+                default: DEFAULT_MGBA_OPTIONS.interframeBlending,
+            },
+        ],
+    },
+    {
+        id: 'audio',
+        label: 'Audio',
+        options: [
+            {
+                key: 'volume',
+                label: 'Volume',
+                description: 'Master audio volume.',
+                type: 'number',
+                default: DEFAULT_MGBA_OPTIONS.volume,
+                values: [
+                    { value: 0, label: 'Mute' },
+                    { value: 0.25, label: '25%' },
+                    { value: 0.5, label: '50%' },
+                    { value: 0.75, label: '75%' },
+                    { value: 1, label: '100%' },
+                ],
+                range: { minimum: 0, maximum: 1 },
+            },
+        ],
+    },
+    {
+        id: 'emulation',
+        label: 'Emulation',
+        options: [
+            {
+                key: 'system',
+                label: 'System',
+                description: 'Which core boots the ROM. Auto sniffs the image, which is right for every well-formed dump; force it for headerless or mislabelled files.',
+                type: 'enum',
+                default: DEFAULT_MGBA_OPTIONS.system,
+                requiresReset: true,
+                values: [
+                    { value: 'auto', label: 'Auto' },
+                    { value: 'gba', label: 'GBA' },
+                    { value: 'gb', label: 'Game Boy' },
+                ],
+            },
+            {
+                key: 'gbModel',
+                label: 'Game Boy model',
+                description: 'Hardware the Game Boy core emulates. Auto follows the cartridge header. Ignored when a GBA ROM is loaded.',
+                type: 'enum',
+                default: DEFAULT_MGBA_OPTIONS.gbModel,
+                requiresReset: true,
+                values: [
+                    { value: 'auto', label: 'Auto' },
+                    { value: 'dmg', label: 'DMG' },
+                    { value: 'sgb', label: 'Super GB' },
+                    { value: 'cgb', label: 'Color' },
+                    { value: 'agb', label: 'GBA' },
+                ],
+            },
+            {
+                key: 'idleOptimization',
+                label: 'Idle loops',
+                description: 'How the GBA core treats the busy-wait loops games spin in. Remove skips them and is where nearly all of the speed comes from; ignore emulates them cycle for cycle.',
+                type: 'enum',
+                default: DEFAULT_MGBA_OPTIONS.idleOptimization,
+                values: [
+                    { value: 'remove', label: 'Remove' },
+                    { value: 'detect', label: 'Detect' },
+                    { value: 'ignore', label: 'Ignore' },
+                ],
+            },
+            {
+                key: 'skipBios',
+                label: 'Skip BIOS intro',
+                description: 'Jump straight into the game instead of playing the boot animation. Forced on when no BIOS image was supplied, since the built-in HLE BIOS has no intro.',
+                type: 'boolean',
+                default: DEFAULT_MGBA_OPTIONS.skipBios,
+                requiresReset: true,
+            },
+        ],
+    },
+    {
+        id: 'controllers',
+        label: 'Controllers',
+        options: [
+            {
+                key: 'allowOpposingDirections',
+                label: 'Opposing directions',
+                description: 'Let the D-pad report left+right (or up+down) at once. Real hardware cannot, and a few games misbehave when it happens.',
+                type: 'boolean',
+                default: DEFAULT_MGBA_OPTIONS.allowOpposingDirections,
+            },
+            {
+                key: 'gamepads',
+                label: 'Gamepads',
+                description: 'Poll connected gamepads (standard mapping) each frame.',
+                type: 'boolean',
+                default: DEFAULT_MGBA_OPTIONS.gamepads,
+            },
+        ],
+    },
+    {
+        id: 'debug',
+        label: 'Debug',
+        options: [
+            {
+                key: 'logLevel',
+                label: 'Core logging',
+                description: 'Core messages printed to the browser console: errors and warnings, or also its informational ones.',
+                type: 'enum',
+                default: DEFAULT_MGBA_OPTIONS.logLevel,
+                values: [
+                    { value: 'off', label: 'Off' },
+                    { value: 'error', label: 'Errors' },
+                    { value: 'debug', label: 'Debug' },
+                ],
+            },
+        ],
+    },
+];
+/** Flat view of every runtime-tweakable option across all groups. */
+export const MGBA_ENGINE_OPTIONS = MGBA_OPTION_GROUPS.flatMap((group) => group.options);
+const OPTION_BY_KEY = new Map(MGBA_ENGINE_OPTIONS.map((option) => [option.key, option]));
+export function mgbaOption(key) {
+    return OPTION_BY_KEY.get(key);
+}
+/**
+ * Coerces a host- or storage-supplied value to what the option accepts,
+ * returning `undefined` when it is not a value the option can take. Numbers
+ * outside a `range` are clamped rather than rejected; enums are exact.
+ */
+export function coerceOptionValue(option, value) {
+    if (option.type === 'boolean') {
+        return typeof value === 'boolean' ? value : undefined;
+    }
+    if (option.type === 'enum') {
+        const next = String(value);
+        return option.values.some((choice) => choice.value === next) ? next : undefined;
+    }
+    const next = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(next))
+        return undefined;
+    if (option.range) {
+        return Math.min(option.range.maximum, Math.max(option.range.minimum, next));
+    }
+    return option.values.some((choice) => choice.value === next) ? next : undefined;
+}
+/**
+ * Projects the catalog onto the shape `@wasm-gaming/engine-specs` (>=0.2.5)
+ * feeds its `esc-menu` component.
+ *
+ * The menu lives in the demo shell now, not in this package: the shell renders
+ * the rows and emits `option-change`, and the host writes the value back
+ * through `engine.config`. Since the component only draws chips for `boolean`
+ * and `enum`, numeric options are handed over as an enum of their menu choices
+ * — the numbers survive, because the chips compare values with `===`.
+ *
+ * Pass the running engine's `config.values()` so the menu opens on what the
+ * emulator is actually set to rather than on this package's defaults.
+ */
+export function toEscMenuGroups(values = {}) {
+    return MGBA_OPTION_GROUPS.map((group) => ({
+        id: group.id,
+        label: group.label,
+        options: group.options.map((option) => ({
+            key: option.key,
+            label: option.label,
+            description: option.description,
+            type: option.type === 'boolean' ? 'boolean' : 'enum',
+            value: values[option.key] ?? option.default,
+            ...(option.type === 'boolean' ? {} : { values: option.values }),
+            ...(option.requiresReset ? { requiresReset: true } : {}),
+        })),
+    }));
+}
+// -------------------------------------------------------------- schema
+function schemaForOption(option) {
+    if (option.type === 'boolean') {
+        return { type: 'boolean', default: option.default, description: option.description };
+    }
+    if (option.type === 'enum') {
+        return {
+            type: 'string',
+            enum: option.values.map((choice) => choice.value),
+            default: option.default,
+            description: option.description,
+        };
+    }
+    return {
+        type: option.integer ? 'integer' : 'number',
+        default: option.default,
+        ...(option.range
+            ? { minimum: option.range.minimum, maximum: option.range.maximum }
+            : { enum: option.values.map((choice) => choice.value) }),
+        description: option.description,
+    };
+}
+export const MGBA_OPTIONS_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        ...Object.fromEntries(MGBA_ENGINE_OPTIONS.map((option) => [option.key, schemaForOption(option)])),
+        escMenu: {
+            type: 'boolean',
+            default: true,
+            description: "Show the demo shell's in-game settings menu when the player presses Escape.",
+        },
+    },
+};
+//# sourceMappingURL=mgba.options.js.map

package/dist/mgba/mgba.options.js.map

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

package/dist/mgba/mgba.sdk.d.ts

@@ -0,0 +1,24 @@
+import type { EngineConfig, EngineInstance } from '@wasm-gaming/engine-specs';
+import { manifest } from './mgba.manifest.js';
+import { type MgbaConfig } from './mgba.config.js';
+import { type EscMenuGroup } from './mgba.options.js';
+export { manifest };
+export type MgbaInstance = EngineInstance & {
+    /** Live handle on the emulator settings; writes apply to the running game. */
+    config: MgbaConfig;
+    /**
+     * The option rows for the demo shell's ESC menu, in the shape
+     * `@wasm-gaming/engine-specs` (>=0.2.5) renders. Snapshot at call time — read
+     * it when the menu opens, not once at boot.
+     */
+    escMenuGroups(): EscMenuGroup[];
+    /** Which core actually booted the ROM. */
+    system: 'gba' | 'gb';
+};
+export declare function load(config: EngineConfig): Promise<MgbaInstance>;
+declare const _default: {
+    manifest: import("@wasm-gaming/engine-specs").EngineManifest;
+    load: typeof load;
+};
+export default _default;
+//# sourceMappingURL=mgba.sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mgba.sdk.d.ts","sourceRoot":"","sources":["../../src/mgba.sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAEZ,cAAc,EAGf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAQL,KAAK,YAAY,EAMlB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,QAAQ,EAAE,CAAC;AAwOpB,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG;IAC1C,8EAA8E;IAC9E,MAAM,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,aAAa,IAAI,YAAY,EAAE,CAAC;IAChC,0CAA0C;IAC1C,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,wBAAsB,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA+qBtE;;;;;AAED,wBAAkC"}