@datamoc/mw_games 0.1.1

package/dist/render/Camera.js

@@ -0,0 +1,145 @@
+import { Container } from 'pixi.js';
+import { Game } from '../core/Game.js';
+import * as Random from '../core/Random.js';
+export class Camera {
+    constructor(options = {}) {
+        /** put the map and everything in it here */
+        this.world = new Container();
+        /** centre of the view, in world units */
+        this.x = 0;
+        this.y = 0;
+        this.viewWidth = 0;
+        this.viewHeight = 0;
+        this.followTarget = null;
+        //how fast the camera closes on its target: it covers `intensity` of the remaining
+        //distance each second, so it eases in without ever quite arriving
+        this.followIntensity = 0;
+        this.shakeMagnitude = 0;
+        this.shakeRemaining = 0;
+        this.shakeDuration = 1;
+        this.shakeX = 0;
+        this.shakeY = 0;
+        /** clamps the view to these world bounds when set, so the map's edge is never crossed */
+        this.bounds = null;
+        this._zoom = options.zoom ?? 1;
+        this.deadzone = options.deadzone ?? 0;
+    }
+    get zoom() {
+        return this._zoom;
+    }
+    set zoom(value) {
+        this._zoom = Math.max(0.01, value);
+    }
+    /** the framework calls this on resize; sizes are in screen pixels */
+    setViewport(width, height) {
+        this.viewWidth = width;
+        this.viewHeight = height;
+    }
+    /** the visible rectangle, in world units — use it to cull */
+    get view() {
+        const width = this.viewWidth / this._zoom;
+        const height = this.viewHeight / this._zoom;
+        return { x: this.x - width / 2, y: this.y - height / 2, width, height };
+    }
+    /** stops the camera leaving the map; pass null to allow it again */
+    setBounds(bounds) {
+        this.bounds = bounds;
+    }
+    /** jumps to a point with no easing, for a teleport or a scene change */
+    snapTo(x, y) {
+        this.x = x;
+        this.y = y;
+        this.followTarget = null;
+        this.followIntensity = 0;
+        this.apply();
+    }
+    /** eases towards a fixed point */
+    panTo(x, y, intensity = 4) {
+        this.followTarget = { x, y };
+        this.followIntensity = intensity;
+    }
+    /** eases towards something that keeps moving, such as the player */
+    follow(target, intensity = 8) {
+        this.followTarget = target;
+        this.followIntensity = intensity;
+    }
+    stopFollowing() {
+        this.followTarget = null;
+        this.followIntensity = 0;
+    }
+    /** @param magnitude world units @param duration seconds */
+    shake(magnitude, duration = 0.4) {
+        this.shakeMagnitude = magnitude;
+        this.shakeRemaining = this.shakeDuration = duration;
+    }
+    update(dt) {
+        if (this.followTarget && this.followIntensity > 0) {
+            const deadX = (this.view.width * this.deadzone) / 2;
+            const deadY = (this.view.height * this.deadzone) / 2;
+            let dx = this.followTarget.x - this.x;
+            let dy = this.followTarget.y - this.y;
+            //inside the deadzone the camera simply does not move
+            dx = dx > deadX ? dx - deadX : dx < -deadX ? dx + deadX : 0;
+            dy = dy > deadY ? dy - deadY : dy < -deadY ? dy + deadY : 0;
+            //framerate-independent easing: the same fraction is covered per second however
+            //long the frame was, so a slow frame does not lag the camera behind
+            const t = 1 - Math.exp(-this.followIntensity * dt);
+            this.x += dx * t;
+            this.y += dy * t;
+        }
+        if (this.shakeRemaining > 0) {
+            this.shakeRemaining -= dt;
+            //the shake fades out over its duration rather than stopping dead
+            const damping = Math.max(0, this.shakeRemaining / this.shakeDuration);
+            this.shakeX = Random.float(-this.shakeMagnitude, this.shakeMagnitude) * damping;
+            this.shakeY = Random.float(-this.shakeMagnitude, this.shakeMagnitude) * damping;
+        }
+        else {
+            this.shakeX = this.shakeY = 0;
+        }
+        this.apply();
+    }
+    /** world point to screen pixels */
+    toScreen(x, y) {
+        return {
+            x: (x - this.x) * this._zoom + this.viewWidth / 2,
+            y: (y - this.y) * this._zoom + this.viewHeight / 2,
+        };
+    }
+    /** screen pixels to world point, for turning a click into a tile */
+    toWorld(x, y) {
+        return {
+            x: (x - this.viewWidth / 2) / this._zoom + this.x,
+            y: (y - this.viewHeight / 2) / this._zoom + this.y,
+        };
+    }
+    apply() {
+        let centreX = this.x + this.shakeX;
+        let centreY = this.y + this.shakeY;
+        if (this.bounds) {
+            const halfWidth = this.viewWidth / this._zoom / 2;
+            const halfHeight = this.viewHeight / this._zoom / 2;
+            const { minX, minY, maxX, maxY } = this.bounds;
+            //when the map is narrower than the view, centre it rather than clamping to an
+            //edge, which would push the map against one side of the screen
+            centreX = maxX - minX < halfWidth * 2 ? (minX + maxX) / 2 : clamp(centreX, minX + halfWidth, maxX - halfWidth);
+            centreY = maxY - minY < halfHeight * 2 ? (minY + maxY) / 2 : clamp(centreY, minY + halfHeight, maxY - halfHeight);
+        }
+        this.world.scale.set(this._zoom);
+        //rounding to whole screen pixels stops pixel art shimmering as the camera moves
+        this.world.x = Math.round(this.viewWidth / 2 - centreX * this._zoom);
+        this.world.y = Math.round(this.viewHeight / 2 - centreY * this._zoom);
+    }
+}
+function clamp(value, min, max) {
+    return value < min ? min : value > max ? max : value;
+}
+/** a camera sized to the running game's viewport, updated on every frame */
+export function createCamera(options = {}) {
+    const camera = new Camera(options);
+    const game = Game.current;
+    //the logical viewport, not the backing store, which is larger on a hidpi display
+    camera.setViewport(game.width, game.height);
+    return camera;
+}
+//# sourceMappingURL=Camera.js.map

