@alife-sdk/core 0.1.0

package/dist/core/Vec2.js

@@ -0,0 +1,52 @@
+/** Frozen origin vector `{ x: 0, y: 0 }`. Safe to use as a default or sentinel. */
+export const ZERO = Object.freeze({ x: 0, y: 0 });
+/** Squared Euclidean distance. Prefer over distance() in hot loops to avoid sqrt. */
+export function distanceSq(a, b) {
+    const dx = a.x - b.x;
+    const dy = a.y - b.y;
+    return dx * dx + dy * dy;
+}
+/** Euclidean distance between two points. */
+export function distance(a, b) {
+    return Math.sqrt(distanceSq(a, b));
+}
+/** Linear interpolation. t = 0 returns `a`, t = 1 returns `b`. */
+export function lerp(a, b, t) {
+    return { x: a.x + (b.x - a.x) * t, y: a.y + (b.y - a.y) * t };
+}
+/** Component-wise subtraction (a − b). */
+export function subtract(a, b) {
+    return { x: a.x - b.x, y: a.y - b.y };
+}
+/** Length of the vector (distance from origin). */
+export function magnitude(v) {
+    return Math.sqrt(v.x * v.x + v.y * v.y);
+}
+/** Unit vector in the same direction. Returns ZERO for zero-length input. */
+export function normalize(v) {
+    const mag = magnitude(v);
+    if (mag === 0)
+        return ZERO;
+    return { x: v.x / mag, y: v.y / mag };
+}
+/** Component-wise addition. Returns a new Vec2. */
+export function add(a, b) {
+    return { x: a.x + b.x, y: a.y + b.y };
+}
+/** Scalar multiplication. Returns a new Vec2. */
+export function scale(v, s) {
+    return { x: v.x * s, y: v.y * s };
+}
+/** Dot product of two vectors. */
+export function dot(a, b) {
+    return a.x * b.x + a.y * b.y;
+}
+/**
+ * Angle of vector from +X axis in radians (-π, +π].
+ * Returns 0 for the zero vector.
+ * Replaces `Math.atan2(dy, dx)` pattern in state handlers.
+ */
+export function angle(v) {
+    return Math.atan2(v.y, v.x);
+}
+//# sourceMappingURL=Vec2.js.map

package/dist/core/Vec2.js.map

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

package/dist/core/math/CatmullRom.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Evaluate a Catmull-Rom spline at normalised parameter `t`.
+ *
+ * Pure replacement for `Phaser.Math.Interpolation.CatmullRom`.
+ * Uses identical cubic basis coefficients — numerically compatible.
+ *
+ * @param values  1-D control points (call separately for X and Y).
+ * @param t       Position along the spline, normalised to [0, 1].
+ * @returns       Interpolated value at `t`.
+ *
+ * @example
+ * ```ts
+ * const xs = waypoints.map(p => p.x);
+ * const ys = waypoints.map(p => p.y);
+ * const smoothX = catmullRom(xs, 0.5);
+ * const smoothY = catmullRom(ys, 0.5);
+ * ```
+ */
+export declare function catmullRom(values: readonly number[], t: number): number;
+//# sourceMappingURL=CatmullRom.d.ts.map

package/dist/core/math/CatmullRom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatmullRom.d.ts","sourceRoot":"","sources":["../../../src/core/math/CatmullRom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBvE"}

package/dist/core/math/CatmullRom.js

@@ -0,0 +1,37 @@
+/**
+ * Evaluate a Catmull-Rom spline at normalised parameter `t`.
+ *
+ * Pure replacement for `Phaser.Math.Interpolation.CatmullRom`.
+ * Uses identical cubic basis coefficients — numerically compatible.
+ *
+ * @param values  1-D control points (call separately for X and Y).
+ * @param t       Position along the spline, normalised to [0, 1].
+ * @returns       Interpolated value at `t`.
+ *
+ * @example
+ * ```ts
+ * const xs = waypoints.map(p => p.x);
+ * const ys = waypoints.map(p => p.y);
+ * const smoothX = catmullRom(xs, 0.5);
+ * const smoothY = catmullRom(ys, 0.5);
+ * ```
+ */
+export function catmullRom(values, t) {
+    const n = values.length;
+    if (n === 0)
+        return 0;
+    if (n === 1)
+        return values[0];
+    const last = n - 1;
+    const k = Math.floor(t >= 1 ? last - 1 : t * last);
+    const p0 = values[Math.max(0, k - 1)];
+    const p1 = values[k];
+    const p2 = values[Math.min(last, k + 1)];
+    const p3 = values[Math.min(last, k + 2)];
+    const u = t * last - k;
+    return 0.5 * ((2 * p1) +
+        (-p0 + p2) * u +
+        (2 * p0 - 5 * p1 + 4 * p2 - p3) * u * u +
+        (-p0 + 3 * p1 - 3 * p2 + p3) * u * u * u);
+}
+//# sourceMappingURL=CatmullRom.js.map

