@lewismoten/gamemaker-sandbox-tools 3.1.0 → 3.4.0

package/dist/types/paletteReserve.d.ts

@@ -0,0 +1,52 @@
+import type { Block } from '@lewismoten/gamemaker-sandbox-engine/formats/blocks';
+import { type ReduceScore } from './colorReduce.js';
+/** Color numbers 1-15 hold the engine's own interface colors (an inference from PLAYGAME's Box calls), so a proposed range starts at 16. */
+export declare const FIRST_FREE = 16;
+export declare const LAST_FREE = 254;
+/** A sprite range never grows past this many colors; blocks with more get reduced. */
+export declare const RANGE_CAP = 48;
+export interface RoleDemand {
+    role: 'monster' | 'character';
+    /** Different colors (by RGB) the role's shown blocks draw. */
+    distinct: number;
+    /** How many pixels of the role's blocks use each color number, as drawn in their first palette. */
+    usage: number[];
+}
+export interface Proposed {
+    first: number;
+    last: number;
+    role: 'monster' | 'character';
+    /** Pixels of other blocks that already use a color number in this range (the sync must move or reduce them first). */
+    conflicts: number;
+}
+/** Windows for each sprite role, biggest first. `others[i]` counts pixels of other (background) blocks using color i. */
+export declare function planRanges(demands: readonly RoleDemand[], others: readonly number[]): Proposed[];
+export interface SyncFile {
+    blocks: Block[];
+    /** The block numbers scenes show. */
+    shown: ReadonlySet<number>;
+    /** Keys of the palettes the file is shown with; the first is its reference. */
+    palettes: string[];
+}
+export interface SyncResult {
+    ok: true;
+    /** Per file, the blocks whose pixels were renumbered. */
+    pixels: Map<number, Map<number, Uint8Array>>;
+    /** Per palette key, the new 768 bytes (only palettes that changed). */
+    palettes: Map<string, Uint8Array>;
+    score: ReduceScore;
+    /** Blocks (file index, number) whose picture changes, worst first. */
+    changed: {
+        file: number;
+        n: number;
+        mean: number;
+    }[];
+    /** Colors the range holds, and colors that were more than it holds. */
+    used: number;
+    reduced: number;
+}
+/** Makes `first..last` the same in every palette: the role's colors move in, scored. `blocked` is per palette the color numbers other files draw with. */
+export declare function syncRange(files: readonly SyncFile[], palettes: ReadonlyMap<string, Uint8Array>, first: number, last: number, blocked: ReadonlyMap<string, ReadonlySet<number>>): SyncResult | {
+    ok: false;
+    why: string;
+};

package/dist/types/palettes.d.ts

@@ -0,0 +1,4 @@
+import type { Palette } from '@lewismoten/gamemaker-sandbox-engine/formats/palette';
+export { PALETTE_PRESETS, createPalettePreset, type PalettePreset } from './palettePresets.js';
+/** A fresh copy of the original Library palette (768 VGA bytes, black at index zero). */
+export declare function libraryDefaultPalette(): Palette;

package/dist/types/releaseNotes.d.ts

@@ -0,0 +1,3 @@
+import type { DiskDiff } from './diskDiff.js';
+/** Release-note text for a diff, or '' when nothing differs. Sentences: Changed, Added, Removed. */
+export declare function releaseNotes(d: DiskDiff): string;

package/dist/types/simulation.d.ts

@@ -0,0 +1,6 @@
+export { Sim, type SimScene } from './kit/sceneSim.js';
+export { GameSim, readDisk, diskSim, TICKS_PER_SECOND } from './kit/gameSim.js';
+export { newCharInfo, type CharInfo } from '@lewismoten/gamemaker-sandbox-engine/engine/world';
+export * from './kit/sceneInit.js';
+export * from './kit/routeChecks.js';
+export { type State as GameSimState } from './kit/gameSim.js';

package/dist/types/{web/packages/tools/src/text.d.ts → text.d.ts}

