@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/two-d/render/SvgSkeleton.d.ts

@@ -1,54 +0,0 @@
-import { type Mixer, type SkeletonBones } from '../../skeleton/index.ts';
-import { SkeletalSprite } from './SkeletalSprite.ts';
-import type { Texture2D } from './Types2D.ts';
-export interface SvgBoneBinding {
-    bone: string;
-    /** SVG group id; defaults to the bone name. */
-    group?: string;
-    /** Pivot in root SVG user coordinates. Overrides options.pivots and SVG data attributes. */
-    pivot?: {
-        x: number;
-        y: number;
-    };
-    /** Artwork's rest angle in degrees; defaults to the bone's resolved rest angle. */
-    rotation?: number;
-}
-export interface SvgSkeletonOptions {
-    skeleton: SkeletonBones;
-    /** Draw order. Omit to bind matching named groups in SVG document order. */
-    bindings?: readonly SvgBoneBinding[];
-    /** Root SVG user coordinates, keyed by group id (e.g. from a game's art manifest). */
-    pivots?: Readonly<Record<string, {
-        x: number;
-        y: number;
-    }>>;
-    resolution?: number;
-    mixer?: Mixer;
-}
-export interface LoadedSvgSkeleton {
-    sprite: SkeletalSprite;
-    /** Borrowed cached textures. Destroy sprites first, then releaseSvgParts once all users are done. */
-    textures: Readonly<Record<string, Texture2D>>;
-}
-/**
- * Load authored SVG limbs, normalize each around its pivot, and bind them to a skeleton.
- * Uses SVG data-pivot-x / data-pivot-y attributes or pivots supplied by the game. Art is
- * rotated back from its rest angle before rasterization, so rest poses reconstruct the drawing
- * and posed limbs turn around their joints. Separately bound descendant groups are removed
- * from parent parts, avoiding duplicate limbs; ancestor transforms and shared defs/styles survive.
- * Requires browser DOMParser and XMLSerializer. Compiled asset paths work directly under file://.
- * @example
- * ```ts
- * import { create } from '@datamoc/mw_games/skeleton';
- * import { loadSvgSkeleton } from '@datamoc/mw_games/two-d/render';
- * import { releaseSvgParts } from '@datamoc/mw_games/assets';
- * const loaded = await loadSvgSkeleton('<svg xmlns="http://www.w3.org/2000/svg" width="30" height="10"><g id="arm" data-pivot-x="0" data-pivot-y="5"><rect width="30" height="10"/></g></svg>', {
- *   skeleton: create([{ name: 'arm', length: 30, origin: { x: 0, y: 5 } }]), resolution: 2,
- * });
- * loaded.sprite.apply({ arm: 45 });
- * loaded.sprite.destroy({ children: true });
- * await releaseSvgParts(loaded.textures);
- * ```
- */
-export declare function loadSvgSkeleton(source: string, options: SvgSkeletonOptions): Promise<LoadedSvgSkeleton>;
-//# sourceMappingURL=SvgSkeleton.d.ts.map

package/dist/two-d/render/SvgSkeleton.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SvgSkeleton.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/SvgSkeleton.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,sFAAsF;IACtF,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,qGAAqG;IACrG,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgF7G"}

package/dist/two-d/render/SvgSkeleton.js

