@wasm-gaming/engine-specs 0.2.6 → 0.3.0

package/demo/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "declaration": false,
+    "declarationMap": false,
+    "sourceMap": false,
+    "rootDir": "..",
+    "allowJs": true,
+    "checkJs": true
+  },
+  "include": [
+    "../src",
+    "demo.sdk.js",
+    "canvas-renderer.js"
+  ]
+}

package/dist/engine-specs.d.ts

@@ -0,0 +1,99 @@
+export interface PropertyDefinition<Value = unknown> {
+    value: Value;
+    default?: Value;
+    description?: string;
+    live?: boolean;
+    enum?: readonly Value[];
+    allowedTypes?: readonly string[];
+}
+export type PropertiesDefinition<T> = {
+    [K in keyof T]-?: PropertyDefinition<T[K]>;
+};
+export interface EngineConfig {
+    [key: string]: unknown;
+}
+export interface EngineOptions {
+    [key: string]: unknown;
+}
+export interface EngineAssets {
+    [key: string]: unknown;
+}
+export interface EngineStorage {
+    [key: string]: unknown;
+}
+/**
+ * Members are `object`, not the four interfaces above, on purpose: a named
+ * `interface MyEngineConfig { … }` has no implicit index signature, so
+ * constraining to a type that has one would reject exactly what a closed-type
+ * engine will write. Each engine can close its own config/options/assets/storage
+ * shapes without an index signature and still satisfy this constraint.
+ */
+export interface EnginePayloads {
+    config: object;
+    options: object;
+    assets: object;
+    storage: object;
+}
+export interface DefaultPayloads extends EnginePayloads {
+    config: EngineConfig;
+    options: EngineOptions;
+    assets: EngineAssets;
+    storage: EngineStorage;
+}
+export interface EngineInit<P extends EnginePayloads = DefaultPayloads> {
+    config?: Partial<P['config']>;
+    options?: Partial<P['options']>;
+    assets?: Partial<P['assets']>;
+    storage?: Partial<P['storage']>;
+    /**
+     * Not a `Partial`, unlike the four above: the payloads are patches merged onto a
+     * cumulative state, a mount target is a single value that replaces.
+     */
+    mount?: HTMLElement;
+}
+export interface EngineSurface<TSelf, P extends EnginePayloads = DefaultPayloads> {
+    config(): Promise<PropertiesDefinition<P['config']>>;
+    config(patch: Partial<P['config']>): TSelf;
+    options(): Promise<PropertiesDefinition<P['options']>>;
+    options(patch: Partial<P['options']>): TSelf;
+    assets(): Promise<PropertiesDefinition<P['assets']>>;
+    assets(patch: Partial<P['assets']>): TSelf;
+    storage(): Promise<PropertiesDefinition<P['storage']>>;
+    storage(patch: Partial<P['storage']>): TSelf;
+    mount(target: HTMLElement): TSelf;
+}
+export interface EnginePlay<P extends EnginePayloads = DefaultPayloads> extends EngineSurface<PromisePlay<P>, P> {
+    restart(options?: Partial<P['options']>): PromisePlay<P>;
+    destroy(): Promise<void>;
+}
+/**
+ * Structural, not nominal: an engine does NOT need to subclass the real
+ * `Promise` to satisfy this. Implementing `then`/`catch`/`finally` with the
+ * right signatures — typically by delegating to an internal real `Promise` —
+ * is enough. Note that `extends Promise<T>` also pulls in
+ * `[Symbol.toStringTag]: string` via lib.es2015.symbol.wellknown, so an
+ * implementer needs that member too, not just the three methods.
+ */
+export interface PromisePlay<P extends EnginePayloads = DefaultPayloads> extends Promise<EnginePlay<P>>, EngineSurface<PromisePlay<P>, P> {
+    restart(options?: Partial<P['options']>): PromisePlay<P>;
+    destroy(): Promise<void>;
+}
+export interface EngineSDK<P extends EnginePayloads = DefaultPayloads> extends EngineSurface<EngineSDK<P>, P> {
+    boot(init?: EngineInit<P>): PromisePlay<P>;
+    start(options?: Partial<P['options']>): PromisePlay<P>;
+}
+/**
+ * Identity lives on the constructor, not on an instance: a launcher listing engines
+ * reads `Rsdkv4SDK.id` from the imported class, without constructing anything.
+ */
+export interface EngineSDKConstructor<P extends EnginePayloads = DefaultPayloads> {
+    /** Stable engine id, e.g. "rsdkv4" | "fbneo" | "blastem" | "jgenesis" | "smw". */
+    readonly id: string;
+    /** SemVer of this engine build/contract implementation. */
+    readonly version: string;
+    /** Human-readable name. */
+    readonly name?: string;
+    readonly description?: string;
+    new (init?: EngineInit<P>): EngineSDK<P>;
+}
+//# sourceMappingURL=engine-specs.d.ts.map