@@ -1,9 +1,9 @@
-import { FONT_CP437 } from '../../../src/gfx/cp437Glyphs.js';
-import { toCp437, fromCp437 } from '../../../src/retro/text/cp437.js';
-import { Pixels } from '../../../../games/kit/pixels.js';
-import { MICRO_GLYPHS } from './microFont.js';
-export { FONT_CP437, toCp437, fromCp437, MICRO_GLYPHS };
-export type TextFont = 'cp437' | 'micro';
+import { FONT_CP437 } from '@lewismoten/gamemaker-sandbox-engine/gfx/cp437Glyphs';
+import { toCp437, fromCp437 } from '@lewismoten/gamemaker-sandbox-engine/text/cp437';
+import { Pixels } from './kit/pixels.js';
+import { MICRO_GLYPHS, MICRO_SQUARE_GLYPHS } from './microFont.js';
+export { FONT_CP437, toCp437, fromCp437, MICRO_GLYPHS, MICRO_SQUARE_GLYPHS };
+export type TextFont = 'cp437' | 'micro' | 'micro-square';
 /** Encode Unicode DOS symbols, including box drawing. Unsupported characters throw. */
 export declare function encodeText(s: string): Uint8Array;
 /** A fresh copy of a glyph's rows; bit 0 is the leftmost pixel. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lewismoten/gamemaker-sandbox-tools",
-  "version": "3.1.0",
+  "version": "3.4.0",
   "description": "Development tools for building and checking games in RSD Game-Maker formats",
   "type": "module",
   "license": "MIT",
@@ -15,34 +15,160 @@
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     "NOTICE.md"
   ],
   "exports": {
-    "./formats/*": {
-      "types": "./dist/types/web/src/formats/*.d.ts",
-      "browser": null,
-      "import": "./dist/formats/*.js"
-    },
     "./drawing": {
-      "types": "./dist/types/web/packages/tools/src/drawing.d.ts",
+      "types": "./dist/types/drawing.d.ts",
       "browser": null,
+      "gamemaker-source": "./src/drawing.ts",
       "import": "./dist/drawing.js"
     },
     "./audio": {
-      "types": "./dist/types/web/packages/tools/src/audio.d.ts",
-      "browser": null,
+      "types": "./dist/types/audio.d.ts",
+      "gamemaker-source": "./src/audio.ts",
       "import": "./dist/audio.js"
     },
     "./images": {
-      "types": "./dist/types/web/packages/tools/src/images.d.ts",
-      "browser": null,
+      "types": "./dist/types/images.d.ts",
+      "gamemaker-source": "./src/images.ts",
       "import": "./dist/images.js"
     },
     "./simulation": {
-      "types": "./dist/types/web/packages/tools/src/simulation.d.ts",
+      "types": "./dist/types/simulation.d.ts",
       "browser": null,
+      "gamemaker-source": "./src/simulation.ts",
       "import": "./dist/simulation.js"
+    },
+    "./formats/*": {
+      "types": "./dist/types/formats/*.d.ts",
+      "browser": null,
+      "gamemaker-source": "./src/formats/*.ts",
+      "import": "./dist/formats/*.js"
+    },
+    "./kit/tar": {
+      "types": "./dist/types/kit/tar.d.ts",
+      "gamemaker-source": "./src/kit/tar.ts",
+      "import": "./dist/kit/tar.js"
+    },
+    "./kit/fliShrink": {
+      "types": "./dist/types/kit/fliShrink.d.ts",
+      "gamemaker-source": "./src/kit/fliShrink.ts",
+      "import": "./dist/kit/fliShrink.js"
+    },
+    "./kit/blockRoles": {
+      "types": "./dist/types/kit/blockRoles.d.ts",
+      "gamemaker-source": "./src/kit/blockRoles.ts",
+      "import": "./dist/kit/blockRoles.js"
+    },
+    "./kit/levelGen": {
+      "types": "./dist/types/kit/levelGen/index.d.ts",
+      "gamemaker-source": "./src/kit/levelGen/index.ts",
+      "import": "./dist/kit/levelGen.js"
+    },
+    "./kit/*": {
+      "types": "./dist/types/kit/*.d.ts",
+      "browser": null,
+      "gamemaker-source": "./src/kit/*.ts",
+      "import": "./dist/kit/*.js"
+    },
+    "./music/*": {
+      "types": "./dist/types/music/*.d.ts",
+      "gamemaker-source": "./src/music/*.ts",
+      "import": "./dist/music/*.js"
+    },
+    "./embroidery/*": {
+      "types": "./dist/types/embroidery/*.d.ts",
+      "gamemaker-source": "./src/embroidery/*.ts",
+      "import": "./dist/embroidery/*.js"
+    },
+    "./mesh/*": {
+      "types": "./dist/types/mesh/*.d.ts",
+      "gamemaker-source": "./src/mesh/*.ts",
+      "import": "./dist/mesh/*.js"
+    },
+    "./pack/*": {
+      "types": "./dist/types/pack/*.d.ts",
+      "gamemaker-source": "./src/pack/*.ts",
+      "import": "./dist/pack/*.js"
+    },
+    "./image/*": {
+      "types": "./dist/types/image/*.d.ts",
+      "gamemaker-source": "./src/image/*.ts",
+      "import": "./dist/image/*.js"
+    },
+    "./audio-files": {
+      "types": "./dist/types/audioFiles.d.ts",
+      "browser": null,
+      "gamemaker-source": "./src/audioFiles.ts",
+      "import": "./dist/audio-files.js"
+    },
+    "./block-merge": {
+      "types": "./dist/types/blockMerge.d.ts",
+      "gamemaker-source": "./src/blockMerge.ts",
+      "import": "./dist/block-merge.js"
+    },
+    "./look-alike": {
+      "types": "./dist/types/lookAlike.d.ts",
+      "gamemaker-source": "./src/lookAlike.ts",
+      "import": "./dist/look-alike.js"
+    },
+    "./palette-reserve": {
+      "types": "./dist/types/paletteReserve.d.ts",
+      "gamemaker-source": "./src/paletteReserve.ts",
+      "import": "./dist/palette-reserve.js"
+    },
+    "./gif-shrink": {
+      "types": "./dist/types/gifShrink.d.ts",
+      "gamemaker-source": "./src/gifShrink.ts",
+      "import": "./dist/gif-shrink.js"
+    },
+    "./color-reduce": {
+      "types": "./dist/types/colorReduce.d.ts",
+      "gamemaker-source": "./src/colorReduce.ts",
+      "import": "./dist/color-reduce.js"
+    },
+    "./delta": {
+      "types": "./dist/types/delta.d.ts",
+      "gamemaker-source": "./src/delta.ts",
+      "import": "./dist/delta.js"
+    },
+    "./disk-diff": {
+      "types": "./dist/types/diskDiff.d.ts",
+      "gamemaker-source": "./src/diskDiff.ts",
+      "import": "./dist/disk-diff.js"
+    },
+    "./release-notes": {
+      "types": "./dist/types/releaseNotes.d.ts",
+      "gamemaker-source": "./src/releaseNotes.ts",
+      "import": "./dist/release-notes.js"
+    },
+    "./menu-version": {
+      "types": "./dist/types/menuVersionEntry.d.ts",
+      "gamemaker-source": "./src/menuVersionEntry.ts",
+      "import": "./dist/menu-version.js"
+    },
+    "./microFont": {
+      "types": "./dist/types/microFont.d.ts",
+      "gamemaker-source": "./src/microFont.ts",
+      "import": "./dist/microFont.js"
+    },
+    "./colors": {
+      "types": "./dist/types/colors.d.ts",
+      "gamemaker-source": "./src/colors.ts",
+      "import": "./dist/colors.js"
+    },
+    "./text": {
+      "types": "./dist/types/text.d.ts",
+      "gamemaker-source": "./src/text.ts",
+      "import": "./dist/text.js"
+    },
+    "./palettes": {
+      "types": "./dist/types/palettes.d.ts",
+      "gamemaker-source": "./src/palettes.ts",
+      "import": "./dist/palettes.js"
     }
   },
   "scripts": {
@@ -56,7 +182,11 @@
     "vite": "^7.1.0"
   },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  }
+    "registry": "https://npm.pkg.github.com/"
+  },
+  "dependencies": {
+    "@lewismoten/gamemaker-sandbox-engine": "^3.2.0",
+    "@lewismoten/gamemaker-sandbox-archives": "^3.2.0"
+  },
+  "author": "Lewis Moten"
 }

package/dist/binary-D7wuaC5g.js

@@ -1,120 +0,0 @@
-const n = new TextDecoder("latin1");
-class h {
-  bytes;
-  offset;
-  constructor(t, s = 0) {
-    this.bytes = t, this.offset = s;
-  }
-  get length() {
-    return this.bytes.length;
-  }
-  get eof() {
-    return this.offset >= this.bytes.length;
-  }
-  skip(t) {
-    return this.offset += t, this;
-  }
-  u8() {
-    const t = this.offset < this.bytes.length ? this.bytes[this.offset] : 0;
-    return this.offset++, t;
-  }
-  i8() {
-    const t = this.u8();
-    return t > 127 ? t - 256 : t;
-  }
-  u16() {
-    return this.u8() | this.u8() << 8;
-  }
-  i16() {
-    const t = this.u16();
-    return t > 32767 ? t - 65536 : t;
-  }
-  u32() {
-    return (this.u16() | this.u16() << 16) >>> 0;
-  }
-  i32() {
-    return this.u16() | this.u16() << 16;
-  }
-  /** Copies n bytes (zero padded when the source is short). */
-  bytesOf(t) {
-    const s = new Uint8Array(t), e = Math.max(0, Math.min(t, this.bytes.length - this.offset));
-    return e > 0 && s.set(this.bytes.subarray(this.offset, this.offset + e)), this.offset += t, s;
-  }
-  /** Reads a fixed size, NUL terminated string field. */
-  cstr(t) {
-    return u(this.bytesOf(t));
-  }
-}
-class f {
-  buf;
-  offset = 0;
-  constructor(t = 1024) {
-    this.buf = new Uint8Array(t);
-  }
-  ensure(t) {
-    if (this.offset + t <= this.buf.length) return;
-    let s = this.buf.length * 2;
-    for (; s < this.offset + t; ) s *= 2;
-    const e = new Uint8Array(s);
-    e.set(this.buf), this.buf = e;
-  }
-  u8(t) {
-    return this.ensure(1), this.buf[this.offset++] = t & 255, this;
-  }
-  // Signed writes store the same two's complement bytes as the unsigned ones.
-  i8(t) {
-    return this.u8(t);
-  }
-  u16(t) {
-    return this.u8(t).u8(t >> 8);
-  }
-  i16(t) {
-    return this.u16(t);
-  }
-  u32(t) {
-    return this.u16(t & 65535).u16(t >>> 16 & 65535);
-  }
-  i32(t) {
-    return this.u32(t >>> 0);
-  }
-  bytes(t, s = t.length) {
-    this.ensure(s);
-    for (let e = 0; e < s; e++) this.buf[this.offset++] = e < t.length ? t[e] & 255 : 0;
-    return this;
-  }
-  /** Writes a string into a fixed size NUL padded field (truncated to leave room for the NUL). */
-  cstr(t, s) {
-    const e = new Uint8Array(s);
-    for (let i = 0; i < Math.min(t.length, s - 1); i++) e[i] = t.charCodeAt(i) & 255;
-    return this.bytes(e);
-  }
-  /**
-   * Writes a fixed size string field. When the text is unchanged the original raw
-   * bytes (including any garbage after the NUL) are kept so files round-trip exactly.
-   */
-  cstrOver(t, s, e) {
-    return s && s.length === e && u(s) === t ? this.bytes(s) : this.cstr(t, e);
-  }
-  toBytes() {
-    return this.buf.slice(0, this.offset);
-  }
-}
-function u(r) {
-  const t = r.indexOf(0);
-  return n.decode(t < 0 ? r : r.subarray(0, t));
-}
-function o(r) {
-  return n.decode(r);
-}
-function c(r) {
-  const t = new Uint8Array(r.length);
-  for (let s = 0; s < r.length; s++) t[s] = r.charCodeAt(s) & 255;
-  return t;
-}
-export {
-  h as R,
-  f as W,
-  u as c,
-  o as l,
-  c as t
-};

