@wasm-gaming/rsdkv5-wasm 0.1.0

package/dist/rsdkv5/rsdkv5.options.js

@@ -0,0 +1,28 @@
+// Engine-specific options for RSDKv5U (Sonic Mania).
+export const DEFAULT_RSDKV5_OPTIONS = {
+    devMenu: false,
+    engineDebugMode: true,
+    vsync: true,
+    language: 0,
+    region: -1,
+};
+export const RSDKV5_OPTIONS_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        devMenu: {
+            type: 'boolean',
+            default: false,
+            description: "Sonic Mania's native dev menu. The launcher provides its own overlay, so keep this off.",
+        },
+        engineDebugMode: {
+            type: 'boolean',
+            default: true,
+            description: 'Enables the web debug hooks.',
+        },
+        vsync: { type: 'boolean', default: true },
+        language: { type: 'integer', default: 0, minimum: 0 },
+        region: { type: 'integer', default: -1 },
+    },
+};
+//# sourceMappingURL=rsdkv5.options.js.map

package/dist/rsdkv5/rsdkv5.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsdkv5.options.js","sourceRoot":"","sources":["../../src/rsdkv5.options.ts"],"names":[],"mappings":"AAAA,qDAAqD;AA8BrD,MAAM,CAAC,MAAM,sBAAsB,GAA4B;IAC7D,OAAO,EAAE,KAAK;IACd,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAe;IAC/C,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE;QACV,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EACT,yFAAyF;SAC5F;QACD,eAAe,EAAE;YACf,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,8BAA8B;SAC5C;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;QACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;QACrD,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;KACzC;CACF,CAAC"}

package/dist/rsdkv5/rsdkv5.sdk.d.ts

@@ -0,0 +1,44 @@
+import type { EngineConfig, EngineInstance, AssetData } from '@wasm-gaming/engine-specs';
+import { manifest } from './rsdkv5.manifest.js';
+export { manifest };
+/** RSDKv5-specific bridge for the launcher's debug/stage-select UI. */
+export interface RsdkDevMenuBridge {
+    getStageList(): Array<{
+        name: string;
+        stages: Array<{
+            name: string;
+        }>;
+    }>;
+    loadStage(categoryIdx: number, stageIdx: number): void;
+    setPaused(paused: boolean): void;
+}
+export type Rsdkv5Instance = EngineInstance & {
+    devMenu: RsdkDevMenuBridge;
+    /** True when the working dir is OPFS-backed (persistent) rather than in-memory. */
+    persistent: boolean;
+    /** Relative storage namespace used under /data (e.g. "sonic-mania"). */
+    storageNamespace: string;
+    /** Remove persisted game files for this namespace only. */
+    purgeStorage(): {
+        data: boolean;
+        settings: boolean;
+    };
+};
+/**
+ * Extra (engine-specific) config on top of the contract's EngineConfig: lazy asset
+ * providers, invoked only on a cache miss.
+ */
+export type Rsdkv5LoadConfig = EngineConfig & {
+    dataProvider?: () => Promise<AssetData> | AssetData;
+    settingsProvider?: () => Promise<AssetData> | AssetData;
+    /** Per-game storage folder under /data used for OPFS/WASMFS files. */
+    storageNamespace?: string;
+};
+/** Boot the RSDKv5 engine. */
+export declare function load(config: Rsdkv5LoadConfig): Promise<Rsdkv5Instance>;
+declare const _default: {
+    manifest: import("@wasm-gaming/engine-specs").EngineManifest;
+    load: typeof load;
+};
+export default _default;
+//# sourceMappingURL=rsdkv5.sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rsdkv5.sdk.d.ts","sourceRoot":"","sources":["../../src/rsdkv5.sdk.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,CAAC;AA+GpB,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,YAAY,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IACzE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,mFAAmF;IACnF,UAAU,EAAE,OAAO,CAAC;IACpB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,YAAY,IAAI;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CACtD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG;IAC5C,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACpD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACxD,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,8BAA8B;AAC9B,wBAAsB,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmH5E;;;;;AAED,wBAAkC"}

package/dist/rsdkv5/rsdkv5.sdk.js

