@alife-sdk/core 0.1.0

package/dist/core/Clock.d.ts

@@ -0,0 +1,123 @@
+/** Snapshot of Clock state for save/load. */
+export interface IClockState {
+    /** Total elapsed game-seconds since the simulation started. */
+    readonly totalGameSeconds: number;
+    /** Time acceleration factor at the moment of save. */
+    readonly timeFactor: number;
+    /** Whether the clock was paused at the moment of save. */
+    readonly paused?: boolean;
+}
+/** Configuration accepted by the Clock constructor. */
+export interface IClockConfig {
+    /** Game-seconds per real-second. Default: 10. */
+    timeFactor?: number;
+    /** Starting hour (0-23). Default: 8 (08:00). */
+    startHour?: number;
+    /** Starting day number (1-based). Default: 1. */
+    startDay?: number;
+    /** First hour considered daytime (0-23). Default: 6. */
+    dayStartHour?: number;
+    /** Last hour considered daytime, exclusive (0-23). Default: 21. */
+    dayEndHour?: number;
+    /** Called when the in-game hour changes. */
+    onHourChanged?: (hour: number, day: number) => void;
+    /** Called when the day/night state flips. */
+    onDayNightChanged?: (isDay: boolean) => void;
+}
+/**
+ * Accelerated in-game clock with day/night cycle detection.
+ *
+ * Framework-agnostic: no dependency on Phaser, EventBus, or any renderer.
+ * Transition notifications are delivered via optional callback functions
+ * supplied at construction time.
+ *
+ * @example
+ * ```ts
+ * const clock = new Clock({
+ *   timeFactor: 10,
+ *   startHour: 8,
+ *   onHourChanged: (h, d) => console.log(`Day ${d}, ${h}:00`),
+ *   onDayNightChanged: (day) => console.log(day ? 'Dawn' : 'Dusk'),
+ * });
+ *
+ * // Each frame:
+ * clock.update(deltaMs);
+ *
+ * console.log(clock.hour);    // 8
+ * console.log(clock.isDay);   // true
+ * ```
+ */
+export declare class Clock {
+    /**
+     * Total elapsed game-seconds since the simulation epoch (day 1, 00:00:00).
+     * This is the single source of truth — hour, minute, day are all derived.
+     */
+    private gameSeconds;
+    /** Game-seconds per real-second. */
+    private _timeFactor;
+    /** Cached hour for boundary detection. */
+    private previousHour;
+    /** Cached day/night state for transition detection. */
+    private wasDaytime;
+    /** When true, update() is a no-op — time stands still. */
+    private _paused;
+    /** First hour of daytime (inclusive). */
+    private readonly dayStartHour;
+    /** Last hour of daytime (exclusive). */
+    private readonly dayEndHour;
+    private readonly onHourChanged?;
+    private readonly onDayNightChanged?;
+    constructor(config?: IClockConfig);
+    /** Current in-game hour (0-23). */
+    get hour(): number;
+    /** Current in-game minute within the current hour (0-59). */
+    get minute(): number;
+    /** Current in-game day (1-based). */
+    get day(): number;
+    /** Total elapsed game-seconds since epoch. */
+    get totalGameSeconds(): number;
+    /** True during daytime hours (configurable, default 06:00 - 20:59). */
+    get isDay(): boolean;
+    /** True during nighttime hours (21:00 - 05:59). */
+    get isNight(): boolean;
+    /** Current time acceleration factor. */
+    get timeFactor(): number;
+    /** `true` when the clock is paused — `update()` becomes a no-op. */
+    get isPaused(): boolean;
+    /**
+     * Advance the in-game clock by `deltaMs` real milliseconds multiplied by
+     * the time factor. Call once per frame.
+     *
+     * Detects hour boundaries and day/night transitions, invoking the
+     * corresponding callbacks when they occur.
+     *
+     * @param deltaMs - Real milliseconds elapsed since the previous frame.
+     */
+    update(deltaMs: number): void;
+    /** Freeze time — `update()` becomes a no-op until `resume()` is called. */
+    pause(): void;
+    /** Resume time advancement after a `pause()`. */
+    resume(): void;
+    /**
+     * Set the in-game time to an exact hour (and optionally minute) on the
+     * current day. Does not fire transition callbacks — the next `update()`
+     * call will detect and emit any resulting transitions naturally.
+     *
+     * @param hour   - Target hour (0-23).
+     * @param minute - Target minute (0-59). Default: 0.
+     */
+    setTime(hour: number, minute?: number): void;
+    /** Capture the current clock state as a plain object for persistence. */
+    serialize(): IClockState;
+    /**
+     * Restore a Clock from a previously serialised state.
+     *
+     * Callbacks must be re-supplied because functions are not serialisable.
+     * If you need the same callbacks, pass them via the optional config parameter.
+     *
+     * @param state  - Snapshot previously returned by {@link serialize}.
+     * @param config - Optional callbacks and overrides.
+     */
+    static fromState(state: IClockState, config?: Pick<IClockConfig, 'onHourChanged' | 'onDayNightChanged' | 'dayStartHour' | 'dayEndHour'>): Clock;
+}
+//# sourceMappingURL=Clock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../src/core/Clock.ts"],"names":[],"mappings":"AAqBA,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9C;AAmBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,KAAK;IAKhB;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B,oCAAoC;IACpC,OAAO,CAAC,WAAW,CAAS;IAE5B,0CAA0C;IAC1C,OAAO,CAAC,YAAY,CAAS;IAE7B,uDAAuD;IACvD,OAAO,CAAC,UAAU,CAAU;IAE5B,0DAA0D;IAC1D,OAAO,CAAC,OAAO,CAAS;IAExB,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAE/D,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAG3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAsC;IACrE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAA2B;gBAMlD,MAAM,GAAE,YAAiB;IAuCrC,mCAAmC;IACnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,6DAA6D;IAC7D,IAAI,MAAM,IAAI,MAAM,CAInB;IAED,qCAAqC;IACrC,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,8CAA8C;IAC9C,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,uEAAuE;IACvE,IAAI,KAAK,IAAI,OAAO,CAGnB;IAED,mDAAmD;IACnD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wCAAwC;IACxC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,oEAAoE;IACpE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA0B7B,2EAA2E;IAC3E,KAAK,IAAI,IAAI;IAIb,iDAAiD;IACjD,MAAM,IAAI,IAAI;IAQd;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI;IAsB/C,yEAAyE;IACzE,SAAS,IAAI,WAAW;IAQxB;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CACd,KAAK,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,mBAAmB,GAAG,cAAc,GAAG,YAAY,CAAC,GACjG,KAAK;CAiBT"}