@@ -1,112 +0,0 @@
-import { readSvgSource } from '../../assets/SvgSource.js';
-import { loadSvgParts } from '../../assets/SvgParts.js';
-import { resolve } from '../../skeleton/index.js';
-import { SkeletalSprite } from './SkeletalSprite.js';
-/**
- * Load authored SVG limbs, normalize each around its pivot, and bind them to a skeleton.
- * Uses SVG data-pivot-x / data-pivot-y attributes or pivots supplied by the game. Art is
- * rotated back from its rest angle before rasterization, so rest poses reconstruct the drawing
- * and posed limbs turn around their joints. Separately bound descendant groups are removed
- * from parent parts, avoiding duplicate limbs; ancestor transforms and shared defs/styles survive.
- * Requires browser DOMParser and XMLSerializer. Compiled asset paths work directly under file://.
- * @example
- * ```ts
- * import { create } from '@datamoc/mw_games/skeleton';
- * import { loadSvgSkeleton } from '@datamoc/mw_games/two-d/render';
- * import { releaseSvgParts } from '@datamoc/mw_games/assets';
- * const loaded = await loadSvgSkeleton('<svg xmlns="http://www.w3.org/2000/svg" width="30" height="10"><g id="arm" data-pivot-x="0" data-pivot-y="5"><rect width="30" height="10"/></g></svg>', {
- *   skeleton: create([{ name: 'arm', length: 30, origin: { x: 0, y: 5 } }]), resolution: 2,
- * });
- * loaded.sprite.apply({ arm: 45 });
- * loaded.sprite.destroy({ children: true });
- * await releaseSvgParts(loaded.textures);
- * ```
- */
-export async function loadSvgSkeleton(source, options) {
-    if (options.mixer && options.mixer.skeleton !== options.skeleton)
-        throw new Error('SVG skeleton mixer must use the supplied skeleton');
-    const text = await readSvgSource(source);
-    const document = new DOMParser().parseFromString(text, 'image/svg+xml');
-    const root = document.documentElement;
-    if (document.querySelector('parsererror') || root.localName !== 'svg')
-        throw new Error('SVG skeleton needs a valid svg root');
-    const viewBox = root
-        .getAttribute('viewBox')
-        ?.trim()
-        .split(/[\s,]+/)
-        .map(Number) ?? [0, 0, Number(root.getAttribute('width')), Number(root.getAttribute('height'))];
-    if (viewBox.length !== 4 || !viewBox.every(Number.isFinite) || viewBox[2] <= 0 || viewBox[3] <= 0)
-        throw new Error('SVG skeleton needs a finite viewBox or positive numeric width and height');
-    const groups = new Map();
-    for (const group of root.querySelectorAll('g[id]')) {
-        if (groups.has(group.id))
-            throw new Error(`duplicate SVG skeleton group ${group.id}`);
-        groups.set(group.id, group);
-    }
-    const rest = new Map(resolve(options.skeleton).map((bone) => [bone.name, bone]));
-    const bindings = options.bindings ?? [...groups.keys()].filter((name) => rest.has(name)).map((bone) => ({ bone }));
-    if (!bindings.length)
-        throw new Error('SVG skeleton found no matching bone groups');
-    const selected = new Set(bindings.map((binding) => binding.group ?? binding.bone));
-    const bones = new Set();
-    const sources = [];
-    const serializer = new XMLSerializer();
-    for (const binding of bindings) {
-        const id = binding.group ?? binding.bone;
-        if (bones.has(binding.bone))
-            throw new Error(`duplicate SVG binding for bone ${binding.bone}`);
-        bones.add(binding.bone);
-        const bone = rest.get(binding.bone);
-        if (!bone)
-            throw new Error(`SVG binding names no bone ${binding.bone}`);
-        const group = groups.get(id);
-        if (!group)
-            throw new Error(`SVG skeleton missing group ${id}`);
-        const pivot = binding.pivot ??
-            options.pivots?.[id] ?? {
-            x: group.hasAttribute('data-pivot-x') ? Number(group.getAttribute('data-pivot-x')) : NaN,
-            y: group.hasAttribute('data-pivot-y') ? Number(group.getAttribute('data-pivot-y')) : NaN,
-        };
-        const rotation = binding.rotation ?? bone.angle;
-        if (![pivot.x, pivot.y, rotation].every(Number.isFinite))
-            throw new Error(`SVG skeleton group ${id} needs a finite pivot and rest angle`);
-        const farX = Math.max(Math.abs(viewBox[0] - pivot.x), Math.abs(viewBox[0] + viewBox[2] - pivot.x));
-        const farY = Math.max(Math.abs(viewBox[1] - pivot.y), Math.abs(viewBox[1] + viewBox[3] - pivot.y));
-        const radius = Math.ceil(Math.hypot(farX, farY)) + 1;
-        const isolated = root.cloneNode(false);
-        isolated.setAttribute('viewBox', `${-radius} ${-radius} ${radius * 2} ${radius * 2}`);
-        isolated.setAttribute('width', String(radius * 2));
-        isolated.setAttribute('height', String(radius * 2));
-        for (const shared of root.querySelectorAll('defs, style'))
-            isolated.appendChild(shared.cloneNode(true));
-        const drawing = group.cloneNode(true);
-        for (const descendant of drawing.querySelectorAll('g[id]'))
-            if (selected.has(descendant.id))
-                descendant.remove();
-        let wrapped = drawing;
-        for (let ancestor = group.parentElement; ancestor && ancestor !== root; ancestor = ancestor.parentElement) {
-            const wrapper = ancestor.cloneNode(false);
-            wrapper.appendChild(wrapped);
-            wrapped = wrapper;
-        }
-        const centered = document.createElementNS(root.namespaceURI, 'g');
-        centered.setAttribute('id', 'mwg-part');
-        centered.setAttribute('transform', `rotate(${-rotation}) translate(${-pivot.x} ${-pivot.y})`);
-        centered.appendChild(wrapped);
-        isolated.appendChild(centered);
-        sources.push({ bone: binding.bone, svg: serializer.serializeToString(isolated) });
-    }
-    const textures = Object.create(null);
-    // All authoring errors above fail before loading textures or allocating display objects.
-    for (const part of sources)
-        textures[part.bone] = (await loadSvgParts(part.svg, { resolution: options.resolution }))['mwg-part'];
-    const sprite = new SkeletalSprite(options.skeleton, options.mixer);
-    for (const part of sources) {
-        const member = sprite.bind(part.bone, textures[part.bone]);
-        member.anchor.set(0.5);
-        member.label = part.bone;
-    }
-    sprite.apply({});
-    return { sprite, textures: Object.freeze(textures) };
-}
-//# sourceMappingURL=SvgSkeleton.js.map

