@lewismoten/gamemaker-sandbox-tools 3.1.0 → 3.4.0

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

@@ -1,12 +0,0 @@
-import { type HeroSpec, type LevelPicture } from '../src/gfx/levelPicture.js';
-/**
- * A palette PNG of only the colors the picture uses; rows unfiltered (flat pixel art packs best
- * that way). With `transparent`, that palette index is see-through.
- */
-export declare function encodeIndexedPng(pic: LevelPicture, transparent?: number): Uint8Array;
-/**
- * A game's pictures, by site path: each size in BUILT_SHOTS, its title screen (titlePixels),
- * an original game's box views (builtMapViews of its box's `shots`) and its hero (heroOf);
- * none when it has no level to show. `disk` maps a game file's name (as listed) to where it is on disk.
- */
-export declare function gameShots(id: string, gam: string | null, disk: ReadonlyMap<string, string>, boxShots?: [string, number, number][], hero?: HeroSpec): Map<string, Uint8Array>;

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

@@ -1,21 +0,0 @@
-import type { CdCatalogEntry } from './cdGames.js';
-export declare const CARD_W = 1200;
-export declare const CARD_H = 630;
-/** A picture as 8-bit RGB. */
-interface Rgb {
-    width: number;
-    height: number;
-    data: Uint8Array;
-}
-type Read = (name: string) => Uint8Array | undefined;
-/** Words wrapped to `cols` characters a line (a longer word is cut). */
-export declare function wrap(text: string, cols: number): string[];
-/** A PNG chunk: length, type, data and CRC (also for scripts/gameShots.ts). */
-export declare function pngChunk(type: string, data: Uint8Array): Uint8Array;
-/** An RGB PNG. Rows the same as the one above use the Up filter (all zeros); others use Sub. */
-export declare function encodePng(img: Rgb): Uint8Array;
-/** The 1200 x 630 card for a game, as RGB. */
-export declare function gameCard(entry: CdCatalogEntry, pic: Rgb | undefined): Rgb;
-/** The game's preview card as a PNG. `read` gives the game's files by lower-case name. */
-export declare function gameCardPng(entry: CdCatalogEntry, read: Read): Uint8Array;
-export {};

package/dist/types/web/src/audio/cmfLoad.d.ts

@@ -1,7 +0,0 @@
-interface LoadedSong {
-    music: Uint8Array;
-    /** The records load_file read; any past the end of the file are zeros here (DOS left whatever was in memory). */
-    instruments: Uint8Array[];
-}
-export declare function loadSong(bytes: Uint8Array | undefined): LoadedSong | undefined;
-export {};

package/dist/types/web/src/audio/cmfPlayer.d.ts

