@lewismoten/gamemaker-sandbox-engine 0.0.0-stage → 3.1.0

package/dist/types/project/gameFiles.d.ts

@@ -0,0 +1,49 @@
+/** Files of a game still on their way from the site (project/streamGame.ts). */
+export interface FileStream {
+    /** Resolves once these files are in, or known not to come; undefined when none is still coming. */
+    need(names: string[]): Promise<void> | undefined;
+    /** Fetches these next, without waiting for them. */
+    want(names: string[]): void;
+}
+export declare class GameFiles {
+    private files;
+    /** Notified after any change. */
+    onChange?: (name: string) => void;
+    /** Set while files are still arriving: the game waits for one it needs (engine/machine.ts, need). */
+    stream?: FileStream;
+    /** Asked before set or delete changes a file; throws to refuse (a game opened to look inside, editor/core/readOnly.ts). */
+    guard?: (name: string) => void;
+    constructor(entries?: Iterable<[string, Uint8Array]>);
+    get(name: string | undefined): Uint8Array | undefined;
+    has(name: string | undefined): boolean;
+    /** The stored name a reference opens (see cdName), or undefined when there is none. */
+    resolve(name: string | undefined): string | undefined;
+    set(name: string, bytes: Uint8Array): void;
+    /**
+     * A copy of these files to change freely. While files are still arriving here, the copy
+     * gets them too as it needs them (its own changes stay).
+     */
+    copy(): GameFiles;
+    /** Adds a file that arrived (not one the game wrote): onChange is not told, and a file already here stays. */
+    put(name: string, bytes: Uint8Array): void;
+    delete(name: string): void;
+    names(): string[];
+    entries(): [string, Uint8Array][];
+    byExtension(ext: string): string[];
+    get size(): number;
+    /** The .gam file to play: the one named like the folder, else the first. */
+    mainGame(preferred?: string): string | undefined;
+}
+/**
+ * File names as DOS saw them: lower case, without folders, and cut to 8.3. DOS dropped the
+ * extra letters silently, so games could name "nejillian.gif" and open NEJILLIA.GIF.
+ */
+export declare function normalize(name: string): string;
+/**
+ * The name a file got on the Game-Maker CD. Its ISO 9660 copy allowed only A-Z, 0-9 and _,
+ * so A-J.BKD, PARSEC-W.GIF and CAN'T.GIF are a_j.bkd, parsec_w.gif and can_t.gif there,
+ * while the games still name them the DOS way. A name not found as is is looked up this way.
+ */
+export declare function cdName(name: string): string;
+/** Files only meaningful to DOS. */
+export declare const IGNORED_FILE: RegExp;

package/package.json

@@ -1,6 +1,28 @@
 {
   "name": "@lewismoten/gamemaker-sandbox-engine",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.1.0",
+  "description": "Browser engine for RSD Game-Maker games in their original DOS file formats",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lewismoten/GameMaker-SandboxEdition.git",
+    "directory": "web/packages/engine"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": ["dist", "README.md", "LICENSE", "NOTICE.md"],
+  "exports": {
+    ".": {
+      "types": "./dist/types/engine/package.d.ts",
+      "import": "./dist/engine.js"
+    }
+  },
+  "types": "./dist/types/engine/package.d.ts",
+  "scripts": {
+    "build": "vite build --config vite.config.ts && tsc -p tsconfig.build.json && cp ../../../LICENSE LICENSE && cp ../../../NOTICE.md NOTICE.md",
+    "prepack": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.0",
+    "vite": "^7.1.0"
+  }
+}