package/dist/two-d/render/SvgSkeleton.js.map

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

package/dist/two-d/render/TerrainGraphics.d.ts

@@ -1,142 +0,0 @@
-import { Generator } from '../../core/Random.ts';
-/**
- * One condition a rule tests against a neighbouring cell (or its own cell, at `dx=0, dy=0`):
- * which flags that cell must carry, must not carry, or carry at least one of. `dx`/`dy` are in
- * whatever unit the caller's grid uses - a square or isometric grid's own cell steps, or an
- * axial hex offset for `hexRotate` - `resolveTerrainGraphics` never interprets them itself.
- */
-export interface TerrainCondition {
-    readonly dx: number;
-    readonly dy: number;
-    readonly hasAll?: readonly string[];
-    readonly hasAny?: readonly string[];
-    readonly hasNone?: readonly string[];
-}
-/** One image a matched rule places, at an offset from the rule's own anchor cell. */
-export interface TerrainImage {
-    readonly image: string;
-    /** offset from the anchor cell, in the same pixel/cell unit the caller draws with */
-    readonly dx?: number;
-    readonly dy?: number;
-    /** draw order among a rule's own images and other rules matching the same cell; higher draws later (on top) */
-    readonly layer?: number;
-}
-/**
- * One `[terrain_graphics]`-style transition rule: a set of neighbour conditions that must all
- * hold, and the image or images to draw when they do. A rule with more conditions is more
- * specific and wins over a less specific one covering the same cell, the same precedence a
- * hand-authored rule set expects (a "this exact corner" rule beats a "any edge" rule); among
- * rules tied on specificity, `probability` weights which one is picked, so a terrain can vary
- * its look without every variant needing a different neighbourhood to key off of.
- */
-export interface TerrainRule {
-    readonly id: string;
-    readonly conditions: readonly TerrainCondition[];
-    readonly images: readonly TerrainImage[];
-    /** relative weight among rules tied for most-specific at a cell; default 1 */
-    readonly probability?: number;
-    /**
-     * how many rotated copies of this rule to also try, each one `conditions`/`images` rotated
-     * by one more step of `rotate` (see `squareRotate`/`hexRotate`) - so one rule authored for
-     * one direction covers every direction a symmetric transition needs, instead of one rule
-     * per direction written out by hand. 0 or omitted tries only the rule as written.
-     */
-    readonly rotations?: number;
-}
-/** One resolved image placement: an absolute cell plus the rule's own image and offset. */
-export interface TerrainPlacement {
-    readonly x: number;
-    readonly y: number;
-    readonly ruleId: string;
-    readonly image: string;
-    readonly dx: number;
-    readonly dy: number;
-    readonly layer: number;
-}
-/** The flags present at a cell, or `undefined` for a cell with no terrain at all (e.g. off the map). */
-export type TerrainFlagsAt = (x: number, y: number) => ReadonlySet<string> | undefined;
-/** Rotates one condition/image offset by `rotationIndex` of `rotations` total steps around the cell. */
-export type TerrainRotate = (dx: number, dy: number, rotationIndex: number, rotations: number) => {
-    dx: number;
-    dy: number;
-};
-/**
- * `TerrainRotate` for a square or isometric grid: exact 90-degree steps only (`rotations` must
- * be a multiple of 4, or 0).
- *
- * @example
- * ```ts
- * import { squareRotate } from '@datamoc/mw_games/two-d/render';
- *
- * console.log(squareRotate(1, 0, 1, 4)); // { dx: 0, dy: 1 } - one 90-degree step
- * ```
- */
-export declare function squareRotate(dx: number, dy: number, rotationIndex: number, rotations: number): {
-    dx: number;
-    dy: number;
-};
-/**
- * `TerrainRotate` for an axial hex grid: exact 60-degree steps (`rotations` must be a multiple
- * of 6, or 0), via the standard cube-coordinate rotation (`q,r,s -> -r,-s,-q` per 60-degree step,
- * `s = -q - r`).
- *
- * @example
- * ```ts
- * import { hexRotate } from '@datamoc/mw_games/two-d/render';
- *
- * console.log(hexRotate(1, 0, 1, 6)); // one 60-degree step of the axial offset (1, 0)
- * ```
- */
-export declare function hexRotate(dx: number, dy: number, rotationIndex: number, rotations: number): {
-    dx: number;
-    dy: number;
-};
-/**
- * Whether `rule`, rotated by `rotationIndex` of `rotations` steps, matches the cell at `x, y`.
- *
- * @example
- * ```ts
- * import { matchTerrainRule } from '@datamoc/mw_games/two-d/render';
- *
- * const rule = { id: 'coast', conditions: [{ dx: 1, dy: 0, hasAll: ['water'] }], images: [] };
- * const flagsAt = (x: number, y: number) => (x === 1 && y === 0 ? new Set(['water']) : new Set(['land']));
- * console.log(matchTerrainRule(rule, 0, 0, flagsAt)); // true
- * ```
- */
-export declare function matchTerrainRule(rule: TerrainRule, x: number, y: number, flagsAt: TerrainFlagsAt, rotate?: TerrainRotate, rotationIndex?: number): boolean;
-export interface ResolveTerrainGraphicsOptions {
-    rotate?: TerrainRotate;
-    /** deterministic when given a seeded `Generator`; a fresh unseeded one otherwise */
-    random?: Generator;
-}
-/**
- * Resolves a `[terrain_graphics]`-style rule set over a grid into the flat list of image
- * placements a renderer draws, the generalisation `Autotile`'s 47-shape blob table cannot
- * express: a rule can test flags rather than only "same terrain", key off any offset rather
- * than only the 8 immediate neighbours, place more than one image (so a piece bigger than one
- * cell, overlapping its neighbours, is one rule's `images` rather than something `TileMap`'s
- * one-sprite-per-cell grid has to hold), and vary by rotation or probability.
- *
- * At each cell, every rule (at every rotation it declares) is tested; among the rules that
- * match, the most specific (most conditions) wins, and `probability` breaks a tie among rules
- * of equal specificity. A cell with no matching rule contributes nothing. The result is plain
- * data - which cell, which rule, which image, at what offset and layer - a caller draws
- * through `TileMap`, a custom `Sprite` pass, or anything else; this function never touches a
- * renderer itself.
- *
- * @example
- * ```ts
- * import { resolveTerrainGraphics } from '@datamoc/mw_games/two-d/render';
- *
- * const water = new Set(['water']);
- * const land = new Set(['land']);
- * const flagsAt = (x: number, y: number) => (x === 0 ? water : land);
- *
- * const placements = resolveTerrainGraphics(2, 1, [
- * 	{ id: 'coast', conditions: [{ dx: 0, dy: 0, hasAll: ['land'] }, { dx: -1, dy: 0, hasAll: ['water'] }], images: [{ image: 'coast.png' }] },
- * ], flagsAt);
- * console.log(placements); // [{ x: 1, y: 0, ruleId: 'coast', image: 'coast.png', dx: 0, dy: 0, layer: 0 }]
- * ```
- */
-export declare function resolveTerrainGraphics(width: number, height: number, rules: readonly TerrainRule[], flagsAt: TerrainFlagsAt, options?: ResolveTerrainGraphicsOptions): TerrainPlacement[];
-//# sourceMappingURL=TerrainGraphics.d.ts.map