@@ -1,69 +0,0 @@
-import { Opl2 } from './opl.js';
-/**
- * Timer ticks per second: 1193180 / (65535 / 8). PLAYGAME.C reprograms PIT channel 0 with
- * divisor 65535/8 (8 times the normal 18.2 Hz), giving about 145.67 ticks per second.
- */
-export declare const TICK_RATE: number;
-export declare class CmfPlayer {
-    private opl;
-    private music;
-    private instruments;
-    private offset;
-    private wait;
-    private channel;
-    private funct;
-    private rhythm;
-    private rhythmKeys;
-    private notes;
-    private programs;
-    playing: boolean;
-    constructor(opl: Opl2);
-    /** sbfd_init: enable waveform select, melody mode (0xBD = deep tremolo and vibrato, rhythm off). */
-    private init;
-    load(music: Uint8Array, instruments: Uint8Array[]): void;
-    /** sbfd_music_off + rewind. */
-    stop(): void;
-    private allNotesOff;
-    /**
-     * *(APOS) in SBMUSIC.C. PlayIt read sbmusic+offset with no bounds check, so past the end of
-     * the farmalloc'd music block it read whatever heap memory followed. Every CMF ends with the
-     * FF 2F 00 end marker, which restarts the song before the read gets there; only a truncated
-     * file runs off the end, and for that the port reads 0xFF, which takes the same path as the
-     * end marker (sbfd_music_off, offset = 0).
-     */
-    private byte;
-    /**
-     * getpaws() in SBMUSIC.C: reads a MIDI variable length number (7 bits per byte, high bit
-     * set on every byte but the last), with no limit on the number of bytes:
-     *   do { offset++; value = (value << 7) | ((c=*(APOS)) & 0x07F); } while (c & 0x80);
-     * value is an unsigned long, so bits shifted past 32 are lost (>>> 0). The one difference:
-     * the loop stops at the end of the data, where DOS read on into unknown memory.
-     */
-    private getPaws;
-    /** One timer tick of PlayIt(). */
-    tick(): void;
-    /** sbfd_setmode: switch melody/rhythm mode and reload the drum channels' instruments. */
-    private setMode;
-    private programChange;
-    private melodyVoices;
-    /**
-     * Writes one operator from a 16 byte SBI instrument record, whose bytes alternate
-     * modulator/carrier: 0/1 AM-VIB-EG-KSR-MULT, 2/3 KSL-TL, 4/5 AR-DR, 6/7 SL-RR, 8/9 waveform.
-     */
-    private loadOperator;
-    private loadVoice;
-    /**
-     * MIDI note -> OPL frequency: picks the lowest block (octave) whose F-number fits in 10 bits,
-     * which keeps the most pitch resolution (Hz = fnum * 49716 / 2^(20 - block)).
-     */
-    private setPitch;
-    /**
-     * SBFMDRV's loudness by velocity: it scales the instrument's carrier level (TL is an
-     * attenuation, 0 loudest .. 63 silent) and keeps the key-scaling bits:
-     * TL = 63 - floor((velocity + 128) * (63 - instrumentTL) / 256). So velocity 127 plays
-     * the instrument almost as loud as written and velocity 1 about half as loud in TL steps.
-     */
-    private applyVelocity;
-    private noteOn;
-    private noteOff;
-}

package/dist/types/web/src/audio/context.d.ts

@@ -1,12 +0,0 @@
-/** The page's AudioContext (made on first use; undefined where there is no Web Audio). */
-export declare function audioContext(): AudioContext | undefined;
-/** True once a gesture has let the page's sound start (the context is running, or was). */
-export declare function soundUnlocked(): boolean;
-/** Calls `f` (inside the gesture's handler, so it may create and start nodes) each time sound unlocks. */
-export declare function onSoundUnlocked(f: () => void): () => void;
-/**
- * Resumes the context; must run inside a user gesture's handler the first time (iOS).
- * Called by the page's own gesture listeners; call it too from a handler that also starts
- * a sound, before any await.
- */
-export declare function unlock(): void;

package/dist/types/web/src/audio/engine.d.ts

@@ -1,39 +0,0 @@
-export declare class AudioEngine {
-    private ctx?;
-    private master?;
-    private music?;
-    private musicReady?;
-    private speaker?;
-    private voc?;
-    private vocCache;
-    musicEnabled: boolean;
-    soundEnabled: boolean;
-    /**
-     * Starts the sound. The first time, call it from a user gesture's handler (iOS: inside
-     * the touchend/click itself, before any await); the page's one AudioContext (context.ts)
-     * is resumed there.
-     */
-    resume(): Promise<void>;
-    /** Where this engine's sound leaves it (for recording just this game's sound). */
-    get node(): AudioNode | undefined;
-    /**
-     * Stops everything and lets go of the page's context (it is shared, so it stays open);
-     * a later resume() starts afresh.
-     */
-    dispose(): void;
-    get context(): AudioContext | undefined;
-    private post;
-    /** PlaySong: returns false (silently, as the original did) for invalid songs. */
-    playSong(bytes: Uint8Array | undefined): Promise<boolean>;
-    /** Counts songs asked for, so one still waiting for the worklet doesn't start after a newer one (or a stop). */
-    private songs;
-    stopSong(): void;
-    pauseMusic(paused: boolean): void;
-    /** DoSound's PC speaker path: one frequency per 1/145.6 s tick; 0 = silence. */
-    playSpeaker(freqs: ArrayLike<number>): void;
-    stopSpeaker(): void;
-    /** PlaySbVocFile: a new digital sound cuts off the previous one. */
-    playVoc(bytes: Uint8Array | undefined): boolean;
-    stopVoc(): void;
-    stopAll(): void;
-}