package/dist/core/math/CatmullRom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatmullRom.js","sourceRoot":"","sources":["../../../src/core/math/CatmullRom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CAAC,MAAyB,EAAE,CAAS;IAC7D,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAE9B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEnD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEzC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IAEvB,OAAO,GAAG,GAAG,CACX,CAAC,CAAC,GAAG,EAAE,CAAC;QACR,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;QACd,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CACzC,CAAC;AACJ,CAAC"}

package/dist/core/math/index.d.ts

@@ -0,0 +1,6 @@
+export type { Vec2 } from '../Vec2';
+export { distance, distanceSq, lerp, subtract, normalize, magnitude, ZERO, add, scale, dot, angle } from '../Vec2';
+export { catmullRom } from './CatmullRom';
+export { clamp, moveTowardZero } from './utils';
+export { segmentIntersectsRect, segmentIntersectsCircle } from './intersects';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/math/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/math/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACnH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/math/index.js

@@ -0,0 +1,5 @@
+export { distance, distanceSq, lerp, subtract, normalize, magnitude, ZERO, add, scale, dot, angle } from '../Vec2';
+export { catmullRom } from './CatmullRom';
+export { clamp, moveTowardZero } from './utils';
+export { segmentIntersectsRect, segmentIntersectsCircle } from './intersects';
+//# sourceMappingURL=index.js.map

package/dist/core/math/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/math/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACnH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/math/intersects.d.ts

@@ -0,0 +1,32 @@
+import type { Vec2 } from '../Vec2';
+/**
+ * Returns true if the segment from `p1` to `p2` intersects or touches the
+ * axis-aligned rectangle defined by its top-left corner `(rx, ry)` and size
+ * `(rw, rh)`.
+ *
+ * Uses the 2-D parametric slab method — O(1), no sqrt, no allocations.
+ *
+ * @example
+ * ```ts
+ * // Wall at (100, 200) sized 50×10
+ * segmentIntersectsRect({ x: 0, y: 205 }, { x: 200, y: 205 }, 100, 200, 50, 10); // true
+ * segmentIntersectsRect({ x: 0, y: 220 }, { x: 200, y: 220 }, 100, 200, 50, 10); // false
+ * ```
+ */
+export declare function segmentIntersectsRect(p1: Vec2, p2: Vec2, rx: number, ry: number, rw: number, rh: number): boolean;
+/**
+ * Returns true if the segment from `p1` to `p2` intersects or touches the
+ * circle at `center` with the given `radius`.
+ *
+ * Projects the center onto the segment (clamped to [0, 1]) and checks the
+ * squared distance — no sqrt needed for the intersection test.
+ *
+ * @example
+ * ```ts
+ * // Circular pillar at (150, 150) radius 30
+ * segmentIntersectsCircle({ x: 0, y: 150 }, { x: 300, y: 150 }, { x: 150, y: 150 }, 30); // true
+ * segmentIntersectsCircle({ x: 0, y: 190 }, { x: 300, y: 190 }, { x: 150, y: 150 }, 30); // false
+ * ```
+ */
+export declare function segmentIntersectsCircle(p1: Vec2, p2: Vec2, center: Vec2, radius: number): boolean;
+//# sourceMappingURL=intersects.d.ts.map

package/dist/core/math/intersects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intersects.d.ts","sourceRoot":"","sources":["../../../src/core/math/intersects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,IAAI,EACR,EAAE,EAAE,IAAI,EACR,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAmCT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,IAAI,EACR,EAAE,EAAE,IAAI,EACR,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAsBT"}

package/dist/core/math/intersects.js