package/dist/two-d/render/TerrainGraphics.d.ts.map

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

package/dist/two-d/render/TerrainGraphics.js

@@ -1,161 +0,0 @@
-import { Generator } from '../../core/Random.js';
-/**
- * `TerrainRotate` for a square or isometric grid: exact 90-degree steps only (`rotations` must
- * be a multiple of 4, or 0).
- *
- * @example
- * ```ts
- * import { squareRotate } from '@datamoc/mw_games/two-d/render';
- *
- * console.log(squareRotate(1, 0, 1, 4)); // { dx: 0, dy: 1 } - one 90-degree step
- * ```
- */
-export function squareRotate(dx, dy, rotationIndex, rotations) {
-    const steps = (rotationIndex * 4) / rotations;
-    let x = dx;
-    let y = dy;
-    for (let i = 0; i < steps; i += 1)
-        [x, y] = [-y, x];
-    return { dx: x || 0, dy: y || 0 };
-}
-/**
- * `TerrainRotate` for an axial hex grid: exact 60-degree steps (`rotations` must be a multiple
- * of 6, or 0), via the standard cube-coordinate rotation (`q,r,s -> -r,-s,-q` per 60-degree step,
- * `s = -q - r`).
- *
- * @example
- * ```ts
- * import { hexRotate } from '@datamoc/mw_games/two-d/render';
- *
- * console.log(hexRotate(1, 0, 1, 6)); // one 60-degree step of the axial offset (1, 0)
- * ```
- */
-export function hexRotate(dx, dy, rotationIndex, rotations) {
-    const steps = (rotationIndex * 6) / rotations;
-    let q = dx;
-    let r = dy;
-    for (let i = 0; i < steps; i += 1) {
-        const s = -q - r;
-        [q, r] = [-r, -s];
-    }
-    return { dx: q || 0, dy: r || 0 };
-}
-function conditionMatches(condition, flags) {
-    const present = flags ?? new Set();
-    if (condition.hasAll && !condition.hasAll.every((flag) => present.has(flag)))
-        return false;
-    if (condition.hasAny && !condition.hasAny.some((flag) => present.has(flag)))
-        return false;
-    if (condition.hasNone && condition.hasNone.some((flag) => present.has(flag)))
-        return false;
-    return true;
-}
-/**
- * Whether `rule`, rotated by `rotationIndex` of `rotations` steps, matches the cell at `x, y`.
- *
- * @example
- * ```ts
- * import { matchTerrainRule } from '@datamoc/mw_games/two-d/render';
- *
- * const rule = { id: 'coast', conditions: [{ dx: 1, dy: 0, hasAll: ['water'] }], images: [] };
- * const flagsAt = (x: number, y: number) => (x === 1 && y === 0 ? new Set(['water']) : new Set(['land']));
- * console.log(matchTerrainRule(rule, 0, 0, flagsAt)); // true
- * ```
- */
-export function matchTerrainRule(rule, x, y, flagsAt, rotate = squareRotate, rotationIndex = 0) {
-    const rotations = rule.rotations ?? 0;
-    return rule.conditions.every((condition) => {
-        const offset = rotations > 0 ? rotate(condition.dx, condition.dy, rotationIndex, rotations) : condition;
-        return conditionMatches(condition, flagsAt(x + offset.dx, y + offset.dy));
-    });
-}
-/**
- * Resolves a `[terrain_graphics]`-style rule set over a grid into the flat list of image
- * placements a renderer draws, the generalisation `Autotile`'s 47-shape blob table cannot
- * express: a rule can test flags rather than only "same terrain", key off any offset rather
- * than only the 8 immediate neighbours, place more than one image (so a piece bigger than one
- * cell, overlapping its neighbours, is one rule's `images` rather than something `TileMap`'s
- * one-sprite-per-cell grid has to hold), and vary by rotation or probability.
- *
- * At each cell, every rule (at every rotation it declares) is tested; among the rules that
- * match, the most specific (most conditions) wins, and `probability` breaks a tie among rules
- * of equal specificity. A cell with no matching rule contributes nothing. The result is plain
- * data - which cell, which rule, which image, at what offset and layer - a caller draws
- * through `TileMap`, a custom `Sprite` pass, or anything else; this function never touches a
- * renderer itself.
- *
- * @example
- * ```ts
- * import { resolveTerrainGraphics } from '@datamoc/mw_games/two-d/render';
- *
- * const water = new Set(['water']);
- * const land = new Set(['land']);
- * const flagsAt = (x: number, y: number) => (x === 0 ? water : land);
- *
- * const placements = resolveTerrainGraphics(2, 1, [
- * 	{ id: 'coast', conditions: [{ dx: 0, dy: 0, hasAll: ['land'] }, { dx: -1, dy: 0, hasAll: ['water'] }], images: [{ image: 'coast.png' }] },
- * ], flagsAt);
- * console.log(placements); // [{ x: 1, y: 0, ruleId: 'coast', image: 'coast.png', dx: 0, dy: 0, layer: 0 }]
- * ```
- */
-export function resolveTerrainGraphics(width, height, rules, flagsAt, options = {}) {
-    const rotate = options.rotate ?? squareRotate;
-    const random = options.random ?? new Generator();
-    const placements = [];
-    for (let y = 0; y < height; y += 1) {
-        for (let x = 0; x < width; x += 1) {
-            let bestSpecificity = -1;
-            let candidates = [];
-            for (const rule of rules) {
-                const rotations = rule.rotations ?? 0;
-                const steps = rotations > 0 ? rotations : 1;
-                for (let rotationIndex = 0; rotationIndex < steps; rotationIndex += 1) {
-                    if (!matchTerrainRule(rule, x, y, flagsAt, rotate, rotationIndex))
-                        continue;
-                    const specificity = rule.conditions.length;
-                    if (specificity > bestSpecificity) {
-                        bestSpecificity = specificity;
-                        candidates = [{ rule, rotationIndex }];
-                    }
-                    else if (specificity === bestSpecificity) {
-                        candidates.push({ rule, rotationIndex });
-                    }
-                }
-            }
-            if (candidates.length === 0)
-                continue;
-            const chosen = candidates.length === 1
-                ? candidates[0]
-                : candidates[weightedIndex(candidates.map((c) => c.rule.probability ?? 1), random)];
-            const rotations = chosen.rule.rotations ?? 0;
-            for (const image of chosen.rule.images) {
-                const offset = rotations > 0
-                    ? rotate(image.dx ?? 0, image.dy ?? 0, chosen.rotationIndex, rotations)
-                    : { dx: image.dx ?? 0, dy: image.dy ?? 0 };
-                placements.push({
-                    x,
-                    y,
-                    ruleId: chosen.rule.id,
-                    image: image.image,
-                    dx: offset.dx,
-                    dy: offset.dy,
-                    layer: image.layer ?? 0,
-                });
-            }
-        }
-    }
-    return placements;
-}
-function weightedIndex(weights, random) {
-    const total = weights.reduce((sum, weight) => sum + Math.max(0, weight), 0);
-    if (total <= 0)
-        return 0;
-    let roll = random.float() * total;
-    for (let index = 0; index < weights.length; index += 1) {
-        roll -= Math.max(0, weights[index]);
-        if (roll < 0)
-            return index;
-    }
-    return weights.length - 1;
-}
-//# sourceMappingURL=TerrainGraphics.js.map