package/dist/pixels-DzfIIUOl.js

@@ -1,76 +0,0 @@
-class a {
-  constructor(s, t, h = 0) {
-    this.w = s, this.h = t, this.px = new Uint8Array(s * t).fill(h);
-  }
-  get(s, t) {
-    return s < 0 || t < 0 || s >= this.w || t >= this.h ? -1 : this.px[t * this.w + s];
-  }
-  set(s, t, h) {
-    return s = Math.round(s), t = Math.round(t), s >= 0 && t >= 0 && s < this.w && t < this.h && (this.px[t * this.w + s] = h), this;
-  }
-  rect(s, t, h, e, i) {
-    for (let r = t; r < t + e; r++) for (let n = s; n < s + h; n++) this.set(n, r, i);
-    return this;
-  }
-  frame(s, t, h, e, i) {
-    return this.rect(s, t, h, 1, i).rect(s, t + e - 1, h, 1, i), this.rect(s, t, 1, e, i).rect(s + h - 1, t, 1, e, i);
-  }
-  line(s, t, h, e, i) {
-    const r = Math.max(Math.abs(h - s), Math.abs(e - t), 1);
-    for (let n = 0; n <= r; n++) this.set(s + (h - s) * n / r, t + (e - t) * n / r, i);
-    return this;
-  }
-  disc(s, t, h, e) {
-    for (let i = Math.floor(t - h); i <= t + h; i++)
-      for (let r = Math.floor(s - h); r <= s + h; r++) (r - s) ** 2 + (i - t) ** 2 <= h * h && this.set(r, i, e);
-    return this;
-  }
-  ring(s, t, h, e) {
-    for (let i = 0; i < Math.PI * 2; i += 0.5 / Math.max(1, h)) this.set(s + Math.cos(i) * h, t + Math.sin(i) * h, e);
-    return this;
-  }
-  /** Every pixel through fn(x, y, current) → new color (or the same). */
-  map(s) {
-    for (let t = 0; t < this.h; t++) for (let h = 0; h < this.w; h++) this.px[t * this.w + h] = s(h, t, this.px[t * this.w + h]);
-    return this;
-  }
-  /** Copies another picture in, skipping `transparent` pixels. */
-  blit(s, t, h, e = -1) {
-    for (let i = 0; i < s.h; i++)
-      for (let r = 0; r < s.w; r++) {
-        const n = s.px[i * s.w + r];
-        n !== e && this.set(t + r, h + i, n);
-      }
-    return this;
-  }
-  /** A sub-rectangle as a new picture (cutting a 20x20 block out of a big drawing). */
-  crop(s, t, h, e) {
-    const i = new a(h, e);
-    for (let r = 0; r < e; r++) for (let n = 0; n < h; n++) i.px[r * h + n] = this.get(s + n, t + r) & 255;
-    return i;
-  }
-  flipX() {
-    return new a(this.w, this.h).map((t, h) => this.get(this.w - 1 - t, h));
-  }
-  /** ASCII art: each character maps to a color through `key`; others are skipped. */
-  draw(s, t, h, e) {
-    return h.forEach((i, r) => [...i].forEach((n, f) => n in e && this.set(s + f, t + r, e[n]))), this;
-  }
-}
-function l(o) {
-  let s = o >>> 0;
-  return () => {
-    s = s + 1831565813 >>> 0;
-    let t = s;
-    return t = Math.imul(t ^ t >>> 15, t | 1), t ^= t + Math.imul(t ^ t >>> 7, t | 61), ((t ^ t >>> 14) >>> 0) / 4294967296;
-  };
-}
-function u(o, s, t) {
-  const h = [0, 8, 2, 10, 12, 4, 14, 6, 3, 11, 1, 9, 15, 7, 13, 5];
-  return t * 16 > h[(s & 3) * 4 + (o & 3)];
-}
-export {
-  a as P,
-  u as d,
-  l as r
-};