package/dist/engine-specs.d.ts.map

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

package/dist/engine-specs.js

@@ -0,0 +1,3 @@
+// ---- Introspectable property definitions ----
+export {};
+//# sourceMappingURL=engine-specs.js.map

package/dist/engine-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-specs.js","sourceRoot":"","sources":["../src/engine-specs.ts"],"names":[],"mappings":"AAAA,gDAAgD"}

package/package.json

@@ -1,21 +1,19 @@
 {
   "name": "@wasm-gaming/engine-specs",
-  "version": "0.2.6",
-  "description": "The wasm-gaming engine contract: the single shared interface every WASM game/emulator engine and the host app conform to. TypeScript types + JSON Schema + a Zod runtime validator.",
+  "version": "0.3.0",
+  "description": "The wasm-gaming engine contract: the single shared JS API every WASM game/emulator engine and the host app conform to. TypeScript types, no runtime dependencies.",
   "type": "module",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/engine-specs.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./schema/engine-manifest.json": "./schema/engine-manifest.schema.json"
+      "types": "./dist/engine-specs.d.ts",
+      "import": "./dist/engine-specs.js"
+    }
   },
   "files": [
     "dist/",
     "demo/",
-    "src/",
-    "schema/"
+    "src/"
   ],
   "publishConfig": {
     "access": "public",
@@ -23,14 +21,12 @@
     "provenance": true
   },
   "devDependencies": {
+    "typedoc": "^0.28.20",
     "typescript": "^5.5.0"
   },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/wasm-gaming/engine-specs.git"
-  },
-  "dependencies": {
-    "zod": "^4.4.3"
   }
 }

package/src/engine-specs.ts