@@ -0,0 +1,92 @@
+/**
+ * Returns true if the segment from `p1` to `p2` intersects or touches the
+ * axis-aligned rectangle defined by its top-left corner `(rx, ry)` and size
+ * `(rw, rh)`.
+ *
+ * Uses the 2-D parametric slab method — O(1), no sqrt, no allocations.
+ *
+ * @example
+ * ```ts
+ * // Wall at (100, 200) sized 50×10
+ * segmentIntersectsRect({ x: 0, y: 205 }, { x: 200, y: 205 }, 100, 200, 50, 10); // true
+ * segmentIntersectsRect({ x: 0, y: 220 }, { x: 200, y: 220 }, 100, 200, 50, 10); // false
+ * ```
+ */
+export function segmentIntersectsRect(p1, p2, rx, ry, rw, rh) {
+    const dx = p2.x - p1.x;
+    const dy = p2.y - p1.y;
+    let tmin = 0;
+    let tmax = 1;
+    // ── X slab ──────────────────────────────────────────────────────────────────
+    if (Math.abs(dx) < 1e-10) {
+        const xmin = rx < rx + rw ? rx : rx + rw;
+        const xmax = rx < rx + rw ? rx + rw : rx;
+        if (p1.x < xmin || p1.x > xmax)
+            return false;
+    }
+    else {
+        const inv = 1 / dx;
+        const t1 = (rx - p1.x) * inv;
+        const t2 = (rx + rw - p1.x) * inv;
+        tmin = Math.max(tmin, Math.min(t1, t2));
+        tmax = Math.min(tmax, Math.max(t1, t2));
+        if (tmin > tmax)
+            return false;
+    }
+    // ── Y slab ──────────────────────────────────────────────────────────────────
+    if (Math.abs(dy) < 1e-10) {
+        const ymin = ry < ry + rh ? ry : ry + rh;
+        const ymax = ry < ry + rh ? ry + rh : ry;
+        if (p1.y < ymin || p1.y > ymax)
+            return false;
+    }
+    else {
+        const inv = 1 / dy;
+        const t1 = (ry - p1.y) * inv;
+        const t2 = (ry + rh - p1.y) * inv;
+        tmin = Math.max(tmin, Math.min(t1, t2));
+        tmax = Math.min(tmax, Math.max(t1, t2));
+        if (tmin > tmax)
+            return false;
+    }
+    return true;
+}
+/**
+ * Returns true if the segment from `p1` to `p2` intersects or touches the
+ * circle at `center` with the given `radius`.
+ *
+ * Projects the center onto the segment (clamped to [0, 1]) and checks the
+ * squared distance — no sqrt needed for the intersection test.
+ *
+ * @example
+ * ```ts
+ * // Circular pillar at (150, 150) radius 30
+ * segmentIntersectsCircle({ x: 0, y: 150 }, { x: 300, y: 150 }, { x: 150, y: 150 }, 30); // true
+ * segmentIntersectsCircle({ x: 0, y: 190 }, { x: 300, y: 190 }, { x: 150, y: 150 }, 30); // false
+ * ```
+ */
+export function segmentIntersectsCircle(p1, p2, center, radius) {
+    if (radius <= 0)
+        return false;
+    const dx = p2.x - p1.x;
+    const dy = p2.y - p1.y;
+    const lenSq = dx * dx + dy * dy;
+    let t;
+    if (lenSq < 1e-10) {
+        // Degenerate segment — treat as a point
+        t = 0;
+    }
+    else {
+        t = ((center.x - p1.x) * dx + (center.y - p1.y) * dy) / lenSq;
+        if (t < 0)
+            t = 0;
+        else if (t > 1)
+            t = 1;
+    }
+    const closestX = p1.x + t * dx;
+    const closestY = p1.y + t * dy;
+    const ex = center.x - closestX;
+    const ey = center.y - closestY;
+    return ex * ex + ey * ey <= radius * radius;
+}
+//# sourceMappingURL=intersects.js.map

package/dist/core/math/intersects.js.map

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

package/dist/core/math/utils.d.ts

@@ -0,0 +1,5 @@
+/** Clamp value to [min, max] range. */
+export declare function clamp(value: number, min: number, max: number): number;
+/** Move value toward zero by `amount`. Never overshoots past zero. */
+export declare function moveTowardZero(value: number, amount: number): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/math/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/math/utils.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIpE"}

package/dist/core/math/utils.js

