@aura3d/engine 1.0.3 → 1.0.5

package/dist/physics/HitboxWorld.js

@@ -0,0 +1,640 @@
+import { aabbPenetration, guardbox, hitbox, hurtbox, overlapsVolume, pushbox, resolveCollisionVolume, withVolumeOwner } from "./CollisionVolumes.js";
+import { cloneVec3, validateFiniteVec3 } from "./Shape.js";
+export class HitboxWorld {
+    detectPushboxOverlaps;
+    combatantsById = new Map();
+    hitboxesById = new Map();
+    nextHitboxId = 1;
+    frame = 0;
+    lastEvents = [];
+    pendingEvents = [];
+    constructor(descriptor = {}) {
+        this.detectPushboxOverlaps = descriptor.detectPushboxOverlaps ?? true;
+    }
+    registerCombatant(descriptor) {
+        if (this.combatantsById.has(descriptor.id)) {
+            throw new Error(`Combatant ${String(descriptor.id)} already exists.`);
+        }
+        const combatant = createCombatantRecord(descriptor);
+        this.combatantsById.set(combatant.id, combatant);
+        return snapshotCombatant(combatant);
+    }
+    upsertCombatant(descriptor) {
+        const existing = this.combatantsById.get(descriptor.id);
+        if (!existing) {
+            return this.registerCombatant(descriptor);
+        }
+        applyCombatantDescriptor(existing, descriptor);
+        return snapshotCombatant(existing);
+    }
+    removeCombatant(id) {
+        this.combatantsById.delete(id);
+        for (const hitboxRecord of this.hitboxesById.values()) {
+            if (hitboxRecord.ownerId === id) {
+                hitboxRecord.expired = true;
+            }
+        }
+    }
+    getCombatant(id) {
+        const combatant = this.combatantsById.get(id);
+        return combatant ? snapshotCombatant(combatant) : undefined;
+    }
+    setPose(id, pose) {
+        const combatant = this.requireCombatant(id);
+        if (pose.position) {
+            validateFiniteVec3(pose.position, "combatant pose position");
+            combatant.position = cloneVec3(pose.position);
+        }
+        if (pose.facing) {
+            combatant.facing = pose.facing < 0 ? -1 : 1;
+        }
+    }
+    setGuarding(id, blocking) {
+        this.requireCombatant(id).blocking = blocking;
+    }
+    setHurtboxes(id, volumes) {
+        this.requireCombatant(id).hurtboxes = volumes.map((volume) => requireVolumeKind(volume, "hurtbox"));
+    }
+    setGuardBoxes(id, volumes) {
+        this.requireCombatant(id).guardBoxes = volumes.map((volume) => requireVolumeKind(volume, "guardbox"));
+    }
+    setPushbox(id, volume) {
+        this.requireCombatant(id).pushbox = volume === null ? null : requireVolumeKind(volume, "pushbox");
+    }
+    spawnHitbox(descriptor) {
+        const owner = this.requireCombatant(descriptor.ownerId);
+        const id = descriptor.id ?? `${String(descriptor.ownerId)}:${descriptor.moveId}:${this.nextHitboxId}`;
+        this.nextHitboxId += 1;
+        if (this.hitboxesById.has(id)) {
+            throw new Error(`Hitbox ${id} already exists.`);
+        }
+        const activeFrames = normalizeActiveFrames(descriptor.activeFrames ?? { start: 0, end: 2 });
+        const record = {
+            id,
+            ownerId: descriptor.ownerId,
+            team: descriptor.team ?? owner.team,
+            moveId: descriptor.moveId,
+            boxes: descriptor.boxes.map((volume) => requireVolumeKind(volume, "hitbox")),
+            activeFrames,
+            recoveryFrames: nonNegativeInteger(descriptor.recoveryFrames ?? 0, "hitbox recoveryFrames"),
+            damage: nonNegativeFinite(descriptor.damage ?? 10, "hitbox damage"),
+            guardDamage: nonNegativeFinite(descriptor.guardDamage ?? Math.ceil((descriptor.damage ?? 10) * 0.35), "hitbox guardDamage"),
+            hitstunFrames: nonNegativeInteger(descriptor.hitstunFrames ?? 14, "hitbox hitstunFrames"),
+            blockstunFrames: nonNegativeInteger(descriptor.blockstunFrames ?? 8, "hitbox blockstunFrames"),
+            hitStopFrames: nonNegativeInteger(descriptor.hitStopFrames ?? 6, "hitbox hitStopFrames"),
+            selfHitStopFrames: nonNegativeInteger(descriptor.selfHitStopFrames ?? descriptor.hitStopFrames ?? 6, "hitbox selfHitStopFrames"),
+            knockback: cloneVec3(descriptor.knockback ?? [2.4, 0.8, 0]),
+            blockKnockback: cloneVec3(descriptor.blockKnockback ?? [1.1, 0, 0]),
+            priority: finite(descriptor.priority ?? 0, "hitbox priority"),
+            canHitOwner: descriptor.canHitOwner ?? false,
+            canHitSameTeam: descriptor.canHitSameTeam ?? false,
+            hitOnce: descriptor.hitOnce ?? true,
+            maxHits: positiveInteger(descriptor.maxHits ?? Number.MAX_SAFE_INTEGER, "hitbox maxHits"),
+            metadata: descriptor.metadata,
+            ageFrames: 0,
+            hitCount: 0,
+            expired: false,
+            hitTargets: new Set(),
+            recoveryStarted: false
+        };
+        validateFiniteVec3(record.knockback, "hitbox knockback");
+        validateFiniteVec3(record.blockKnockback, "hitbox blockKnockback");
+        this.hitboxesById.set(record.id, record);
+        this.pendingEvents.push({
+            type: "hitbox-spawned",
+            frame: this.frame,
+            hitboxId: record.id,
+            ownerId: record.ownerId,
+            moveId: record.moveId,
+            activeFrames: record.activeFrames
+        });
+        return snapshotHitbox(record);
+    }
+    clearHitboxes(ownerId) {
+        for (const [id, record] of this.hitboxesById) {
+            if (ownerId === undefined || record.ownerId === ownerId) {
+                this.hitboxesById.delete(id);
+            }
+        }
+    }
+    step(frames = 1) {
+        const frameCount = positiveInteger(frames, "HitboxWorld.step frames");
+        const events = [];
+        events.push(...this.drainPendingEvents());
+        for (let index = 0; index < frameCount; index += 1) {
+            events.push(...this.stepOneFrame());
+        }
+        this.lastEvents = events;
+        return events;
+    }
+    drainEvents() {
+        const events = [...this.pendingEvents, ...this.lastEvents];
+        this.pendingEvents.length = 0;
+        this.lastEvents = [];
+        return events;
+    }
+    snapshot() {
+        return {
+            frame: this.frame,
+            combatants: this.combatants(),
+            hitboxes: this.hitboxes(),
+            events: this.lastEvents.map(cloneCombatEvent)
+        };
+    }
+    combatants() {
+        return Array.from(this.combatantsById.values()).sort(compareCombatants).map(snapshotCombatant);
+    }
+    hitboxes() {
+        return Array.from(this.hitboxesById.values()).sort(compareHitboxes).map(snapshotHitbox);
+    }
+    stepOneFrame() {
+        const events = [];
+        if (this.detectPushboxOverlaps) {
+            events.push(...this.collectPushboxEvents());
+        }
+        for (const record of this.sortedHitboxRecords()) {
+            if (record.expired || record.hitCount >= record.maxHits) {
+                record.expired = true;
+                continue;
+            }
+            const owner = this.combatantsById.get(record.ownerId);
+            if (!owner) {
+                record.expired = true;
+                continue;
+            }
+            if (isHitboxActive(record)) {
+                events.push(...this.resolveHitbox(record, owner));
+            }
+            if (!record.recoveryStarted && record.ageFrames > record.activeFrames.end && record.recoveryFrames > 0) {
+                record.recoveryStarted = true;
+                owner.recoveryFrames = Math.max(owner.recoveryFrames, record.recoveryFrames);
+                events.push({
+                    type: "recovery-start",
+                    frame: this.frame,
+                    combatantId: owner.id,
+                    frames: record.recoveryFrames
+                });
+            }
+        }
+        events.push(...this.tickTimers());
+        for (const record of this.sortedHitboxRecords()) {
+            const owner = this.combatantsById.get(record.ownerId);
+            if (owner && owner.hitStopFrames <= 0) {
+                record.ageFrames += 1;
+            }
+            if (record.ageFrames > record.activeFrames.end + record.recoveryFrames || record.hitCount >= record.maxHits || record.expired) {
+                this.expireHitbox(record, events);
+            }
+        }
+        this.frame += 1;
+        return events;
+    }
+    resolveHitbox(record, owner) {
+        const events = [];
+        const hitVolumes = record.boxes.map((volume) => resolveCollisionVolume(withVolumeOwner(volume, owner.id), owner.position, owner.facing));
+        for (const defender of this.sortedCombatantRecords()) {
+            if (!canHitCombatant(record, owner, defender)) {
+                continue;
+            }
+            if (defender.invulnerableFrames > 0) {
+                continue;
+            }
+            if (record.hitOnce && record.hitTargets.has(defender.id)) {
+                continue;
+            }
+            const blockEvent = defender.blocking ? this.tryResolveBlock(record, owner, defender, hitVolumes) : null;
+            if (blockEvent) {
+                record.hitTargets.add(defender.id);
+                record.hitCount += 1;
+                events.push(blockEvent);
+                events.push(...this.applyBlockTimers(record, owner, defender));
+                continue;
+            }
+            const hitEvent = this.tryResolveHit(record, owner, defender, hitVolumes);
+            if (hitEvent) {
+                record.hitTargets.add(defender.id);
+                record.hitCount += 1;
+                events.push(hitEvent);
+                events.push(...this.applyHitTimers(record, owner, defender));
+            }
+        }
+        return events;
+    }
+    tryResolveBlock(record, owner, defender, hitVolumes) {
+        const guardVolumes = (defender.guardBoxes.length > 0 ? defender.guardBoxes : defender.hurtboxes).map((volume) => resolveCollisionVolume(withVolumeOwner(volume, defender.id), defender.position, defender.facing));
+        const pair = firstOverlappingPair(hitVolumes, guardVolumes);
+        if (!pair) {
+            return null;
+        }
+        defender.guard = Math.max(0, defender.guard - record.guardDamage);
+        return {
+            type: "blocked",
+            frame: this.frame,
+            attackerId: owner.id,
+            defenderId: defender.id,
+            hitboxId: record.id,
+            moveId: record.moveId,
+            hitboxVolumeId: pair.attack.id,
+            guardboxId: pair.defense.id,
+            guardDamage: record.guardDamage,
+            defenderGuard: defender.guard,
+            blockstunFrames: record.blockstunFrames,
+            hitStopFrames: record.hitStopFrames,
+            knockback: orientVec3(record.blockKnockback, owner.facing),
+            point: contactPoint(pair.attack, pair.defense),
+            normal: combatNormal(owner, defender)
+        };
+    }
+    tryResolveHit(record, owner, defender, hitVolumes) {
+        const hurtVolumes = defender.hurtboxes.map((volume) => resolveCollisionVolume(withVolumeOwner(volume, defender.id), defender.position, defender.facing));
+        const pair = firstOverlappingPair(hitVolumes, hurtVolumes);
+        if (!pair) {
+            return null;
+        }
+        defender.health = Math.max(0, defender.health - record.damage);
+        return {
+            type: "hit",
+            frame: this.frame,
+            attackerId: owner.id,
+            defenderId: defender.id,
+            hitboxId: record.id,
+            moveId: record.moveId,
+            hitboxVolumeId: pair.attack.id,
+            hurtboxId: pair.defense.id,
+            damage: record.damage,
+            defenderHealth: defender.health,
+            hitstunFrames: record.hitstunFrames,
+            hitStopFrames: record.hitStopFrames,
+            knockback: orientVec3(record.knockback, owner.facing),
+            point: contactPoint(pair.attack, pair.defense),
+            normal: combatNormal(owner, defender)
+        };
+    }
+    applyHitTimers(record, owner, defender) {
+        const events = [];
+        events.push(...setTimer(defender, "hitstunFrames", record.hitstunFrames, "hitstun-start", this.frame));
+        events.push(...setTimer(defender, "hitStopFrames", record.hitStopFrames, "hitstop-start", this.frame));
+        events.push(...setTimer(owner, "hitStopFrames", record.selfHitStopFrames, "hitstop-start", this.frame));
+        return events;
+    }
+    applyBlockTimers(record, owner, defender) {
+        const events = [];
+        events.push(...setTimer(defender, "blockstunFrames", record.blockstunFrames, "blockstun-start", this.frame));
+        events.push(...setTimer(defender, "hitStopFrames", record.hitStopFrames, "hitstop-start", this.frame));
+        events.push(...setTimer(owner, "hitStopFrames", record.selfHitStopFrames, "hitstop-start", this.frame));
+        return events;
+    }
+    tickTimers() {
+        const events = [];
+        for (const combatant of this.sortedCombatantRecords()) {
+            events.push(...tickTimer(combatant, "hitStopFrames", "hitstop-end", this.frame));
+            events.push(...tickTimer(combatant, "hitstunFrames", "hitstun-end", this.frame));
+            events.push(...tickTimer(combatant, "blockstunFrames", "blockstun-end", this.frame));
+            events.push(...tickTimer(combatant, "recoveryFrames", "recovery-end", this.frame));
+            if (combatant.invulnerableFrames > 0) {
+                combatant.invulnerableFrames -= 1;
+            }
+        }
+        return events;
+    }
+    collectPushboxEvents() {
+        const events = [];
+        const combatants = this.sortedCombatantRecords().filter((combatant) => combatant.pushbox !== null);
+        for (let aIndex = 0; aIndex < combatants.length; aIndex += 1) {
+            for (let bIndex = aIndex + 1; bIndex < combatants.length; bIndex += 1) {
+                const combatantA = combatants[aIndex];
+                const combatantB = combatants[bIndex];
+                const pushA = resolveCollisionVolume(withVolumeOwner(combatantA.pushbox, combatantA.id), combatantA.position, combatantA.facing);
+                const pushB = resolveCollisionVolume(withVolumeOwner(combatantB.pushbox, combatantB.id), combatantB.position, combatantB.facing);
+                if (!overlapsVolume(pushA, pushB)) {
+                    continue;
+                }
+                const penetration = aabbPenetration(pushA.bounds, pushB.bounds);
+                if (!penetration) {
+                    continue;
+                }
+                events.push({
+                    type: "pushbox-overlap",
+                    frame: this.frame,
+                    combatantA: combatantA.id,
+                    combatantB: combatantB.id,
+                    normal: penetration.normal,
+                    penetration: penetration.depth
+                });
+            }
+        }
+        return events;
+    }
+    expireHitbox(record, events) {
+        if (!this.hitboxesById.has(record.id)) {
+            return;
+        }
+        if (record.hitCount === 0) {
+            events.push({
+                type: "whiff",
+                frame: this.frame,
+                hitboxId: record.id,
+                ownerId: record.ownerId,
+                moveId: record.moveId
+            });
+        }
+        events.push({
+            type: "hitbox-expired",
+            frame: this.frame,
+            hitboxId: record.id,
+            ownerId: record.ownerId,
+            moveId: record.moveId,
+            hitCount: record.hitCount
+        });
+        this.hitboxesById.delete(record.id);
+    }
+    requireCombatant(id) {
+        const combatant = this.combatantsById.get(id);
+        if (!combatant) {
+            throw new Error(`Combatant ${String(id)} does not exist.`);
+        }
+        return combatant;
+    }
+    sortedCombatantRecords() {
+        return Array.from(this.combatantsById.values()).sort(compareCombatants);
+    }
+    sortedHitboxRecords() {
+        return Array.from(this.hitboxesById.values()).sort(compareHitboxes);
+    }
+    drainPendingEvents() {
+        const events = [...this.pendingEvents];
+        this.pendingEvents.length = 0;
+        return events;
+    }
+}
+function createCombatantRecord(descriptor) {
+    const maxHealth = positiveFinite(descriptor.maxHealth ?? descriptor.health ?? 100, "combatant maxHealth");
+    const maxGuard = positiveFinite(descriptor.maxGuard ?? descriptor.guard ?? 100, "combatant maxGuard");
+    const position = cloneVec3(descriptor.position ?? [0, 0.9, 0]);
+    validateFiniteVec3(position, "combatant position");
+    return {
+        id: descriptor.id,
+        team: descriptor.team,
+        position,
+        facing: descriptor.facing && descriptor.facing < 0 ? -1 : 1,
+        hurtboxes: (descriptor.hurtboxes ?? [hurtbox({ id: "body", halfExtents: [0.36, 0.86, 0.28] })]).map((volume) => requireVolumeKind(volume, "hurtbox")),
+        guardBoxes: (descriptor.guardBoxes ?? [guardbox({ id: "guard", offset: [0.18, 0, 0], halfExtents: [0.28, 0.82, 0.3] })]).map((volume) => requireVolumeKind(volume, "guardbox")),
+        pushbox: descriptor.pushbox === null ? null : requireVolumeKind(descriptor.pushbox ?? pushbox({ id: "push", halfExtents: [0.32, 0.84, 0.26] }), "pushbox"),
+        health: clampNonNegative(descriptor.health ?? maxHealth, maxHealth),
+        maxHealth,
+        guard: clampNonNegative(descriptor.guard ?? maxGuard, maxGuard),
+        maxGuard,
+        meter: nonNegativeFinite(descriptor.meter ?? 0, "combatant meter"),
+        blocking: descriptor.blocking ?? false,
+        invulnerableFrames: nonNegativeInteger(descriptor.invulnerableFrames ?? 0, "combatant invulnerableFrames"),
+        hitStopFrames: 0,
+        hitstunFrames: 0,
+        blockstunFrames: 0,
+        recoveryFrames: 0,
+        metadata: descriptor.metadata
+    };
+}
+function applyCombatantDescriptor(record, descriptor) {
+    if (descriptor.team !== undefined) {
+        record.team = descriptor.team;
+    }
+    if (descriptor.position) {
+        validateFiniteVec3(descriptor.position, "combatant position");
+        record.position = cloneVec3(descriptor.position);
+    }
+    if (descriptor.facing) {
+        record.facing = descriptor.facing < 0 ? -1 : 1;
+    }
+    if (descriptor.hurtboxes) {
+        record.hurtboxes = descriptor.hurtboxes.map((volume) => requireVolumeKind(volume, "hurtbox"));
+    }
+    if (descriptor.guardBoxes) {
+        record.guardBoxes = descriptor.guardBoxes.map((volume) => requireVolumeKind(volume, "guardbox"));
+    }
+    if (descriptor.pushbox !== undefined) {
+        record.pushbox = descriptor.pushbox === null ? null : requireVolumeKind(descriptor.pushbox, "pushbox");
+    }
+    if (descriptor.maxHealth !== undefined) {
+        record.maxHealth = positiveFinite(descriptor.maxHealth, "combatant maxHealth");
+    }
+    if (descriptor.health !== undefined) {
+        record.health = clampNonNegative(descriptor.health, record.maxHealth);
+    }
+    if (descriptor.maxGuard !== undefined) {
+        record.maxGuard = positiveFinite(descriptor.maxGuard, "combatant maxGuard");
+    }
+    if (descriptor.guard !== undefined) {
+        record.guard = clampNonNegative(descriptor.guard, record.maxGuard);
+    }
+    if (descriptor.meter !== undefined) {
+        record.meter = nonNegativeFinite(descriptor.meter, "combatant meter");
+    }
+    if (descriptor.blocking !== undefined) {
+        record.blocking = descriptor.blocking;
+    }
+    if (descriptor.invulnerableFrames !== undefined) {
+        record.invulnerableFrames = nonNegativeInteger(descriptor.invulnerableFrames, "combatant invulnerableFrames");
+    }
+    if (descriptor.metadata !== undefined) {
+        record.metadata = descriptor.metadata;
+    }
+}
+function canHitCombatant(record, owner, defender) {
+    if (owner.id === defender.id && !record.canHitOwner) {
+        return false;
+    }
+    if (!record.canHitSameTeam && record.team !== undefined && defender.team !== undefined && record.team === defender.team) {
+        return false;
+    }
+    return true;
+}
+function firstOverlappingPair(attackVolumes, defenseVolumes) {
+    const attacks = [...attackVolumes].sort(compareResolvedVolumes);
+    const defenses = [...defenseVolumes].sort(compareResolvedVolumes);
+    for (const attack of attacks) {
+        for (const defense of defenses) {
+            if (overlapsVolume(attack, defense)) {
+                return { attack, defense };
+            }
+        }
+    }
+    return null;
+}
+function setTimer(combatant, key, frames, eventType, frame) {
+    if (frames <= 0 || combatant[key] >= frames) {
+        return [];
+    }
+    combatant[key] = frames;
+    return [
+        {
+            type: eventType,
+            frame,
+            combatantId: combatant.id,
+            frames
+        }
+    ];
+}
+function tickTimer(combatant, key, eventType, frame) {
+    if (combatant[key] <= 0) {
+        return [];
+    }
+    combatant[key] -= 1;
+    if (combatant[key] > 0) {
+        return [];
+    }
+    return [
+        {
+            type: eventType,
+            frame,
+            combatantId: combatant.id
+        }
+    ];
+}
+function isHitboxActive(record) {
+    return record.ageFrames >= record.activeFrames.start && record.ageFrames <= record.activeFrames.end;
+}
+function normalizeActiveFrames(value) {
+    const start = nonNegativeInteger(value.start, "hitbox activeFrames.start");
+    const end = nonNegativeInteger(value.end, "hitbox activeFrames.end");
+    if (end < start) {
+        throw new Error("hitbox activeFrames.end must be greater than or equal to activeFrames.start.");
+    }
+    return { start, end };
+}
+function requireVolumeKind(volume, kind) {
+    if (volume.kind !== kind) {
+        throw new Error(`Expected ${kind} volume but received ${volume.kind}.`);
+    }
+    return volume;
+}
+function contactPoint(attack, defense) {
+    return [
+        (Math.max(attack.bounds.min[0], defense.bounds.min[0]) + Math.min(attack.bounds.max[0], defense.bounds.max[0])) * 0.5,
+        (Math.max(attack.bounds.min[1], defense.bounds.min[1]) + Math.min(attack.bounds.max[1], defense.bounds.max[1])) * 0.5,
+        (Math.max(attack.bounds.min[2], defense.bounds.min[2]) + Math.min(attack.bounds.max[2], defense.bounds.max[2])) * 0.5
+    ];
+}
+function combatNormal(owner, defender) {
+    if (owner.position[0] === defender.position[0]) {
+        return [owner.facing, 0, 0];
+    }
+    return [owner.position[0] < defender.position[0] ? 1 : -1, 0, 0];
+}
+function orientVec3(value, facing) {
+    return [value[0] * facing, value[1], value[2]];
+}
+function snapshotCombatant(record) {
+    return {
+        id: record.id,
+        ...(record.team === undefined ? {} : { team: record.team }),
+        position: cloneVec3(record.position),
+        facing: record.facing,
+        health: record.health,
+        maxHealth: record.maxHealth,
+        guard: record.guard,
+        maxGuard: record.maxGuard,
+        meter: record.meter,
+        blocking: record.blocking,
+        invulnerableFrames: record.invulnerableFrames,
+        hitStopFrames: record.hitStopFrames,
+        hitstunFrames: record.hitstunFrames,
+        blockstunFrames: record.blockstunFrames,
+        recoveryFrames: record.recoveryFrames
+    };
+}
+function snapshotHitbox(record) {
+    return {
+        id: record.id,
+        ownerId: record.ownerId,
+        moveId: record.moveId,
+        ageFrames: record.ageFrames,
+        activeFrames: record.activeFrames,
+        recoveryFrames: record.recoveryFrames,
+        hitCount: record.hitCount,
+        expired: record.expired
+    };
+}
+function cloneCombatEvent(event) {
+    switch (event.type) {
+        case "hit":
+            return {
+                ...event,
+                knockback: cloneVec3(event.knockback),
+                point: cloneVec3(event.point),
+                normal: cloneVec3(event.normal)
+            };
+        case "blocked":
+            return {
+                ...event,
+                knockback: cloneVec3(event.knockback),
+                point: cloneVec3(event.point),
+                normal: cloneVec3(event.normal)
+            };
+        case "pushbox-overlap":
+            return {
+                ...event,
+                normal: cloneVec3(event.normal)
+            };
+        default:
+            return { ...event };
+    }
+}
+function compareCombatants(a, b) {
+    return compareIds(a.id, b.id);
+}
+function compareHitboxes(a, b) {
+    if (a.priority !== b.priority) {
+        return b.priority - a.priority;
+    }
+    return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+}
+function compareResolvedVolumes(a, b) {
+    const left = `${a.kind}:${a.id}`;
+    const right = `${b.kind}:${b.id}`;
+    if (left === right) {
+        return 0;
+    }
+    return left < right ? -1 : 1;
+}
+function compareIds(a, b) {
+    const left = String(a);
+    const right = String(b);
+    if (left === right) {
+        return 0;
+    }
+    return left < right ? -1 : 1;
+}
+function finite(value, name) {
+    if (!Number.isFinite(value)) {
+        throw new Error(`${name} must be finite.`);
+    }
+    return value;
+}
+function nonNegativeFinite(value, name) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`${name} must be finite and non-negative.`);
+    }
+    return value;
+}
+function positiveFinite(value, name) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`${name} must be finite and positive.`);
+    }
+    return value;
+}
+function nonNegativeInteger(value, name) {
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`${name} must be a non-negative integer.`);
+    }
+    return value;
+}
+function positiveInteger(value, name) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${name} must be a positive integer.`);
+    }
+    return value;
+}
+function clampNonNegative(value, max) {
+    return Math.max(0, Math.min(max, nonNegativeFinite(value, "combatant value")));
+}
+//# sourceMappingURL=HitboxWorld.js.map