@@ -0,0 +1,110 @@
+// ---- Introspectable property definitions ----
+
+export interface PropertyDefinition<Value = unknown> {
+  value: Value;
+  default?: Value;
+  description?: string;
+  live?: boolean; // Absent means `false`. `true` = changing it applies to current play session.
+  enum?: readonly Value[];
+  allowedTypes?: readonly string[];
+}
+
+export type PropertiesDefinition<T> = { [K in keyof T]-?: PropertyDefinition<T[K]> };
+
+// ---- Default open payloads, for an engine that doesn't close its types ----
+
+export interface EngineConfig { [key: string]: unknown }
+export interface EngineOptions { [key: string]: unknown }
+export interface EngineAssets { [key: string]: unknown }
+export interface EngineStorage { [key: string]: unknown }
+
+/**
+ * Members are `object`, not the four interfaces above, on purpose: a named
+ * `interface MyEngineConfig { … }` has no implicit index signature, so
+ * constraining to a type that has one would reject exactly what a closed-type
+ * engine will write. Each engine can close its own config/options/assets/storage
+ * shapes without an index signature and still satisfy this constraint.
+ */
+export interface EnginePayloads {
+  config: object;
+  options: object;
+  assets: object;
+  storage: object;
+}
+
+export interface DefaultPayloads extends EnginePayloads {
+  config: EngineConfig;
+  options: EngineOptions;
+  assets: EngineAssets;
+  storage: EngineStorage;
+}
+
+export interface EngineInit<P extends EnginePayloads = DefaultPayloads> {
+  config?: Partial<P['config']>;
+  options?: Partial<P['options']>;
+  assets?: Partial<P['assets']>;
+  storage?: Partial<P['storage']>;
+  /**
+   * Not a `Partial`, unlike the four above: the payloads are patches merged onto a
+   * cumulative state, a mount target is a single value that replaces.
+   */
+  mount?: HTMLElement;
+}
+
+// ---- The shared fluent surface: the members every carrier exposes ----
+
+export interface EngineSurface<TSelf, P extends EnginePayloads = DefaultPayloads> {
+  config(): Promise<PropertiesDefinition<P['config']>>;
+  config(patch: Partial<P['config']>): TSelf;
+  options(): Promise<PropertiesDefinition<P['options']>>;
+  options(patch: Partial<P['options']>): TSelf;
+  assets(): Promise<PropertiesDefinition<P['assets']>>;
+  assets(patch: Partial<P['assets']>): TSelf;
+  storage(): Promise<PropertiesDefinition<P['storage']>>;
+  storage(patch: Partial<P['storage']>): TSelf;
+  mount(target: HTMLElement): TSelf;
+}
+
+// ---- Public contract each WASM engine must implement ----
+
+export interface EnginePlay<P extends EnginePayloads = DefaultPayloads>
+  extends EngineSurface<PromisePlay<P>, P> {
+  restart(options?: Partial<P['options']>): PromisePlay<P>;
+  destroy(): Promise<void>;
+}
+
+/**
+ * Structural, not nominal: an engine does NOT need to subclass the real
+ * `Promise` to satisfy this. Implementing `then`/`catch`/`finally` with the
+ * right signatures — typically by delegating to an internal real `Promise` —
+ * is enough. Note that `extends Promise<T>` also pulls in
+ * `[Symbol.toStringTag]: string` via lib.es2015.symbol.wellknown, so an
+ * implementer needs that member too, not just the three methods.
+ */
+export interface PromisePlay<P extends EnginePayloads = DefaultPayloads>
+  extends Promise<EnginePlay<P>>, EngineSurface<PromisePlay<P>, P> {
+  restart(options?: Partial<P['options']>): PromisePlay<P>;
+  destroy(): Promise<void>;
+}
+
+export interface EngineSDK<P extends EnginePayloads = DefaultPayloads>
+  extends EngineSurface<EngineSDK<P>, P> {
+  boot(init?: EngineInit<P>): PromisePlay<P>;
+  start(options?: Partial<P['options']>): PromisePlay<P>;
+}
+
+/**
+ * Identity lives on the constructor, not on an instance: a launcher listing engines
+ * reads `Rsdkv4SDK.id` from the imported class, without constructing anything.
+ */
+export interface EngineSDKConstructor<P extends EnginePayloads = DefaultPayloads> {
+  /** Stable engine id, e.g. "rsdkv4" | "fbneo" | "blastem" | "jgenesis" | "smw". */
+  readonly id: string;
+  /** SemVer of this engine build/contract implementation. */
+  readonly version: string;
+  /** Human-readable name. */
+  readonly name?: string;
+  readonly description?: string;
+
+  new (init?: EngineInit<P>): EngineSDK<P>;
+}

package/demo/README.md