package/dist/types/web/src/audio/music.worklet.d.ts

@@ -1,14 +0,0 @@
-export type MusicMessage = {
-    type: 'load';
-    music: Uint8Array;
-    instruments: Uint8Array[];
-} | {
-    type: 'stop';
-} | {
-    type: 'pause';
-    paused: boolean;
-}
-/** The engine is done with this node (the page's context lives on): stop processing. */
- | {
-    type: 'end';
-};

package/dist/types/web/src/audio/opl.d.ts

@@ -1,37 +0,0 @@
-export declare class Opl2 {
-    readonly sampleRate: number;
-    private channels;
-    private regs;
-    private waveSelect;
-    private noteSel;
-    private amDepth;
-    private vibDepth;
-    private rhythm;
-    private time;
-    private noise;
-    constructor(sampleRate: number);
-    reset(): void;
-    read(reg: number): number;
-    write(reg: number, value: number): void;
-    private rhythmKeys;
-    /**
-     * Register 0xBD: bit 7 tremolo depth, bit 6 vibrato depth, bit 5 rhythm mode, bits 0-4 the
-     * drum keys. In rhythm mode channels 6-8 become the bass drum (both operators of channel 6),
-     * hi-hat and snare (channel 7) and tom-tom and cymbal (channel 8).
-     */
-    private writeRhythm;
-    /** Renders mono samples into out (added to existing content). */
-    render(out: Float32Array, gain?: number): void;
-    /** Linear amplitude from the summed attenuation: envelope + TL (0.75 dB steps) + KSL + tremolo. */
-    private opLevel;
-    private advance;
-    private channelSample;
-    /**
-     * Approximates the five drums. The bass drum is a normal FM channel (at double level); the
-     * hi-hat, snare and cymbal mix operator tone with LFSR noise, and the tom-tom is a plain tone.
-     * The mixing weights are this port's approximation, not the chip's exact phase logic.
-     */
-    private rhythmSample;
-}
-/** Register offsets of the modulator for each FM channel (carrier = +3). */
-export declare const MODULATOR_OFFSET: number[];

package/dist/types/web/src/audio/output.d.ts

@@ -1,13 +0,0 @@
-export declare const getVolume: () => number;
-/** 0 (silent) to 1 (full). */
-export declare function setVolume(v: number): void;
-/** Where a context's sound should go: its destination, through the volume. */
-export declare function output(ctx: BaseAudioContext): AudioNode;
-type Tap = (ctx: BaseAudioContext, node: AudioNode) => void;
-/**
- * Calls `f` for every context's line out, now and as new ones appear (for recording the
- * sound). Like a capture card on the sound card's line out, a recording has the PC's sound
- * whatever the speakers' volume knob is set to, even turned all the way down.
- */
-export declare function tapOutputs(f: Tap): () => void;
-export {};

package/dist/types/web/src/desk/boxes/boxFacts.d.ts

