@jgengine/core 0.10.0 → 0.11.0

package/dist/cartridge/spec.d.ts

@@ -1,188 +0,0 @@
-import type { SpawnDirectorConfig } from "../ai/spawnDirector.js";
-import type { Curve } from "../game/progression.js";
-import type { ActionCodesMap } from "../input/actionBindings.js";
-import type { GameContext } from "../runtime/gameContext.js";
-export type Leveled = number | {
-    base: number;
-    perLevel: number;
-    min?: number;
-    max?: number;
-} | {
-    table: readonly number[];
-};
-export declare function leveled(value: Leveled, level: number): number;
-export interface CartridgePlayer {
-    kind: string;
-    health: number;
-    walkSpeed: number;
-    spawnAt?: readonly [number, number, number];
-}
-export interface CartridgeEnemy {
-    label: string;
-    health: number;
-    walkSpeed: number;
-    xp: number;
-    contact: {
-        damage: number;
-        intervalSeconds: number;
-    };
-    behavior?: "chase" | "none";
-}
-export interface CartridgeFlow {
-    start?: "auto" | "gate";
-    countdownSeconds?: number;
-    restart?: boolean;
-}
-export interface WeaponCommon {
-    label: string;
-    damage: Leveled;
-    cooldownMs: Leveled;
-    maxLevel: number;
-    fxColor?: string;
-    fxEmissive?: string;
-}
-export type CartridgeWeapon = (WeaponCommon & {
-    kind: "projectile";
-    range: number;
-    speed: number;
-}) | (WeaponCommon & {
-    kind: "orbit";
-    blades: Leveled;
-    radius: Leveled;
-    hitRadius: number;
-    angularSpeed: number;
-}) | (WeaponCommon & {
-    kind: "pulse";
-    radius: Leveled;
-    durationSeconds: number;
-}) | (WeaponCommon & {
-    kind: "custom";
-    fire(ctx: GameContext, run: CartridgeRun, args: WeaponFireArgs): void;
-});
-export interface WeaponFireArgs {
-    weaponId: string;
-    level: number;
-    damage: number;
-    playerId: string;
-    playerPosition: readonly [number, number, number];
-    enemyIds: readonly string[];
-    dt: number;
-}
-export type UpgradeEffect = {
-    kind: "weaponLevel";
-    weapon: string;
-} | {
-    kind: "statBonus";
-    stat: string;
-    amount: number;
-} | {
-    kind: "fieldAdd";
-    field: string;
-    amount: number;
-} | {
-    kind: "fieldMultiply";
-    field: string;
-    factor: number;
-} | {
-    kind: "custom";
-    apply(ctx: GameContext, run: CartridgeRun, stacks: number): void;
-};
-export interface CartridgeUpgrade {
-    id: string;
-    label: string;
-    weight: number;
-    maxStacks: number;
-    effect: UpgradeEffect;
-}
-export interface CartridgeProgression {
-    xp: Curve;
-    maxLevel: number;
-    draft: {
-        choices: number;
-        upgrades: readonly CartridgeUpgrade[];
-    };
-}
-export interface CartridgeSpawning {
-    director: SpawnDirectorConfig;
-    placement: {
-        kind: "ring";
-        radius: number;
-    } | {
-        kind: "custom";
-        position(ctx: GameContext, run: CartridgeRun): readonly [number, number, number];
-    };
-}
-export interface CartridgeXpGems {
-    collectRadius: number;
-    pullSpeed: number;
-    rarityThresholds: readonly (readonly [number, string])[];
-    defaultRarity: string;
-}
-export interface CartridgeRules {
-    win?: {
-        kind: "survive";
-        seconds: number;
-    } | {
-        kind: "custom";
-        check(ctx: GameContext, run: CartridgeRun): boolean;
-    };
-    lose?: {
-        kind: "playerDeath";
-    } | {
-        kind: "custom";
-        check(ctx: GameContext, run: CartridgeRun): boolean;
-    };
-    killLeaderboardStat?: string;
-}
-export interface CartridgeSpec {
-    seed?: string | number;
-    flow?: CartridgeFlow;
-    player: CartridgePlayer;
-    enemies: Record<string, CartridgeEnemy>;
-    combat: {
-        contactRadius: number;
-    };
-    spawning: CartridgeSpawning;
-    weapons: Record<string, CartridgeWeapon>;
-    progression: CartridgeProgression;
-    xpGems: CartridgeXpGems;
-    rules: CartridgeRules;
-    fields?: Record<string, number>;
-    input?: ActionCodesMap;
-    systems?: readonly ((ctx: GameContext, run: CartridgeRun, dt: number) => void)[];
-}
-export interface BoltFx {
-    id: number;
-    weaponId: string;
-    origin: readonly [number, number, number];
-    target: readonly [number, number, number];
-    firedAt: number;
-    travelSeconds: number;
-}
-export interface PulseFx {
-    id: number;
-    weaponId: string;
-    at: readonly [number, number, number];
-    firedAt: number;
-    durationSeconds: number;
-    maxRadius: number;
-}
-export type CartridgePhase = "start" | "countdown" | "playing" | "won" | "lost";
-export interface CartridgeRun {
-    phase: CartridgePhase;
-    playingSeconds: number;
-    countdownRemaining: number;
-    kills: number;
-    weaponLevel(weaponId: string): number;
-    field(name: string): number;
-    pendingOffers: readonly {
-        id: string;
-        label: string;
-    }[] | null;
-    bolts: readonly BoltFx[];
-    pulses: readonly PulseFx[];
-    subscribe(listener: () => void): () => void;
-}
-export declare const WASD_KEYBINDS: ActionCodesMap;
-export declare const XP_GEM_BASE_TYPE = "xp_gem";
-export declare const HIT_EFFECT = "hit";

