toaimin-indie-engine 1.0.0

package/dist/rendering/CanvasContext.d.ts

@@ -0,0 +1,80 @@
+import { Matrix2D } from '../math/Matrix2D';
+import { Color } from '../math/Color';
+import { ICanvasRenderingContext2D } from './CanvasMock';
+export interface CanvasContextOptions {
+    pixelArt?: boolean;
+}
+/**
+ * Ergonomic wrapper around Canvas 2D rendering context.
+ * Features:
+ * - Direct transformation matrix synchronization with Matrix2D.
+ * - Robust save/restore state stack tracking with underflow protection.
+ * - Push/pop alpha and composite operations for nested hierarchies.
+ * - Pixel-art smoothing controls.
+ * - Headless fallback in Node.js runtime.
+ */
+export declare class CanvasContext {
+    readonly rawContext: ICanvasRenderingContext2D;
+    readonly currentMatrix: Matrix2D;
+    private _saveDepth;
+    private _matrixStack;
+    private _alphaStack;
+    private _compositeStack;
+    constructor(context: ICanvasRenderingContext2D, options?: CanvasContextOptions);
+    get saveDepth(): number;
+    /**
+     * Pushes current state (transform, alpha, composite, and context state) to the stack.
+     */
+    save(): this;
+    /**
+     * Restores the most recently saved context state.
+     * Guarded against underflow when saveDepth is 0.
+     */
+    restore(): this;
+    /**
+     * Restores state until save depth matches targetDepth.
+     */
+    restoreTo(targetDepth: number): this;
+    /**
+     * Sets transformation matrix directly and synchronizes with Canvas context.
+     */
+    setMatrix(matrix: Matrix2D): this;
+    /**
+     * Multiplies given matrix onto the current context transformation.
+     */
+    transformMatrix(matrix: Matrix2D): this;
+    translate(x: number, y: number): this;
+    rotate(radians: number): this;
+    scale(sx: number, sy?: number): this;
+    resetTransform(): this;
+    getMatrix(out?: Matrix2D): Matrix2D;
+    get globalAlpha(): number;
+    set globalAlpha(value: number);
+    /**
+     * Multiplies current alpha by factor and pushes previous alpha to stack.
+     */
+    pushAlpha(factor: number): this;
+    popAlpha(): this;
+    get blendMode(): GlobalCompositeOperation;
+    set blendMode(mode: GlobalCompositeOperation);
+    pushBlendMode(mode: GlobalCompositeOperation): this;
+    popBlendMode(): this;
+    get imageSmoothingEnabled(): boolean;
+    setImageSmoothing(enabled: boolean): this;
+    setFillStyle(style: string | Color | CanvasGradient | CanvasPattern): this;
+    setStrokeStyle(style: string | Color | CanvasGradient | CanvasPattern): this;
+    setLineWidth(width: number): this;
+    clearRect(x: number, y: number, width: number, height: number): this;
+    fillRect(x: number, y: number, width: number, height: number): this;
+    strokeRect(x: number, y: number, width: number, height: number): this;
+    beginPath(): this;
+    closePath(): this;
+    moveTo(x: number, y: number): this;
+    lineTo(x: number, y: number): this;
+    arc(x: number, y: number, radius: number, startAngle?: number, endAngle?: number, counterclockwise?: boolean): this;
+    fill(): this;
+    stroke(): this;
+    clip(): this;
+    drawImage(image: any, sx?: number, sy?: number, sw?: number, sh?: number, dx?: number, dy?: number, dw?: number, dh?: number): this;
+}
+//# sourceMappingURL=CanvasContext.d.ts.map

package/dist/rendering/CanvasContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasContext.d.ts","sourceRoot":"","sources":["../../src/rendering/CanvasContext.ts"],"names":[],"mappings":"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"}