@@ -1,85 +0,0 @@
-import type { CatalogEntry } from '../../project/files.js';
-import { type Game } from '../../formats/game.js';
-/** Optional extras an about.json "box" may carry, beside the art and copy. */
-export interface BoxExtras {
-    /** Hours of play to finish, set from the walkthrough by games/kit/playtime.ts (playtime.ts); estimated from the number of levels when missing. */
-    hours?: number;
-    /**
-     * What the box says in place of "N levels to explore" (the count of level scenes), for a game
-     * whose scenes aren't what a player would call levels: "One night in five parts", "23 haywire
-     * circuit boards". An empty string leaves the line off.
-     */
-    levels?: string;
-    /** More selling points, printed with the ones worked out from the game's files. */
-    claims?: string[];
-    /** Quotes from (made-up) 1994-95 magazines. */
-    reviews?: {
-        quote: string;
-        source: string;
-    }[];
-    /** A laurel on the front, e.g. { title: 'Shareware Game of the Month', from: 'Diskette Digest' }. */
-    award?: {
-        title: string;
-        from: string;
-    };
-    /** The store's price sticker ($4.99 at Bits & Bytes by default): what the store asked for the shareware disk, not the author's registration fee (CatalogEntry.price). */
-    sticker?: {
-        store?: string;
-        price?: string;
-    };
-    /** A poster or fold-out map for the wall while the game is played. */
-    poster?: {
-        gif?: string;
-        map?: [string, number, number, number, number];
-        title?: string;
-        caption?: string;
-    };
-}
-export { disksLine } from '../../project/diskFacts.js';
-/** How many 1.44 MB disks an original game ships on (its files plus the DOS player): project/diskFacts.ts gameDisks, from a size alone. */
-export declare function boxDisks(bytes: number | undefined): number;
-/** Hours to finish: the box's own figure, or about 45 minutes a level, rounded down to a figure a box would print. */
-export declare function playHours(levels: number, stated?: number): number;
-export declare function hoursLine(hours: number): string;
-/** Selling points that are true of this game, from its files and sound card. */
-export declare function boxClaims(entry: Pick<CatalogEntry, 'files' | 'original'>, levels: number): string[];
-/** The rating seal: "Ages 8 and up" -> 8+; anything without an age is for everyone. */
-export declare function ratingMark(rating: string | undefined): {
-    mark: string;
-    label: string;
-};
-/** A small, stable random number generator, so a box is scuffed the same way every time. */
-export declare function seeded(seed: string): () => number;
-export declare function boxReviews(id: string, extras: BoxExtras): {
-    quote: string;
-    source: string;
-}[];
-export declare function boxAward(id: string, extras: BoxExtras): {
-    title: string;
-    from: string;
-};
-interface BackPlan {
-    bodyPx: number;
-    features: number;
-    reviews: number;
-    /** Screenshot row scale (1 = full size); 0 drops the screenshots. */
-    shots: number;
-    height: number;
-}
-/** How good a back cover plan looks: readable type, the reviews, screenshots and features, in that order. */
-export declare function backScore(p: Omit<BackPlan, 'height'>): number;
-/**
- * Fits the back cover: the story, reviews, feature bullets and a row of screenshots must
- * end above the claims and requirements. Of every mix of type size, features, reviews and
- * screenshot size that fits, picks the best looking (backScore); `heightOf` measures the
- * content laid out with a plan.
- */
-export declare function planBack(available: number, featureCount: number, reviewCount: number, heightOf: (p: Omit<BackPlan, 'height'>) => number): BackPlan;
-/** A screenshot's caption: the name of the level its map belongs to ("1a The Data Bus" -> "Stage 1: The Data Bus"). */
-export declare function shotCaption(game: Game | undefined, map: string): string;
-/** What a box reads from the game's .gam: its number of levels and its screenshots' captions (CatalogEntry.boxGame, worked out when the site is built). */
-export interface BoxGame {
-    levels: number;
-    captions: string[];
-}
-export declare function boxGame(game: Game | undefined, shots: [string, number, number][] | undefined): BoxGame;

package/dist/types/web/src/dosPlayer/fileExtensions.d.ts

