@alife-sdk/core 0.1.0

package/dist/combat/MoraleStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MoraleStateMachine.d.ts","sourceRoot":"","sources":["../../src/combat/MoraleStateMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAYD,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAK3C,uCAAuC;IACvC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,kEAAkE;IAClE,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS3B;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiB9B,kCAAkC;IAClC,KAAK,IAAI,IAAI;CAId"}

package/dist/combat/MoraleStateMachine.js

@@ -0,0 +1,84 @@
+/**
+ * 3-state morale system: STABLE / SHAKEN / PANICKED.
+ *
+ * Morale is a value in [-1, 1] that determines the NPC's psychological state:
+ *   - STABLE:   morale > shakenThreshold  (-0.3 by default), recovery +0.005/s toward 0
+ *   - SHAKEN:   morale between shaken and panicked thresholds, recovery +0.01/s toward 0
+ *   - PANICKED: morale <= panicThreshold (-0.7 by default), no recovery
+ *
+ * External systems call {@link adjust} to apply morale hits/boosts
+ * and {@link update} each frame to apply recovery.
+ */
+import { clamp, moveTowardZero } from '../core/math/utils';
+export const MoraleState = {
+    STABLE: 'stable',
+    SHAKEN: 'shaken',
+    PANICKED: 'panicked',
+};
+const DEFAULT_CONFIG = {
+    shakenThreshold: -0.3,
+    panicThreshold: -0.7,
+    stableRecoveryRate: 0.005,
+    shakenRecoveryRate: 0.01,
+};
+const MORALE_MIN = -1;
+const MORALE_MAX = 1;
+export class MoraleTracker {
+    constructor(config) {
+        this.currentMorale = 0;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this._cachedState = deriveState(this.currentMorale, this.config);
+    }
+    /** Current morale value in [-1, 1]. */
+    get morale() {
+        return this.currentMorale;
+    }
+    /** Derived morale state based on current value and thresholds. */
+    get state() {
+        return this._cachedState;
+    }
+    /**
+     * Apply a morale adjustment (positive = boost, negative = hit).
+     * Result is clamped to [-1, 1].
+     */
+    adjust(delta) {
+        this.currentMorale = clamp(this.currentMorale + delta, MORALE_MIN, MORALE_MAX);
+        this._cachedState = deriveState(this.currentMorale, this.config);
+    }
+    /**
+     * Tick recovery. Should be called each frame with the elapsed seconds.
+     *
+     * - STABLE: recovers toward 0 at stableRecoveryRate per second.
+     * - SHAKEN: recovers toward 0 at shakenRecoveryRate per second.
+     * - PANICKED: no recovery.
+     */
+    update(deltaSec) {
+        if (deltaSec <= 0)
+            return;
+        const currentState = this._cachedState;
+        if (currentState === MoraleState.PANICKED)
+            return;
+        const rate = currentState === MoraleState.SHAKEN
+            ? this.config.shakenRecoveryRate
+            : this.config.stableRecoveryRate;
+        const recovery = rate * deltaSec;
+        this.currentMorale = moveTowardZero(this.currentMorale, recovery);
+        this._cachedState = deriveState(this.currentMorale, this.config);
+    }
+    /** Reset morale to 0 (STABLE). */
+    reset() {
+        this.currentMorale = 0;
+        this._cachedState = deriveState(this.currentMorale, this.config);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function deriveState(morale, config) {
+    if (morale <= config.panicThreshold)
+        return MoraleState.PANICKED;
+    if (morale <= config.shakenThreshold)
+        return MoraleState.SHAKEN;
+    return MoraleState.STABLE;
+}
+//# sourceMappingURL=MoraleStateMachine.js.map

package/dist/combat/MoraleStateMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MoraleStateMachine.js","sourceRoot":"","sources":["../../src/combat/MoraleStateMachine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAeX,MAAM,cAAc,GAAkB;IACpC,eAAe,EAAE,CAAC,GAAG;IACrB,cAAc,EAAE,CAAC,GAAG;IACpB,kBAAkB,EAAE,KAAK;IACzB,kBAAkB,EAAE,IAAI;CACzB,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC;AACtB,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,MAAM,OAAO,aAAa;IAKxB,YAAY,MAA+B;QAJnC,kBAAa,GAAG,CAAC,CAAC;QAKxB,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,uCAAuC;IACvC,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,kEAAkE;IAClE,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAa;QAClB,IAAI,CAAC,aAAa,GAAG,KAAK,CACxB,IAAI,CAAC,aAAa,GAAG,KAAK,EAC1B,UAAU,EACV,UAAU,CACX,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAgB;QACrB,IAAI,QAAQ,IAAI,CAAC;YAAE,OAAO;QAE1B,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAEvC,IAAI,YAAY,KAAK,WAAW,CAAC,QAAQ;YAAE,OAAO;QAElD,MAAM,IAAI,GACR,YAAY,KAAK,WAAW,CAAC,MAAM;YACjC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB;YAChC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;QAErC,MAAM,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAClE,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,kCAAkC;IAClC,KAAK;QACH,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,WAAW,CAAC,MAAc,EAAE,MAAqB;IACxD,IAAI,MAAM,IAAI,MAAM,CAAC,cAAc;QAAE,OAAO,WAAW,CAAC,QAAQ,CAAC;IACjE,IAAI,MAAM,IAAI,MAAM,CAAC,eAAe;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC;IAChE,OAAO,WAAW,CAAC,MAAM,CAAC;AAC5B,CAAC"}

package/dist/combat/index.d.ts

@@ -0,0 +1,5 @@
+export type { IDamageInstance, IDamageInstanceParams } from './DamageInstance';
+export { createDamageInstance } from './DamageInstance';
+export { MoraleTracker } from './MoraleStateMachine';
+export type { MoraleState, IMoraleConfig } from './MoraleStateMachine';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/combat/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/combat/index.js

@@ -0,0 +1,3 @@
+export { createDamageInstance } from './DamageInstance';
+export { MoraleTracker } from './MoraleStateMachine';
+//# sourceMappingURL=index.js.map

package/dist/combat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/combat/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/config/ALifeConfig.d.ts

@@ -0,0 +1,131 @@
+export interface ITickConfig {
+    /** Milliseconds between A-Life simulation ticks. */
+    readonly intervalMs: number;
+    /** Maximum offline NPC brains updated per tick (round-robin). */
+    readonly maxBrainUpdatesPerTick: number;
+    /** Maximum hostile faction-pair combat resolutions per tick. */
+    readonly maxCombatResolutionsPerTick: number;
+    /** Wall-clock budget (ms) for a full tick; warns if exceeded. */
+    readonly budgetWarningMs: number;
+    /** Run redundancy cleanup every N ticks. */
+    readonly redundancyCleanupInterval: number;
+    /** Game-time delay (ms) after death before an offline NPC is purged. */
+    readonly redundancyCleanupDelayMs: number;
+}
+export interface ISimulationConfig {
+    /** NPC goes online when closer than this distance (px). */
+    readonly onlineRadius: number;
+    /** NPC goes offline when farther than this distance (px). */
+    readonly offlineRadius: number;
+    /** Cell size (px) for the spatial hash grid. */
+    readonly spatialGridCellSize: number;
+}
+export interface ITimeConfig {
+    /** Game-time acceleration factor. 1 real second = timeFactor game seconds. */
+    readonly timeFactor: number;
+    /** In-game hour at which the simulation starts (0-23). */
+    readonly startHour: number;
+    /** First hour considered daytime. */
+    readonly dayStartHour: number;
+    /** Last hour considered daytime (exclusive). */
+    readonly dayEndHour: number;
+}
+export interface ICombatConfig {
+    /** Minimum time (ms) between consecutive melee attacks. */
+    readonly meleeCooldownMs: number;
+    /** Minimum time (ms) before switching between NPC targets. */
+    readonly enemyInertiaMs: number;
+}
+/** Morale range is [-1, 1]. All deltas and thresholds use this range. */
+export interface IMoraleConfig {
+    /** Morale delta [-1, 0] when an NPC takes a hit. E.g. -0.15. */
+    readonly hitPenalty: number;
+    /** Morale delta [-1, 0] when a squad ally dies. E.g. -0.25. */
+    readonly allyDiedPenalty: number;
+    /** Morale delta [-1, 0] when the squad leader dies (replaces allyDiedPenalty). */
+    readonly leaderDiedPenalty: number;
+    /** Morale delta [0, 1] when this NPC kills an enemy. E.g. 0.2. */
+    readonly enemyKilledBonus: number;
+    /** Morale delta [-1, 0] during an active surge event. */
+    readonly surgePenalty: number;
+    /** Passive morale recovery (per second) in SHAKEN state. E.g. 0.01/s. */
+    readonly shakenRecoveryRate: number;
+    /** Passive morale recovery (per second) in STABLE state (toward 0). E.g. 0.005/s. */
+    readonly stableRecoveryRate: number;
+    /** Morale threshold [-1, 1] below which the NPC enters SHAKEN. E.g. -0.3. */
+    readonly shakenThreshold: number;
+    /** Morale threshold [-1, 1] at or below which the NPC enters PANICKED. E.g. -0.7. */
+    readonly panicThreshold: number;
+}
+export interface ISpawnConfig {
+    /** Default cooldown (ms) after spawning before the same point can spawn again. */
+    readonly defaultCooldownMs: number;
+}
+export interface IMemoryConfig {
+    /** Confidence decay rate (per ms) for the VISUAL channel. E.g. 0.001 = full decay in ~1s. */
+    readonly visualDecayRate: number;
+    /** Confidence decay rate (per ms) for the SOUND channel. */
+    readonly soundDecayRate: number;
+    /** Confidence decay rate (per ms) for the HIT channel. */
+    readonly hitDecayRate: number;
+    /** Confidence decay rate (per ms) for the DANGER channel. */
+    readonly dangerDecayRate: number;
+    /** Maximum memory entries kept per channel per NPC. */
+    readonly maxEntriesPerChannel: number;
+    /** Confidence [0, 1] below which a memory record is pruned. E.g. 0.1. */
+    readonly confidenceThreshold: number;
+}
+export interface ISurgeConfig {
+    /** Duration (ms) of the warning phase before the surge hits. */
+    readonly warningDurationMs: number;
+    /** Duration (ms) of the active surge (damage ticking). */
+    readonly activeDurationMs: number;
+    /** Duration (ms) of the aftermath cooldown after the surge ends. */
+    readonly aftermathDurationMs: number;
+    /** PSI damage dealt per second to outdoor NPCs during the active phase. */
+    readonly psiDamagePerSecond: number;
+}
+export interface IMonsterConfig {
+    /** Wind-up duration (ms) before a boar charge releases. */
+    readonly chargeWindupMs: number;
+    /** Damage multiplier applied when a charge connects. */
+    readonly chargeDamageMult: number;
+    /** Distance (px) within which a bloodsucker exits stealth. */
+    readonly stalkApproachDist: number;
+    /** Sprite alpha [0, 1] while fully invisible during STALK state. E.g. 0.08. */
+    readonly stalkAlphaInvisible: number;
+    /** Wind-up duration (ms) before a snork leap launches. */
+    readonly leapWindupMs: number;
+    /** Duration (ms) the snork is airborne during a leap. */
+    readonly leapAirtimeMs: number;
+    /** Channel duration (ms) of the controller PSI attack. */
+    readonly psiChannelMs: number;
+}
+export interface ITradeConfig {
+    /** Pixel radius within which the player can interact with a trader. */
+    readonly interactionRadius: number;
+    /** Price modifier for allied factions (< 1 = discount). */
+    readonly allyDiscount: number;
+    /** How often (ms) trader inventories restock. */
+    readonly restockIntervalMs: number;
+}
+export interface IALifeConfig {
+    readonly tick: ITickConfig;
+    readonly simulation: ISimulationConfig;
+    readonly time: ITimeConfig;
+    readonly combat: ICombatConfig;
+    readonly morale: IMoraleConfig;
+    readonly spawn: ISpawnConfig;
+    readonly memory: IMemoryConfig;
+    readonly surge: ISurgeConfig;
+    readonly monster: IMonsterConfig;
+    readonly trade: ITradeConfig;
+}
+/**
+ * Creates a complete IALifeConfig populated with production-grade defaults.
+ *
+ * Values are sourced from the original game's Constants module and represent
+ * the tuned baseline for the Chornobyl: The Lost Zone simulation.
+ */
+export declare function createDefaultConfig(): IALifeConfig;
+//# sourceMappingURL=ALifeConfig.d.ts.map

package/dist/config/ALifeConfig.d.ts.map

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

package/dist/config/ALifeConfig.js

@@ -0,0 +1,82 @@
+// ---------------------------------------------------------------------------
+// IALifeConfig — all tunable A-Life constants grouped by domain.
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Default factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a complete IALifeConfig populated with production-grade defaults.
+ *
+ * Values are sourced from the original game's Constants module and represent
+ * the tuned baseline for the Chornobyl: The Lost Zone simulation.
+ */
+export function createDefaultConfig() {
+    return {
+        tick: {
+            intervalMs: 5000,
+            maxBrainUpdatesPerTick: 20,
+            maxCombatResolutionsPerTick: 10,
+            budgetWarningMs: 50,
+            redundancyCleanupInterval: 3,
+            redundancyCleanupDelayMs: 30000,
+        },
+        simulation: {
+            onlineRadius: 600,
+            offlineRadius: 800,
+            spatialGridCellSize: 200,
+        },
+        time: {
+            timeFactor: 10,
+            startHour: 8,
+            dayStartHour: 6,
+            dayEndHour: 21,
+        },
+        combat: {
+            meleeCooldownMs: 1000,
+            enemyInertiaMs: 3000,
+        },
+        morale: {
+            hitPenalty: -0.15,
+            allyDiedPenalty: -0.25,
+            leaderDiedPenalty: -0.4,
+            enemyKilledBonus: 0.2,
+            surgePenalty: -0.3,
+            shakenRecoveryRate: 0.01,
+            stableRecoveryRate: 0.005,
+            shakenThreshold: -0.3,
+            panicThreshold: -0.7,
+        },
+        spawn: {
+            defaultCooldownMs: 30000,
+        },
+        memory: {
+            visualDecayRate: 0.001,
+            soundDecayRate: 0.003,
+            hitDecayRate: 0.0005,
+            dangerDecayRate: 0.002,
+            maxEntriesPerChannel: 20,
+            confidenceThreshold: 0.1,
+        },
+        surge: {
+            warningDurationMs: 30000,
+            activeDurationMs: 60000,
+            aftermathDurationMs: 15000,
+            psiDamagePerSecond: 5,
+        },
+        monster: {
+            chargeWindupMs: 600,
+            chargeDamageMult: 2,
+            stalkApproachDist: 80,
+            stalkAlphaInvisible: 0.08,
+            leapWindupMs: 400,
+            leapAirtimeMs: 350,
+            psiChannelMs: 2000,
+        },
+        trade: {
+            interactionRadius: 150,
+            allyDiscount: 0.8,
+            restockIntervalMs: 300000,
+        },
+    };
+}
+//# sourceMappingURL=ALifeConfig.js.map

package/dist/config/ALifeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ALifeConfig.js","sourceRoot":"","sources":["../../src/config/ALifeConfig.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AA4I9E,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI,EAAE;YACJ,UAAU,EAAE,IAAK;YACjB,sBAAsB,EAAE,EAAE;YAC1B,2BAA2B,EAAE,EAAE;YAC/B,eAAe,EAAE,EAAE;YACnB,yBAAyB,EAAE,CAAC;YAC5B,wBAAwB,EAAE,KAAM;SACjC;QAED,UAAU,EAAE;YACV,YAAY,EAAE,GAAG;YACjB,aAAa,EAAE,GAAG;YAClB,mBAAmB,EAAE,GAAG;SACzB;QAED,IAAI,EAAE;YACJ,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC;YACZ,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,EAAE;SACf;QAED,MAAM,EAAE;YACN,eAAe,EAAE,IAAK;YACtB,cAAc,EAAE,IAAK;SACtB;QAED,MAAM,EAAE;YACN,UAAU,EAAE,CAAC,IAAI;YACjB,eAAe,EAAE,CAAC,IAAI;YACtB,iBAAiB,EAAE,CAAC,GAAG;YACvB,gBAAgB,EAAE,GAAG;YACrB,YAAY,EAAE,CAAC,GAAG;YAClB,kBAAkB,EAAE,IAAI;YACxB,kBAAkB,EAAE,KAAK;YACzB,eAAe,EAAE,CAAC,GAAG;YACrB,cAAc,EAAE,CAAC,GAAG;SACrB;QAED,KAAK,EAAE;YACL,iBAAiB,EAAE,KAAM;SAC1B;QAED,MAAM,EAAE;YACN,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,YAAY,EAAE,MAAM;YACpB,eAAe,EAAE,KAAK;YACtB,oBAAoB,EAAE,EAAE;YACxB,mBAAmB,EAAE,GAAG;SACzB;QAED,KAAK,EAAE;YACL,iBAAiB,EAAE,KAAM;YACzB,gBAAgB,EAAE,KAAM;YACxB,mBAAmB,EAAE,KAAM;YAC3B,kBAAkB,EAAE,CAAC;SACtB;QAED,OAAO,EAAE;YACP,cAAc,EAAE,GAAG;YACnB,gBAAgB,EAAE,CAAC;YACnB,iBAAiB,EAAE,EAAE;YACrB,mBAAmB,EAAE,IAAI;YACzB,YAAY,EAAE,GAAG;YACjB,aAAa,EAAE,GAAG;YAClB,YAAY,EAAE,IAAK;SACpB;QAED,KAAK,EAAE;YACL,iBAAiB,EAAE,GAAG;YACtB,YAAY,EAAE,GAAG;YACjB,iBAAiB,EAAE,MAAO;SAC3B;KACF,CAAC;AACJ,CAAC"}

package/dist/config/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/config/index.js

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

package/dist/config/index.js.map

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

package/dist/core/ALifeKernel.d.ts

@@ -0,0 +1,163 @@
+import { EventBus } from '../events/EventBus';
+import type { ALifeEventPayloads } from '../events/ALifeEvents';
+import { Clock } from './Clock';
+import type { IClockConfig, IClockState } from './Clock';
+import { SpatialGrid } from './SpatialGrid';
+import type { ILoggerConfig } from '../logger/Logger';
+import { type IALifeConfig } from '../config/ALifeConfig';
+import type { IEntityAdapter } from '../ports/IEntityAdapter';
+import type { IPlayerPositionProvider } from '../ports/IPlayerPositionProvider';
+import type { IEntityFactory } from '../ports/IEntityFactory';
+import type { ILogger } from '../ports/ILogger';
+import type { IALifePlugin } from '../plugins/IALifePlugin';
+import type { PluginToken } from '../plugins/PluginToken';
+import type { Vec2 } from './Vec2';
+import { PortRegistry, type PortToken } from './PortRegistry';
+import { DiagnosticsCollector } from './Diagnostics';
+import type { IDevToolsSnapshot, IDevToolsConfig } from './DevToolsInspector';
+/** Optional overrides for kernel sub-systems. */
+export interface IALifeKernelConfig {
+    readonly config?: Partial<IALifeConfig>;
+    readonly logger?: ILoggerConfig;
+    readonly clock?: Omit<IClockConfig, 'onHourChanged' | 'onDayNightChanged'>;
+}
+/** @deprecated Use IALifeKernelConfig */
+export type IALifeKernelOptions = IALifeKernelConfig;
+/** Current serialisation format version. */
+export declare const KERNEL_STATE_VERSION = 1;
+/**
+ * Migration function that transforms kernel state from one version to the next.
+ *
+ * @param state - The kernel state object to migrate.
+ * @returns The migrated state for the next version.
+ */
+export type StateMigration = (state: IALifeKernelState) => IALifeKernelState;
+/** Wrapper for per-plugin state with version tag. */
+export interface IPluginStateCapsule {
+    readonly version?: number;
+    readonly state: Record<string, unknown>;
+}
+export interface IALifeKernelState {
+    readonly version: number;
+    readonly clock: IClockState;
+    readonly tick: number;
+    readonly plugins?: Readonly<Record<string, IPluginStateCapsule>>;
+}
+export declare class ALifeKernel {
+    readonly events: EventBus<ALifeEventPayloads>;
+    readonly portRegistry: PortRegistry;
+    private readonly plugins;
+    private pluginOrder;
+    private readonly migrations;
+    private _clock;
+    private _logger;
+    private _spatialGrid;
+    private readonly config;
+    private readonly loggerConfig;
+    private readonly clockConfig;
+    private initialized;
+    private _running;
+    private _paused;
+    private _tick;
+    /**
+     * Create a new A-Life kernel.
+     *
+     * @example
+     * ```ts
+     * const kernel = new ALifeKernel();
+     * kernel.provide(Ports.EntityAdapter, myAdapter);
+     * kernel.use(new SimulationPlugin());
+     * kernel.init();
+     * kernel.start();
+     * ```
+     */
+    constructor(options?: IALifeKernelConfig);
+    /** Register a port adapter by token. Must be called before `init()`. */
+    provide<T>(token: PortToken<T>, impl: T): this;
+    /**
+     * Install a plugin. Must be called before `init()`.
+     *
+     * Plugins extend the kernel with domain-specific registries and logic.
+     * Each plugin is identified by its `name` property — duplicates throw.
+     */
+    use(plugin: IALifePlugin): this;
+    /** Retrieve an installed plugin by typed token or name string. */
+    getPlugin<T extends IALifePlugin>(token: PluginToken<T>): T;
+    getPlugin<T extends IALifePlugin>(name: string): T;
+    /** Check whether a plugin is installed. */
+    hasPlugin(name: string): boolean;
+    /**
+     * Register a state migration from one version to the next.
+     *
+     * When `restoreState()` receives a save with `state.version < KERNEL_STATE_VERSION`,
+     * the kernel applies registered migrations in sequence to bring the state up to date.
+     *
+     * @param fromVersion - The version this migration upgrades FROM (migrates to fromVersion + 1).
+     * @param migration - A function that transforms the state.
+     */
+    registerMigration(fromVersion: number, migration: StateMigration): this;
+    /**
+     * Validate configuration, create subsystems, and initialize plugins
+     * in dependency order.
+     *
+     * Returns a {@link DiagnosticsCollector} with all warnings/infos.
+     * Throws {@link ALifeValidationError} if any required port is missing
+     * or a plugin hard-dependency is unresolved.
+     */
+    init(): DiagnosticsCollector;
+    /**
+     * Start the simulation — enables frame-based `update()`.
+     * Must be called after `init()`.
+     */
+    start(): void;
+    /**
+     * Advance the simulation by `deltaMs` real milliseconds.
+     * Requires `init()` + `start()`. No-op when paused.
+     */
+    update(deltaMs: number): void;
+    /**
+     * Advance the simulation by a fixed number of ticks at the configured
+     * interval. Does not require `start()` — ideal for deterministic tests.
+     *
+     * @param count - Number of ticks to execute (default: 1).
+     */
+    step(count?: number): void;
+    /** Pause the simulation — `update()` becomes a no-op, clock freezes. */
+    pause(): void;
+    /** Resume after a `pause()`. */
+    resume(): void;
+    /** Release all resources and subscriptions. */
+    destroy(): void;
+    get clock(): Clock;
+    get logger(): ILogger;
+    get spatialGrid(): SpatialGrid<{
+        id: string;
+        position: Vec2;
+    }>;
+    get entityAdapter(): IEntityAdapter;
+    get playerPosition(): IPlayerPositionProvider;
+    get entityFactory(): IEntityFactory;
+    get currentConfig(): IALifeConfig;
+    get tick(): number;
+    get isInitialized(): boolean;
+    get isRunning(): boolean;
+    get isPaused(): boolean;
+    serialize(): IALifeKernelState;
+    restoreState(state: IALifeKernelState): void;
+    /**
+     * Create a runtime snapshot of the kernel state for developer tooling.
+     *
+     * @param config - Optional configuration to control what data is included.
+     * @returns A plain, JSON-serialisable snapshot.
+     */
+    inspect(config?: IDevToolsConfig): IDevToolsSnapshot;
+    private validatePorts;
+    private validatePluginDeps;
+    private validateConfig;
+    private topologicalSort;
+    private collectPluginState;
+    private createSubsystems;
+    private ensureInitialized;
+    private ensureRunning;
+}
+//# sourceMappingURL=ALifeKernel.d.ts.map

package/dist/core/ALifeKernel.d.ts.map

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