@@ -1,155 +0,0 @@
-# Themable Engine Demo Template
-
-This directory contains a standalone, themable web interface template for hosting interactive WASM gaming engine demos.
-
-## 🚀 How to use in another engine repository
-
-1. **Copy the `demo/` folder** into your engine repository.
-
-2. **Initialize via ES module script**:
-   ```html
-   <script type="module">
-     import demo from './demo.js'
-     import sdk from './demo.sdk.js' // Or your engine SDK import
-
-     demo
-       .init({
-         messages: {
-           title: 'My Custom Engine Demo',
-         },
-         bios: false, // 'required' | 'optional' | false
-         escMenu: {
-           enabled: true,
-           title: 'Game Pause Menu',
-           items: [
-             { label: 'Toggle Fullscreen', action: (instance) => { document.documentElement.requestFullscreen?.(); } }
-           ],
-         },
-       })
-       .on('file', ({ type, action, file }) => {
-         if (file) {
-           console.log(`[Demo] Selected ${type} file: ${file.name}`)
-         }
-       })
-       .on('launch', async (e) => {
-         const assets = {}
-
-         // if rom loaded
-         if (demo.hasFile('rom')) {
-           assets.rom = await demo.loadToMEMFS('rom')
-         }
-
-         // if bios required and loaded
-         if (demo.hasFile('bios')) {
-           assets.bios = await demo.loadToMEMFS('bios')
-         }
-
-         const instance = await sdk.load({
-           attachTo: e.attachTo,
-           assets,
-           options: { fileName: e.fileName, byteLength: e.byteLength },
-         })
-
-         instance.start()
-         return instance
-       })
-   </script>
-   ```
-
----
-
-## 🎮 Component79 ESC Menu
-
-The demo includes an interactive, customizable in-game ESC pause menu component built with **Component79**.
-
-### ESC Menu Options (`escMenu`)
-
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `enabled` | `boolean` | `true` | Enable/disable in-game ESC menu overlay. |
-| `title` | `string` | `"Game Menu"` | Title displayed at top of ESC menu modal. |
-| `shortcutKey` | `string` | `"Escape"` | Keyboard key that toggles the menu overlay. |
-| `showTriggerButton` | `boolean` | `true` | Display floating top-right "ESC Menu" trigger badge for mouse/touch access. |
-| `items` | `Array<{label: string, action: function}>` | `[]` | Custom action buttons added to ESC menu. |
-| `onReset` | `function` | `instance.reset()` | Callback when Reset Game button is pressed. |
-| `onExit` | `function` | `instance.destroy()` | Callback when Exit to Launcher button is pressed. |
-| `onSaveState` | `function` | `instance.saveState()` | Callback when Save State button is pressed. |
-| `onLoadState` | `function` | `instance.loadState()` | Callback when Load State button is pressed. |
-
----
-
-## 🎨 Customizing & Theming
-
-The demo visual design system is fully controlled via **CSS Custom Properties** defined in `demo.css`.
-
-### Overriding CSS Variables
-
-To apply your custom branding, override any of the `:root` variables in `demo.css` or in your own custom stylesheet:
-
-```css
-:root {
-  /* Brand colors */
-  --demo-bg-a: #1e1b4b;
-  --demo-bg-b: #0f172a;
-  --demo-text: #f8fafc;
-  --demo-muted: #94a3b8;
-
-  /* Accent highlights */
-  --demo-accent: #00ffcc;
-  --demo-accent-rgb: 0, 255, 204;
-  --demo-accent2: #38bdf8;
-  --demo-accent2-rgb: 56, 189, 248;
-
-  /* Glassmorphism panels */
-  --demo-panel-bg: rgba(15, 23, 42, 0.75);
-  --demo-panel-border: rgba(255, 255, 255, 0.1);
-  --demo-subpanel-bg: rgba(30, 41, 59, 0.6);
-  --demo-subpanel-border: rgba(255, 255, 255, 0.1);
-
-  /* ESC Menu styling */
-  --demo-esc-bg: rgba(6, 9, 16, 0.85);
-  --demo-esc-card-bg: rgba(15, 23, 42, 0.9);
-  --demo-esc-text: #f8fafc;
-}
-```
-
-### Full Token Reference
-
-| Variable | Description | Default |
-|---|---|---|
-| `--demo-bg-a` | Gradient background stop 1 | `#d8b4fe` |
-| `--demo-bg-b` | Gradient background stop 2 | `#7dd3fc` |
-| `--demo-text` | Primary text color | `#0f172a` |
-| `--demo-muted` | Secondary/muted text color | `#475569` |
-| `--demo-accent` | Primary accent color | `#ff007f` |
-| `--demo-accent-rgb` | Primary accent RGB channels | `255, 0, 127` |
-| `--demo-accent2` | Secondary accent color | `#0284c7` |
-| `--demo-accent2-rgb` | Secondary accent RGB channels | `2, 132, 199` |
-| `--demo-panel-bg` | Main card/launcher background | `rgba(255, 255, 255, 0.25)` |
-| `--demo-panel-border` | Main card border color | `rgba(255, 255, 255, 0.4)` |
-| `--demo-panel-radius` | Main card corner rounding | `12px` |
-| `--demo-panel-blur` | Backdrop glass blur effect | `24px` |
-| `--demo-subpanel-bg` | Inner info section background | `rgba(255, 255, 255, 0.35)` |
-| `--demo-drop-bg` | Dropzone background | `rgba(255, 255, 255, 0.15)` |
-| `--demo-drop-active-bg` | Drag-over active background | `rgba(255, 255, 255, 0.4)` |
-| `--demo-picker-bg` | Pick File button background | `rgba(255, 255, 255, 0.5)` |
-| `--demo-pill-bg` | Metadata badge background | `rgba(var(--demo-accent-rgb), 0.1)` |
-| `--demo-file-info-bg` | Canvas overlay panel background | `rgba(255, 255, 255, 0.7)` |
-| `--demo-esc-bg` | ESC menu overlay background | `rgba(6, 9, 16, 0.82)` |
-| `--demo-esc-card-bg` | ESC menu card background | `rgba(15, 23, 42, 0.88)` |
-| `--demo-esc-text` | ESC menu text color | `#f8fafc` |
-| `--demo-font-sans` | Primary sans-serif font family | `"Outfit", system-ui, sans-serif` |
-| `--demo-font-mono` | Monospace code font family | `"Space Mono", monospace` |
-
----
-
-## 🛠 Features
-
-- **Component79 ESC Menu**: Customizable pause menu overlay with keydown listeners and touch/mouse badges.
-- **OPFS Asset Persistence**: Automatically stores selected ROM and BIOS files in the Origin Private File System (`navigator.storage.getDirectory()`), restoring them automatically across page reloads.
-- **Split Asset Drop Zones**: Independent drop/picker areas for optional **BIOS** firmware and game **ROM** assets.
-- **Dedicated Launch Trigger**: Prominent launch button that activates once required game assets are selected.
-- **Automated Manifest Integration**: Page title, SDK info, asset key mapping, and file type (`accept`) filters are automatically loaded from `sdk.manifest`.
-- **Checksum Calculation**: Computes MD5, SHA-1, and SHA-256 hashes of loaded files asynchronously in the background.
-- **Shadow DOM Isolation**: UI components are isolated using Shadow DOM to prevent style leakage.
-- **Subpath Hosting Ready**: Uses `import.meta.url` for component templates to work seamlessly on subpaths (e.g. GitHub Pages).