@@ -1,44 +0,0 @@
-interface ExtKind {
-    /** Game-Maker's own extension, lower case, no dot. */
-    ext: string;
-    label: string;
-    note: string;
-    /**
-     * File offsets of each ".ext" in XFERPLAY 3.00, the one it opens files by first; none for the
-     * kinds the .gam names in full.
-     */
-    offsets: number[];
-}
-export declare const EXT_KINDS: ExtKind[];
-/** The patch id for a kind. */
-export declare const extId: (ext: string) => string;
-/** The kind an id names, if it is one. */
-export declare function extKind(id: string): ExtKind | undefined;
-/** Why `value` can't be kind `ext`'s new extension, or undefined when it can. */
-export declare function extValueProblem(ext: string, value: unknown): string | undefined;
-/** The kinds a set of patches renames: Game-Maker's extension -> the new one (both lower case, no dot). */
-export declare function extensionMap(patches: Record<string, unknown> | undefined): Map<string, string>;
-/** Kinds that share a new extension (each problem names both), for the panel and the export. */
-export declare function extensionClashes(patches: Record<string, unknown> | undefined): Map<string, string>;
-/** The patches without any renamed extensions (what the web player and web-page exports carry). */
-export declare function withoutExtensions<T>(patches: Record<string, T>): Record<string, T>;
-/** Writes each renamed kind's extension into every one of its copies in the player. */
-export declare function writeExtensions(exe: Uint8Array, patches: Record<string, unknown>): void;
-/**
- * A player's renamed extensions as patches, for the kinds whose copies all agree and keep the
- * rules; `read` lists the kinds read (so their bytes are explained).
- */
-export declare function readExtensions(exe: Uint8Array): {
-    patches: Record<string, string>;
-    read: string[];
-};
-/** Writes Game-Maker's own extension back into every copy of the kinds listed. */
-export declare function writeStockExtensions(exe: Uint8Array, kinds: string[]): void;
-/**
- * The CD's extension -> the one this player opens files by instead ('' when blanked), lower
- * case with the dot, for the player's own kinds that differ. (Virtual Mario blanked .gam.)
- */
-export declare function renamedExtensions(exe: Uint8Array): Record<string, string>;
-/** Acord Games' extensions, as NEVER.EXE and its games' files use them (.lst, .voc and .dat kept). */
-export declare const ACORD_EXTENSIONS: Record<string, string>;
-export {};

package/dist/types/web/src/dosPlayer/patchRules.d.ts

@@ -1,24 +0,0 @@
-import { type FramePatch, type PatchEntry } from './patchTable.js';
-export type PatchValue = string | number | number[];
-/** A project's DOS player choices: patch id -> value (patchTable.ts says what each takes). */
-export type PlayerPatches = Record<string, PatchValue>;
-export declare function patchEntry(id: string): PatchEntry | undefined;
-/** A printf format's % codes, in order. */
-export declare function formatCodes(text: string): string[];
-/** Why `value` can't be written for `entry`, or undefined when it can. */
-export declare function patchProblem(entry: PatchEntry, value: unknown): string | undefined;
-/** The largest value a frame's left, top, right or bottom (i: 0-3) takes: a push imm8 is sign-extended, so a 1-byte one stops at 127. */
-export declare function frameLimit(entry: FramePatch, i: number): number;
-/** True when `value` is what the CD's player already has (so no patch is needed). */
-export declare function isStock(entry: PatchEntry, value: PatchValue): boolean;
-/** Writes a value already checked with patchProblem. */
-export declare function writePatch(exe: Uint8Array, entry: PatchEntry, value: PatchValue): void;
-/** The entry's value in `exe` (text up to its first 0, trailing spaces dropped), or undefined when it can't be read as one. */
-export declare function readPatch(exe: Uint8Array, entry: PatchEntry): PatchValue | undefined;
-/** Writes the CD's own value back (for every byte the entry covers, the 0s included). */
-export declare function writeStock(exe: Uint8Array, entry: PatchEntry): void;
-/**
- * Only the patches that are known, valid and not the stock value; the rest are left out. Renamed
- * file extensions (fileExtensions.ts) are kept in lower case.
- */
-export declare function cleanPatches(patches: Record<string, unknown> | undefined): PlayerPatches;