@@ -0,0 +1,234 @@
+// @wasm-gaming/rsdkv5-wasm — SDK entry point.
+import { manifest } from './rsdkv5.manifest.js';
+import { DEFAULT_RSDKV5_OPTIONS } from './rsdkv5.options.js';
+export { manifest };
+const WORK_ROOT = '/data';
+const DEFAULT_STORAGE_NAMESPACE = 'default';
+/**
+ * Serialize engine options into RSDKv5U's Settings.ini format. This is the v5
+ * dialect (lowercase keys, 0/1 booleans, `dataFile=` in [Game]) — matching the
+ * exact file the proven build preloaded — NOT v4's [Dev]/CamelCase format.
+ * `dataFile=Data.rsdk` is load-bearing: it names the pack the engine opens,
+ * relative to CWD (the SDK chdir()s into the working dir before callMain).
+ */
+function buildSettingsIni(options = {}) {
+    const o = { ...DEFAULT_RSDKV5_OPTIONS, ...options };
+    const b = (v) => (v ? '1' : '0');
+    return [
+        '[Game]',
+        'dataFile=Data.rsdk',
+        `devMenu=${b(o.devMenu)}`,
+        `language=${o.language | 0}`,
+        `region=${o.region | 0}`,
+        '',
+        '[Video]',
+        'windowed=1',
+        'border=1',
+        'exclusiveFS=0',
+        `vsync=${b(o.vsync)}`,
+        'tripleBuffering=0',
+        'pixWidth=424',
+        'winWidth=424',
+        'winHeight=240',
+        'fsWidth=0',
+        'fsHeight=0',
+        'refreshRate=60',
+        'shaderSupport=0',
+        'screenShader=0',
+        '',
+        '[Audio]',
+        'streamsEnabled=1',
+        'streamVolume=0.8',
+        'sfxVolume=1.0',
+        '',
+    ].join('\n');
+}
+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('asset must be Uint8Array | ArrayBuffer | string');
+}
+/** Normalize a user-provided storage namespace into a safe relative path. */
+function normalizeStorageNamespace(namespace) {
+    if (typeof namespace !== 'string' || !namespace.trim())
+        return DEFAULT_STORAGE_NAMESPACE;
+    const cleaned = namespace
+        .split('/')
+        .map((segment) => segment.trim())
+        .filter(Boolean)
+        .map((segment) => segment.replace(/[^A-Za-z0-9._-]/g, '_'))
+        .filter(Boolean)
+        .join('/');
+    return cleaned || DEFAULT_STORAGE_NAMESPACE;
+}
+/** Best-effort mkdir -p for the Emscripten FS layer. */
+function ensureDir(Module, path) {
+    const parts = path.split('/').filter(Boolean);
+    let current = '';
+    for (const part of parts) {
+        current += `/${part}`;
+        try {
+            Module.FS.mkdir(current);
+        }
+        catch {
+            /* already exists */
+        }
+    }
+}
+/** Mount the game working directory. */
+function mountWorkingDir(Module, storageNamespace) {
+    const workDir = `${WORK_ROOT}/${storageNamespace}`;
+    ensureDir(Module, workDir);
+    return { persistent: false, workDir };
+}
+/** True if `path` exists in the (mounted) filesystem. */
+function fileExists(Module, path) {
+    try {
+        Module.FS.stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Delete a file if present; returns true when something was removed. */
+function deleteFileIfExists(Module, path) {
+    if (!fileExists(Module, path))
+        return false;
+    try {
+        Module.FS.unlink(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Boot the RSDKv5 engine. */
+export async function load(config) {
+    const { canvas, assets, onEvent } = config;
+    const options = config.options;
+    if (!canvas)
+        throw new Error('rsdkv5: config.canvas is required');
+    // Emscripten's SDL2 port locates the canvas via document.querySelector('#canvas').
+    if (canvas.id !== 'canvas')
+        canvas.id = 'canvas';
+    const emit = (e) => {
+        try {
+            onEvent?.(e);
+        }
+        catch { /* host handler must not break us */ }
+    };
+    const jsUrl = config.jsUrl ?? new URL('./rsdkv5.js', import.meta.url).href;
+    const wasmUrl = config.wasmUrl ?? new URL('./rsdkv5.wasm', import.meta.url).href;
+    // RSDKv5 uses the same key map preset used by the shared launcher script.
+    if (typeof window !== 'undefined')
+        window.__gamepadKeyMap = manifest.input;
+    const mod = await import(/* @vite-ignore */ jsUrl);
+    const createRSDKv5 = mod.default;
+    const Module = await createRSDKv5({
+        canvas,
+        noInitialRun: true,
+        locateFile: (path) => (path.endsWith('.wasm') ? wasmUrl : path),
+        print: (...a) => console.log('[rsdkv5]', ...a),
+        printErr: (...a) => console.error('[rsdkv5]', ...a),
+        onAbort: (reason) => emit({ type: 'error', error: new Error(`rsdkv5 aborted: ${reason}`) }),
+    });
+    const storageNamespace = normalizeStorageNamespace(config.storageNamespace);
+    const { persistent, workDir } = mountWorkingDir(Module, storageNamespace);
+    const dataPath = `${workDir}/Data.rsdk`;
+    // Capital S: RSDKv5U opens "Settings.ini" and the Emscripten FS is
+    // case-sensitive (v4 used lowercase settings.ini — do not copy that here).
+    const settingsPath = `${workDir}/Settings.ini`;
+    // Data.rsdk — precedence: explicit asset > lazy provider > existing file.
+    let dataBytes = toUint8(assets?.data);
+    if (!dataBytes && config.dataProvider) {
+        dataBytes = toUint8(await config.dataProvider());
+    }
+    if (dataBytes) {
+        Module.FS.writeFile(dataPath, dataBytes);
+    }
+    else if (!fileExists(Module, dataPath)) {
+        throw new Error('rsdkv5: no Data.rsdk — provide assets.data or dataProvider');
+    }
+    // settings.ini — explicit asset > lazy provider > generated from options.
+    let settingsBytes = toUint8(assets?.settings);
+    if (!settingsBytes && config.settingsProvider) {
+        settingsBytes = toUint8(await config.settingsProvider());
+    }
+    if (settingsBytes) {
+        Module.FS.writeFile(settingsPath, settingsBytes);
+    }
+    else if (!fileExists(Module, settingsPath)) {
+        Module.FS.writeFile(settingsPath, new TextEncoder().encode(buildSettingsIni(options)));
+    }
+    Module.FS.chdir(workDir);
+    const setPaused = (paused) => {
+        if (typeof Module.web_devmenu_set_paused === 'function')
+            Module.web_devmenu_set_paused(paused);
+    };
+    const devMenu = {
+        getStageList() {
+            if (typeof Module.web_devmenu_get_stage_list !== 'function')
+                return [];
+            try {
+                return JSON.parse(Module.web_devmenu_get_stage_list());
+            }
+            catch (e) {
+                console.error('[rsdkv5] getStageList failed', e);
+                return [];
+            }
+        },
+        loadStage(categoryIdx, stageIdx) {
+            if (typeof Module.web_devmenu_load_stage === 'function') {
+                Module.web_devmenu_load_stage(categoryIdx | 0, stageIdx | 0);
+            }
+        },
+        setPaused,
+    };
+    // No 'UsingCWD' argv — that's a v4-ism; v5U's main() doesn't parse it. The
+    // engine resolves Settings.ini/dataFile relative to the FS CWD set above.
+    Module.callMain([]);
+    emit({ type: 'ready' });
+    return {
+        start() { },
+        pause() { setPaused(true); },
+        resume() { setPaused(false); },
+        reset() {
+            throw new Error('rsdkv5: reset() is not supported — destroy() and load() again');
+        },
+        setInput(preset) {
+            if (typeof window !== 'undefined') {
+                window.__gamepadKeyMap = preset ?? manifest.input;
+            }
+        },
+        destroy() {
+            try {
+                Module.pauseMainLoop?.();
+            }
+            catch { /* noop */ }
+            try {
+                setPaused(true);
+            }
+            catch { /* noop */ }
+        },
+        devMenu,
+        persistent,
+        storageNamespace,
+        purgeStorage() {
+            return {
+                data: deleteFileIfExists(Module, dataPath),
+                settings: deleteFileIfExists(Module, settingsPath),
+            };
+        },
+    };
+}
+export default { manifest, load };
+//# sourceMappingURL=rsdkv5.sdk.js.map

package/dist/rsdkv5/rsdkv5.sdk.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@wasm-gaming/rsdkv5-wasm",
+  "version": "0.1.0",
+  "description": "RSDKv5 (Retro Software Development Kit v5) compiled to WebAssembly, with a JS SDK conforming to the wasm-gaming engine contract. Runs Sonic Mania by loading Data.rsdk at runtime.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wasm-gaming/rsdkv5-wasm.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wasm-gaming/rsdkv5-wasm/issues"
+  },
+  "homepage": "https://github.com/wasm-gaming/rsdkv5-wasm#readme",
+  "type": "module",
+  "main": "./dist/rsdkv5/rsdkv5.sdk.js",
+  "types": "./dist/rsdkv5/rsdkv5.sdk.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/rsdkv5/rsdkv5.sdk.d.ts",
+      "import": "./dist/rsdkv5/rsdkv5.sdk.js"
+    },
+    "./options": {
+      "types": "./dist/rsdkv5/rsdkv5.options.d.ts",
+      "import": "./dist/rsdkv5/rsdkv5.options.js"
+    },
+    "./manifest": "./dist/manifest.json"
+  },
+  "files": [
+    "dist/rsdkv5/",
+    "!dist/rsdkv5/*.data",
+    "!dist/rsdkv5/*.rsdk",
+    "dist/manifest.json",
+    "src/rsdkv5.manifest.ts",
+    "src/rsdkv5.options.ts",
+    "src/rsdkv5.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.1.0",
+    "typescript": "^5.5.0"
+  },
+  "engineContract": "https://github.com/wasm-gaming/engine-specs",
+  "license": "MIT"
+}

package/src/rsdkv5.manifest.ts

@@ -0,0 +1,44 @@
+// The rsdkv5 EngineManifest — typed against the contract, so a drift from
+// @wasm-gaming/engine-specs is a compile error here. `npm run build:manifest`
+// serializes this to dist/manifest.json (the artifact CI attaches to a Release).
+
+import type { EngineManifest } from '@wasm-gaming/engine-specs';
+import { RSDKV5_OPTIONS_SCHEMA } from './rsdkv5.options.js';
+
+export const manifest: EngineManifest = {
+  id: 'rsdkv5',
+  version: '0.1.0',
+  name: 'Retro Software Development Kit v5',
+  artifacts: {
+    // Relative to the manifest (dist/manifest.json); the engine files live in
+    // the dist/rsdkv5/ subfolder.
+    wasm: 'rsdkv5/rsdkv5.wasm',
+    js: 'rsdkv5/rsdkv5.js',
+  },
+  assets: [
+    {
+      key: 'data',
+      // Lives under the OPFS-backed (persistent) working dir; the engine reads it
+      // via CWD.
+      mountPath: '/data/Data.rsdk',
+      required: true,
+      accept: ['.rsdk'],
+      description:
+        'RSDKv5 game data pack. Sonic Mania uses this at runtime to select content.',
+    },
+    {
+      key: 'settings',
+      mountPath: '/data/Settings.ini',
+      required: false,
+      accept: ['.ini'],
+      description:
+        'Engine settings. Omitted → the SDK generates one from config.options.',
+    },
+  ],
+  input: 'rsdkv5',
+  video: { baseWidth: 424, baseHeight: 240, aspect: '16:9' },
+  options: RSDKV5_OPTIONS_SCHEMA,
+  capabilities: { saveStates: false, sram: false, coreSelectable: false },
+};
+
+export default manifest;

package/src/rsdkv5.options.ts

@@ -0,0 +1,58 @@
+// Engine-specific options for RSDKv5U (Sonic Mania).
+
+// This is the authoritative description of what `EngineConfig.options` accepts
+// for this engine. It provides both:
+//   - `Rsdkv5Options`         — the compile-time type (for TS hosts/launchers)
+//   - `RSDKV5_OPTIONS_SCHEMA` — the JSON Schema mirrored into manifest.json's
+//                               `options` (for runtime host UI + validation)
+//   - `DEFAULT_RSDKV5_OPTIONS` — defaults the SDK falls back to.
+//
+// At runtime these options are serialized into Sonic Mania's `Settings.ini`
+// when the host does not pass an explicit `settings` asset.
+
+import type { JSONSchema } from '@wasm-gaming/engine-specs';
+
+export interface Rsdkv5Options {
+  /**
+   * Sonic Mania's native dev menu. Kept off by default: the launcher owns its
+   * own overlay, and leaving this on can hijack boot flow.
+   */
+  devMenu?: boolean;
+  /** Enables the debug hooks exposed by the web build. */
+  engineDebugMode?: boolean;
+  /** VSync the engine's SDL window. */
+  vsync?: boolean;
+  /** Language numeric value used by the build's settings.ini. */
+  language?: number;
+  /** Region numeric value used by the build's settings.ini. */
+  region?: number;
+}
+
+export const DEFAULT_RSDKV5_OPTIONS: Required<Rsdkv5Options> = {
+  devMenu: false,
+  engineDebugMode: true,
+  vsync: true,
+  language: 0,
+  region: -1,
+};
+
+export const RSDKV5_OPTIONS_SCHEMA: JSONSchema = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    devMenu: {
+      type: 'boolean',
+      default: false,
+      description:
+        "Sonic Mania's native dev menu. The launcher provides its own overlay, so keep this off.",
+    },
+    engineDebugMode: {
+      type: 'boolean',
+      default: true,
+      description: 'Enables the web debug hooks.',
+    },
+    vsync: { type: 'boolean', default: true },
+    language: { type: 'integer', default: 0, minimum: 0 },
+    region: { type: 'integer', default: -1 },
+  },
+};