@alife-sdk/core 0.1.0

package/dist/terrain/SmartTerrain.js

@@ -0,0 +1,124 @@
+/**
+ * SmartTerrain -- a Zone with job slots, capacity, and NPC fitness scoring.
+ *
+ * NPCs evaluate available terrains and select the one with the highest
+ * fitness score. The terrain tracks its occupants and enforces capacity.
+ */
+import { distance, distanceSq } from '../core/Vec2';
+import { DefaultRandom } from '../ports/IRandom';
+import { Zone } from './Zone';
+// ---------------------------------------------------------------------------
+// Scoring constants
+// ---------------------------------------------------------------------------
+const DEFAULT_DISTANCE_PENALTY_DIVISOR = 100;
+const DEFAULT_SHELTER_BONUS = 50;
+const DEFAULT_RANK_MATCH_BONUS = 10;
+const DEFAULT_SCORING_JITTER = 0;
+// ---------------------------------------------------------------------------
+// SmartTerrain
+// ---------------------------------------------------------------------------
+export class SmartTerrain extends Zone {
+    constructor(config) {
+        super(config.id, config.bounds, config.dangerLevel);
+        this.occupants = new Set();
+        this.capacity = config.capacity;
+        this.allowedFactions = new Set(config.allowedFactions ?? []);
+        this.isShelter = config.isShelter ?? false;
+        this.tags = new Set(config.tags ?? []);
+        this.jobs = config.jobs ?? [];
+        this.spawnPoints = config.spawnPoints ?? [];
+        this.patrolRoutes = buildRouteMap(config.patrolRoutes);
+        this.distancePenaltyDivisor = config.scoring?.distancePenaltyDivisor ?? DEFAULT_DISTANCE_PENALTY_DIVISOR;
+        this.useSquaredDistance = config.scoring?.useSquaredDistance ?? false;
+        this.distancePenaltySqDivisor = config.scoring?.distancePenaltySqDivisor
+            ?? (this.distancePenaltyDivisor * this.distancePenaltyDivisor);
+        this.shelterBonus = config.scoring?.shelterBonus ?? DEFAULT_SHELTER_BONUS;
+        this.rankMatchBonus = config.scoring?.rankMatchBonus ?? DEFAULT_RANK_MATCH_BONUS;
+        this.scoringJitter = config.scoring?.scoringJitter ?? DEFAULT_SCORING_JITTER;
+        this.random = config.random ?? new DefaultRandom();
+    }
+    /** Number of NPCs currently assigned to this terrain. */
+    get occupantCount() {
+        return this.occupants.size;
+    }
+    /** Whether the terrain can accept another NPC. */
+    get hasCapacity() {
+        return this.occupants.size < this.capacity;
+    }
+    /**
+     * Register an NPC as an occupant.
+     * Returns false if the terrain is already at capacity.
+     */
+    addOccupant(npcId) {
+        if (this.occupants.size >= this.capacity)
+            return false;
+        this.occupants.add(npcId);
+        return true;
+    }
+    /** Remove an NPC from the occupant set. */
+    removeOccupant(npcId) {
+        this.occupants.delete(npcId);
+    }
+    /** Check whether a given NPC is an occupant. */
+    hasOccupant(npcId) {
+        return this.occupants.has(npcId);
+    }
+    /** Read-only view of the current occupant set. */
+    getOccupants() {
+        return this.occupants;
+    }
+    /**
+     * Compute a fitness score for an NPC considering faction, distance,
+     * capacity, shelter status, and danger-to-rank matching.
+     *
+     * Scoring breakdown:
+     *   - Base = remaining capacity (capacity - occupantCount)
+     *   - Faction not allowed: -Infinity
+     *   - Distance penalty: -distance / 100
+     *   - Shelter bonus: +50 if isShelter
+     *   - Rank >= dangerLevel: +10
+     */
+    scoreFitness(npcFaction, npcPosition, npcRank) {
+        if (!this.acceptsFaction(npcFaction))
+            return -Infinity;
+        let score = this.capacity - this.occupants.size;
+        if (this.useSquaredDistance) {
+            score -= distanceSq(npcPosition, this.center) / this.distancePenaltySqDivisor;
+        }
+        else {
+            score -= distance(npcPosition, this.center) / this.distancePenaltyDivisor;
+        }
+        if (this.isShelter) {
+            score += this.shelterBonus;
+        }
+        if (npcRank >= this.dangerLevel) {
+            score += this.rankMatchBonus;
+        }
+        if (this.scoringJitter > 0) {
+            score += (this.random.next() - 0.5) * 2 * this.scoringJitter;
+        }
+        return score;
+    }
+    /**
+     * Check whether a faction is allowed in this terrain.
+     * An empty allowedFactions set means all factions are accepted.
+     */
+    acceptsFaction(factionId) {
+        if (this.allowedFactions.size === 0)
+            return true;
+        return this.allowedFactions.has(factionId);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function buildRouteMap(routes) {
+    const map = new Map();
+    if (routes) {
+        for (const route of routes) {
+            map.set(route.id, route);
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=SmartTerrain.js.map

package/dist/terrain/SmartTerrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartTerrain.js","sourceRoot":"","sources":["../../src/terrain/SmartTerrain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAoB,MAAM,QAAQ,CAAC;AA2EhD,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,gCAAgC,GAAG,GAAG,CAAC;AAC7C,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AACpC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,OAAO,YAAa,SAAQ,IAAI;IAkBpC,YAAY,MAA2B;QACrC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAHrC,cAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAK7C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC,OAAO,EAAE,sBAAsB,IAAI,gCAAgC,CAAC;QACzG,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,OAAO,EAAE,kBAAkB,IAAI,KAAK,CAAC;QACtE,IAAI,CAAC,wBAAwB,GAAG,MAAM,CAAC,OAAO,EAAE,wBAAwB;eACnE,CAAC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACjE,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,EAAE,YAAY,IAAI,qBAAqB,CAAC;QAC1E,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,OAAO,EAAE,cAAc,IAAI,wBAAwB,CAAC;QACjF,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,OAAO,EAAE,aAAa,IAAI,sBAAsB,CAAC;QAC7E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;IACrD,CAAC;IAED,yDAAyD;IACzD,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED,kDAAkD;IAClD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,KAAa;QACvB,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QACvD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2CAA2C;IAC3C,cAAc,CAAC,KAAa;QAC1B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,gDAAgD;IAChD,WAAW,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,kDAAkD;IAClD,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;;;;;;OAUG;IACH,YAAY,CACV,UAAkB,EAClB,WAAiB,EACjB,OAAe;QAEf,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC;YAAE,OAAO,CAAC,QAAQ,CAAC;QAEvD,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAEhD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,KAAK,IAAI,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,wBAAwB,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,sBAAsB,CAAC;QAC5E,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAC7B,CAAC;QAED,IAAI,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAChC,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC;QAC/B,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;QAC/D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,SAAiB;QAC9B,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,aAAa,CACpB,MAAsC;IAEtC,MAAM,GAAG,GAAG,IAAI,GAAG,EAA8B,CAAC;IAElD,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/terrain/TerrainBuilder.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Fluent builder for SmartTerrain configurations.
+ *
+ * Usage:
+ *   const config = new TerrainBuilder('bar_rostok')
+ *     .name('Bar "Rostok"')
+ *     .bounds({ x: 100, y: 200, width: 300, height: 300 })
+ *     .capacity(8)
+ *     .allowFactions(['stalkers', 'duty'])
+ *     .shelter(true)
+ *     .tags(['indoor', 'settlement'])
+ *     .addJob({ type: 'guard', slots: 2, position: { x: 120, y: 210 } })
+ *     .build();
+ */
+import type { IZoneBounds } from './Zone';
+import type { ISmartTerrainConfig, IJobSlot, ISpawnPoint, IPatrolRouteConfig } from './SmartTerrain';
+export declare class TerrainBuilder {
+    private readonly id;
+    private terrainName;
+    private terrainBounds;
+    private terrainDangerLevel;
+    private terrainCapacity;
+    private terrainFactions;
+    private terrainShelter;
+    private terrainTags;
+    private terrainJobs;
+    private terrainSpawnPoints;
+    private terrainPatrolRoutes;
+    constructor(id: string);
+    name(name: string): this;
+    bounds(b: IZoneBounds): this;
+    dangerLevel(level: number): this;
+    capacity(n: number): this;
+    allowFactions(factions: string[]): this;
+    shelter(isShelter: boolean): this;
+    tags(tags: string[]): this;
+    addJob(job: IJobSlot): this;
+    addSpawnPoint(sp: ISpawnPoint): this;
+    addPatrolRoute(route: IPatrolRouteConfig): this;
+    /** Validate required fields and return the SmartTerrain configuration. */
+    build(): ISmartTerrainConfig;
+    private validate;
+}
+//# sourceMappingURL=TerrainBuilder.d.ts.map

package/dist/terrain/TerrainBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TerrainBuilder.d.ts","sourceRoot":"","sources":["../../src/terrain/TerrainBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,WAAW,EACX,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAExB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,mBAAmB,CAA4B;gBAE3C,EAAE,EAAE,MAAM;IAOtB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,MAAM,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI;IAK5B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAUzB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAKvC,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAKjC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAK1B,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAK3B,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAKpC,cAAc,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAK/C,0EAA0E;IAC1E,KAAK,IAAI,mBAAmB;IA+B5B,OAAO,CAAC,QAAQ;CAejB"}

package/dist/terrain/TerrainBuilder.js

@@ -0,0 +1,112 @@
+/**
+ * Fluent builder for SmartTerrain configurations.
+ *
+ * Usage:
+ *   const config = new TerrainBuilder('bar_rostok')
+ *     .name('Bar "Rostok"')
+ *     .bounds({ x: 100, y: 200, width: 300, height: 300 })
+ *     .capacity(8)
+ *     .allowFactions(['stalkers', 'duty'])
+ *     .shelter(true)
+ *     .tags(['indoor', 'settlement'])
+ *     .addJob({ type: 'guard', slots: 2, position: { x: 120, y: 210 } })
+ *     .build();
+ */
+export class TerrainBuilder {
+    constructor(id) {
+        this.terrainName = '';
+        this.terrainDangerLevel = 0;
+        this.terrainCapacity = 0;
+        this.terrainFactions = [];
+        this.terrainShelter = false;
+        this.terrainTags = [];
+        this.terrainJobs = [];
+        this.terrainSpawnPoints = [];
+        this.terrainPatrolRoutes = [];
+        if (!id) {
+            throw new Error('[TerrainBuilder] id must not be empty');
+        }
+        this.id = id;
+    }
+    name(name) {
+        this.terrainName = name;
+        return this;
+    }
+    bounds(b) {
+        this.terrainBounds = b;
+        return this;
+    }
+    dangerLevel(level) {
+        this.terrainDangerLevel = level;
+        return this;
+    }
+    capacity(n) {
+        if (n < 0) {
+            throw new Error(`[TerrainBuilder] capacity must be non-negative, got ${n}`);
+        }
+        this.terrainCapacity = n;
+        return this;
+    }
+    allowFactions(factions) {
+        this.terrainFactions = [...factions];
+        return this;
+    }
+    shelter(isShelter) {
+        this.terrainShelter = isShelter;
+        return this;
+    }
+    tags(tags) {
+        this.terrainTags = [...tags];
+        return this;
+    }
+    addJob(job) {
+        this.terrainJobs.push(job);
+        return this;
+    }
+    addSpawnPoint(sp) {
+        this.terrainSpawnPoints.push(sp);
+        return this;
+    }
+    addPatrolRoute(route) {
+        this.terrainPatrolRoutes.push(route);
+        return this;
+    }
+    /** Validate required fields and return the SmartTerrain configuration. */
+    build() {
+        const errors = this.validate();
+        if (errors.length > 0) {
+            throw new Error(`[TerrainBuilder] Invalid terrain "${this.id}": ${errors.join('; ')}`);
+        }
+        return {
+            id: this.id,
+            name: this.terrainName,
+            bounds: this.terrainBounds,
+            dangerLevel: this.terrainDangerLevel,
+            capacity: this.terrainCapacity,
+            allowedFactions: this.terrainFactions.length > 0 ? [...this.terrainFactions] : undefined,
+            isShelter: this.terrainShelter || undefined,
+            tags: this.terrainTags.length > 0 ? [...this.terrainTags] : undefined,
+            jobs: this.terrainJobs.length > 0 ? [...this.terrainJobs] : undefined,
+            spawnPoints: this.terrainSpawnPoints.length > 0
+                ? [...this.terrainSpawnPoints]
+                : undefined,
+            patrolRoutes: this.terrainPatrolRoutes.length > 0
+                ? [...this.terrainPatrolRoutes]
+                : undefined,
+        };
+    }
+    validate() {
+        const errors = [];
+        if (!this.terrainName) {
+            errors.push('name is required');
+        }
+        if (!this.terrainBounds) {
+            errors.push('bounds is required');
+        }
+        if (this.terrainCapacity <= 0) {
+            errors.push('capacity must be a positive number');
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=TerrainBuilder.js.map

package/dist/terrain/TerrainBuilder.js.map

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

package/dist/terrain/Zone.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Base zone -- a named rectangular area in the world.
+ *
+ * Used as the foundation for SmartTerrain and other spatial constructs.
+ */
+import type { Vec2 } from '../core/Vec2';
+export interface IZoneBounds {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export declare class Zone {
+    readonly id: string;
+    readonly bounds: IZoneBounds;
+    readonly dangerLevel: number;
+    readonly metadata: ReadonlyMap<string, unknown>;
+    private readonly _center;
+    constructor(id: string, bounds: IZoneBounds, dangerLevel?: number, metadata?: Record<string, unknown>);
+    /** Check whether a point lies within this zone's bounds. */
+    contains(point: Vec2): boolean;
+    /** The geometric center of the zone (cached, frozen). */
+    get center(): Vec2;
+}
+//# sourceMappingURL=Zone.d.ts.map

package/dist/terrain/Zone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Zone.d.ts","sourceRoot":"","sources":["../../src/terrain/Zone.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,IAAI;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAO;gBAG7B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,EACnB,WAAW,SAAI,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYpC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAS9B,yDAAyD;IACzD,IAAI,MAAM,IAAI,IAAI,CAEjB;CACF"}

package/dist/terrain/Zone.js

@@ -0,0 +1,29 @@
+/**
+ * Base zone -- a named rectangular area in the world.
+ *
+ * Used as the foundation for SmartTerrain and other spatial constructs.
+ */
+export class Zone {
+    constructor(id, bounds, dangerLevel = 0, metadata) {
+        this.id = id;
+        this.bounds = bounds;
+        this.dangerLevel = dangerLevel;
+        this.metadata = new Map(Object.entries(metadata ?? {}));
+        this._center = Object.freeze({
+            x: bounds.x + bounds.width / 2,
+            y: bounds.y + bounds.height / 2,
+        });
+    }
+    /** Check whether a point lies within this zone's bounds. */
+    contains(point) {
+        return (point.x >= this.bounds.x &&
+            point.x <= this.bounds.x + this.bounds.width &&
+            point.y >= this.bounds.y &&
+            point.y <= this.bounds.y + this.bounds.height);
+    }
+    /** The geometric center of the zone (cached, frozen). */
+    get center() {
+        return this._center;
+    }
+}
+//# sourceMappingURL=Zone.js.map

package/dist/terrain/Zone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Zone.js","sourceRoot":"","sources":["../../src/terrain/Zone.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,OAAO,IAAI;IAOf,YACE,EAAU,EACV,MAAmB,EACnB,WAAW,GAAG,CAAC,EACf,QAAkC;QAElC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;YAC3B,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC;YAC9B,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IAED,4DAA4D;IAC5D,QAAQ,CAAC,KAAW;QAClB,OAAO,CACL,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;YAC5C,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAC9C,CAAC;IACJ,CAAC;IAED,yDAAyD;IACzD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/terrain/index.d.ts

@@ -0,0 +1,6 @@
+export { Zone } from './Zone';
+export type { IZoneBounds } from './Zone';
+export { SmartTerrain } from './SmartTerrain';
+export type { ISmartTerrainConfig, IScoringConfig, IJobSlot, IJobPreconditions, ISpawnPoint, IPatrolRouteConfig } from './SmartTerrain';
+export { TerrainBuilder } from './TerrainBuilder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/terrain/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACxI,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/terrain/index.js

@@ -0,0 +1,5 @@
+// terrain sub-path barrel
+export { Zone } from './Zone';
+export { SmartTerrain } from './SmartTerrain';
+export { TerrainBuilder } from './TerrainBuilder';
+//# sourceMappingURL=index.js.map

package/dist/terrain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/terrain/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/time/TimeManager.d.ts

@@ -0,0 +1,21 @@
+import { Clock } from '../core/Clock';
+import type { IClockConfig, IClockState } from '../core/Clock';
+import type { EventBus } from '../events/EventBus';
+import type { ALifeEventPayloads } from '../events/ALifeEvents';
+export interface ITimeManagerConfig {
+    /** Optional EventBus to receive 'time:hour_changed' and 'time:day_night_changed'. */
+    events?: EventBus<ALifeEventPayloads>;
+    /** Clock config (timeFactor, startHour, etc). onHourChanged/onDayNightChanged are managed internally. */
+    clockConfig?: Omit<IClockConfig, 'onHourChanged' | 'onDayNightChanged'>;
+}
+export declare class TimeManager {
+    private _clock;
+    private readonly _events;
+    constructor(config?: ITimeManagerConfig);
+    update(deltaMs: number): void;
+    get clock(): Clock;
+    serialize(): IClockState;
+    restore(state: IClockState): void;
+    private _buildCallbacks;
+}
+//# sourceMappingURL=TimeManager.d.ts.map

package/dist/time/TimeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeManager.d.ts","sourceRoot":"","sources":["../../src/time/TimeManager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,MAAM,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACtC,yGAAyG;IACzG,WAAW,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,mBAAmB,CAAC,CAAC;CACzE;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;gBAEvD,MAAM,GAAE,kBAAuB;IAQ3C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED,SAAS,IAAI,WAAW;IAIxB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIjC,OAAO,CAAC,eAAe;CAaxB"}

package/dist/time/TimeManager.js

@@ -0,0 +1,41 @@
+// time/TimeManager.ts
+// Standalone game-time manager.
+// Wraps Clock with optional EventBus wiring — for games that do not use ALifeKernel.
+import { Clock } from '../core/Clock';
+import { ALifeEvents } from '../events/ALifeEvents';
+export class TimeManager {
+    constructor(config = {}) {
+        this._events = config.events;
+        this._clock = new Clock({
+            ...(config.clockConfig ?? {}),
+            ...this._buildCallbacks(),
+        });
+    }
+    update(deltaMs) {
+        this._clock.update(deltaMs);
+    }
+    get clock() {
+        return this._clock;
+    }
+    serialize() {
+        return this._clock.serialize();
+    }
+    restore(state) {
+        this._clock = Clock.fromState(state, this._buildCallbacks());
+    }
+    _buildCallbacks() {
+        if (!this._events)
+            return {};
+        const events = this._events;
+        const self = this;
+        return {
+            onHourChanged: (hour, day) => {
+                events.emit(ALifeEvents.HOUR_CHANGED, { hour, day, isDay: self._clock.isDay });
+            },
+            onDayNightChanged: (isDay) => {
+                events.emit(ALifeEvents.DAY_NIGHT_CHANGED, { isDay });
+            },
+        };
+    }
+}
+//# sourceMappingURL=TimeManager.js.map

package/dist/time/TimeManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeManager.js","sourceRoot":"","sources":["../../src/time/TimeManager.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,gCAAgC;AAChC,qFAAqF;AAErF,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAItC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASpD,MAAM,OAAO,WAAW;IAItB,YAAY,SAA6B,EAAE;QACzC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC;YACtB,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;YAC7B,GAAG,IAAI,CAAC,eAAe,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,KAAkB;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/D,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,OAAO;YACL,aAAa,EAAE,CAAC,IAAY,EAAE,GAAW,EAAE,EAAE;gBAC3C,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,iBAAiB,EAAE,CAAC,KAAc,EAAE,EAAE;gBACpC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/time/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/time/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/time/index.js

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

package/dist/time/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/time/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@alife-sdk/core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic A-Life simulation and AI decision-making system",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./math": {
+      "types": "./dist/core/math/index.d.ts",
+      "import": "./dist/core/math/index.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "import": "./dist/events/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.ts",
+      "import": "./dist/registry/index.js"
+    },
+    "./entity": {
+      "types": "./dist/entity/index.d.ts",
+      "import": "./dist/entity/index.js"
+    },
+    "./faction": {
+      "types": "./dist/faction/index.d.ts",
+      "import": "./dist/faction/index.js"
+    },
+    "./combat": {
+      "types": "./dist/combat/index.d.ts",
+      "import": "./dist/combat/index.js"
+    },
+    "./terrain": {
+      "types": "./dist/terrain/index.d.ts",
+      "import": "./dist/terrain/index.js"
+    },
+    "./movement": {
+      "types": "./dist/movement/index.d.ts",
+      "import": "./dist/movement/index.js"
+    },
+    "./spawn": {
+      "types": "./dist/spawn/index.d.ts",
+      "import": "./dist/spawn/index.js"
+    },
+    "./ai": {
+      "types": "./dist/ai/index.d.ts",
+      "import": "./dist/ai/index.js"
+    },
+    "./logger": {
+      "types": "./dist/logger/index.d.ts",
+      "import": "./dist/logger/index.js"
+    },
+    "./ports": {
+      "types": "./dist/ports/index.d.ts",
+      "import": "./dist/ports/index.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "import": "./dist/plugins/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "import": "./dist/schema/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    },
+    "./navigation": {
+      "types": "./dist/navigation/index.d.ts",
+      "import": "./dist/navigation/index.js"
+    }
+  },
+  "keywords": [
+    "alife",
+    "game-ai",
+    "simulation",
+    "npc",
+    "behavior",
+    "state-machine",
+    "goap"
+  ],
+  "license": "MIT",
+  "author": "Eugene Rusakov",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eurusik/alife-sdk.git",
+    "directory": "packages/alife-core"
+  },
+  "homepage": "https://github.com/eurusik/alife-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/eurusik/alife-sdk/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}