@@ -0,0 +1,13 @@
+/** Clamp value to [min, max] range. */
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+/** Move value toward zero by `amount`. Never overshoots past zero. */
+export function moveTowardZero(value, amount) {
+    if (value > 0)
+        return Math.max(0, value - amount);
+    if (value < 0)
+        return Math.min(0, value + amount);
+    return 0;
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/math/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/math/utils.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,MAAc;IAC1D,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;IAClD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/entity/IComponent.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Lifecycle contract for an entity component.
+ *
+ * Components encapsulate a single concern (health, movement, combat, AI)
+ * and are attached to entities by name.
+ */
+export interface IComponent {
+    /** Unique component identifier used in hasComponent() / getComponent(). */
+    readonly name: string;
+    /** Called once when the component is first attached to an entity. */
+    init(): void;
+    /** Called every frame. `delta` is seconds since the last frame. */
+    update(delta: number): void;
+    /** Called when the component or its owner entity is destroyed. Release resources here. */
+    destroy(): void;
+}
+//# sourceMappingURL=IComponent.d.ts.map

package/dist/entity/IComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IComponent.d.ts","sourceRoot":"","sources":["../../src/entity/IComponent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,IAAI,IAAI,IAAI,CAAC;IACb,mEAAmE;IACnE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0FAA0F;IAC1F,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/entity/IComponent.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IComponent.js.map

package/dist/entity/IComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IComponent.js","sourceRoot":"","sources":["../../src/entity/IComponent.ts"],"names":[],"mappings":""}

package/dist/entity/IEntity.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Minimal entity contract used by AI states, GOAP actions, and the state machine.
+ *
+ * This is the simulation's view of an entity — not the full game object.
+ * Host engines provide a richer object; the kernel only consumes this slice.
+ */
+export interface IEntity {
+    /** Globally unique identifier. */
+    readonly id: string;
+    /** Type discriminator (e.g. 'npc', 'monster', 'player'). */
+    readonly entityType: string;
+    /** True while the entity has not been killed or destroyed. */
+    readonly isAlive: boolean;
+    /** Arbitrary key-value store for cross-system data. */
+    readonly metadata?: ReadonlyMap<string, unknown>;
+    /** Current X world position (px). Mutable — updated by the simulation. */
+    x: number;
+    /** Current Y world position (px). Mutable — updated by the simulation. */
+    y: number;
+    /** Whether the entity participates in physics and AI updates. */
+    active: boolean;
+    /** Move the entity to a new world position. */
+    setPosition(x: number, y: number): void;
+    /** Enable/disable the entity. Returns `this` for chaining. */
+    setActive(value: boolean): this;
+    /** Show/hide the entity. Returns `this` for chaining. */
+    setVisible(value: boolean): this;
+    /** Check if a named component is attached. */
+    hasComponent(name: string): boolean;
+    /** Retrieve a component by name. Throws if not found. */
+    getComponent<T>(name: string): T;
+}
+//# sourceMappingURL=IEntity.d.ts.map

package/dist/entity/IEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntity.d.ts","sourceRoot":"","sources":["../../src/entity/IEntity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,0EAA0E;IAC1E,CAAC,EAAE,MAAM,CAAC;IACV,0EAA0E;IAC1E,CAAC,EAAE,MAAM,CAAC;IACV,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,8DAA8D;IAC9D,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,yDAAyD;IACzD,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,8CAA8C;IAC9C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,yDAAyD;IACzD,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;CAClC"}

package/dist/entity/IEntity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IEntity.js.map

package/dist/entity/IEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEntity.js","sourceRoot":"","sources":["../../src/entity/IEntity.ts"],"names":[],"mappings":""}

package/dist/entity/index.d.ts

@@ -0,0 +1,3 @@
+export type { IEntity } from './IEntity';
+export type { IComponent } from './IComponent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/entity/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/entity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entity/index.ts"],"names":[],"mappings":""}

package/dist/events/ALifeEvents.d.ts

@@ -0,0 +1,241 @@
+import type { Vec2 } from '../core/Vec2';
+export declare const ALifeEvents: {
+    readonly TICK: "alife:tick";
+    readonly NPC_MOVED: "alife:npc_moved";
+    readonly FACTION_CONFLICT: "alife:faction_conflict";
+    readonly NPC_ONLINE: "alife:npc_online";
+    readonly NPC_OFFLINE: "alife:npc_offline";
+    readonly TASK_ASSIGNED: "alife:task_assigned";
+    readonly NPC_DIED: "alife:npc_died";
+    readonly SPAWN_REQUESTED: "alife:spawn_requested";
+    readonly NPC_RELEASED: "alife:npc_released";
+    readonly TERRAIN_STATE_CHANGED: "alife:terrain_state_changed";
+    readonly MORALE_CHANGED: "alife:morale_changed";
+    readonly NPC_PANICKED: "ai:npc_panicked";
+    readonly SPOTTED_ENEMY: "ai:spotted_enemy";
+    readonly HEARD_SOUND: "ai:heard_sound";
+    readonly LOST_TARGET: "ai:lost_target";
+    readonly STATE_CHANGED: "ai:state_changed";
+    readonly NPC_SHOOT: "ai:npc_shoot";
+    readonly NPC_VOCALIZATION: "ai:npc_vocalization";
+    readonly NPC_ATTACKED: "ai:npc_attacked";
+    readonly SURGE_WARNING: "surge:warning";
+    readonly SURGE_STARTED: "surge:started";
+    readonly SURGE_ENDED: "surge:ended";
+    readonly SURGE_DAMAGE: "surge:damage";
+    readonly ANOMALY_DAMAGE: "anomaly:damage";
+    readonly ARTEFACT_SPAWNED: "anomaly:artefact_spawned";
+    readonly ARTEFACT_COLLECTED: "anomaly:artefact_collected";
+    readonly SQUAD_FORMED: "squad:formed";
+    readonly SQUAD_MEMBER_ADDED: "squad:member_added";
+    readonly SQUAD_MEMBER_REMOVED: "squad:member_removed";
+    readonly SQUAD_DISBANDED: "squad:disbanded";
+    readonly SQUAD_COMMAND_ISSUED: "squad:command_issued";
+    readonly SQUAD_GOAL_SET: "squad:goal_set";
+    readonly SQUAD_GOAL_CLEARED: "squad:goal_cleared";
+    readonly FACTION_RELATION_CHANGED: "faction:relation_changed";
+    readonly HOUR_CHANGED: "time:hour_changed";
+    readonly DAY_NIGHT_CHANGED: "time:day_night_changed";
+    readonly NPC_SOCIAL_BUBBLE: "social:npc_bubble";
+    readonly NPC_MEET_PLAYER: "social:npc_meet_player";
+    readonly KAMP_STATE_CHANGED: "social:kamp_state_changed";
+    readonly MONSTER_MELEE_HIT: "monster:melee_hit";
+    readonly PSI_ATTACK_START: "monster:psi_attack_start";
+};
+export type ALifeEvents = (typeof ALifeEvents)[keyof typeof ALifeEvents];
+export interface ALifeEventPayloads {
+    [ALifeEvents.TICK]: {
+        tick: number;
+        delta: number;
+    };
+    [ALifeEvents.NPC_MOVED]: {
+        npcId: string;
+        fromZone: string;
+        toZone: string;
+    };
+    [ALifeEvents.FACTION_CONFLICT]: {
+        factionA: string;
+        factionB: string;
+        zoneId: string;
+    };
+    [ALifeEvents.NPC_ONLINE]: {
+        npcId: string;
+        position: Vec2;
+    };
+    [ALifeEvents.NPC_OFFLINE]: {
+        npcId: string;
+        zoneId: string;
+    };
+    [ALifeEvents.TASK_ASSIGNED]: {
+        npcId: string;
+        terrainId: string;
+        taskType: string;
+    };
+    [ALifeEvents.NPC_DIED]: {
+        npcId: string;
+        killedBy: string;
+        zoneId: string;
+    };
+    [ALifeEvents.SPAWN_REQUESTED]: {
+        spawnPointId: string;
+        terrainId: string;
+        position: Vec2;
+        factionId: string;
+        enemyType: string;
+    };
+    [ALifeEvents.NPC_RELEASED]: {
+        npcId: string;
+        terrainId: string;
+    };
+    [ALifeEvents.TERRAIN_STATE_CHANGED]: {
+        terrainId: string;
+        oldState: number;
+        newState: number;
+    };
+    [ALifeEvents.MORALE_CHANGED]: {
+        npcId: string;
+        morale: number;
+        previousMorale: number;
+        moraleState: string;
+    };
+    [ALifeEvents.NPC_PANICKED]: {
+        npcId: string;
+        squadId: string | null;
+    };
+    [ALifeEvents.SPOTTED_ENEMY]: {
+        npcId: string;
+        enemyId: string;
+        position: Vec2;
+    };
+    [ALifeEvents.HEARD_SOUND]: {
+        npcId: string;
+        sourceId: string;
+        position: Vec2;
+    };
+    [ALifeEvents.LOST_TARGET]: {
+        npcId: string;
+        lastKnown: Vec2;
+    };
+    [ALifeEvents.STATE_CHANGED]: {
+        npcId: string;
+        oldState: string;
+        newState: string;
+    };
+    [ALifeEvents.NPC_SHOOT]: {
+        npcId: string;
+        from: Vec2;
+        target: Vec2;
+        damage: number;
+    };
+    [ALifeEvents.NPC_VOCALIZATION]: {
+        npcId: string;
+        soundType: string;
+        position: Vec2;
+        factionId: string;
+    };
+    [ALifeEvents.NPC_ATTACKED]: {
+        attackerId: string;
+        targetId: string;
+        damage: number;
+        attackerFaction: string;
+        targetFaction: string;
+    };
+    [ALifeEvents.SURGE_WARNING]: {
+        timeUntilSurge: number;
+    };
+    [ALifeEvents.SURGE_STARTED]: {
+        surgeNumber: number;
+    };
+    [ALifeEvents.SURGE_ENDED]: {
+        surgeNumber: number;
+    };
+    [ALifeEvents.SURGE_DAMAGE]: {
+        npcId: string;
+        damage: number;
+    };
+    [ALifeEvents.ANOMALY_DAMAGE]: {
+        entityId: string;
+        anomalyId: string;
+        damage: number;
+        damageType: string;
+    };
+    [ALifeEvents.ARTEFACT_SPAWNED]: {
+        artefactId: string;
+        anomalyId: string;
+        position: Vec2;
+    };
+    [ALifeEvents.ARTEFACT_COLLECTED]: {
+        artefactId: string;
+        collectorId: string;
+    };
+    [ALifeEvents.SQUAD_FORMED]: {
+        squadId: string;
+        factionId: string;
+        memberIds: string[];
+    };
+    [ALifeEvents.SQUAD_MEMBER_ADDED]: {
+        squadId: string;
+        npcId: string;
+    };
+    [ALifeEvents.SQUAD_MEMBER_REMOVED]: {
+        squadId: string;
+        npcId: string;
+    };
+    [ALifeEvents.SQUAD_DISBANDED]: {
+        squadId: string;
+    };
+    [ALifeEvents.SQUAD_COMMAND_ISSUED]: {
+        squadId: string;
+        command: string;
+    };
+    [ALifeEvents.SQUAD_GOAL_SET]: {
+        squadId: string;
+        goalType: string;
+        terrainId: string | null;
+        priority: number;
+    };
+    [ALifeEvents.SQUAD_GOAL_CLEARED]: {
+        squadId: string;
+        previousGoalType: string;
+    };
+    [ALifeEvents.FACTION_RELATION_CHANGED]: {
+        factionId: string;
+        targetFactionId: string;
+        oldRelation: number;
+        newRelation: number;
+    };
+    [ALifeEvents.HOUR_CHANGED]: {
+        hour: number;
+        day: number;
+        isDay: boolean;
+    };
+    [ALifeEvents.DAY_NIGHT_CHANGED]: {
+        isDay: boolean;
+    };
+    [ALifeEvents.NPC_SOCIAL_BUBBLE]: {
+        npcId: string;
+        text: string;
+        category: string;
+    };
+    [ALifeEvents.NPC_MEET_PLAYER]: {
+        npcId: string;
+        factionId: string;
+        greetingType: string;
+    };
+    [ALifeEvents.KAMP_STATE_CHANGED]: {
+        terrainId: string;
+        directorId: string | null;
+        state: string;
+    };
+    [ALifeEvents.MONSTER_MELEE_HIT]: {
+        attackerId: string;
+        position: Vec2;
+        damage: number;
+        range: number;
+    };
+    [ALifeEvents.PSI_ATTACK_START]: {
+        npcId: string;
+        position: Vec2;
+    };
+}
+//# sourceMappingURL=ALifeEvents.d.ts.map