package/demo/checksums.js

@@ -1,101 +0,0 @@
-const CRC_TABLE = Uint32Array.from({ length: 256 }, (_, n) => {
-  let c = n;
-  for (let k = 0; k < 8; k += 1) {
-    c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
-  }
-  return c >>> 0;
-});
-
-const crc32 = (bytes) => {
-  let crc = 0xffffffff;
-  for (const byte of bytes) {
-    crc = CRC_TABLE[(crc ^ byte) & 0xff] ^ (crc >>> 8);
-  }
-  return ((crc ^ 0xffffffff) >>> 0).toString(16).padStart(8, "0");
-};
-
-const toHex = (buffer) =>
-  Array.from(new Uint8Array(buffer), (byte) => byte.toString(16).padStart(2, "0")).join("");
-
-// RFC 1321. Hand-rolled because crypto.subtle does not offer MD5.
-const MD5_K = Uint32Array.from({ length: 64 }, (_, i) =>
-  Math.floor(Math.abs(Math.sin(i + 1)) * 2 ** 32));
-
-const MD5_S = [
-  7, 12, 17, 22, 7, 12, 17, 22, 7, 12, 17, 22, 7, 12, 17, 22,
-  5, 9, 14, 20, 5, 9, 14, 20, 5, 9, 14, 20, 5, 9, 14, 20,
-  4, 11, 16, 23, 4, 11, 16, 23, 4, 11, 16, 23, 4, 11, 16, 23,
-  6, 10, 15, 21, 6, 10, 15, 21, 6, 10, 15, 21, 6, 10, 15, 21,
-];
-
-const md5 = (bytes) => {
-  const paddedLength = (((bytes.length + 8) >> 6) + 1) << 6;
-  const padded = new Uint8Array(paddedLength);
-  padded.set(bytes);
-  padded[bytes.length] = 0x80;
-  const view = new DataView(padded.buffer);
-  view.setUint32(paddedLength - 8, (bytes.length * 8) >>> 0, true);
-  view.setUint32(paddedLength - 4, Math.floor(bytes.length / 0x20000000), true);
-
-  let [h0, h1, h2, h3] = [0x67452301, 0xefcdab89, 0x98badcfe, 0x10325476];
-  const words = new Uint32Array(16);
-
-  for (let offset = 0; offset < paddedLength; offset += 64) {
-    for (let j = 0; j < 16; j += 1) {
-      words[j] = view.getUint32(offset + j * 4, true);
-    }
-    let [a, b, c, d] = [h0, h1, h2, h3];
-    for (let i = 0; i < 64; i += 1) {
-      let f;
-      let g;
-      if (i < 16) {
-        f = (b & c) | (~b & d);
-        g = i;
-      } else if (i < 32) {
-        f = (d & b) | (~d & c);
-        g = (5 * i + 1) % 16;
-      } else if (i < 48) {
-        f = b ^ c ^ d;
-        g = (3 * i + 5) % 16;
-      } else {
-        f = c ^ (b | ~d);
-        g = (7 * i) % 16;
-      }
-      const sum = (a + f + MD5_K[i] + words[g]) >>> 0;
-      const rotated = (sum << MD5_S[i]) | (sum >>> (32 - MD5_S[i]));
-      [a, b, c, d] = [d, (b + rotated) >>> 0, b, c];
-    }
-    h0 = (h0 + a) >>> 0;
-    h1 = (h1 + b) >>> 0;
-    h2 = (h2 + c) >>> 0;
-    h3 = (h3 + d) >>> 0;
-  }
-
-  const digest = new DataView(new ArrayBuffer(16));
-  digest.setUint32(0, h0, true);
-  digest.setUint32(4, h1, true);
-  digest.setUint32(8, h2, true);
-  digest.setUint32(12, h3, true);
-  return toHex(digest.buffer);
-};
-
-const sha = async (algorithm, buffer) => {
-  // crypto.subtle only exists in secure contexts (https or localhost).
-  if (!globalThis.crypto?.subtle) {
-    return "unavailable (requires a secure context)";
-  }
-  return toHex(await crypto.subtle.digest(algorithm, buffer));
-};
-
-export const checksumAlgorithms = ["CRC32", "MD5", "SHA-1", "SHA-256"];
-
-export async function computeChecksums(buffer) {
-  const bytes = new Uint8Array(buffer);
-  const [sha1, sha256] = await Promise.all([sha("SHA-1", buffer), sha("SHA-256", buffer)]);
-  return [
-    { label: "CRC32", value: crc32(bytes) },
-    { label: "MD5", value: md5(bytes) },
-    { label: "SHA-1", value: sha1 },
-    { label: "SHA-256", value: sha256 },
-  ];
-}