package/dist/render/Camera.js.map

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

package/dist/render/ColorTransformBatcher.d.ts

@@ -0,0 +1,57 @@
+import { Batcher, ExtensionType, Geometry, Shader } from 'pixi.js';
+import type { BatchableMeshElement, BatchableQuadElement, BatcherOptions, Matrix } from 'pixi.js';
+/**
+ * The fields the runtime elements carry but the published types omit.
+ *
+ * Pixi's own DefaultBatcher is untyped JavaScript, so these never had to be declared. They
+ * are read here exactly as DefaultBatcher reads them.
+ */
+interface PackedElement {
+    transform: Matrix;
+    color: number;
+    roundPixels: number;
+    colorAdd?: number;
+}
+type MeshElement = BatchableMeshElement & PackedElement;
+type QuadElement = BatchableQuadElement & PackedElement;
+/**
+ * Carries the additive colour for one renderable.
+ *
+ * Anything drawn through this batcher may set `colorAdd` on itself; anything that does not
+ * is packed with zero and renders exactly as it would have with the default batcher.
+ */
+export interface HasColorAdd {
+    /** additive colour, packed as 0xAABBGGRR to match the attribute's byte order */
+    colorAdd?: number;
+}
+export declare class ColorTransformBatcher extends Batcher {
+    /** @internal */
+    static extension: {
+        readonly type: readonly [ExtensionType.Batcher];
+        readonly name: 'mwg-color-transform';
+    };
+    geometry: Geometry;
+    shader: Shader;
+    name: "mwg-color-transform";
+    vertexSize: number;
+    constructor(options: BatcherOptions);
+    packAttributes(element: MeshElement, float32View: Float32Array, uint32View: Uint32Array, index: number, textureId: number): void;
+    packQuadAttributes(element: QuadElement, float32View: Float32Array, uint32View: Uint32Array, index: number, textureId: number): void;
+    /** @internal - Pixi calls this when the device's texture limit is known */
+    _updateMaxTextures(maxTextures: number): void;
+    destroy(): void;
+}
+/**
+ * Packs an additive colour into the form the attribute expects.
+ *
+ * @param r red, 0 to 1
+ * @param g green, 0 to 1
+ * @param b blue, 0 to 1
+ * @param a how much to add to the sprite's own alpha, 0 to 1; usually 0
+ */
+export declare function packColorAdd(r: number, g: number, b: number, a?: number): number;
+/** the additive half of `lerp(texel, colour, strength)`; pair with a tint of `1 - strength` */
+export declare function packTintAdd(color: number, strength: number): number;
+export declare const NO_COLOR_ADD = 0;
+export {};
+//# sourceMappingURL=ColorTransformBatcher.d.ts.map