package/dist/core/Clock.js

@@ -0,0 +1,228 @@
+// core/Clock.ts
+// Framework-agnostic game time manager — accelerated day/night cycle.
+//
+// Responsibilities:
+//   - Advance an in-game clock decoupled from wall-clock time via a
+//     configurable timeFactor (e.g. 10 = 10 game-seconds per real-second).
+//   - Wrap at 24h and expose human-readable helpers (hour, minute, isDay).
+//   - Invoke optional callbacks on hour boundaries and day/night transitions,
+//     keeping Clock decoupled from any specific EventBus implementation.
+//
+// Design notes:
+//   - All time arithmetic uses seconds (not milliseconds) to avoid large
+//     intermediate values and keep the math readable.
+//   - Day boundary detection uses a cached previousHour comparison —
+//     no string formatting on the hot path.
+//   - Zero external dependencies.
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SECONDS_PER_MINUTE = 60;
+const SECONDS_PER_HOUR = 3600;
+const SECONDS_PER_DAY = 86400;
+const DEFAULT_DAY_START_HOUR = 6;
+const DEFAULT_DAY_END_HOUR = 21;
+const DEFAULT_TIME_FACTOR = 10;
+const DEFAULT_START_HOUR = 8;
+const DEFAULT_START_DAY = 1;
+// ---------------------------------------------------------------------------
+// Clock
+// ---------------------------------------------------------------------------
+/**
+ * Accelerated in-game clock with day/night cycle detection.
+ *
+ * Framework-agnostic: no dependency on Phaser, EventBus, or any renderer.
+ * Transition notifications are delivered via optional callback functions
+ * supplied at construction time.
+ *
+ * @example
+ * ```ts
+ * const clock = new Clock({
+ *   timeFactor: 10,
+ *   startHour: 8,
+ *   onHourChanged: (h, d) => console.log(`Day ${d}, ${h}:00`),
+ *   onDayNightChanged: (day) => console.log(day ? 'Dawn' : 'Dusk'),
+ * });
+ *
+ * // Each frame:
+ * clock.update(deltaMs);
+ *
+ * console.log(clock.hour);    // 8
+ * console.log(clock.isDay);   // true
+ * ```
+ */
+export class Clock {
+    // ---------------------------------------------------------------------------
+    // Construction
+    // ---------------------------------------------------------------------------
+    constructor(config = {}) {
+        /** When true, update() is a no-op — time stands still. */
+        this._paused = false;
+        /** First hour of daytime (inclusive). */
+        this.dayStartHour = DEFAULT_DAY_START_HOUR;
+        /** Last hour of daytime (exclusive). */
+        this.dayEndHour = DEFAULT_DAY_END_HOUR;
+        const { timeFactor = DEFAULT_TIME_FACTOR, startHour = DEFAULT_START_HOUR, startDay = DEFAULT_START_DAY, dayStartHour = DEFAULT_DAY_START_HOUR, dayEndHour = DEFAULT_DAY_END_HOUR, onHourChanged, onDayNightChanged, } = config;
+        if (timeFactor <= 0) {
+            throw new RangeError(`Clock: timeFactor must be > 0, got ${timeFactor}`);
+        }
+        if (startHour < 0 || startHour > 23) {
+            throw new RangeError(`Clock: startHour must be 0-23, got ${startHour}`);
+        }
+        if (startDay < 1) {
+            throw new RangeError(`Clock: startDay must be >= 1, got ${startDay}`);
+        }
+        this._timeFactor = timeFactor;
+        this.dayStartHour = dayStartHour;
+        this.dayEndHour = dayEndHour;
+        this.onHourChanged = onHourChanged;
+        this.onDayNightChanged = onDayNightChanged;
+        // Convert start parameters to total game-seconds.
+        this.gameSeconds = (startDay - 1) * SECONDS_PER_DAY + startHour * SECONDS_PER_HOUR;
+        // Initialize boundary-detection caches.
+        this.previousHour = this.hour;
+        this.wasDaytime = this.isDay;
+    }
+    // ---------------------------------------------------------------------------
+    // Readonly properties
+    // ---------------------------------------------------------------------------
+    /** Current in-game hour (0-23). */
+    get hour() {
+        return Math.floor((this.gameSeconds % SECONDS_PER_DAY) / SECONDS_PER_HOUR);
+    }
+    /** Current in-game minute within the current hour (0-59). */
+    get minute() {
+        return Math.floor((this.gameSeconds % SECONDS_PER_HOUR) / SECONDS_PER_MINUTE);
+    }
+    /** Current in-game day (1-based). */
+    get day() {
+        return Math.floor(this.gameSeconds / SECONDS_PER_DAY) + 1;
+    }
+    /** Total elapsed game-seconds since epoch. */
+    get totalGameSeconds() {
+        return this.gameSeconds;
+    }
+    /** True during daytime hours (configurable, default 06:00 - 20:59). */
+    get isDay() {
+        const h = this.hour;
+        return h >= this.dayStartHour && h < this.dayEndHour;
+    }
+    /** True during nighttime hours (21:00 - 05:59). */
+    get isNight() {
+        return !this.isDay;
+    }
+    /** Current time acceleration factor. */
+    get timeFactor() {
+        return this._timeFactor;
+    }
+    /** `true` when the clock is paused — `update()` becomes a no-op. */
+    get isPaused() {
+        return this._paused;
+    }
+    // ---------------------------------------------------------------------------
+    // Frame update
+    // ---------------------------------------------------------------------------
+    /**
+     * Advance the in-game clock by `deltaMs` real milliseconds multiplied by
+     * the time factor. Call once per frame.
+     *
+     * Detects hour boundaries and day/night transitions, invoking the
+     * corresponding callbacks when they occur.
+     *
+     * @param deltaMs - Real milliseconds elapsed since the previous frame.
+     */
+    update(deltaMs) {
+        if (this._paused)
+            return;
+        // Convert real ms to game-seconds and advance.
+        this.gameSeconds += (deltaMs / 1000) * this._timeFactor;
+        const currentHour = this.hour;
+        // --- Hour boundary ---
+        if (currentHour !== this.previousHour) {
+            this.previousHour = currentHour;
+            this.onHourChanged?.(currentHour, this.day);
+        }
+        // --- Day/night transition (inline to avoid recomputing hour via isDay getter) ---
+        const nowIsDay = currentHour >= this.dayStartHour && currentHour < this.dayEndHour;
+        if (nowIsDay !== this.wasDaytime) {
+            this.wasDaytime = nowIsDay;
+            this.onDayNightChanged?.(nowIsDay);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Pause / Resume
+    // ---------------------------------------------------------------------------
+    /** Freeze time — `update()` becomes a no-op until `resume()` is called. */
+    pause() {
+        this._paused = true;
+    }
+    /** Resume time advancement after a `pause()`. */
+    resume() {
+        this._paused = false;
+    }
+    // ---------------------------------------------------------------------------
+    // Manual override
+    // ---------------------------------------------------------------------------
+    /**
+     * Set the in-game time to an exact hour (and optionally minute) on the
+     * current day. Does not fire transition callbacks — the next `update()`
+     * call will detect and emit any resulting transitions naturally.
+     *
+     * @param hour   - Target hour (0-23).
+     * @param minute - Target minute (0-59). Default: 0.
+     */
+    setTime(hour, minute = 0) {
+        if (hour < 0 || hour > 23) {
+            throw new RangeError(`Clock.setTime: hour must be 0-23, got ${hour}`);
+        }
+        if (minute < 0 || minute > 59) {
+            throw new RangeError(`Clock.setTime: minute must be 0-59, got ${minute}`);
+        }
+        // Preserve the current day, replace only the time-of-day portion.
+        const dayOffset = (this.day - 1) * SECONDS_PER_DAY;
+        this.gameSeconds = dayOffset + hour * SECONDS_PER_HOUR + minute * SECONDS_PER_MINUTE;
+        // Update caches so the next update() doesn't spuriously fire events
+        // for the transition we just caused.
+        this.previousHour = this.hour;
+        this.wasDaytime = this.isDay;
+    }
+    // ---------------------------------------------------------------------------
+    // Serialisation
+    // ---------------------------------------------------------------------------
+    /** Capture the current clock state as a plain object for persistence. */
+    serialize() {
+        return {
+            totalGameSeconds: this.gameSeconds,
+            timeFactor: this._timeFactor,
+            paused: this._paused || undefined,
+        };
+    }
+    /**
+     * Restore a Clock from a previously serialised state.
+     *
+     * Callbacks must be re-supplied because functions are not serialisable.
+     * If you need the same callbacks, pass them via the optional config parameter.
+     *
+     * @param state  - Snapshot previously returned by {@link serialize}.
+     * @param config - Optional callbacks and overrides.
+     */
+    static fromState(state, config) {
+        const clock = new Clock({
+            timeFactor: state.timeFactor,
+            startHour: 0,
+            startDay: 1,
+            ...config,
+        });
+        // Override the computed gameSeconds with the saved value.
+        if (!Number.isFinite(state.totalGameSeconds) || state.totalGameSeconds < 0) {
+            throw new Error(`Clock.fromState: invalid totalGameSeconds (${state.totalGameSeconds})`);
+        }
+        clock.gameSeconds = state.totalGameSeconds;
+        clock.previousHour = clock.hour;
+        clock.wasDaytime = clock.isDay;
+        if (state.paused)
+            clock._paused = true;
+        return clock;
+    }
+}
+//# sourceMappingURL=Clock.js.map

package/dist/core/Clock.js.map

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

package/dist/core/DevToolsInspector.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Configuration for the DevTools inspector snapshot.
+ */
+export interface IDevToolsConfig {
+    /** Include per-plugin inspection data. Default: true. */
+    readonly includePlugins?: boolean;
+    /** Include spatial grid statistics. Default: true. */
+    readonly includeSpatialGrid?: boolean;
+    /** Include port registry info. Default: true. */
+    readonly includePorts?: boolean;
+}
+/**
+ * Runtime snapshot of the kernel state for developer tooling.
+ *
+ * Returned by `kernel.inspect()`. Designed for overlay UIs, debug panels,
+ * or automated monitoring.
+ *
+ * @example
+ * ```ts
+ * const snapshot = kernel.inspect();
+ * console.log(`Tick: ${snapshot.tick}, Clock: ${snapshot.clock.gameHour}`);
+ * for (const [name, data] of Object.entries(snapshot.plugins ?? {})) {
+ *   console.log(`  ${name}:`, data);
+ * }
+ * ```
+ */
+export interface IDevToolsSnapshot {
+    /** Current simulation tick. */
+    readonly tick: number;
+    /** Whether the kernel is running. */
+    readonly running: boolean;
+    /** Whether the kernel is paused. */
+    readonly paused: boolean;
+    /** Clock state. */
+    readonly clock: {
+        readonly gameHour: number;
+        readonly isDay: boolean;
+        readonly elapsedMs: number;
+    };
+    /** Spatial grid stats (when includeSpatialGrid is true). */
+    readonly spatialGrid?: {
+        readonly entityCount: number;
+        readonly cellSize: number;
+    };
+    /** Registered port IDs (when includePorts is true). */
+    readonly ports?: readonly string[];
+    /** Installed plugin names in dependency order. */
+    readonly pluginNames: readonly string[];
+    /** Per-plugin inspection data (when includePlugins is true). */
+    readonly plugins?: Readonly<Record<string, Record<string, unknown>>>;
+}
+export declare const DEFAULT_DEVTOOLS_CONFIG: IDevToolsConfig;
+//# sourceMappingURL=DevToolsInspector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsInspector.d.ts","sourceRoot":"","sources":["../../src/core/DevToolsInspector.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,iDAAiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACtE;AAED,eAAO,MAAM,uBAAuB,EAAE,eAIrC,CAAC"}

package/dist/core/DevToolsInspector.js

@@ -0,0 +1,8 @@
+// core/DevToolsInspector.ts
+// Types for runtime inspection and developer tooling.
+export const DEFAULT_DEVTOOLS_CONFIG = {
+    includePlugins: true,
+    includeSpatialGrid: true,
+    includePorts: true,
+};
+//# sourceMappingURL=DevToolsInspector.js.map

package/dist/core/DevToolsInspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsInspector.js","sourceRoot":"","sources":["../../src/core/DevToolsInspector.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,sDAAsD;AAuDtD,MAAM,CAAC,MAAM,uBAAuB,GAAoB;IACtD,cAAc,EAAE,IAAI;IACpB,kBAAkB,EAAE,IAAI;IACxB,YAAY,EAAE,IAAI;CACnB,CAAC"}

package/dist/core/Diagnostics.d.ts

@@ -0,0 +1,64 @@
+export type DiagnosticSeverity = 'error' | 'warning' | 'info';
+/** A single diagnostic message produced during kernel validation. */
+export interface IDiagnostic {
+    /** How severe the problem is. Errors block init; warnings and infos do not. */
+    readonly severity: DiagnosticSeverity;
+    /** Origin of the diagnostic: `'kernel'`, a plugin name, or `'config'`. */
+    readonly source: string;
+    /** Dot-separated path to the problematic value (e.g. `'ports.pathfinder'`). */
+    readonly path: string;
+    /** Human-readable explanation of the problem. */
+    readonly message: string;
+    /** Optional suggestion for how to fix it (e.g. `'Did you mean "bandits"?'`). */
+    readonly hint?: string;
+}
+/**
+ * Thrown by {@link DiagnosticsCollector.throwIfErrors} when at least one
+ * diagnostic with severity `'error'` has been collected.
+ */
+export declare class ALifeValidationError extends Error {
+    readonly diagnostics: readonly IDiagnostic[];
+    constructor(diagnostics: readonly IDiagnostic[]);
+}
+/**
+ * Accumulates diagnostics during kernel initialization.
+ *
+ * After all validation passes complete, call {@link throwIfErrors} to
+ * either let execution continue (no errors) or throw a single
+ * {@link ALifeValidationError} containing every collected problem.
+ *
+ * @example
+ * ```ts
+ * const diag = new DiagnosticsCollector();
+ * diag.error('kernel', 'ports.entityAdapter', 'Required port not provided');
+ * diag.warning('surge', 'config.surge.durationMs', 'Duration seems too short');
+ * diag.throwIfErrors(); // throws ALifeValidationError
+ * ```
+ */
+export declare class DiagnosticsCollector {
+    private readonly items;
+    /** Add a raw diagnostic entry. */
+    add(diagnostic: IDiagnostic): void;
+    /** Shorthand: add an error diagnostic. */
+    error(source: string, path: string, message: string, hint?: string): void;
+    /** Shorthand: add a warning diagnostic. */
+    warning(source: string, path: string, message: string, hint?: string): void;
+    /** Shorthand: add an informational diagnostic. */
+    info(source: string, path: string, message: string, hint?: string): void;
+    /** All error-severity diagnostics. */
+    get errors(): IDiagnostic[];
+    /** All warning-severity diagnostics. */
+    get warnings(): IDiagnostic[];
+    /** All collected diagnostics in insertion order. */
+    get all(): readonly IDiagnostic[];
+    /** `true` when at least one error-severity diagnostic exists. */
+    get hasErrors(): boolean;
+    /**
+     * Throw {@link ALifeValidationError} if any errors were collected.
+     * Safe to call when only warnings/infos are present — does nothing.
+     */
+    throwIfErrors(): void;
+    /** Format all diagnostics as a human-readable multi-line string. */
+    format(): string;
+}
+//# sourceMappingURL=Diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/Diagnostics.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,WAAW,EAAE,CAAC;gBAEjC,WAAW,EAAE,SAAS,WAAW,EAAE;CAKhD;AAMD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAE3C,kCAAkC;IAClC,GAAG,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAIlC,0CAA0C;IAC1C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIzE,2CAA2C;IAC3C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3E,kDAAkD;IAClD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIxE,sCAAsC;IACtC,IAAI,MAAM,IAAI,WAAW,EAAE,CAE1B;IAED,wCAAwC;IACxC,IAAI,QAAQ,IAAI,WAAW,EAAE,CAE5B;IAED,oDAAoD;IACpD,IAAI,GAAG,IAAI,SAAS,WAAW,EAAE,CAEhC;IAED,iEAAiE;IACjE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;OAGG;IACH,aAAa,IAAI,IAAI;IAMrB,oEAAoE;IACpE,MAAM,IAAI,MAAM;CAGjB"}

package/dist/core/Diagnostics.js

@@ -0,0 +1,107 @@
+// core/Diagnostics.ts
+// Structured error/warning collector for kernel initialization.
+//
+// Instead of throwing on the first validation failure, the kernel collects
+// all problems into a DiagnosticsCollector and returns it from init().
+// This gives developers a complete picture of what's wrong — missing ports,
+// unresolved plugin dependencies, config issues — in a single pass.
+// ---------------------------------------------------------------------------
+// Validation error
+// ---------------------------------------------------------------------------
+/**
+ * Thrown by {@link DiagnosticsCollector.throwIfErrors} when at least one
+ * diagnostic with severity `'error'` has been collected.
+ */
+export class ALifeValidationError extends Error {
+    constructor(diagnostics) {
+        super(`A-Life validation failed:\n${formatDiagnostics(diagnostics)}`);
+        this.name = 'ALifeValidationError';
+        this.diagnostics = diagnostics;
+    }
+}
+// ---------------------------------------------------------------------------
+// DiagnosticsCollector
+// ---------------------------------------------------------------------------
+/**
+ * Accumulates diagnostics during kernel initialization.
+ *
+ * After all validation passes complete, call {@link throwIfErrors} to
+ * either let execution continue (no errors) or throw a single
+ * {@link ALifeValidationError} containing every collected problem.
+ *
+ * @example
+ * ```ts
+ * const diag = new DiagnosticsCollector();
+ * diag.error('kernel', 'ports.entityAdapter', 'Required port not provided');
+ * diag.warning('surge', 'config.surge.durationMs', 'Duration seems too short');
+ * diag.throwIfErrors(); // throws ALifeValidationError
+ * ```
+ */
+export class DiagnosticsCollector {
+    constructor() {
+        this.items = [];
+    }
+    /** Add a raw diagnostic entry. */
+    add(diagnostic) {
+        this.items.push(diagnostic);
+    }
+    /** Shorthand: add an error diagnostic. */
+    error(source, path, message, hint) {
+        this.items.push({ severity: 'error', source, path, message, hint });
+    }
+    /** Shorthand: add a warning diagnostic. */
+    warning(source, path, message, hint) {
+        this.items.push({ severity: 'warning', source, path, message, hint });
+    }
+    /** Shorthand: add an informational diagnostic. */
+    info(source, path, message, hint) {
+        this.items.push({ severity: 'info', source, path, message, hint });
+    }
+    /** All error-severity diagnostics. */
+    get errors() {
+        return this.items.filter((d) => d.severity === 'error');
+    }
+    /** All warning-severity diagnostics. */
+    get warnings() {
+        return this.items.filter((d) => d.severity === 'warning');
+    }
+    /** All collected diagnostics in insertion order. */
+    get all() {
+        return this.items;
+    }
+    /** `true` when at least one error-severity diagnostic exists. */
+    get hasErrors() {
+        return this.items.some((d) => d.severity === 'error');
+    }
+    /**
+     * Throw {@link ALifeValidationError} if any errors were collected.
+     * Safe to call when only warnings/infos are present — does nothing.
+     */
+    throwIfErrors() {
+        if (this.hasErrors) {
+            throw new ALifeValidationError(this.errors);
+        }
+    }
+    /** Format all diagnostics as a human-readable multi-line string. */
+    format() {
+        return formatDiagnostics(this.items);
+    }
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+const SEVERITY_ICON = {
+    error: 'ERROR',
+    warning: 'WARN',
+    info: 'INFO',
+};
+function formatDiagnostics(diagnostics) {
+    return diagnostics
+        .map((d) => {
+        const prefix = `[${SEVERITY_ICON[d.severity]}] ${d.source} > ${d.path}`;
+        const hint = d.hint ? `\n         hint: ${d.hint}` : '';
+        return `  ${prefix}: ${d.message}${hint}`;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=Diagnostics.js.map

package/dist/core/Diagnostics.js.map

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

package/dist/core/ISerializable.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Contract for subsystems that support save/load.
+ *
+ * TState must be a plain JSON-serialisable object (no functions, Maps, Sets).
+ */
+export interface ISerializable<TState> {
+    /** Capture the current state as a plain JSON-serialisable object. */
+    serialize(): TState;
+    /** Overwrite internal state from a previously serialised snapshot. */
+    restore(state: TState): void;
+}
+//# sourceMappingURL=ISerializable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ISerializable.d.ts","sourceRoot":"","sources":["../../src/core/ISerializable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM;IACnC,qEAAqE;IACrE,SAAS,IAAI,MAAM,CAAC;IACpB,sEAAsE;IACtE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B"}

package/dist/core/ISerializable.js

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

package/dist/core/ISerializable.js.map

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