package/dist/types/games/kit/blit.d.ts

@@ -1,10 +0,0 @@
-import { Pixels } from './pixels.js';
-export declare const CLEAR = 255;
-/** Copies src over dst, skipping clear pixels. */
-export declare function over(dst: Pixels, src: Pixels, x?: number, y?: number): Pixels;
-/** Recolors every pixel through a lookup (palette swaps for variants and hurt flashes). */
-export declare function recolor(src: Pixels, fn: (c: number) => number): Pixels;
-/** Nearest-neighbor scaled copy (for big sprites on screens). */
-export declare function scaleBlit(dst: Pixels, src: Pixels, x: number, y: number, s: number, flip?: boolean): void;
-/** Adds a 1 pixel outline in `ink` around every opaque pixel. */
-export declare function outline(src: Pixels, ink: number): Pixels;

package/dist/types/games/kit/music.d.ts

@@ -1 +0,0 @@
-export * from '../../web/src/audio/compose.js';

package/dist/types/games/kit/pcText.d.ts

@@ -1,8 +0,0 @@
-import { Pixels } from './pixels.js';
-/** Text in the PC font; returns the width drawn. */
-export declare function text(p: Pixels, x: number, y: number, s: string, col: number, scale?: number): number;
-export declare const textWidth: (s: string, scale?: number) => number;
-/** Text with an outline (and an optional drop shadow). */
-export declare function outlined(p: Pixels, x: number, y: number, s: string, col: number, edge: number, scale?: number, shadow?: number): void;
-/** Centered text (outlined when `edge` is given). */
-export declare function centered(p: Pixels, y: number, s: string, col: number, scale?: number, edge?: number, cx?: number, shadow?: number): void;