package/dist/rendering/CanvasMock.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Standard Canvas 2D Text Metrics Mock
+ */
+export interface ITextMetrics {
+    width: number;
+    actualBoundingBoxLeft: number;
+    actualBoundingBoxRight: number;
+    actualBoundingBoxAscent: number;
+    actualBoundingBoxDescent: number;
+}
+/**
+ * Minimal CanvasRenderingContext2D Duck-Type Interface
+ * Matching methods and properties used by the framework rendering pipeline.
+ */
+export interface ICanvasRenderingContext2D {
+    canvas: any;
+    fillStyle: string | CanvasGradient | CanvasPattern;
+    strokeStyle: string | CanvasGradient | CanvasPattern;
+    lineWidth: number;
+    lineCap: CanvasLineCap;
+    lineJoin: CanvasLineJoin;
+    miterLimit: number;
+    globalAlpha: number;
+    globalCompositeOperation: GlobalCompositeOperation;
+    imageSmoothingEnabled: boolean;
+    font: string;
+    textAlign: CanvasTextAlign;
+    textBaseline: CanvasTextBaseline;
+    shadowBlur: number;
+    shadowColor: string;
+    shadowOffsetX: number;
+    shadowOffsetY: number;
+    save(): void;
+    restore(): void;
+    scale(x: number, y: number): void;
+    rotate(angle: number): void;
+    translate(x: number, y: number): void;
+    transform(a: number, b: number, c: number, d: number, e: number, f: number): void;
+    setTransform(a: number, b: number, c: number, d: number, e: number, f: number): void;
+    resetTransform(): void;
+    getTransform(): DOMMatrix;
+    clearRect(x: number, y: number, w: number, h: number): void;
+    fillRect(x: number, y: number, w: number, h: number): void;
+    strokeRect(x: number, y: number, w: number, h: number): void;
+    beginPath(): void;
+    closePath(): void;
+    moveTo(x: number, y: number): void;
+    lineTo(x: number, y: number): void;
+    arc(x: number, y: number, radius: number, startAngle: number, endAngle: number, counterclockwise?: boolean): void;
+    rect(x: number, y: number, w: number, h: number): void;
+    roundRect?(x: number, y: number, w: number, h: number, radii?: number | number[]): void;
+    ellipse?(x: number, y: number, radiusX: number, radiusY: number, rotation: number, startAngle: number, endAngle: number, counterclockwise?: boolean): void;
+    arcTo?(x1: number, y1: number, x2: number, y2: number, radius: number): void;
+    fill(): void;
+    stroke(): void;
+    clip(): void;
+    drawImage(image: any, sx: number, sy: number, sw?: number, sh?: number, dx?: number, dy?: number, dw?: number, dh?: number): void;
+    fillText(text: string, x: number, y: number, maxWidth?: number): void;
+    strokeText(text: string, x: number, y: number, maxWidth?: number): void;
+    measureText(text: string): ITextMetrics;
+    createLinearGradient?(x0: number, y0: number, x1: number, y1: number): CanvasGradient;
+    createRadialGradient?(x0: number, y0: number, r0: number, x1: number, y1: number, r1: number): CanvasGradient;
+}
+/**
+ * In-memory Mock Canvas 2D Rendering Context
+ * Runs in headless Node.js without native binary dependencies and records draw calls for test inspection.
+ */
+export declare class MockCanvasRenderingContext2D implements ICanvasRenderingContext2D {
+    canvas: any;
+    fillStyle: string | CanvasGradient | CanvasPattern;
+    strokeStyle: string | CanvasGradient | CanvasPattern;
+    lineWidth: number;
+    lineCap: CanvasLineCap;
+    lineJoin: CanvasLineJoin;
+    miterLimit: number;
+    globalAlpha: number;
+    globalCompositeOperation: GlobalCompositeOperation;
+    imageSmoothingEnabled: boolean;
+    font: string;
+    textAlign: CanvasTextAlign;
+    textBaseline: CanvasTextBaseline;
+    shadowBlur: number;
+    shadowColor: string;
+    shadowOffsetX: number;
+    shadowOffsetY: number;
+    drawCalls: number;
+    callHistory: Array<{
+        method: string;
+        args: any[];
+    }>;
+    private _matrix;
+    private _stateStack;
+    constructor(canvas: any);
+    save(): void;
+    restore(): void;
+    scale(x: number, y: number): void;
+    rotate(angle: number): void;
+    translate(x: number, y: number): void;
+    transform(a: number, b: number, c: number, d: number, e: number, f: number): void;
+    setTransform(a: number, b: number, c: number, d: number, e: number, f: number): void;
+    resetTransform(): void;
+    getTransform(): DOMMatrix;
+    clearRect(x: number, y: number, w: number, h: number): void;
+    fillRect(x: number, y: number, w: number, h: number): void;
+    strokeRect(x: number, y: number, w: number, h: number): void;
+    beginPath(): void;
+    closePath(): void;
+    moveTo(x: number, y: number): void;
+    lineTo(x: number, y: number): void;
+    arc(x: number, y: number, radius: number, startAngle: number, endAngle: number, counterclockwise?: boolean): void;
+    rect(x: number, y: number, w: number, h: number): void;
+    roundRect(x: number, y: number, w: number, h: number, radii?: number | number[]): void;
+    arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): void;
+    ellipse(x: number, y: number, radiusX: number, radiusY: number, rotation: number, startAngle: number, endAngle: number, counterclockwise?: boolean): void;
+    fill(): void;
+    stroke(): void;
+    clip(): void;
+    drawImage(image: any, ...args: any[]): void;
+    fillText(text: string, x: number, y: number, maxWidth?: number): void;
+    strokeText(text: string, x: number, y: number, maxWidth?: number): void;
+    measureText(text: string): ITextMetrics;
+    createLinearGradient(_x0: number, _y0: number, _x1: number, _y1: number): CanvasGradient;
+    createRadialGradient(_x0: number, _y0: number, _r0: number, _x1: number, _y1: number, _r1: number): CanvasGradient;
+    clearMock(): void;
+}
+/**
+ * In-memory Mock Canvas Element
+ */
+export declare class MockCanvasElement {
+    width: number;
+    height: number;
+    style: {
+        width: string;
+        height: string;
+        position: string;
+        left: string;
+        top: string;
+        display: string;
+    };
+    private _context;
+    constructor(width?: number, height?: number);
+    getContext(contextId: string): ICanvasRenderingContext2D | null;
+    getBoundingClientRect(): {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+    };
+    addEventListener(_type: string, _listener: any): void;
+    removeEventListener(_type: string, _listener: any): void;
+    dispatchEvent(_event: any): boolean;
+}
+export declare function createMockCanvas(width?: number, height?: number): MockCanvasElement;
+export declare const CanvasMock: {
+    MockCanvasElement: typeof MockCanvasElement;
+    MockCanvasRenderingContext2D: typeof MockCanvasRenderingContext2D;
+    createMockCanvas: typeof createMockCanvas;
+};
+//# sourceMappingURL=CanvasMock.d.ts.map