package/dist/types/web/src/dosPlayer/patchTable.d.ts

@@ -1,80 +0,0 @@
-/** The editor panel's groups. */
-export type PatchGroup = 'words' | 'colors' | 'frames' | 'positions' | 'times' | 'keys';
-/** The screen a patch shows on, which the panel previews while it is edited. */
-export type PatchScreen = 'menu' | 'hiscores' | 'newHiscore' | 'status' | 'load' | 'save' | 'drop' | 'help' | 'text' | 'missing' | 'about' | 'play' | 'all';
-/**
- * The color targets RGBdata::Match looks for, by name, with the DGROUP offset of each object
- * (what a color selector's push imm16 names).
- */
-export declare const COLOR_TARGETS: {
-    readonly yellow: 623;
-    readonly red: 626;
-    readonly blue: 629;
-    readonly purple: 632;
-    readonly hsRed: 5626;
-    readonly hsBlue: 5629;
-    readonly hsGreen: 5632;
-};
-export type ColorName = keyof typeof COLOR_TARGETS;
-/** One immediate in the code: its file offset and size (1: push imm8, sign-extended; 2: imm16). */
-export interface ImmField {
-    offset: number;
-    size: number;
-}
-interface Base {
-    id: string;
-    group: PatchGroup;
-    screen: PatchScreen;
-    label: string;
-    note?: string;
-    safety: 'safe' | 'caution';
-    /** The web player shows it too (false: DOS only). */
-    web: boolean;
-}
-/** A NUL-ended string: never longer than `length`, characters 0x20-0x7E; a `format` keeps its % codes. */
-export interface TextPatch extends Base {
-    kind: 'text' | 'format';
-    offset: number;
-    length: number;
-    stock: string;
-}
-/** A number in one immediate, or the same number in each of several (`fields`, patched together). */
-export interface NumberPatch extends Base {
-    kind: 'number';
-    fields: ImmField[];
-    /** A 1-byte field is a sign-extended push imm8. */
-    signed: boolean;
-    min: number;
-    max: number;
-    stock: number;
-}
-/** A color: red, green and blue (0-63), one byte each. */
-interface RgbPatch extends Base {
-    kind: 'rgb';
-    offsets: [number, number, number];
-    stock: [number, number, number];
-}
-/** Which color target a screen matches (the push imm16 before RGBdata::Match). */
-interface SelectPatch extends Base {
-    kind: 'select';
-    offset: number;
-    stock: ColorName;
-}
-/** A Box(x1, y1, x2, y2) frame. */
-export interface FramePatch extends Base {
-    kind: 'frame';
-    fields: [ImmField, ImmField, ImmField, ImmField];
-    stock: [number, number, number, number];
-}
-/** A function key's entry in DoFunKy's jump table: on (as shipped) or 'off'. */
-interface FkeyPatch extends Base {
-    kind: 'fkey';
-    key: number;
-    offset: number;
-    stock: number;
-}
-export type PatchEntry = TextPatch | NumberPatch | RgbPatch | SelectPatch | FramePatch | FkeyPatch;
-/** DoFunKy's "does nothing" target: an F-key whose entry jumps here is off. */
-export declare const FKEY_OFF = 10489;
-export declare const PATCHES: PatchEntry[];
-export {};

package/dist/types/web/src/edition.d.ts

@@ -1,6 +0,0 @@
-export declare const EDITION = "Sandbox Edition";
-export declare const PRODUCT = "Game-Maker: Sandbox Edition";
-export declare const SHORT = "Game-Maker SE";
-/** One line saying what it is, for footers and notes. */
-export declare const FORK_NOTE = "A modified fork of RSD Game-Maker 3.0 \u2014 not an original RSD release";
-export declare const NOTICE_URL = "https://github.com/lewismoten/GameMaker-SandboxEdition/blob/master/NOTICE.md";