package/dist/types/games/kit/shading.d.ts

@@ -1,11 +0,0 @@
-import { Pixels } from './pixels.js';
-/** A shade between ramp[lo] and ramp[hi] for level 0..1, ordered-dithered at (x, y). */
-export declare function shadeAt(ramp: number[], lo: number, hi: number, level: number, x: number, y: number): number;
-/** A vertical gradient across a rectangle. */
-export declare function gradient(p: Pixels, x0: number, y0: number, w: number, h: number, ramp: number[], lo: number, hi: number): Pixels;
-/** A lit ellipsoid lump, light from the upper left. */
-export declare function blob(p: Pixels, cx: number, cy: number, rx: number, ry: number, ramp: number[], lo: number, hi: number, light?: number): Pixels;
-/** A raised box: light top/left edge, dark bottom/right edge. */
-export declare function bevel(p: Pixels, x: number, y: number, w: number, h: number, ramp: number[], face: number, depth?: number): Pixels;
-/** Fills a rectangle with a speckled texture from ramp[lo..hi]. */
-export declare function speckle(p: Pixels, x0: number, y0: number, w: number, h: number, ramp: number[], base: number, spread: number, seed: number, density?: number): Pixels;

package/dist/types/web/packages/tools/src/audio.d.ts

@@ -1,3 +0,0 @@
-export * from '../../../src/audio/compose.js';
-export * from '../../../../games/kit/tune.js';
-export * from '../../../../games/kit/sound.js';

