cubeforge 0.1.2 → 0.1.3

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "cubeforge",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "React-first 2D browser game engine",
-  "main": "./dist/index.js",
+  "main": "./src/index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "build": "NODE_ENV=production bun build src/index.ts --outfile dist/index.js --target browser --format esm --external react --external react-dom --external react/jsx-runtime && tsc --emitDeclarationOnly --noEmit false"
+    "build": "tsup"
   },
   "publishConfig": {
     "main": "./dist/index.js",
@@ -24,6 +24,13 @@
     "react": "^18.0.0",
     "react-dom": "^18.0.0"
   },
+  "devDependencies": {
+    "@cubeforge/core": "workspace:*",
+    "@cubeforge/input": "workspace:*",
+    "@cubeforge/physics": "workspace:*",
+    "@cubeforge/renderer": "workspace:*",
+    "tsup": "^8.0.0"
+  },
   "keywords": [
     "game-engine",
     "react",
@@ -35,12 +42,5 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/1homsi/cubeforge"
-  },
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
   }
 }

package/dist/components/Animation.d.ts

@@ -1,14 +0,0 @@
-interface AnimationProps {
-    /** Frame indices to play (indexes into the sprite sheet) */
-    frames: number[];
-    /** Frames per second, default 12 */
-    fps?: number;
-    /** Whether to loop, default true */
-    loop?: boolean;
-    /** Whether currently playing, default true */
-    playing?: boolean;
-    /** Called once when a non-looping animation finishes playing */
-    onComplete?: () => void;
-}
-export declare function Animation({ frames, fps, loop, playing, onComplete }: AnimationProps): null;
-export {};

package/dist/components/BoxCollider.d.ts

@@ -1,17 +0,0 @@
-interface BoxColliderProps {
-    width: number;
-    height: number;
-    offsetX?: number;
-    offsetY?: number;
-    isTrigger?: boolean;
-    layer?: string;
-    /** Which layers this collider interacts with. '*' = all (default). */
-    mask?: string | string[];
-    /**
-     * One-way platform: only blocks entities falling onto the top surface.
-     * Entities below pass through freely (useful for jump-through ledges).
-     */
-    oneWay?: boolean;
-}
-export declare function BoxCollider({ width, height, offsetX, offsetY, isTrigger, layer, mask, oneWay, }: BoxColliderProps): null;
-export {};

package/dist/components/Camera2D.d.ts

@@ -1,27 +0,0 @@
-interface Camera2DProps {
-    /** String ID of entity to follow */
-    followEntity?: string;
-    /** Initial camera X position in world space (default 0 = world origin at screen center) */
-    x?: number;
-    /** Initial camera Y position in world space (default 0 = world origin at screen center) */
-    y?: number;
-    zoom?: number;
-    /** Lerp smoothing factor (0 = instant snap, 0.85 = smooth) */
-    smoothing?: number;
-    background?: string;
-    bounds?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    deadZone?: {
-        w: number;
-        h: number;
-    };
-    /** World-space offset applied to the follow target (look-ahead, vertical bias, etc.) */
-    followOffsetX?: number;
-    followOffsetY?: number;
-}
-export declare function Camera2D({ followEntity, x, y, zoom, smoothing, background, bounds, deadZone, followOffsetX, followOffsetY, }: Camera2DProps): null;
-export {};

package/dist/components/Checkpoint.d.ts

@@ -1,18 +0,0 @@
-import React from 'react';
-interface CheckpointProps {
-    x: number;
-    y: number;
-    width?: number;
-    height?: number;
-    color?: string;
-    /** Called once when a 'player'-tagged entity enters the checkpoint */
-    onActivate?: () => void;
-}
-/**
- * A trigger zone that fires `onActivate` once when a player-tagged entity enters it.
- *
- * @example
- * <Checkpoint x={800} y={450} onActivate={() => setCheckpoint(800)} />
- */
-export declare function Checkpoint({ x, y, width, height, color, onActivate, }: CheckpointProps): React.ReactElement;
-export {};

package/dist/components/CircleCollider.d.ts