package/dist/cartridge/spec.js

@@ -1,19 +0,0 @@
-export function leveled(value, level) {
-    if (typeof value === "number")
-        return value;
-    if ("table" in value) {
-        const index = Math.min(value.table.length - 1, Math.max(0, level - 1));
-        return value.table[index] ?? 0;
-    }
-    const raw = value.base + value.perLevel * (level - 1);
-    const floored = value.min === undefined ? raw : Math.max(value.min, raw);
-    return value.max === undefined ? floored : Math.min(value.max, floored);
-}
-export const WASD_KEYBINDS = {
-    moveForward: ["KeyW"],
-    moveBack: ["KeyS"],
-    moveLeft: ["KeyA"],
-    moveRight: ["KeyD"],
-};
-export const XP_GEM_BASE_TYPE = "xp_gem";
-export const HIT_EFFECT = "hit";

package/dist/cartridge/validate.d.ts

@@ -1,2 +0,0 @@
-import { type CartridgeSpec } from "./spec.js";
-export declare function validateCartridge(spec: CartridgeSpec): string[];

package/dist/cartridge/validate.js

@@ -1,78 +0,0 @@
-import { leveled } from "./spec.js";
-export function validateCartridge(spec) {
-    const problems = [];
-    const enemyIds = new Set(Object.keys(spec.enemies));
-    const weaponIds = new Set(Object.keys(spec.weapons));
-    if (spec.player.health <= 0)
-        problems.push(`player "${spec.player.kind}": health must be positive`);
-    if (spec.player.walkSpeed <= 0)
-        problems.push(`player "${spec.player.kind}": walkSpeed must be positive`);
-    if (enemyIds.has(spec.player.kind))
-        problems.push(`player kind "${spec.player.kind}" collides with an enemy id`);
-    if (spec.flow?.countdownSeconds !== undefined && spec.flow.countdownSeconds < 0) {
-        problems.push("flow.countdownSeconds must not be negative");
-    }
-    for (const [id, enemy] of Object.entries(spec.enemies)) {
-        if (enemy.health <= 0)
-            problems.push(`enemy "${id}": health must be positive`);
-        if (enemy.walkSpeed <= 0)
-            problems.push(`enemy "${id}": walkSpeed must be positive`);
-        if (enemy.xp <= 0)
-            problems.push(`enemy "${id}": xp must be positive`);
-        if (enemy.contact.damage <= 0)
-            problems.push(`enemy "${id}": contact.damage must be positive`);
-        if (enemy.contact.intervalSeconds <= 0)
-            problems.push(`enemy "${id}": contact.intervalSeconds must be positive`);
-    }
-    for (const wave of spec.spawning.director.waves) {
-        for (const entry of wave.entries) {
-            if (!enemyIds.has(entry.id))
-                problems.push(`spawning wave references unknown enemy "${entry.id}"`);
-        }
-    }
-    for (const [id, weapon] of Object.entries(spec.weapons)) {
-        for (let level = 1; level <= weapon.maxLevel; level += 1) {
-            if (leveled(weapon.damage, level) <= 0)
-                problems.push(`weapon "${id}": damage at level ${level} must be positive`);
-            if (leveled(weapon.cooldownMs, level) <= 0)
-                problems.push(`weapon "${id}": cooldownMs at level ${level} must be positive`);
-        }
-    }
-    const seenUpgrades = new Set();
-    for (const upgrade of spec.progression.draft.upgrades) {
-        if (seenUpgrades.has(upgrade.id))
-            problems.push(`upgrade "${upgrade.id}": duplicate id`);
-        seenUpgrades.add(upgrade.id);
-        if (upgrade.maxStacks <= 0)
-            problems.push(`upgrade "${upgrade.id}": maxStacks must be positive`);
-        const effect = upgrade.effect;
-        if (effect.kind === "weaponLevel") {
-            if (!weaponIds.has(effect.weapon)) {
-                problems.push(`upgrade "${upgrade.id}": references unknown weapon "${effect.weapon}"`);
-            }
-            else {
-                const weapon = spec.weapons[effect.weapon];
-                if (1 + upgrade.maxStacks > weapon.maxLevel) {
-                    problems.push(`upgrade "${upgrade.id}": maxStacks ${upgrade.maxStacks} exceeds weapon "${effect.weapon}" maxLevel ${weapon.maxLevel}`);
-                }
-            }
-        }
-        if ((effect.kind === "fieldAdd" || effect.kind === "fieldMultiply") && spec.fields?.[effect.field] === undefined) {
-            problems.push(`upgrade "${upgrade.id}": references undeclared field "${effect.field}"`);
-        }
-    }
-    if (spec.progression.draft.choices <= 0)
-        problems.push("progression.draft.choices must be positive");
-    if (spec.progression.maxLevel <= 1)
-        problems.push("progression.maxLevel must exceed 1");
-    const thresholds = spec.xpGems.rarityThresholds;
-    for (let i = 1; i < thresholds.length; i += 1) {
-        if (thresholds[i][0] >= thresholds[i - 1][0]) {
-            problems.push("xpGems.rarityThresholds must be sorted by descending value");
-        }
-    }
-    if (spec.rules.win?.kind === "survive" && spec.rules.win.seconds <= 0) {
-        problems.push("rules.win.seconds must be positive");
-    }
-    return problems;
-}