package/dist/types/web/packages/tools/src/drawing.d.ts

@@ -1,10 +0,0 @@
-export * from '../../../../games/kit/pixels.js';
-export * from '../../../../games/kit/palette.js';
-export * from '../../../../games/kit/pcText.js';
-export * from '../../../../games/kit/blit.js';
-export * from '../../../../games/kit/shading.js';
-export * from '../../../../games/kit/textBounds.js';
-export * from '../../../../games/kit/reel.js';
-export { FONT8X8 } from '../../../src/gfx/font8x8.js';
-export * from './text.js';
-export * from './colors.js';

package/dist/types/web/packages/tools/src/images.d.ts

@@ -1,2 +0,0 @@
-export { encodePng, type IndexedPicture } from '../../../src/assistant/png.js';
-export { crc32 } from '../../../src/project/zip.js';

package/dist/types/web/packages/tools/src/microFont.d.ts

@@ -1 +0,0 @@
-export declare const MICRO_GLYPHS: Readonly<Record<string, string>>;

package/dist/types/web/packages/tools/src/simulation.d.ts

@@ -1,3 +0,0 @@
-export { Sim, type SimScene } from '../../../../games/kit/sceneSim.js';
-export { GameSim, readDisk, diskSim, TICKS_PER_SECOND } from '../../../../games/kit/gameSim.js';
-export { newCharInfo, type CharInfo } from '../../../src/engine/world.js';

package/dist/types/web/scripts/cdGames.d.ts