@@ -1,11 +0,0 @@
-interface CircleColliderProps {
-    radius: number;
-    offsetX?: number;
-    offsetY?: number;
-    isTrigger?: boolean;
-    layer?: string;
-    /** Which layers this collider interacts with. '*' = all (default). */
-    mask?: string | string[];
-}
-export declare function CircleCollider({ radius, offsetX, offsetY, isTrigger, layer, mask, }: CircleColliderProps): null;
-export {};

package/dist/components/DevTools.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-import type { WorldSnapshot } from '@cubeforge/core';
-import type { ECSWorld, GameLoop } from '@cubeforge/core';
-export declare const MAX_DEVTOOLS_FRAMES = 600;
-export interface DevToolsHandle {
-    buffer: WorldSnapshot[];
-    onFrame?: () => void;
-}
-interface DevToolsProps {
-    handle: DevToolsHandle;
-    loop: GameLoop;
-    ecs: ECSWorld;
-}
-export declare function DevToolsOverlay({ handle, loop, ecs }: DevToolsProps): React.ReactPortal;
-export {};

package/dist/components/Entity.d.ts

@@ -1,10 +0,0 @@
-import { type ReactNode } from 'react';
-interface EntityProps {
-    /** Optional string ID for cross-entity lookups (e.g. camera follow) */
-    id?: string;
-    /** Tags for grouping / querying (e.g. ['enemy', 'damageable']) */
-    tags?: string[];
-    children?: ReactNode;
-}
-export declare function Entity({ id, tags, children }: EntityProps): import("react/jsx-runtime").JSX.Element | null;
-export {};

package/dist/components/Game.d.ts