package/dist/types/web/src/eggs/eggState.d.ts

@@ -1,26 +0,0 @@
-import { type Egg, type EggDetect } from './eggs.js';
-export declare const OVERRIDES_KEY = "gm-eggs";
-/** Fired on window when EGG.EXE changes an override. */
-export declare const EGGS_CHANGED = "gm-eggs-changed";
-export type Override = 'added' | 'broken';
-export type EggStatus = 'saved' | 'added' | 'broken' | 'none';
-/** Does one game<n>.sav (this port's JSON save) hold the egg? */
-export declare function saveHolds(bytes: Uint8Array, detect: EggDetect): boolean;
-/** Does any saved slot (game0.sav .. game9.sav) of a game's save data hold the egg? */
-export declare function savesHold(files: Record<string, Uint8Array>, detect: EggDetect | undefined): boolean;
-export declare function readOverrides(): Record<string, Override>;
-export declare function setOverride(game: string, value: Override | undefined): void;
-/** EGG.EXE's X Reset all: every egg (the bonus ones too) back to what the saves say. */
-export declare function resetAllOverrides(): void;
-/** What EGG.EXE shows: where the egg stands, and whether it counts as found. */
-export declare function statusOf(inSave: boolean, override: Override | undefined): {
-    status: EggStatus;
-    found: boolean;
-};
-export interface EggState {
-    egg: Egg;
-    inSave: boolean;
-    status: EggStatus;
-    found: boolean;
-}
-export declare function eggStates(): Promise<EggState[]>;

package/dist/types/web/src/eggs/eggs.d.ts

@@ -1,31 +0,0 @@
-export type EggDetect = {
-    block: number;
-} | {
-    counter: number;
-    atLeast?: number;
-};
-/** How the viewer stitches an egg: felt colors, a band pattern and an appliqué. */
-export interface EggLook {
-    /** Felt colors: the shell, the bands, the appliqué, the thread. */
-    felt: string;
-    band: string;
-    patch: string;
-    thread: string;
-    pattern: 'zigzag' | 'dots' | 'stars' | 'snowflakes' | 'scallops' | 'checks' | 'waves' | 'circuit' | 'ruled' | 'pawprints' | 'grid' | 'diamonds' | 'confetti';
-    motif: 'paw' | 'castle' | 'mitten' | 'bolt' | 'planet' | 'mask' | 'rocket' | 'bug' | 'bookworm' | 'bone' | 'cube' | 'sword' | 'cake';
-}
-export interface Egg {
-    /** The Sandbox game it is hidden in (games/<id>). */
-    game: string;
-    gameTitle: string;
-    name: string;
-    /** The felt egg itself, as the viewer describes it. */
-    description: string;
-    credits: string[];
-    /** Its piece of the mystery. */
-    lore: string;
-    look: EggLook;
-    /** Set once the egg is in the game; see the top of this file. */
-    detect?: EggDetect;
-}
-export declare const EGGS: readonly Egg[];

package/dist/types/web/src/engine/character.d.ts