package/dist/render/ColorTransformBatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorTransformBatcher.d.ts","sourceRoot":"","sources":["../../src/render/ColorTransformBatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,OAAO,EAGP,aAAa,EACb,QAAQ,EACR,MAAM,EAUN,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAElG;;;;;GAKG;AACH,UAAU,aAAa;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,WAAW,GAAG,oBAAoB,GAAG,aAAa,CAAC;AACxD,KAAK,WAAW,GAAG,oBAAoB,GAAG,aAAa,CAAC;AA4HxD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,qBAAsB,SAAQ,OAAO;IACjD,gBAAgB;IAChB,MAAM,CAAC,SAAS;iBACf,IAAI;iBACJ,IAAI,EAAE,qBAAqB;MACjB;IAEX,QAAQ,EAAE,QAAQ,CAAgC;IAClD,MAAM,EAAE,MAAM,CAAC;IACN,IAAI,wBAAwC;IAC5C,UAAU,SAAe;IAElC,YAAY,OAAO,EAAE,cAAc,EAGlC;IAED,cAAc,CACb,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,YAAY,EACzB,UAAU,EAAE,WAAW,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GACf,IAAI,CAuBN;IAED,kBAAkB,CACjB,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,YAAY,EACzB,UAAU,EAAE,WAAW,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GACf,IAAI,CAgCN;IAED,2EAA2E;IAC3E,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAI5C;IAEQ,OAAO,IAAI,IAAI,CAGvB;CACD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,MAAM,CAM3E;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMnE;AAMD,eAAO,MAAM,YAAY,IAAS,CAAC"}

package/dist/render/ColorTransformBatcher.js