@@ -1,52 +0,0 @@
-import React, { type CSSProperties } from 'react';
-import { type Plugin, type System, type EntityId } from '@cubeforge/core';
-export interface GameControls {
-    pause(): void;
-    resume(): void;
-    reset(): void;
-}
-interface GameProps {
-    width?: number;
-    height?: number;
-    /** Pixels per second squared downward (default 980) */
-    gravity?: number;
-    /** Enable debug overlay: collider wireframes, FPS, entity count */
-    debug?: boolean;
-    /**
-     * Canvas scaling strategy (default 'none'):
-     * - 'none'    — fixed pixel size, no scaling
-     * - 'contain' — CSS scale to fit parent while preserving aspect ratio
-     * - 'pixel'   — nearest-neighbor pixel-art scaling via CSS
-     */
-    scale?: 'none' | 'contain' | 'pixel';
-    /** Called once the engine is ready — receives pause/resume/reset controls */
-    onReady?: (controls: GameControls) => void;
-    /** Enable time-travel debugging overlay (frame scrubber + entity inspector). */
-    devtools?: boolean;
-    /** Run the simulation in deterministic mode using a seeded RNG. */
-    deterministic?: boolean;
-    /** Seed for the deterministic RNG (default 0). Only used when deterministic=true. */
-    seed?: number;
-    /**
-     * When true, the game loop starts immediately and sprites swap from color → image as
-     * they load in the background. When false (default) the loop is held until every
-     * sprite that is part of the initial scene has finished loading, so the first frame
-     * shown is fully rendered with real assets.
-     */
-    asyncAssets?: boolean;
-    /** Custom plugins to register after core systems. Each plugin's systems run after Render. */
-    plugins?: Plugin[];
-    /**
-     * Custom render system constructor. Must implement the System interface and accept
-     * `(canvas: HTMLCanvasElement, entityIds: Map<string, EntityId>)`.
-     *
-     * Defaults to the built-in Canvas2D RenderSystem.
-     * Example: `import { WebGLRenderSystem } from '@cubeforge/webgl-renderer'`
-     */
-    renderer?: new (canvas: HTMLCanvasElement, entityIds: Map<string, EntityId>) => System;
-    style?: CSSProperties;
-    className?: string;
-    children?: React.ReactNode;
-}
-export declare function Game({ width, height, gravity, debug, devtools, scale, deterministic, seed, asyncAssets, onReady, plugins, renderer: CustomRenderer, style, className, children, }: GameProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/components/MovingPlatform.d.ts

@@ -1,22 +0,0 @@
-import React from 'react';
-interface MovingPlatformProps {
-    /** Start position */
-    x1: number;
-    y1: number;
-    /** End position */
-    x2: number;
-    y2: number;
-    width?: number;
-    height?: number;
-    /** Seconds for a full round trip (default 3) */
-    duration?: number;
-    color?: string;
-}
-/**
- * A static platform that oscillates between (x1,y1) and (x2,y2).
- *
- * @example
- * <MovingPlatform x1={200} y1={350} x2={450} y2={350} width={120} duration={2.5} />
- */
-export declare function MovingPlatform({ x1, y1, x2, y2, width, height, duration, color, }: MovingPlatformProps): React.ReactElement;
-export {};

package/dist/components/ParallaxLayer.d.ts

@@ -1,28 +0,0 @@
-import React from 'react';
-interface ParallaxLayerProps {
-    /** Image URL to use as the background layer */
-    src: string;
-    /** Scroll speed relative to camera (0 = fixed, 1 = moves with camera, 0.3 = slow parallax). Default 0.5 */
-    speedX?: number;
-    /** Vertical scroll speed relative to camera. Default 0 */
-    speedY?: number;
-    /** Tile image horizontally. Default true */
-    repeatX?: boolean;
-    /** Tile image vertically. Default false */
-    repeatY?: boolean;
-    /** Render order — use negative values to render behind sprites. Default -10 */
-    zIndex?: number;
-    /** Manual horizontal offset in pixels. Default 0 */
-    offsetX?: number;
-    /** Manual vertical offset in pixels. Default 0 */
-    offsetY?: number;
-}
-/**
- * A background layer that scrolls at a fraction of the camera speed to create depth.
- *
- * @example
- * <ParallaxLayer src="/bg/sky.png" speedX={0.2} repeatX />
- * <ParallaxLayer src="/bg/mountains.png" speedX={0.5} repeatX zIndex={-5} />
- */
-export declare function ParallaxLayer({ src, speedX, speedY, repeatX, repeatY, zIndex, offsetX, offsetY, }: ParallaxLayerProps): React.ReactElement;
-export {};

package/dist/components/ParticleEmitter.d.ts

@@ -1,26 +0,0 @@
-import type { ParticlePreset } from './particlePresets';
-interface ParticleEmitterProps {
-    active?: boolean;
-    /** Named preset — values can be overridden by explicit props */
-    preset?: ParticlePreset;
-    /** Particles per second, default 20 */
-    rate?: number;
-    /** Initial particle speed (pixels/s), default 80 */
-    speed?: number;
-    /** Angle spread in radians, default Math.PI */
-    spread?: number;
-    /** Base emit angle in radians (0=right, -PI/2=up), default -Math.PI/2 */
-    angle?: number;
-    /** Particle lifetime in seconds, default 0.8 */
-    particleLife?: number;
-    /** Particle size in pixels, default 4 */
-    particleSize?: number;
-    /** Particle color, default '#ffffff' */
-    color?: string;
-    /** Gravity applied to particles (pixels/s²), default 200 */
-    gravity?: number;
-    /** Maximum live particles, default 100 */
-    maxParticles?: number;
-}
-export declare function ParticleEmitter({ active, preset, rate, speed, spread, angle, particleLife, particleSize, color, gravity, maxParticles, }: ParticleEmitterProps): null;
-export {};

package/dist/components/RigidBody.d.ts

@@ -1,15 +0,0 @@
-interface RigidBodyProps {
-    mass?: number;
-    gravityScale?: number;
-    isStatic?: boolean;
-    bounce?: number;
-    friction?: number;
-    vx?: number;
-    vy?: number;
-    /** Prevent any horizontal movement — velocity.x is zeroed every frame */
-    lockX?: boolean;
-    /** Prevent any vertical movement — velocity.y is zeroed every frame (disables gravity) */
-    lockY?: boolean;
-}
-export declare function RigidBody({ mass, gravityScale, isStatic, bounce, friction, vx, vy, lockX, lockY, }: RigidBodyProps): null;
-export {};

package/dist/components/ScreenFlash.d.ts

@@ -1,4 +0,0 @@
-export interface ScreenFlashHandle {
-    flash(color: string, duration: number): void;
-}
-export declare const ScreenFlash: import("react").ForwardRefExoticComponent<import("react").RefAttributes<ScreenFlashHandle>>;

package/dist/components/Script.d.ts

@@ -1,11 +0,0 @@
-import { type ScriptUpdateFn } from '@cubeforge/core';
-import type { ECSWorld, EntityId } from '@cubeforge/core';
-import type { InputManager } from '@cubeforge/input';
-interface ScriptProps {
-    /** Called once when the entity is mounted — use to attach extra components */
-    init?: (entityId: EntityId, world: ECSWorld) => void;
-    /** Called every frame */
-    update: ScriptUpdateFn | ((entityId: EntityId, world: ECSWorld, input: InputManager, dt: number) => void);
-}
-export declare function Script({ init, update }: ScriptProps): null;
-export {};

package/dist/components/Sprite.d.ts

@@ -1,22 +0,0 @@
-import type { SpriteAtlas } from './spriteAtlas';
-interface SpriteProps {
-    width: number;
-    height: number;
-    color?: string;
-    src?: string;
-    offsetX?: number;
-    offsetY?: number;
-    zIndex?: number;
-    visible?: boolean;
-    flipX?: boolean;
-    anchorX?: number;
-    anchorY?: number;
-    frameIndex?: number;
-    frameWidth?: number;
-    frameHeight?: number;
-    frameColumns?: number;
-    atlas?: SpriteAtlas;
-    frame?: string;
-}
-export declare function Sprite({ width, height, color, src, offsetX, offsetY, zIndex, visible, flipX, anchorX, anchorY, frameIndex, frameWidth, frameHeight, frameColumns, atlas, frame, }: SpriteProps): null;
-export {};

package/dist/components/SquashStretch.d.ts

@@ -1,8 +0,0 @@
-interface SquashStretchProps {
-    /** How much to squash/stretch (default 0.2) */
-    intensity?: number;
-    /** How fast it returns to 1.0 — lerp speed (default 8) */
-    recovery?: number;
-}
-export declare function SquashStretch({ intensity, recovery }: SquashStretchProps): null;
-export {};

package/dist/components/Tilemap.d.ts

@@ -1,58 +0,0 @@
-import React from 'react';
-interface TiledProperty {
-    name: string;
-    type: string;
-    value: string | number | boolean;
-}
-export interface TiledObject {
-    id: number;
-    name: string;
-    type: string;
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    properties?: TiledProperty[];
-}
-export interface TiledLayer {
-    type: 'tilelayer' | 'objectgroup';
-    name: string;
-    visible: boolean;
-    opacity: number;
-    data?: number[];
-    objects?: TiledObject[];
-    properties?: TiledProperty[];
-}
-interface TilemapProps {
-    /** URL to the Tiled JSON file */
-    src: string;
-    /**
-     * Object layer spawner: called for each object in object layers.
-     * Return a React element or null.
-     */
-    onSpawnObject?: (obj: TiledObject, layer: TiledLayer) => React.ReactNode;
-    /**
-     * Layer filter: return false to skip rendering/processing a layer.
-     * Default: all layers rendered.
-     */
-    layerFilter?: (layer: TiledLayer) => boolean;
-    /** Z-index for tile sprites (default 0) */
-    zIndex?: number;
-    /**
-     * Name of the layer (or layers with property `collision: true`) that
-     * should create invisible solid colliders. Default: "collision".
-     */
-    collisionLayer?: string;
-    /**
-     * Name of the layer (or layers with property `trigger: true`) that
-     * should create trigger BoxColliders (no sprite). Default: "triggers".
-     */
-    triggerLayer?: string;
-    /**
-     * Called for every tile that has custom properties defined in the tileset.
-     * Receives the global tile ID, the property map, and the tile's world position.
-     */
-    onTileProperty?: (tileId: number, properties: Record<string, unknown>, x: number, y: number) => void;
-}
-export declare function Tilemap({ src, onSpawnObject, layerFilter, zIndex, collisionLayer, triggerLayer: triggerLayerName, onTileProperty, }: TilemapProps): React.ReactElement | null;
-export {};

package/dist/components/Transform.d.ts

@@ -1,9 +0,0 @@
-interface TransformProps {
-    x?: number;
-    y?: number;
-    rotation?: number;
-    scaleX?: number;
-    scaleY?: number;
-}
-export declare function Transform({ x, y, rotation, scaleX, scaleY }: TransformProps): null;
-export {};

package/dist/components/World.d.ts

@@ -1,10 +0,0 @@
-import { type ReactNode } from 'react';
-interface WorldProps {
-    /** Gravitational acceleration in pixels/s² (default inherited from Game) */
-    gravity?: number;
-    /** Canvas background color */
-    background?: string;
-    children?: ReactNode;
-}
-export declare function World({ gravity, background, children }: WorldProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/components/particlePresets.d.ts

@@ -1,13 +0,0 @@
-export type ParticlePreset = 'explosion' | 'spark' | 'smoke' | 'coinPickup' | 'jumpDust';
-export interface ParticleEmitterConfig {
-    rate?: number;
-    speed?: number;
-    spread?: number;
-    angle?: number;
-    particleLife?: number;
-    particleSize?: number;
-    color?: string;
-    gravity?: number;
-    maxParticles?: number;
-}
-export declare const PARTICLE_PRESETS: Record<ParticlePreset, ParticleEmitterConfig>;

package/dist/components/spriteAtlas.d.ts

@@ -1,8 +0,0 @@
-/** Maps frame names to frameIndex numbers */
-export type SpriteAtlas = Record<string, number>;
-/**
- * Helper to build an atlas from a grid spritesheet.
- * columns = number of frames per row.
- * names = frame names in row-major order.
- */
-export declare function createAtlas(names: string[], _columns: number): SpriteAtlas;

package/dist/context.d.ts

@@ -1,22 +0,0 @@
-import type { ECSWorld, EventBus, AssetManager, EntityId } from '@cubeforge/core';
-import type { InputManager } from '@cubeforge/input';
-import type { Canvas2DRenderer, RenderSystem } from '@cubeforge/renderer';
-import type { PhysicsSystem } from '@cubeforge/physics';
-import type { GameLoop } from '@cubeforge/core';
-export interface EngineState {
-    ecs: ECSWorld;
-    input: InputManager;
-    /** Canvas2D renderer. Undefined when a custom WebGL renderer is used via the `renderer` Game prop. */
-    renderer?: Canvas2DRenderer;
-    /** The active render system. Undefined when a custom renderer is used. */
-    renderSystem?: RenderSystem;
-    physics: PhysicsSystem;
-    events: EventBus;
-    assets: AssetManager;
-    loop: GameLoop;
-    canvas: HTMLCanvasElement;
-    /** Maps string entity IDs (e.g. "player") to numeric ECS EntityIds */
-    entityIds: Map<string, EntityId>;
-}
-export declare const EngineContext: import("react").Context<EngineState | null>;
-export declare const EntityContext: import("react").Context<number | null>;

package/dist/hooks/useCamera.d.ts

@@ -1,37 +0,0 @@
-export interface CameraControls {
-    /**
-     * Trigger a screen-shake effect.
-     * @param intensity - Maximum pixel displacement per frame.
-     * @param duration  - How long the shake lasts in seconds.
-     */
-    shake(intensity: number, duration: number): void;
-    /**
-     * Set the world-space offset applied to the camera's follow target.
-     * Useful for look-ahead: `setFollowOffset(facing * 80, 0)`.
-     */
-    setFollowOffset(x: number, y: number): void;
-    /**
-     * Instantly move the camera center to a world-space position.
-     * Bypasses smoothing — useful for instant scene cuts.
-     */
-    setPosition(x: number, y: number): void;
-    /**
-     * Programmatically set the camera zoom level.
-     */
-    setZoom(zoom: number): void;
-}
-/**
- * Returns controls for the active Camera2D in the scene.
- * Must be used inside `<Game>`.
- *
- * @example
- * ```tsx
- * function HUD() {
- *   const camera = useCamera()
- *   return (
- *     <button onClick={() => camera.shake(8, 0.4)}>Shake!</button>
- *   )
- * }
- * ```
- */
-export declare function useCamera(): CameraControls;

package/dist/hooks/useContact.d.ts

@@ -1,57 +0,0 @@
-import type { EntityId } from '@cubeforge/core';
-interface ContactOpts {
-    /** Only fire if the other entity has this tag */
-    tag?: string;
-    /** Only fire if the other entity's BoxCollider is on this layer */
-    layer?: string;
-}
-/**
- * Fires once when another entity's collider first overlaps this entity's trigger.
- * Must be used inside an `<Entity>`.
- *
- * @example
- * function CoinPickup() {
- *   useTriggerEnter((other) => collectCoin(), { tag: 'player' })
- *   return null
- * }
- */
-export declare function useTriggerEnter(handler: (other: EntityId) => void, opts?: ContactOpts): void;
-/**
- * Fires once when an overlapping entity's collider leaves this entity's trigger.
- * Must be used inside an `<Entity>`.
- */
-export declare function useTriggerExit(handler: (other: EntityId) => void, opts?: ContactOpts): void;
-/**
- * Fires once on the first frame two solid dynamic bodies touch.
- * Must be used inside an `<Entity>`.
- *
- * @example
- * function Enemy() {
- *   useCollisionEnter((other) => takeDamage(), { tag: 'player' })
- *   return null
- * }
- */
-export declare function useCollisionEnter(handler: (other: EntityId) => void, opts?: ContactOpts): void;
-/**
- * Fires once when two solid dynamic bodies separate.
- * Must be used inside an `<Entity>`.
- */
-export declare function useCollisionExit(handler: (other: EntityId) => void, opts?: ContactOpts): void;
-/**
- * Fires once when another entity's CircleCollider first overlaps this entity's CircleCollider.
- * Also fires when a CircleCollider overlaps a BoxCollider.
- * Must be used inside an `<Entity>`.
- *
- * @example
- * function Asteroid() {
- *   useCircleEnter((other) => onHit(other), { tag: 'bullet' })
- *   return null
- * }
- */
-export declare function useCircleEnter(handler: (other: EntityId) => void, opts?: ContactOpts): void;
-/**
- * Fires once when two CircleCollider entities stop overlapping.
- * Must be used inside an `<Entity>`.
- */
-export declare function useCircleExit(handler: (other: EntityId) => void, opts?: ContactOpts): void;
-export {};

package/dist/hooks/useEntity.d.ts

@@ -1,2 +0,0 @@
-import type { EntityId } from '@cubeforge/core';
-export declare function useEntity(): EntityId;

package/dist/hooks/useEvents.d.ts

@@ -1,3 +0,0 @@
-import type { EventBus } from '@cubeforge/core';
-export declare function useEvents(): EventBus;
-export declare function useEvent<T>(event: string, handler: (data: T) => void): void;

package/dist/hooks/useGame.d.ts

@@ -1,2 +0,0 @@
-import { type EngineState } from '../context';
-export declare function useGame(): EngineState;

package/dist/hooks/useInput.d.ts

@@ -1,2 +0,0 @@
-import type { InputManager } from '@cubeforge/input';
-export declare function useInput(): InputManager;

package/dist/hooks/useInputMap.d.ts

@@ -1,25 +0,0 @@
-import type { ActionBindings } from '@cubeforge/input';
-export interface BoundInputMap {
-    /** True every frame any bound key is held. */
-    isActionDown(action: string): boolean;
-    /** True only on the first frame any bound key was pressed. */
-    isActionPressed(action: string): boolean;
-    /** True only on the frame any bound key was released. */
-    isActionReleased(action: string): boolean;
-}
-/**
- * React hook that returns a pre-bound action map for use inside `<Game>`.
- *
- * @example
- * ```tsx
- * function MyScript() {
- *   const actions = useInputMap({
- *     left:  ['ArrowLeft', 'KeyA'],
- *     right: ['ArrowRight', 'KeyD'],
- *     jump:  ['Space', 'ArrowUp', 'KeyW'],
- *   })
- *   // use actions.isActionDown('left') in a Script update or game loop callback
- * }
- * ```
- */
-export declare function useInputMap(bindings: ActionBindings): BoundInputMap;