package/dist/store/engineStore.d.ts

@@ -1,22 +0,0 @@
-export interface EngineStoreConfig<TState, TAction, TEventMap extends object> {
-    initialState: TState;
-    reduce: (state: TState, action: TAction) => TState;
-    derive?: (state: TState) => TState;
-    onTransition?: (previous: TState, next: TState, emit: <K extends keyof TEventMap>(eventName: K, payload: TEventMap[K]) => void) => void;
-}
-export declare class EngineStore<TState, TAction, TEventMap extends object> {
-    private snapshot;
-    private readonly stateListeners;
-    private readonly eventListeners;
-    private readonly reduce;
-    private readonly derive;
-    private readonly onTransition;
-    constructor(config: EngineStoreConfig<TState, TAction, TEventMap>);
-    getState(): TState;
-    subscribe(listener: (state: TState) => void): () => boolean;
-    dispatch(action: TAction): void;
-    on<K extends keyof TEventMap>(eventName: K, listener: (payload: TEventMap[K]) => void): () => boolean;
-    private setState;
-    private emit;
-    private getEventBucket;
-}

package/dist/store/engineStore.js

@@ -1,50 +0,0 @@
-export class EngineStore {
-    snapshot;
-    stateListeners = new Set();
-    eventListeners;
-    reduce;
-    derive;
-    onTransition;
-    constructor(config) {
-        this.snapshot = config.derive ? config.derive(config.initialState) : config.initialState;
-        this.reduce = config.reduce;
-        this.derive = config.derive ?? null;
-        this.onTransition = config.onTransition;
-        this.eventListeners = {};
-    }
-    getState() {
-        return this.snapshot;
-    }
-    subscribe(listener) {
-        this.stateListeners.add(listener);
-        return () => this.stateListeners.delete(listener);
-    }
-    dispatch(action) {
-        this.setState((current) => this.reduce(current, action));
-    }
-    on(eventName, listener) {
-        this.getEventBucket(eventName).add(listener);
-        return () => this.getEventBucket(eventName).delete(listener);
-    }
-    setState(updater) {
-        const previous = this.snapshot;
-        const reduced = updater(previous);
-        const next = this.derive ? this.derive(reduced) : reduced;
-        this.snapshot = next;
-        for (const listener of this.stateListeners)
-            listener(next);
-        this.onTransition?.(previous, next, (eventName, payload) => this.emit(eventName, payload));
-    }
-    emit(eventName, payload) {
-        for (const listener of this.getEventBucket(eventName))
-            listener(payload);
-    }
-    getEventBucket(eventName) {
-        const currentBucket = this.eventListeners[eventName];
-        if (currentBucket !== undefined)
-            return currentBucket;
-        const nextBucket = new Set();
-        this.eventListeners[eventName] = nextBucket;
-        return nextBucket;
-    }
-}

package/dist/store/features.d.ts

@@ -1,10 +0,0 @@
-export interface StateFeature<TState, TAction, TEventMap extends object> {
-    reduce?: (state: TState, action: TAction) => TState;
-    derive?: (state: TState) => TState;
-    onTransition?: (previous: TState, next: TState, emit: <K extends keyof TEventMap>(eventName: K, payload: TEventMap[K]) => void) => void;
-}
-export declare function composeStateFeatures<TState, TAction, TEventMap extends object>(features: readonly StateFeature<TState, TAction, TEventMap>[]): {
-    reduce(state: TState, action: TAction): TState;
-    derive(state: TState): TState;
-    onTransition(previous: TState, next: TState, emit: <K extends keyof TEventMap>(eventName: K, payload: TEventMap[K]) => void): void;
-};

package/dist/store/features.js

@@ -1,23 +0,0 @@
-export function composeStateFeatures(features) {
-    return {
-        reduce(state, action) {
-            let nextState = state;
-            for (const feature of features) {
-                nextState = feature.reduce ? feature.reduce(nextState, action) : nextState;
-            }
-            return nextState;
-        },
-        derive(state) {
-            let nextState = state;
-            for (const feature of features) {
-                nextState = feature.derive ? feature.derive(nextState) : nextState;
-            }
-            return nextState;
-        },
-        onTransition(previous, next, emit) {
-            for (const feature of features) {
-                feature.onTransition?.(previous, next, emit);
-            }
-        },
-    };
-}