@@ -0,0 +1,212 @@
+import { Batcher, Buffer, BufferUsage, ExtensionType, Geometry, Shader, colorBit, colorBitGl, compileHighShaderGlProgram, compileHighShaderGpuProgram, generateTextureBatchBit, generateTextureBatchBitGl, getBatchSamplersUniformGroup, roundPixelsBit, roundPixelsBitGl, } from 'pixi.js';
+/**
+ * A batcher that adds a per-sprite *additive* colour term.
+ *
+ * Pixi's built-in tint can only multiply. A roguelike needs `texel × M + A`, because the
+ * add term is what expresses everything that pulls a sprite *towards* a colour rather
+ * than darkening it: a poisoned enemy going green, a hit flashing white, a remembered but
+ * unlit tile washing out to grey. Those all read as `lerp(texel, colour, strength)`, which
+ * is `texel × (1 - s) + colour × s` — impossible with multiply alone.
+ *
+ * Doing it here rather than as a per-object filter is the whole point: a filter costs a
+ * render-texture pass per object, while this rides along in the same batch and costs one
+ * extra vertex attribute.
+ *
+ * ## A note on coupling
+ *
+ * This is the one file in `mwg` that builds on Pixi's batching internals: `Batcher`, the
+ * high-shader bits, and the vertex packing layout. They are exported from the package
+ * root, but they are implementation surface and may shift between Pixi minor versions.
+ * The coupling is deliberately confined to this file, and `ColorTransform.test.ts` pins
+ * the behaviour so an upgrade fails loudly rather than quietly rendering wrong.
+ */
+/** the extra vertex attribute, and how it folds into the fragment colour */
+const colorAddBitGl = {
+    name: 'color-add-bit',
+    vertex: {
+        header: /* glsl */ `
+            in vec4 aColorAdd;
+            out vec4 vColorAdd;
+        `,
+        main: /* glsl */ `
+            vColorAdd = aColorAdd;
+        `,
+    },
+    fragment: {
+        header: /* glsl */ `
+            in vec4 vColorAdd;
+        `,
+        end: /* glsl */ `
+            // Pixi works in premultiplied alpha, so the added colour is scaled by the
+            // final alpha. That keeps a transparent texel transparent instead of leaving
+            // a coloured halo where the sprite is empty.
+            float addedAlpha = finalColor.a + vColorAdd.a;
+            finalColor = vec4(finalColor.rgb + vColorAdd.rgb * addedAlpha, addedAlpha);
+        `,
+    },
+};
+const colorAddBit = {
+    name: 'color-add-bit',
+    vertex: {
+        header: /* wgsl */ `
+            @in aColorAdd: vec4<f32>;
+            @out vColorAdd: vec4<f32>;
+        `,
+        main: /* wgsl */ `
+            vColorAdd = aColorAdd;
+        `,
+    },
+    fragment: {
+        header: /* wgsl */ `
+            @in vColorAdd: vec4<f32>;
+        `,
+        end: /* wgsl */ `
+            let addedAlpha = finalColor.a + vColorAdd.a;
+            finalColor = vec4<f32>(finalColor.rgb + vColorAdd.rgb * addedAlpha, addedAlpha);
+        `,
+    },
+};
+class ColorTransformShader extends Shader {
+    constructor(maxTextures) {
+        super({
+            glProgram: compileHighShaderGlProgram({
+                name: 'color-transform-batch',
+                bits: [colorBitGl, colorAddBitGl, generateTextureBatchBitGl(maxTextures), roundPixelsBitGl],
+            }),
+            gpuProgram: compileHighShaderGpuProgram({
+                name: 'color-transform-batch',
+                bits: [colorBit, colorAddBit, generateTextureBatchBit(maxTextures), roundPixelsBit],
+            }),
+            resources: { batchSamplers: getBatchSamplersUniformGroup(maxTextures) },
+        });
+        this.maxTextures = maxTextures;
+    }
+}
+/** the default layout plus one more 32-bit word for the additive colour */
+const VERTEX_SIZE = 7;
+class ColorTransformGeometry extends Geometry {
+    constructor() {
+        const attributeBuffer = new Buffer({
+            data: new Float32Array(1),
+            label: 'mwg-color-transform-attribute-buffer',
+            usage: BufferUsage.VERTEX | BufferUsage.COPY_DST,
+            shrinkToFit: false,
+        });
+        const indexBuffer = new Buffer({
+            data: new Uint32Array(1),
+            label: 'mwg-color-transform-index-buffer',
+            usage: BufferUsage.INDEX | BufferUsage.COPY_DST,
+            shrinkToFit: false,
+        });
+        const stride = VERTEX_SIZE * 4;
+        super({
+            attributes: {
+                aPosition: { buffer: attributeBuffer, format: 'float32x2', stride, offset: 0 },
+                aUV: { buffer: attributeBuffer, format: 'float32x2', stride, offset: 2 * 4 },
+                aColor: { buffer: attributeBuffer, format: 'unorm8x4', stride, offset: 4 * 4 },
+                aTextureIdAndRound: { buffer: attributeBuffer, format: 'uint16x2', stride, offset: 5 * 4 },
+                aColorAdd: { buffer: attributeBuffer, format: 'unorm8x4', stride, offset: 6 * 4 },
+            },
+            indexBuffer,
+        });
+    }
+}
+const NO_ADD = 0;
+const addOf = (element) => element.colorAdd ?? NO_ADD;
+export class ColorTransformBatcher extends Batcher {
+    /** @internal */
+    static { this.extension = {
+        type: [ExtensionType.Batcher],
+        name: 'mwg-color-transform',
+    }; }
+    constructor(options) {
+        super(options);
+        this.geometry = new ColorTransformGeometry();
+        this.name = ColorTransformBatcher.extension.name;
+        this.vertexSize = VERTEX_SIZE;
+        this.shader = new ColorTransformShader(options.maxTextures);
+    }
+    packAttributes(element, float32View, uint32View, index, textureId) {
+        const textureIdAndRound = (textureId << 16) | (element.roundPixels & 0xffff);
+        const { a, b, c, d, tx, ty } = element.transform;
+        const { positions, uvs } = element;
+        const argb = element.color;
+        const colorAdd = addOf(element);
+        const offset = element.attributeOffset;
+        const end = offset + element.attributeSize;
+        for (let i = offset; i < end; i++) {
+            const i2 = i * 2;
+            const x = positions[i2];
+            const y = positions[i2 + 1];
+            float32View[index++] = a * x + c * y + tx;
+            float32View[index++] = d * y + b * x + ty;
+            float32View[index++] = uvs[i2];
+            float32View[index++] = uvs[i2 + 1];
+            uint32View[index++] = argb;
+            uint32View[index++] = textureIdAndRound;
+            uint32View[index++] = colorAdd;
+        }
+    }
+    packQuadAttributes(element, float32View, uint32View, index, textureId) {
+        const { a, b, c, d, tx, ty } = element.transform;
+        const { bounds } = element;
+        const uvs = element.texture.uvs;
+        const w0 = bounds.maxX;
+        const w1 = bounds.minX;
+        const h0 = bounds.maxY;
+        const h1 = bounds.minY;
+        const argb = element.color;
+        const colorAdd = addOf(element);
+        const textureIdAndRound = (textureId << 16) | (element.roundPixels & 0xffff);
+        //the four corners, in the winding order Pixi's shared index buffer expects
+        const corners = [
+            [w1, h1, uvs.x0, uvs.y0],
+            [w0, h1, uvs.x1, uvs.y1],
+            [w0, h0, uvs.x2, uvs.y2],
+            [w1, h0, uvs.x3, uvs.y3],
+        ];
+        for (const [x, y, u, v] of corners) {
+            float32View[index] = a * x + c * y + tx;
+            float32View[index + 1] = d * y + b * x + ty;
+            float32View[index + 2] = u;
+            float32View[index + 3] = v;
+            uint32View[index + 4] = argb;
+            uint32View[index + 5] = textureIdAndRound;
+            uint32View[index + 6] = colorAdd;
+            index += VERTEX_SIZE;
+        }
+    }
+    /** @internal - Pixi calls this when the device's texture limit is known */
+    _updateMaxTextures(maxTextures) {
+        if (this.shader.maxTextures === maxTextures)
+            return;
+        this.shader.destroy();
+        this.shader = new ColorTransformShader(maxTextures);
+    }
+    destroy() {
+        this.shader.destroy();
+        super.destroy();
+    }
+}
+/**
+ * Packs an additive colour into the form the attribute expects.
+ *
+ * @param r red, 0 to 1
+ * @param g green, 0 to 1
+ * @param b blue, 0 to 1
+ * @param a how much to add to the sprite's own alpha, 0 to 1; usually 0
+ */
+export function packColorAdd(r, g, b, a = 0) {
+    //unorm8x4 reads the four bytes in memory order, and the view is little-endian, so the
+    //red channel has to sit in the lowest byte
+    return (((clamp255(a) << 24) | (clamp255(b) << 16) | (clamp255(g) << 8) | clamp255(r)) >>> 0);
+}
+/** the additive half of `lerp(texel, colour, strength)`; pair with a tint of `1 - strength` */
+export function packTintAdd(color, strength) {
+    return packColorAdd((((color >> 16) & 0xff) / 255) * strength, (((color >> 8) & 0xff) / 255) * strength, ((color & 0xff) / 255) * strength);
+}
+function clamp255(value) {
+    return Math.max(0, Math.min(255, Math.round(value * 255)));
+}
+export const NO_COLOR_ADD = NO_ADD;
+//# sourceMappingURL=ColorTransformBatcher.js.map