package/dist/two-d/render/TerrainGraphics.js.map

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

package/dist/two-d/render/TerrainGraphicsLayer.d.ts

@@ -1,55 +0,0 @@
-import { Node2D } from './Shape2D.ts';
-import type { Texture2D } from './Types2D.ts';
-import type { TerrainPlacement } from './TerrainGraphics.ts';
-export interface TerrainGraphicsLayerOptions {
-    /** the placements `resolveTerrainGraphics` produced, or any list of the same shape */
-    readonly placements: readonly TerrainPlacement[];
-    /**
-     * Where a placement lands, in pixels: its anchor cell (`x`, `y`) plus the rule image's own
-     * offset (`dx`, `dy`), both in the unit the rules were authored in. A square or isometric grid
-     * projects the sum of the two; a hex grid, whose offsets are axial, projects the cell and the
-     * offset separately - which is why the layer is handed the whole placement rather than only a
-     * cell, and why the projection belongs to the caller.
-     */
-    readonly project: (x: number, y: number, dx: number, dy: number) => {
-        x: number;
-        y: number;
-    };
-    /** how an image path becomes a texture; defaults to the asset resolver with a `Texture.EMPTY` fallback */
-    readonly resolveImage?: (path: string) => Texture2D;
-}
-/**
- * Draws the placements `resolveTerrainGraphics` resolves - the renderer half of `[terrain_graphics]`
- * that the rule pass deliberately leaves to a caller.
- *
- * It is one `Sprite2D` per placement, added in `layer` order (a stable sort, so placements sharing a
- * layer keep the order the rule pass emitted, which is its row-major walk). That is what makes a
- * rule's multi-cell art *one rule's images at their own offsets* rather than something `TileMap`'s
- * one-sprite-per-cell grid would have to hold, and what lets a rotated or probabilistic rule vary
- * how a transition looks without the layer knowing any of that.
- *
- * Z-order between this layer and the rest of a scene is the caller's, as it is for `Halo`: add the
- * layer before a unit to sit terrain under it, or after to overlay.
- *
- * @example
- * ```ts
- * import { TerrainGraphicsLayer, resolveTerrainGraphics } from '@datamoc/mw_games/two-d/render';
- *
- * const placements = resolveTerrainGraphics(2, 1, [], () => new Set(['land']));
- * const layer = new TerrainGraphicsLayer({
- * 	placements,
- * 	project: (x, y, dx, dy) => ({ x: (x + dx) * 32, y: (y + dy) * 32 }),
- * });
- * layer.setPlacements(placements);
- * ```
- */
-export declare class TerrainGraphicsLayer extends Node2D {
-    private placements;
-    private readonly project;
-    private readonly resolveImage;
-    constructor(options: TerrainGraphicsLayerOptions);
-    /** replaces the resolved placements and redraws them in layer order */
-    setPlacements(placements: readonly TerrainPlacement[]): void;
-    private rebuild;
-}
-//# sourceMappingURL=TerrainGraphicsLayer.d.ts.map