@@ -1,103 +0,0 @@
-import type { Plugin } from 'vite';
-import type { PrintablesFile } from '../src/manual/printables/types.js';
-import { type Issue } from '../src/project/health.js';
-import { type BoxGame } from '../src/desk/boxes/boxFacts.js';
-export interface CdCatalogEntry {
-    id: string;
-    title: string;
-    kind: 'gameware' | 'shareware';
-    /** Folder of the game's files, relative to the site root. */
-    path: string;
-    gam: string | null;
-    files: string[];
-    /** Size of each file in `files`, in bytes. */
-    sizes: number[];
-    /** Shareware: the author's notice (readme / order form), as text. */
-    notice?: string;
-    /** Shareware: CRC-32 of the .gam file, to recognize the game when imported. */
-    gamCrc?: number;
-    /** Total size of the game's files in bytes. */
-    bytes: number;
-    /** Shareware: the name of its DOS program (listed on the retro PC; never served). */
-    exe?: string;
-    /** A few lines from the game's own story or instruction screen. */
-    blurb?: string;
-    author?: string;
-    company?: string;
-    year?: number;
-    price?: string;
-    /** Original games (../games): the disk label, box art and manual, from about.json. */
-    original?: OriginalExtras;
-    /** Original games: about.json "series" ("bizarre": The Bard of Bizarre's games, src/project/bizarre.ts). */
-    series?: string;
-    /** games/catalog.json: the entry has a games/details/<id>.json (see slimCatalog). */
-    details?: boolean;
-    /** Original games: the site path of the game's walkthrough (../games/<id>/walkthrough.json, src/walkthrough). */
-    walkthrough?: string;
-    /** Original games: its DOS player look, ../games/<id>/player.json ({ base, patches }: src/dosPlayer/catalogPatches.ts). */
-    player?: unknown;
-    /** The build drew its pictures (games/shots/<id>-<cols>x<rows>.png, scripts/gameShots.ts). */
-    shots?: boolean;
-    /** …and its hero (games/shots/<id>-hero.png). */
-    heroShot?: boolean;
-    /** All its files in one gzipped file in its folder, named by a hash of them (packName, src/project/gamePack.ts). */
-    pack?: string;
-    /** Built sites: what the home page's quick check finds in it (src/editor/shell/gameHealth.ts), so the page need not fetch files to know. */
-    health?: Issue[];
-    /** Built sites: the size of its pack in bytes (what downloading it for offline use costs, src/offline). */
-    packBytes?: number;
-    /** Built sites, games with a box: what the box reads from the .gam (src/desk/boxes/boxFacts.ts). */
-    boxGame?: BoxGame;
-}
-/** What ../games/<id>/about.json and manual.json add for an original game. */
-export interface OriginalExtras {
-    /** Printed disk label: background, band and text colors, and a small logo line. */
-    label?: {
-        background: string;
-        band: string;
-        ink: string;
-        logo?: string;
-    };
-    /** Box art: colors, tagline, back-cover copy, feature bullets and screenshot spots. */
-    box?: {
-        background: string;
-        accent: string;
-        ink: string;
-        tagline: string;
-        back: string;
-        features: string[];
-        /** Map views for screenshots: [map file, x, y] in blocks. */
-        shots?: [string, number, number][];
-        rating?: string;
-    };
-    /** The manual: pages of simple HTML, with <shot map="x.map" x="1" y="2"> screenshots. */
-    manual?: {
-        title: string;
-        pages: {
-            head: string;
-            html: string;
-        }[];
-    };
-    /** The paper extras in the box (games/<id>/printables.json, see src/manual/printables). */
-    printables?: PrintablesFile;
-    /** 'sb' games use the Sound Blaster; 'speaker' ones only the PC speaker. */
-    sound?: 'sb' | 'speaker';
-}
-export interface GmInstallEntry {
-    name: string;
-    size: number;
-    dir: boolean;
-}
-/**
- * The catalog without what only some pages read (games/catalog.json): a shareware notice,
- * an original game's manual and printables. Those are in games/details/<id>.json. The play
- * page needs only this (and, for shareware, its game's details); games/index.json has it all.
- */
-export declare function slimCatalog(catalog: CdCatalogEntry[]): CdCatalogEntry[];
-/** Every playable game on the CD and in ../games but the secret ones (what games/index.json lists, and every page, sitemap and picture the build makes). */
-export declare function cdCatalog(cdRoot: string): CdCatalogEntry[];
-/** The secret games (games/extra-<gate>.json): listed only once what reveals each is found. */
-export declare function cdSecretCatalog(cdRoot: string): CdCatalogEntry[];
-/** Where each game file the site serves (e.g. games/gameware/nebula/nebula.gam) is on disk. */
-export declare function cdFiles(cdRoot: string): ReadonlyMap<string, string>;
-export declare function cdGames(cdRoot: string): Plugin;