package/dist/render/ColorTransformBatcher.js.map

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

package/dist/render/LayeredSprite.d.ts

@@ -0,0 +1,27 @@
+import { Container } from 'pixi.js';
+import type { Texture } from 'pixi.js';
+import { TintedSprite } from './TintedSprite.ts';
+/**
+ * A character assembled from independently swappable, independently tintable layers -
+ * skin, eyes, hair, garments, worn equipment - rather than one flat sprite per combination.
+ * A second palette is a colour change on one layer; worn equipment shows because it is
+ * another layer added on top, not a redrawn sprite for every gear combination a game might
+ * have. `tools/make-example-assets.mjs` already draws its characters this way; this is the
+ * runtime counterpart that keeps the layers together as one sprite that moves as a unit.
+ */
+export declare class LayeredSprite extends Container {
+    private layers;
+    /**
+     * Adds or replaces a named layer.
+     *
+     * @param order stacking order, higher drawn on top; equal order keeps insertion order
+     */
+    addLayer(name: string, texture: Texture, order?: number): TintedSprite;
+    removeLayer(name: string): void;
+    layer(name: string): TintedSprite | undefined;
+    hasLayer(name: string): boolean;
+    /** swaps a layer's texture without touching its tint, order, or identity - gear changing */
+    setTexture(name: string, texture: Texture): void;
+    private resort;
+}
+//# sourceMappingURL=LayeredSprite.d.ts.map