@@ -1,30 +0,0 @@
-import { type Frame } from '../formats/character.js';
-import { type World } from './world.js';
-/** Asks the player which inventory slot to drop; resolves -1 for Esc. */
-type DropPicker = () => Promise<number>;
-/**
- * CHRFRAME with the original's out-of-range behavior: frame -1 read the 17 bytes
- * before the sequence's first frame (the tail of the previous sequence record).
- */
-export declare function currentFrame(w: World): Frame;
-/**
- * MoveCharGrav: every GRAVSPEED ticks, accelerate by one pixel a tick in each
- * direction the block's grav bits name (1 up, 2 right, 4 down, 8 left), capped at
- * MAXGRAV * 4. Returns true while there is any gravity momentum.
- */
-export declare function moveCharGrav(w: World, reset?: boolean): boolean;
-/** HandleJStick: joystick directions/buttons can trigger sequences too. */
-export declare function handleJoystick(w: World, reset?: boolean): boolean;
-/** movechars: one game tick of character animation and movement. Returns true when dead. */
-export declare function moveChars(w: World, pickDrop: DropPicker): Promise<boolean>;
-/**
- * Screen coordinates of the character's bottom block (nextx/nexty), the tail of
- * movechars (PLAYGAME.C 2593-2601; the func-key return at 1643 is the same with
- * scroll.nx 0). The strict < matches the C: column mx itself counts as MLEN blocks
- * away, so nextx is 2000+ (row my likewise). chkScrnBounds keeps a walk from
- * entering it, but a solid monster's push (C 2508) can put the character there;
- * the C then draws it off screen and ChangeScroll scrolls hard toward it. The port
- * keeps that. test/charScreenColumn.test.ts covers it, across the map wrap too.
- */
-export declare function updateCharScreenPos(w: World): void;
-export {};

package/dist/types/web/src/engine/funcKeys.d.ts

@@ -1,33 +0,0 @@
-import type { Machine } from './machine.js';
-import type { Screen } from '../gfx/screen.js';
-import { type PlayerLook } from './playerLook.js';
-import { type World } from './world.js';
-/** What the status and drop screens read of a level: its palette, blocks, inventory and clock. */
-export type InventoryWorld = Pick<World, 'palette' | 'bg' | 'clock'> & {
-    ci: Pick<World['ci'], 'inv' | 'score' | 'meter' | 'hitpts' | 'lives'>;
-};
-/**
- * F1: HelpFiles. XFERPLAY.EXE (PLAYGAME.C built with TRANSFER, the player of every transferred
- * game) shows the game's instructions, or one red line; it never reads GMHELP.TXT. PLAYGAME.EXE,
- * run from Game-Maker, first shows Game-Maker's own GMHELP.TXT (`gmHelp`) in a blue frame.
- */
-export declare function helpScreen(m: Machine, w: World, instructions: string | undefined, gmHelp?: Uint8Array, look?: PlayerLook): Promise<void>;
-/** Display_Invent's page (F2). */
-export declare function drawStatus(screen: Screen, w: InventoryWorld, look: PlayerLook): void;
-/** F2: Display_Invent */
-export declare function statusScreen(m: Machine, w: World, look?: PlayerLook): Promise<void>;
-/** GMabout's first page (this web edition's words); returns the text color. */
-export declare function drawAbout(screen: Screen, palette: Uint8Array, look: PlayerLook): number;
-/** F10: GMabout */
-export declare function aboutScreen(m: Machine, w: World, look?: PlayerLook): Promise<void>;
-/** DropBloc's picker screen, with the selection box on slot (j, k); returns the box's color. */
-export declare function drawDropPicker(screen: Screen, w: InventoryWorld, look: PlayerLook, j?: number, k?: number): number;
-/** DropBloc's picker: arrows choose a slot, Enter drops, Esc cancels (-1). */
-export declare function pickDropSlot(m: Machine, w: World, look?: PlayerLook): Promise<number>;
-/** The load or save heading and slot marks, drawn when the game has no load or save picture. */
-export declare function drawLoadHeading(screen: Screen, look: PlayerLook, cols: Uint8Array): void;
-export declare function drawSaveHeading(screen: Screen, look: PlayerLook, cols: Uint8Array): void;
-/** The ten slot names, in the load or save screen's color. */
-export declare function drawSaveSlots(screen: Screen, look: PlayerLook, pal: Uint8Array, names: string[], saving: boolean): number;
-/** SelectGameToLoad / SelectGameToSave: returns the slot (0..9) or -1. */
-export declare function pickSaveSlot(m: Machine, pal: Uint8Array, saving: boolean, look?: PlayerLook): Promise<number>;