package/dist/two-d/render/TerrainGraphicsLayer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TerrainGraphicsLayer.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/TerrainGraphicsLayer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAY,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,MAAM,WAAW,2BAA2B;IAC3C,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAEjD;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE7F,0GAA0G;IAC1G,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;CACpD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,oBAAqB,SAAQ,MAAM;IAC/C,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAE3D,YAAY,OAAO,EAAE,2BAA2B,EAM/C;IAED,uEAAuE;IACvE,aAAa,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAG3D;IAED,OAAO,CAAC,OAAO;CAWf"}

package/dist/two-d/render/TerrainGraphicsLayer.js

@@ -1,54 +0,0 @@
-import { Texture } from 'pixi.js';
-import { Node2D, Sprite2D } from './Shape2D.js';
-import { texture } from '../../assets/loader.js';
-/**
- * Draws the placements `resolveTerrainGraphics` resolves - the renderer half of `[terrain_graphics]`
- * that the rule pass deliberately leaves to a caller.
- *
- * It is one `Sprite2D` per placement, added in `layer` order (a stable sort, so placements sharing a
- * layer keep the order the rule pass emitted, which is its row-major walk). That is what makes a
- * rule's multi-cell art *one rule's images at their own offsets* rather than something `TileMap`'s
- * one-sprite-per-cell grid would have to hold, and what lets a rotated or probabilistic rule vary
- * how a transition looks without the layer knowing any of that.
- *
- * Z-order between this layer and the rest of a scene is the caller's, as it is for `Halo`: add the
- * layer before a unit to sit terrain under it, or after to overlay.
- *
- * @example
- * ```ts
- * import { TerrainGraphicsLayer, resolveTerrainGraphics } from '@datamoc/mw_games/two-d/render';
- *
- * const placements = resolveTerrainGraphics(2, 1, [], () => new Set(['land']));
- * const layer = new TerrainGraphicsLayer({
- * 	placements,
- * 	project: (x, y, dx, dy) => ({ x: (x + dx) * 32, y: (y + dy) * 32 }),
- * });
- * layer.setPlacements(placements);
- * ```
- */
-export class TerrainGraphicsLayer extends Node2D {
-    constructor(options) {
-        super();
-        this.placements = options.placements;
-        this.project = options.project;
-        this.resolveImage = options.resolveImage ?? ((path) => texture(path, Texture.EMPTY));
-        this.rebuild();
-    }
-    /** replaces the resolved placements and redraws them in layer order */
-    setPlacements(placements) {
-        this.placements = placements;
-        this.rebuild();
-    }
-    rebuild() {
-        for (const child of this.removeChildren())
-            child.destroy();
-        for (const placement of [...this.placements].sort((a, b) => a.layer - b.layer)) {
-            const at = this.project(placement.x, placement.y, placement.dx, placement.dy);
-            const sprite = new Sprite2D(this.resolveImage(placement.image));
-            sprite.x = at.x;
-            sprite.y = at.y;
-            this.addChild(sprite);
-        }
-    }
-}
-//# sourceMappingURL=TerrainGraphicsLayer.js.map

package/dist/two-d/render/TerrainGraphicsLayer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TerrainGraphicsLayer.js","sourceRoot":"","sources":["../../../src/two-d/render/TerrainGraphicsLayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAmBjD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,oBAAqB,SAAQ,MAAM;IAK/C,YAAY,OAAoC;QAC/C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IAED,uEAAuE;IACvE,aAAa,CAAC,UAAuC;QACpD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IAEO,OAAO;QACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE;YAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAE3D,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAChF,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;YAC9E,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAChE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;CACD"}