package/dist/render/LayeredSprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayeredSprite.d.ts","sourceRoot":"","sources":["../../src/render/LayeredSprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD;;;;;;;GAOG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC3C,OAAO,CAAC,MAAM,CAA4B;IAE1C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,YAAY,CAQhE;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM9B;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE5C;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED,4FAA4F;IAC5F,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAG/C;IAED,OAAO,CAAC,MAAM;CAId"}

package/dist/render/LayeredSprite.js

@@ -0,0 +1,53 @@
+import { Container } from 'pixi.js';
+import { TintedSprite } from './TintedSprite.js';
+/**
+ * A character assembled from independently swappable, independently tintable layers -
+ * skin, eyes, hair, garments, worn equipment - rather than one flat sprite per combination.
+ * A second palette is a colour change on one layer; worn equipment shows because it is
+ * another layer added on top, not a redrawn sprite for every gear combination a game might
+ * have. `tools/make-example-assets.mjs` already draws its characters this way; this is the
+ * runtime counterpart that keeps the layers together as one sprite that moves as a unit.
+ */
+export class LayeredSprite extends Container {
+    constructor() {
+        super(...arguments);
+        this.layers = new Map();
+    }
+    /**
+     * Adds or replaces a named layer.
+     *
+     * @param order stacking order, higher drawn on top; equal order keeps insertion order
+     */
+    addLayer(name, texture, order = 0) {
+        this.removeLayer(name);
+        const sprite = new TintedSprite(texture);
+        this.layers.set(name, { sprite, order });
+        this.addChild(sprite);
+        this.resort();
+        return sprite;
+    }
+    removeLayer(name) {
+        const existing = this.layers.get(name);
+        if (!existing)
+            return;
+        this.layers.delete(name);
+        existing.sprite.destroy();
+    }
+    layer(name) {
+        return this.layers.get(name)?.sprite;
+    }
+    hasLayer(name) {
+        return this.layers.has(name);
+    }
+    /** swaps a layer's texture without touching its tint, order, or identity - gear changing */
+    setTexture(name, texture) {
+        const layer = this.layers.get(name);
+        if (layer)
+            layer.sprite.texture = texture;
+    }
+    resort() {
+        const sorted = [...this.layers.values()].sort((a, b) => a.order - b.order);
+        sorted.forEach((layer, index) => this.setChildIndex(layer.sprite, index));
+    }
+}
+//# sourceMappingURL=LayeredSprite.js.map

package/dist/render/LayeredSprite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayeredSprite.js","sourceRoot":"","sources":["../../src/render/LayeredSprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD;;;;;;;GAOG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAA5C;;QACS,WAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IA2C3C,CAAC;IAzCA;;;;OAIG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAgB,EAAE,KAAK,GAAG,CAAC;QACjD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEvB,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,MAAM,CAAC;IACf,CAAC;IAED,WAAW,CAAC,IAAY;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACtC,CAAC;IAED,QAAQ,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,4FAA4F;IAC5F,UAAU,CAAC,IAAY,EAAE,OAAgB;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK;YAAE,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3C,CAAC;IAEO,MAAM;QACb,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3E,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3E,CAAC;CACD"}

package/dist/render/Projectile.d.ts