package/dist/rendering/CanvasMock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasMock.d.ts","sourceRoot":"","sources":["../../src/rendering/CanvasMock.ts"],"names":[],"mappings":"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"}

package/dist/rendering/ParticleSystem.d.ts

@@ -0,0 +1,103 @@
+import { Vector2 } from '../math/Vector2';
+import { Color } from '../math/Color';
+import { Sprite } from './Sprite';
+import { CanvasContext } from './CanvasContext';
+import { ICanvasRenderingContext2D } from './CanvasMock';
+export interface Particle {
+    active: boolean;
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    life: number;
+    maxLife: number;
+    startSize: number;
+    endSize: number;
+    currentSize: number;
+    rotation: number;
+    angularVelocity: number;
+    startR: number;
+    startG: number;
+    startB: number;
+    startA: number;
+    endR: number;
+    endG: number;
+    endB: number;
+    endA: number;
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export type RangeValue = number | [number, number];
+export interface ParticleEmitterConfig {
+    /** Maximum particles in the pre-allocated pool (default: 500) */
+    maxParticles?: number;
+    /** Continuous emission rate in particles per second (default: 50) */
+    rate?: number;
+    /** Lifetime in seconds [min, max] or scalar (default: [0.5, 1.5]) */
+    lifetime?: RangeValue;
+    /** Speed in pixels per second [min, max] (default: [50, 150]) */
+    speed?: RangeValue;
+    /** Emission angle in radians [min, max] (default: [0, Math.PI * 2]) */
+    angle?: RangeValue;
+    /** Angular spread around angle in radians (default: 0) */
+    spread?: number;
+    /** Particle size in pixels at birth [min, max] (default: [4, 8]) */
+    startSize?: RangeValue;
+    /** Particle size in pixels at death [min, max] (default: [0, 2]) */
+    endSize?: RangeValue;
+    /** Starting color (default: Color.WHITE) */
+    startColor?: Color | string;
+    /** Ending color (default: Color.TRANSPARENT) */
+    endColor?: Color | string;
+    /** Constant external acceleration (e.g. gravity: { x: 0, y: 150 }) */
+    gravity?: Vector2 | {
+        x: number;
+        y: number;
+    };
+    /** Acceleration directed away from emitter origin (positive) or inward (negative) */
+    radialAcceleration?: RangeValue;
+    /** Perpendicular orbital acceleration (vortex effect) */
+    tangentialAcceleration?: RangeValue;
+    /** Angular spin speed in radians per second [min, max] */
+    angularVelocity?: RangeValue;
+    /** Canvas composite operation (default: 'source-over', use 'lighter' for fire/glow) */
+    blendMode?: GlobalCompositeOperation;
+    /** Particle visual shape */
+    shape?: 'circle' | 'rect' | 'sprite';
+    /** Texture or Sprite used when shape === 'sprite' */
+    texture?: CanvasImageSource | Sprite | any;
+}
+export declare class ParticleSystem {
+    position: Vector2;
+    config: Required<Omit<ParticleEmitterConfig, 'gravity' | 'texture' | 'startColor' | 'endColor'>> & {
+        gravity: Vector2;
+        startColor: Color;
+        endColor: Color;
+        texture?: CanvasImageSource | Sprite | any;
+    };
+    private _pool;
+    private _activeCount;
+    private _emitTimer;
+    isEmitting: boolean;
+    constructor(config?: ParticleEmitterConfig);
+    get activeCount(): number;
+    private _resolveRange;
+    /**
+     * Instantly emits N particles (e.g. for explosions or impacts).
+     */
+    burst(count: number, originX?: number, originY?: number): void;
+    private _spawnParticle;
+    /**
+     * Advances simulation using O(1) swap-and-pop despawning with zero allocations.
+     */
+    update(dt: number): void;
+    private _getRawContext;
+    /**
+     * Fast Canvas2D batch rendering.
+     */
+    render(context: CanvasRenderingContext2D | ICanvasRenderingContext2D | CanvasContext | any): void;
+    clear(): void;
+}
+//# sourceMappingURL=ParticleSystem.d.ts.map

package/dist/rendering/ParticleSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleSystem.d.ts","sourceRoot":"","sources":["../../src/rendering/ParticleSystem.ts"],"names":[],"mappings":"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"}

package/dist/rendering/Renderer.d.ts

@@ -0,0 +1,98 @@
+import { Vector2 } from '../math/Vector2';
+import { CanvasContext } from './CanvasContext';
+import { ICanvasRenderingContext2D, MockCanvasElement } from './CanvasMock';
+import { Camera2D } from './Camera2D';
+export type ScaleMode = 'letterbox' | 'fit' | 'stretch' | 'none' | 'fill';
+export interface RendererConfig {
+    canvas?: HTMLCanvasElement | MockCanvasElement | string;
+    width?: number;
+    height?: number;
+    scaleMode?: ScaleMode;
+    pixelArt?: boolean;
+    backgroundColor?: string;
+    highDPI?: boolean;
+    maxPixelRatio?: number;
+    dpr?: number;
+}
+export interface RenderCommand {
+    layer?: number;
+    zIndex?: number;
+    camera?: Camera2D | null;
+    render: (ctx: CanvasContext) => void;
+}
+export declare enum RenderLayer {
+    BACKGROUND = -1000,
+    DEFAULT = 0,
+    ENTITIES = 100,
+    EFFECTS = 200,
+    FOREGROUND = 300,
+    UI = 1000,
+    DEBUG = 2000
+}
+/**
+ * 2D Canvas Renderer managing viewport resolution, HiDPI buffer scaling,
+ * letterbox/fit/stretch presentation, frame lifecycle, and layer composition.
+ */
+export declare class Renderer {
+    readonly canvas: any;
+    readonly ctx: CanvasContext;
+    readonly rawContext: ICanvasRenderingContext2D;
+    readonly virtualWidth: number;
+    readonly virtualHeight: number;
+    readonly scaleMode: ScaleMode;
+    readonly pixelArt: boolean;
+    readonly highDPI: boolean;
+    readonly maxPixelRatio: number;
+    backgroundColor: string;
+    dpr: number;
+    scaleX: number;
+    scaleY: number;
+    offsetX: number;
+    offsetY: number;
+    cssWidth: number;
+    cssHeight: number;
+    drawCalls: number;
+    private _isFrameActive;
+    private _renderQueue;
+    constructor(config?: RendererConfig);
+    /**
+     * Recalculates canvas display dimensions, physical buffer size,
+     * and scale factors according to container/window dimensions and active scaleMode.
+     */
+    resize(containerWidth?: number, containerHeight?: number): void;
+    /**
+     * Converts browser client window coordinates (e.g., mouse / touch clientX, clientY)
+     * to game virtual coordinates (0 to virtualWidth, 0 to virtualHeight).
+     */
+    screenToVirtual(clientX: number, clientY: number, out?: Vector2): Vector2;
+    /**
+     * Converts game virtual coordinates to browser client coordinates.
+     */
+    virtualToScreen(vx: number, vy: number, out?: Vector2): Vector2;
+    /**
+     * Clears entire physical canvas buffer with background color.
+     */
+    clear(color?: string): void;
+    /**
+     * Begins frame rendering:
+     * - Resets draw call counters
+     * - Clears canvas with background color
+     * - Sets initial high-DPI viewport transform
+     */
+    beginFrame(): void;
+    /**
+     * Ends frame rendering:
+     * - Flushes queued render commands sorted by layer & zIndex
+     * - Restores context save depth to 0 if left unbalanced
+     */
+    endFrame(): void;
+    /**
+     * Submits a render command to be executed in layer & zIndex order on endFrame().
+     */
+    submit(command: RenderCommand): void;
+    /**
+     * Sorts and renders all queued render commands.
+     */
+    flushQueue(): void;
+}
+//# sourceMappingURL=Renderer.d.ts.map

package/dist/rendering/Renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../src/rendering/Renderer.ts"],"names":[],"mappings":"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"}

package/dist/rendering/Shapes.d.ts

@@ -0,0 +1,24 @@
+import { Color } from '../math/Color';
+import { Vector2 } from '../math/Vector2';
+import { CanvasContext } from './CanvasContext';
+import { ICanvasRenderingContext2D } from './CanvasMock';
+export type ContextLike = CanvasRenderingContext2D | ICanvasRenderingContext2D | CanvasContext | any;
+export declare class Shapes {
+    private static _getRaw;
+    private static _resolveColor;
+    static line(ctx: ContextLike, x1: number, y1: number, x2: number, y2: number, color: Color | string, lineWidth?: number, lineCap?: CanvasLineCap): void;
+    static rect(ctx: ContextLike, x: number, y: number, width: number, height: number, color: Color | string, filled?: boolean, lineWidth?: number): void;
+    static roundedRect(ctx: ContextLike, x: number, y: number, width: number, height: number, radius: number, color: Color | string, filled?: boolean, lineWidth?: number): void;
+    static circle(ctx: ContextLike, x: number, y: number, radius: number, color: Color | string, filled?: boolean, lineWidth?: number): void;
+    static arc(ctx: ContextLike, x: number, y: number, radius: number, startAngle: number, endAngle: number, color: Color | string, anticlockwise?: boolean, lineWidth?: number): void;
+    static ellipse(ctx: ContextLike, x: number, y: number, radiusX: number, radiusY: number, rotation: number | undefined, color: Color | string, filled?: boolean, lineWidth?: number): void;
+    static polygon(ctx: ContextLike, points: Array<{
+        x: number;
+        y: number;
+    } | Vector2>, color: Color | string, filled?: boolean, lineWidth?: number): void;
+    static path(ctx: ContextLike, points: Array<{
+        x: number;
+        y: number;
+    } | Vector2>, color: Color | string, closed?: boolean, lineWidth?: number): void;
+}
+//# sourceMappingURL=Shapes.d.ts.map

package/dist/rendering/Shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Shapes.d.ts","sourceRoot":"","sources":["../../src/rendering/Shapes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,WAAW,GAAG,wBAAwB,GAAG,yBAAyB,GAAG,aAAa,GAAG,GAAG,CAAC;AAErG,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,OAAO;IAItB,OAAO,CAAC,MAAM,CAAC,aAAa;WAId,IAAI,CAChB,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,SAAS,GAAE,MAAU,EACrB,OAAO,GAAE,aAAsB,GAC9B,IAAI;WAWO,IAAI,CAChB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,MAAM,GAAE,OAAc,EACtB,SAAS,GAAE,MAAU,GACpB,IAAI;WAaO,WAAW,CACvB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,MAAM,GAAE,OAAc,EACtB,SAAS,GAAE,MAAU,GACpB,IAAI;WAiCO,MAAM,CAClB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,MAAM,GAAE,OAAc,EACtB,SAAS,GAAE,MAAU,GACpB,IAAI;WAeO,GAAG,CACf,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,aAAa,GAAE,OAAe,EAC9B,SAAS,GAAE,MAAU,GACpB,IAAI;WASO,OAAO,CACnB,GAAG,EAAE,WAAW,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,YAAI,EACpB,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,MAAM,GAAE,OAAc,EACtB,SAAS,GAAE,MAAU,GACpB,IAAI;WAyBO,OAAO,CACnB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,EACjD,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,MAAM,GAAE,OAAc,EACtB,SAAS,GAAE,MAAU,GACpB,IAAI;WAqBO,IAAI,CAChB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,EACjD,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,MAAM,GAAE,OAAe,EACvB,SAAS,GAAE,MAAU,GACpB,IAAI;CAaR"}

package/dist/rendering/Sprite.d.ts

@@ -0,0 +1,74 @@
+import { Vector2 } from '../math/Vector2';
+import { Rect } from '../math/Rect';
+import { Color } from '../math/Color';
+import { Transform2D } from '../math/Transform2D';
+import { CanvasContext } from './CanvasContext';
+import { ICanvasRenderingContext2D } from './CanvasMock';
+export interface SpriteConfig {
+    /** CanvasImageSource: HTMLImageElement, HTMLCanvasElement, ImageBitmap, OffscreenCanvas, or MockCanvasElement */
+    texture: CanvasImageSource | any;
+    /** Source rectangle in the texture (for sprite sheets / atlases). Default: full texture */
+    sourceRect?: Rect | {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Destination rendering width. Default: sourceRect.width or texture.width */
+    width?: number;
+    /** Destination rendering height. Default: sourceRect.height or texture.height */
+    height?: number;
+    /** Normalized pivot/anchor [0, 1]. Default: (0.5, 0.5) for center */
+    anchor?: Vector2 | {
+        x: number;
+        y: number;
+    };
+    /** Tint color applied to sprite. Default: null (no tint) */
+    tint?: Color | string | null;
+    /** Horizontal flip */
+    flipX?: boolean;
+    /** Vertical flip */
+    flipY?: boolean;
+    /** Opacity [0.0, 1.0]. Default: 1.0 */
+    opacity?: number;
+}
+/**
+ * Cache for tinted offscreen canvases to eliminate per-frame canvas allocations.
+ */
+export declare class TextureTintCache {
+    private static _cache;
+    static getTintedTexture(source: any, sourceRect: Rect, tint: Color): any | null;
+    static clear(): void;
+}
+export declare class Sprite {
+    texture: any;
+    sourceRect: Rect;
+    width: number;
+    height: number;
+    anchor: Vector2;
+    tint: Color | null;
+    flipX: boolean;
+    flipY: boolean;
+    opacity: number;
+    private _cachedBounds;
+    constructor(config: SpriteConfig);
+    setSourceRect(x: number, y: number, width: number, height: number): this;
+    setAnchor(x: number, y: number): this;
+    setDimensions(width: number, height: number): this;
+    setFlip(flipX: boolean, flipY: boolean): this;
+    setTint(tint: Color | string | null): this;
+    /**
+     * Returns the local bounding box relative to the anchor point.
+     */
+    getBounds(out?: Rect): Rect;
+    private _getRawContext;
+    /**
+     * Draws the sprite at an explicit world position, rotation, and scale.
+     */
+    draw(context: CanvasRenderingContext2D | ICanvasRenderingContext2D | CanvasContext | any, x: number, y: number, rotation?: number, scaleX?: number, scaleY?: number): void;
+    /**
+     * Draws the sprite using a Transform2D hierarchy component.
+     */
+    drawTransform(context: CanvasRenderingContext2D | ICanvasRenderingContext2D | CanvasContext | any, transform: Transform2D): void;
+}
+//# sourceMappingURL=Sprite.d.ts.map

package/dist/rendering/Sprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../src/rendering/Sprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,iHAAiH;IACjH,OAAO,EAAE,iBAAiB,GAAG,GAAG,CAAC;IACjC,2FAA2F;IAC3F,UAAU,CAAC,EAAE,IAAI,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,4DAA4D;IAC5D,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B,sBAAsB;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,CAA+B;WAEtC,gBAAgB,CAC5B,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,IAAI,EAChB,IAAI,EAAE,KAAK,GACV,GAAG,GAAG,IAAI;WA6BC,KAAK,IAAI,IAAI;CAG5B;AAED,qBAAa,MAAM;IACV,OAAO,EAAE,GAAG,CAAC;IACb,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAQ;IAC1B,KAAK,EAAE,OAAO,CAAS;IACvB,KAAK,EAAE,OAAO,CAAS;IACvB,OAAO,EAAE,MAAM,CAAO;IAG7B,OAAO,CAAC,aAAa,CAAoB;gBAE7B,MAAM,EAAE,YAAY;IA6BzB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKxE,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMlD,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAM7C,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI;IAWjD;;OAEG;IACI,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI;IAWlC,OAAO,CAAC,cAAc;IAItB;;OAEG;IACI,IAAI,CACT,OAAO,EAAE,wBAAwB,GAAG,yBAAyB,GAAG,aAAa,GAAG,GAAG,EACnF,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,GAAE,MAAU,EACpB,MAAM,GAAE,MAAU,EAClB,MAAM,GAAE,MAAU,GACjB,IAAI;IA8CP;;OAEG;IACI,aAAa,CAClB,OAAO,EAAE,wBAAwB,GAAG,yBAAyB,GAAG,aAAa,GAAG,GAAG,EACnF,SAAS,EAAE,WAAW,GACrB,IAAI;CAuCR"}

package/dist/rendering/SpriteSheet.d.ts

@@ -0,0 +1,22 @@
+import { Rect } from '../math/Rect';
+import { AnimationClip, PlaybackMode } from './Animation';
+export interface SpriteSheetGridOptions {
+    frameWidth: number;
+    frameHeight: number;
+    columns?: number;
+    rows?: number;
+    spacing?: number;
+    margin?: number;
+    totalFrames?: number;
+}
+/**
+ * Utility for slicing texture atlases and grid sprite sheets.
+ */
+export declare class SpriteSheet {
+    readonly texture: any;
+    readonly frames: Rect[];
+    constructor(texture: any, options: SpriteSheetGridOptions);
+    getFrame(index: number): Rect;
+    createClip(name: string, frameIndices: number[], fps?: number, wrapMode?: PlaybackMode): AnimationClip;
+}
+//# sourceMappingURL=SpriteSheet.d.ts.map

package/dist/rendering/SpriteSheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteSheet.d.ts","sourceRoot":"","sources":["../../src/rendering/SpriteSheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,aAAa,EAAkB,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,SAAgB,OAAO,EAAE,GAAG,CAAC;IAC7B,SAAgB,MAAM,EAAE,IAAI,EAAE,CAAM;gBAExB,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,sBAAsB;IAyBlD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO7B,UAAU,CACf,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EAAE,EACtB,GAAG,GAAE,MAAW,EAChB,QAAQ,GAAE,YAAqB,GAC9B,aAAa;CAUjB"}

package/dist/rendering/index.d.ts

@@ -0,0 +1,11 @@
+export * from './CanvasMock';
+export * from './CanvasContext';
+export * from './Renderer';
+export * from './Camera2D';
+export * from './Sprite';
+export * from './Animation';
+export * from './SpriteSheet';
+export * from './ParticleSystem';
+export * from './Shapes';
+export * from './AssetLoader';
+//# sourceMappingURL=index.d.ts.map

package/dist/rendering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rendering/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}