@@ -0,0 +1,37 @@
+export interface ProjectilePoint {
+    x: number;
+    y: number;
+}
+export interface ProjectileOptions {
+    /** world units per second; ignored if `duration` is given */
+    speed?: number;
+    /** seconds to cross the whole flight; overrides `speed` when both are given */
+    duration?: number;
+}
+/**
+ * Tweens a sprite's position in a straight line, world units to world units.
+ *
+ * This owns position only, the same division `GridMover` draws for tile movement: whether
+ * the shot lands, what it does on arrival, whether it should even be fired - all of that is
+ * the caller's business, decided (with `mwg/roguelike`'s targeting helpers, typically)
+ * before a `Projectile` is ever created. What is here is just "this point moves to that
+ * point over time", because a thrown potion and a wand bolt both need exactly that and
+ * nothing about the game's own arithmetic.
+ */
+export declare class Projectile {
+    private sprite;
+    private fromX;
+    private fromY;
+    private toX;
+    private toY;
+    private duration;
+    private elapsed;
+    private arrived;
+    constructor(sprite: ProjectilePoint, from: ProjectilePoint, to: ProjectilePoint, options?: ProjectileOptions);
+    get done(): boolean;
+    /** 0 at launch, 1 on arrival */
+    get progress(): number;
+    /** @returns true the instant it arrives, so a caller can trigger impact exactly once */
+    update(dt: number): boolean;
+}
+//# sourceMappingURL=Projectile.d.ts.map

package/dist/render/Projectile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Projectile.d.ts","sourceRoot":"","sources":["../../src/render/Projectile.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAED,MAAM,WAAW,iBAAiB;IACjC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,EAAE,OAAO,GAAE,iBAAsB,EAc/G;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,gCAAgC;IAChC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,wFAAwF;IACxF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAa1B;CACD"}

package/dist/render/Projectile.js

@@ -0,0 +1,50 @@
+/**
+ * Tweens a sprite's position in a straight line, world units to world units.
+ *
+ * This owns position only, the same division `GridMover` draws for tile movement: whether
+ * the shot lands, what it does on arrival, whether it should even be fired - all of that is
+ * the caller's business, decided (with `mwg/roguelike`'s targeting helpers, typically)
+ * before a `Projectile` is ever created. What is here is just "this point moves to that
+ * point over time", because a thrown potion and a wand bolt both need exactly that and
+ * nothing about the game's own arithmetic.
+ */
+export class Projectile {
+    constructor(sprite, from, to, options = {}) {
+        this.elapsed = 0;
+        this.arrived = false;
+        this.sprite = sprite;
+        this.fromX = from.x;
+        this.fromY = from.y;
+        this.toX = to.x;
+        this.toY = to.y;
+        const distance = Math.hypot(to.x - from.x, to.y - from.y);
+        this.duration = options.duration ?? distance / (options.speed ?? 400);
+        //a zero-length flight (fired at your own feet) still resolves in one update
+        if (this.duration <= 0)
+            this.duration = 1e-6;
+        sprite.x = from.x;
+        sprite.y = from.y;
+    }
+    get done() {
+        return this.arrived;
+    }
+    /** 0 at launch, 1 on arrival */
+    get progress() {
+        return Math.min(1, this.elapsed / this.duration);
+    }
+    /** @returns true the instant it arrives, so a caller can trigger impact exactly once */
+    update(dt) {
+        if (this.arrived)
+            return false;
+        this.elapsed += dt;
+        const t = this.progress;
+        this.sprite.x = this.fromX + (this.toX - this.fromX) * t;
+        this.sprite.y = this.fromY + (this.toY - this.fromY) * t;
+        if (t >= 1) {
+            this.arrived = true;
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=Projectile.js.map

package/dist/render/Projectile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Projectile.js","sourceRoot":"","sources":["../../src/render/Projectile.ts"],"names":[],"mappings":"AAaA;;;;;;;;;GASG;AACH,MAAM,OAAO,UAAU;IAUtB,YAAY,MAAuB,EAAE,IAAqB,EAAE,EAAmB,EAAE,OAAO,GAAsB,EAAE;QAHxG,YAAO,GAAG,CAAC,CAAC;QACZ,YAAO,GAAG,KAAK,CAAC;QAGvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QAChB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QAEhB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;QACtE,4EAA4E;QAC5E,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAE7C,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAClB,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,gCAAgC;IAChC,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,wFAAwF;IACxF,MAAM,CAAC,EAAU;QAChB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE/B,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEzD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}