@alife-sdk/core 0.1.0

package/dist/plugins/MonstersPlugin.d.ts

@@ -0,0 +1,26 @@
+import type { IALifePlugin } from './IALifePlugin';
+import type { ALifeKernel } from '../core/ALifeKernel';
+import { MonsterRegistry } from '../registry/MonsterRegistry';
+/**
+ * Adds monster type registration to the A-Life kernel.
+ *
+ * Install this plugin when your game has monster entities (non-human hostile
+ * creatures with lair territories and special abilities).
+ *
+ * @example
+ * ```ts
+ * const alife = new ALifeKernel(ports);
+ * alife.use(new MonstersPlugin());
+ *
+ * const mp = alife.getPlugin<MonstersPlugin>('monsters');
+ * mp.monsters.register('dog', { name: 'Blind Dog', hp: 100, ... });
+ * ```
+ */
+export declare class MonstersPlugin implements IALifePlugin {
+    readonly name = "monsters";
+    readonly monsters: MonsterRegistry;
+    private kernel;
+    install(kernel: ALifeKernel): void;
+    init(): void;
+}
+//# sourceMappingURL=MonstersPlugin.d.ts.map

package/dist/plugins/MonstersPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonstersPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/MonstersPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,QAAQ,kBAAyB;IAE1C,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIlC,IAAI,IAAI,IAAI;CAIb"}

package/dist/plugins/MonstersPlugin.js

@@ -0,0 +1,30 @@
+import { MonsterRegistry } from '../registry/MonsterRegistry';
+/**
+ * Adds monster type registration to the A-Life kernel.
+ *
+ * Install this plugin when your game has monster entities (non-human hostile
+ * creatures with lair territories and special abilities).
+ *
+ * @example
+ * ```ts
+ * const alife = new ALifeKernel(ports);
+ * alife.use(new MonstersPlugin());
+ *
+ * const mp = alife.getPlugin<MonstersPlugin>('monsters');
+ * mp.monsters.register('dog', { name: 'Blind Dog', hp: 100, ... });
+ * ```
+ */
+export class MonstersPlugin {
+    constructor() {
+        this.name = 'monsters';
+        this.monsters = new MonsterRegistry();
+    }
+    install(kernel) {
+        this.kernel = kernel;
+    }
+    init() {
+        this.monsters.freeze();
+        this.kernel.logger.info('plugin', `MonstersPlugin: ${this.monsters.size} types registered`);
+    }
+}
+//# sourceMappingURL=MonstersPlugin.js.map

package/dist/plugins/MonstersPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonstersPlugin.js","sourceRoot":"","sources":["../../src/plugins/MonstersPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,cAAc;IAA3B;QACW,SAAI,GAAG,UAAU,CAAC;QAClB,aAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IAY5C,CAAC;IARC,OAAO,CAAC,MAAmB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,IAAI,CAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/dist/plugins/NPCTypesPlugin.d.ts

@@ -0,0 +1,26 @@
+import type { IALifePlugin } from './IALifePlugin';
+import type { ALifeKernel } from '../core/ALifeKernel';
+import { NPCTypeRegistry } from '../registry/NPCTypeRegistry';
+/**
+ * Owns NPC type definitions (human archetypes, ranks, equipment profiles).
+ *
+ * Install this plugin when your game spawns human NPCs with
+ * data-driven type configurations.
+ *
+ * @example
+ * ```ts
+ * const alife = new ALifeKernel(ports);
+ * alife.use(new NPCTypesPlugin());
+ *
+ * const np = alife.getPlugin<NPCTypesPlugin>('npcTypes');
+ * np.npcTypes.register('stalker', { name: 'Сталкер', hp: 100, ... });
+ * ```
+ */
+export declare class NPCTypesPlugin implements IALifePlugin {
+    readonly name = "npcTypes";
+    readonly npcTypes: NPCTypeRegistry;
+    private kernel;
+    install(kernel: ALifeKernel): void;
+    init(): void;
+}
+//# sourceMappingURL=NPCTypesPlugin.d.ts.map

package/dist/plugins/NPCTypesPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NPCTypesPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/NPCTypesPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,QAAQ,kBAAyB;IAE1C,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIlC,IAAI,IAAI,IAAI;CAIb"}

package/dist/plugins/NPCTypesPlugin.js

@@ -0,0 +1,30 @@
+import { NPCTypeRegistry } from '../registry/NPCTypeRegistry';
+/**
+ * Owns NPC type definitions (human archetypes, ranks, equipment profiles).
+ *
+ * Install this plugin when your game spawns human NPCs with
+ * data-driven type configurations.
+ *
+ * @example
+ * ```ts
+ * const alife = new ALifeKernel(ports);
+ * alife.use(new NPCTypesPlugin());
+ *
+ * const np = alife.getPlugin<NPCTypesPlugin>('npcTypes');
+ * np.npcTypes.register('stalker', { name: 'Сталкер', hp: 100, ... });
+ * ```
+ */
+export class NPCTypesPlugin {
+    constructor() {
+        this.name = 'npcTypes';
+        this.npcTypes = new NPCTypeRegistry();
+    }
+    install(kernel) {
+        this.kernel = kernel;
+    }
+    init() {
+        this.npcTypes.freeze();
+        this.kernel.logger.info('plugin', `NPCTypesPlugin: ${this.npcTypes.size} NPC types registered`);
+    }
+}
+//# sourceMappingURL=NPCTypesPlugin.js.map

package/dist/plugins/NPCTypesPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NPCTypesPlugin.js","sourceRoot":"","sources":["../../src/plugins/NPCTypesPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,cAAc;IAA3B;QACW,SAAI,GAAG,UAAU,CAAC;QAClB,aAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IAY5C,CAAC;IARC,OAAO,CAAC,MAAmB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,IAAI,CAAC,QAAQ,CAAC,IAAI,uBAAuB,CAAC,CAAC;IAClG,CAAC;CACF"}

package/dist/plugins/PluginToken.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Type-safe plugin retrieval token.
+ *
+ * Associates a plugin name string with its concrete class type,
+ * eliminating magic strings and unsafe generic casts in `getPlugin()`.
+ *
+ * @example
+ * ```ts
+ * const MY_PLUGIN = createPluginToken<MyPlugin>('myPlugin');
+ * kernel.use(new MyPlugin());
+ * const p = kernel.getPlugin(MY_PLUGIN); // typed as MyPlugin
+ * ```
+ */
+import type { IALifePlugin } from './IALifePlugin';
+export interface PluginToken<T extends IALifePlugin> {
+    readonly name: string;
+    /** @internal Phantom field for type inference — never set at runtime. */
+    readonly _phantom?: T;
+}
+/**
+ * Create a typed plugin token for use with `kernel.getPlugin()`.
+ *
+ * @param name - Plugin name string (must match `plugin.name`).
+ */
+export declare function createPluginToken<T extends IALifePlugin>(name: string): PluginToken<T>;
+//# sourceMappingURL=PluginToken.d.ts.map

package/dist/plugins/PluginToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginToken.d.ts","sourceRoot":"","sources":["../../src/plugins/PluginToken.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMnD,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,YAAY;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAEtF"}

package/dist/plugins/PluginToken.js

@@ -0,0 +1,22 @@
+/**
+ * Type-safe plugin retrieval token.
+ *
+ * Associates a plugin name string with its concrete class type,
+ * eliminating magic strings and unsafe generic casts in `getPlugin()`.
+ *
+ * @example
+ * ```ts
+ * const MY_PLUGIN = createPluginToken<MyPlugin>('myPlugin');
+ * kernel.use(new MyPlugin());
+ * const p = kernel.getPlugin(MY_PLUGIN); // typed as MyPlugin
+ * ```
+ */
+/**
+ * Create a typed plugin token for use with `kernel.getPlugin()`.
+ *
+ * @param name - Plugin name string (must match `plugin.name`).
+ */
+export function createPluginToken(name) {
+    return { name };
+}
+//# sourceMappingURL=PluginToken.js.map

package/dist/plugins/PluginToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginToken.js","sourceRoot":"","sources":["../../src/plugins/PluginToken.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAyB,IAAY;IACpE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/plugins/SocialPlugin.d.ts

@@ -0,0 +1,14 @@
+import type { IALifePlugin } from './IALifePlugin';
+import type { ALifeKernel } from '../core/ALifeKernel';
+/**
+ * Declares NPC social system support in the A-Life kernel.
+ *
+ * Phase 2 will add SocialManager, MeetBehavior, and KampSocialFSM here.
+ * Social events (`social:npc_bubble`, `social:npc_meet_player`, etc.) are
+ * already typed in ALifeEvents.
+ */
+export declare class SocialPlugin implements IALifePlugin {
+    readonly name = "social";
+    install(_kernel: ALifeKernel): void;
+}
+//# sourceMappingURL=SocialPlugin.d.ts.map

package/dist/plugins/SocialPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/SocialPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,QAAQ,CAAC,IAAI,YAAY;IAEzB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAGpC"}

package/dist/plugins/SocialPlugin.js

@@ -0,0 +1,16 @@
+/**
+ * Declares NPC social system support in the A-Life kernel.
+ *
+ * Phase 2 will add SocialManager, MeetBehavior, and KampSocialFSM here.
+ * Social events (`social:npc_bubble`, `social:npc_meet_player`, etc.) are
+ * already typed in ALifeEvents.
+ */
+export class SocialPlugin {
+    constructor() {
+        this.name = 'social';
+    }
+    install(_kernel) {
+        // Social events are already typed in ALifeEvents.
+    }
+}
+//# sourceMappingURL=SocialPlugin.js.map

package/dist/plugins/SocialPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialPlugin.js","sourceRoot":"","sources":["../../src/plugins/SocialPlugin.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IAAzB;QACW,SAAI,GAAG,QAAQ,CAAC;IAK3B,CAAC;IAHC,OAAO,CAAC,OAAoB;QAC1B,kDAAkD;IACpD,CAAC;CACF"}

package/dist/plugins/SpawnPlugin.d.ts

@@ -0,0 +1,15 @@
+import type { ALifeKernel } from '../core/ALifeKernel';
+import type { IALifePlugin } from './IALifePlugin';
+import { SpawnRegistry } from '../spawn/SpawnRegistry';
+export declare class SpawnPlugin implements IALifePlugin {
+    readonly name = "spawn";
+    readonly spawns: SpawnRegistry;
+    constructor(defaultCooldownMs?: number);
+    install(_kernel: ALifeKernel): void;
+    init(): void;
+    update(deltaMs: number): void;
+    serialize(): Record<string, unknown>;
+    restore(state: Record<string, unknown>): void;
+    destroy(): void;
+}
+//# sourceMappingURL=SpawnPlugin.d.ts.map

package/dist/plugins/SpawnPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpawnPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/SpawnPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEnB,iBAAiB,GAAE,MAAe;IAI9C,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAInC,IAAI,IAAI,IAAI;IAIZ,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIpC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI7C,OAAO,IAAI,IAAI;CAGhB"}

package/dist/plugins/SpawnPlugin.js

@@ -0,0 +1,26 @@
+import { SpawnRegistry } from '../spawn/SpawnRegistry';
+export class SpawnPlugin {
+    constructor(defaultCooldownMs = 30000) {
+        this.name = 'spawn';
+        this.spawns = new SpawnRegistry(defaultCooldownMs);
+    }
+    install(_kernel) {
+        // SpawnPlugin requires no kernel reference.
+    }
+    init() {
+        // SpawnRegistry is ready — no additional init needed.
+    }
+    update(deltaMs) {
+        this.spawns.update(deltaMs);
+    }
+    serialize() {
+        return this.spawns.serialize();
+    }
+    restore(state) {
+        this.spawns.restore(state);
+    }
+    destroy() {
+        // SpawnRegistry has no subscriptions to clean up.
+    }
+}
+//# sourceMappingURL=SpawnPlugin.js.map

package/dist/plugins/SpawnPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpawnPlugin.js","sourceRoot":"","sources":["../../src/plugins/SpawnPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,MAAM,OAAO,WAAW;IAItB,YAAY,oBAA4B,KAAM;QAHrC,SAAI,GAAG,OAAO,CAAC;QAItB,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,CAAC,OAAoB;QAC1B,4CAA4C;IAC9C,CAAC;IAED,IAAI;QACF,sDAAsD;IACxD,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAwC,CAAC;IACvE,CAAC;IAED,OAAO,CAAC,KAA8B;QACpC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAuC,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,kDAAkD;IACpD,CAAC;CACF"}

package/dist/plugins/SquadPlugin.d.ts

@@ -0,0 +1,14 @@
+import type { IALifePlugin } from './IALifePlugin';
+import type { ALifeKernel } from '../core/ALifeKernel';
+/**
+ * Declares squad system support in the A-Life kernel.
+ *
+ * Phase 2 will add SquadManager and SquadTactics here.
+ * Squad events (`squad:formed`, `squad:command_issued`, etc.) are already
+ * typed in ALifeEvents — this plugin enables their semantic use.
+ */
+export declare class SquadPlugin implements IALifePlugin {
+    readonly name = "squad";
+    install(_kernel: ALifeKernel): void;
+}
+//# sourceMappingURL=SquadPlugin.d.ts.map

package/dist/plugins/SquadPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SquadPlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/SquadPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAGpC"}

package/dist/plugins/SquadPlugin.js

@@ -0,0 +1,16 @@
+/**
+ * Declares squad system support in the A-Life kernel.
+ *
+ * Phase 2 will add SquadManager and SquadTactics here.
+ * Squad events (`squad:formed`, `squad:command_issued`, etc.) are already
+ * typed in ALifeEvents — this plugin enables their semantic use.
+ */
+export class SquadPlugin {
+    constructor() {
+        this.name = 'squad';
+    }
+    install(_kernel) {
+        // No registries. Squad events are already typed in ALifeEvents.
+    }
+}
+//# sourceMappingURL=SquadPlugin.js.map

package/dist/plugins/SquadPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SquadPlugin.js","sourceRoot":"","sources":["../../src/plugins/SquadPlugin.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IAAxB;QACW,SAAI,GAAG,OAAO,CAAC;IAK1B,CAAC;IAHC,OAAO,CAAC,OAAoB;QAC1B,gEAAgE;IAClE,CAAC;CACF"}

package/dist/plugins/SurgePlugin.d.ts

@@ -0,0 +1,20 @@
+import type { IALifePlugin } from './IALifePlugin';
+import type { ALifeKernel } from '../core/ALifeKernel';
+import type { ISurgeConfig } from '../config/ALifeConfig';
+/**
+ * Declares surge system support in the A-Life kernel.
+ *
+ * Currently provides config access for the surge subsystem.
+ * Phase 2 will add the full SurgeManager state machine here
+ * (INACTIVE → WARNING → ACTIVE → AFTERMATH).
+ *
+ * Surge events (`surge:warning`, `surge:started`, etc.) are already typed
+ * in ALifeEvents — this plugin enables their semantic use.
+ */
+export declare class SurgePlugin implements IALifePlugin {
+    readonly name = "surge";
+    private kernel;
+    install(kernel: ALifeKernel): void;
+    get config(): ISurgeConfig;
+}
+//# sourceMappingURL=SurgePlugin.d.ts.map

package/dist/plugins/SurgePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurgePlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/SurgePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;GASG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIlC,IAAI,MAAM,IAAI,YAAY,CAEzB;CACF"}

package/dist/plugins/SurgePlugin.js

@@ -0,0 +1,22 @@
+/**
+ * Declares surge system support in the A-Life kernel.
+ *
+ * Currently provides config access for the surge subsystem.
+ * Phase 2 will add the full SurgeManager state machine here
+ * (INACTIVE → WARNING → ACTIVE → AFTERMATH).
+ *
+ * Surge events (`surge:warning`, `surge:started`, etc.) are already typed
+ * in ALifeEvents — this plugin enables their semantic use.
+ */
+export class SurgePlugin {
+    constructor() {
+        this.name = 'surge';
+    }
+    install(kernel) {
+        this.kernel = kernel;
+    }
+    get config() {
+        return this.kernel.currentConfig.surge;
+    }
+}
+//# sourceMappingURL=SurgePlugin.js.map

package/dist/plugins/SurgePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurgePlugin.js","sourceRoot":"","sources":["../../src/plugins/SurgePlugin.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,OAAO,WAAW;IAAxB;QACW,SAAI,GAAG,OAAO,CAAC;IAW1B,CAAC;IAPC,OAAO,CAAC,MAAmB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;IACzC,CAAC;CACF"}

package/dist/plugins/TradePlugin.d.ts

@@ -0,0 +1,16 @@
+import type { IALifePlugin } from './IALifePlugin';
+import type { ALifeKernel } from '../core/ALifeKernel';
+import type { ITradeConfig } from '../config/ALifeConfig';
+/**
+ * Declares trade system support in the A-Life kernel.
+ *
+ * Currently provides config access for the trade subsystem.
+ * Phase 2 will add TradeManager here.
+ */
+export declare class TradePlugin implements IALifePlugin {
+    readonly name = "trade";
+    private kernel;
+    install(kernel: ALifeKernel): void;
+    get config(): ITradeConfig;
+}
+//# sourceMappingURL=TradePlugin.d.ts.map

package/dist/plugins/TradePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TradePlugin.d.ts","sourceRoot":"","sources":["../../src/plugins/TradePlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIlC,IAAI,MAAM,IAAI,YAAY,CAEzB;CACF"}

package/dist/plugins/TradePlugin.js

@@ -0,0 +1,18 @@
+/**
+ * Declares trade system support in the A-Life kernel.
+ *
+ * Currently provides config access for the trade subsystem.
+ * Phase 2 will add TradeManager here.
+ */
+export class TradePlugin {
+    constructor() {
+        this.name = 'trade';
+    }
+    install(kernel) {
+        this.kernel = kernel;
+    }
+    get config() {
+        return this.kernel.currentConfig.trade;
+    }
+}
+//# sourceMappingURL=TradePlugin.js.map

package/dist/plugins/TradePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TradePlugin.js","sourceRoot":"","sources":["../../src/plugins/TradePlugin.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IAAxB;QACW,SAAI,GAAG,OAAO,CAAC;IAW1B,CAAC;IAPC,OAAO,CAAC,MAAmB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;IACzC,CAAC;CACF"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,11 @@
+export type { IALifePlugin } from './IALifePlugin';
+export { FactionsPlugin } from './FactionsPlugin';
+export { NPCTypesPlugin } from './NPCTypesPlugin';
+export { CombatSchemaPlugin } from './CombatSchemaPlugin';
+export { MonstersPlugin } from './MonstersPlugin';
+export { AnomaliesPlugin } from './AnomaliesPlugin';
+export { SpawnPlugin } from './SpawnPlugin';
+export { PluginNames, Plugins } from './pluginNames';
+export { type PluginToken, createPluginToken } from './PluginToken';
+export { fullPreset, fullStalkerPreset, minimalPreset } from './presets';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,KAAK,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,10 @@
+export { FactionsPlugin } from './FactionsPlugin';
+export { NPCTypesPlugin } from './NPCTypesPlugin';
+export { CombatSchemaPlugin } from './CombatSchemaPlugin';
+export { MonstersPlugin } from './MonstersPlugin';
+export { AnomaliesPlugin } from './AnomaliesPlugin';
+export { SpawnPlugin } from './SpawnPlugin';
+export { PluginNames, Plugins } from './pluginNames';
+export { createPluginToken } from './PluginToken';
+export { fullPreset, fullStalkerPreset, minimalPreset } from './presets';
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAoB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/plugins/pluginNames.d.ts

@@ -0,0 +1,37 @@
+import type { FactionsPlugin } from './FactionsPlugin';
+import type { NPCTypesPlugin } from './NPCTypesPlugin';
+import type { CombatSchemaPlugin } from './CombatSchemaPlugin';
+import type { SpawnPlugin } from './SpawnPlugin';
+import type { MonstersPlugin } from './MonstersPlugin';
+import type { AnomaliesPlugin } from './AnomaliesPlugin';
+import type { SurgePlugin } from './SurgePlugin';
+import type { SquadPlugin } from './SquadPlugin';
+import type { SocialPlugin } from './SocialPlugin';
+import type { TradePlugin } from './TradePlugin';
+/** Well-known plugin name constants to avoid magic strings in `getPlugin()`. */
+export declare const PluginNames: {
+    readonly FACTIONS: "factions";
+    readonly NPC_TYPES: "npcTypes";
+    readonly COMBAT_SCHEMA: "combatSchema";
+    readonly SPAWN: "spawn";
+    readonly MONSTERS: "monsters";
+    readonly ANOMALIES: "anomalies";
+    readonly SURGE: "surge";
+    readonly SQUAD: "squad";
+    readonly SOCIAL: "social";
+    readonly TRADE: "trade";
+};
+/** Type-safe plugin tokens for use with `kernel.getPlugin()`. */
+export declare const Plugins: {
+    readonly FACTIONS: import("./PluginToken").PluginToken<FactionsPlugin>;
+    readonly NPC_TYPES: import("./PluginToken").PluginToken<NPCTypesPlugin>;
+    readonly COMBAT_SCHEMA: import("./PluginToken").PluginToken<CombatSchemaPlugin>;
+    readonly SPAWN: import("./PluginToken").PluginToken<SpawnPlugin>;
+    readonly MONSTERS: import("./PluginToken").PluginToken<MonstersPlugin>;
+    readonly ANOMALIES: import("./PluginToken").PluginToken<AnomaliesPlugin>;
+    readonly SURGE: import("./PluginToken").PluginToken<SurgePlugin>;
+    readonly SQUAD: import("./PluginToken").PluginToken<SquadPlugin>;
+    readonly SOCIAL: import("./PluginToken").PluginToken<SocialPlugin>;
+    readonly TRADE: import("./PluginToken").PluginToken<TradePlugin>;
+};
+//# sourceMappingURL=pluginNames.d.ts.map

package/dist/plugins/pluginNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginNames.d.ts","sourceRoot":"","sources":["../../src/plugins/pluginNames.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,gFAAgF;AAChF,eAAO,MAAM,WAAW;;;;;;;;;;;CAWd,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,OAAO;;;;;;;;;;;CAWV,CAAC"}

package/dist/plugins/pluginNames.js

@@ -0,0 +1,28 @@
+import { createPluginToken } from './PluginToken';
+/** Well-known plugin name constants to avoid magic strings in `getPlugin()`. */
+export const PluginNames = {
+    FACTIONS: 'factions',
+    NPC_TYPES: 'npcTypes',
+    COMBAT_SCHEMA: 'combatSchema',
+    SPAWN: 'spawn',
+    MONSTERS: 'monsters',
+    ANOMALIES: 'anomalies',
+    SURGE: 'surge',
+    SQUAD: 'squad',
+    SOCIAL: 'social',
+    TRADE: 'trade',
+};
+/** Type-safe plugin tokens for use with `kernel.getPlugin()`. */
+export const Plugins = {
+    FACTIONS: createPluginToken(PluginNames.FACTIONS),
+    NPC_TYPES: createPluginToken(PluginNames.NPC_TYPES),
+    COMBAT_SCHEMA: createPluginToken(PluginNames.COMBAT_SCHEMA),
+    SPAWN: createPluginToken(PluginNames.SPAWN),
+    MONSTERS: createPluginToken(PluginNames.MONSTERS),
+    ANOMALIES: createPluginToken(PluginNames.ANOMALIES),
+    SURGE: createPluginToken(PluginNames.SURGE),
+    SQUAD: createPluginToken(PluginNames.SQUAD),
+    SOCIAL: createPluginToken(PluginNames.SOCIAL),
+    TRADE: createPluginToken(PluginNames.TRADE),
+};
+//# sourceMappingURL=pluginNames.js.map

package/dist/plugins/pluginNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginNames.js","sourceRoot":"","sources":["../../src/plugins/pluginNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAYlD,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,UAAU;IACrB,aAAa,EAAE,cAAc;IAC7B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACN,CAAC;AAEX,iEAAiE;AACjE,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,QAAQ,EAAE,iBAAiB,CAAiB,WAAW,CAAC,QAAQ,CAAC;IACjE,SAAS,EAAE,iBAAiB,CAAiB,WAAW,CAAC,SAAS,CAAC;IACnE,aAAa,EAAE,iBAAiB,CAAqB,WAAW,CAAC,aAAa,CAAC;IAC/E,KAAK,EAAE,iBAAiB,CAAc,WAAW,CAAC,KAAK,CAAC;IACxD,QAAQ,EAAE,iBAAiB,CAAiB,WAAW,CAAC,QAAQ,CAAC;IACjE,SAAS,EAAE,iBAAiB,CAAkB,WAAW,CAAC,SAAS,CAAC;IACpE,KAAK,EAAE,iBAAiB,CAAc,WAAW,CAAC,KAAK,CAAC;IACxD,KAAK,EAAE,iBAAiB,CAAc,WAAW,CAAC,KAAK,CAAC;IACxD,MAAM,EAAE,iBAAiB,CAAe,WAAW,CAAC,MAAM,CAAC;IAC3D,KAAK,EAAE,iBAAiB,CAAc,WAAW,CAAC,KAAK,CAAC;CAChD,CAAC"}

package/dist/plugins/presets.d.ts

@@ -0,0 +1,31 @@
+import type { ALifeKernel } from '../core/ALifeKernel';
+/**
+ * Install all built-in plugins for a full simulation:
+ * factions, NPC types, combat schemas, monsters, anomalies, and spawn.
+ *
+ * Stub plugins (Surge, Squad, Social, Trade) are not included until
+ * they have real implementations. Re-add them via `kernel.use()` as needed.
+ *
+ * @example
+ * ```ts
+ * const alife = new ALifeKernel(ports);
+ * fullPreset(alife);
+ * alife.init();
+ * ```
+ */
+export declare function fullPreset(kernel: ALifeKernel): ALifeKernel;
+/** @deprecated Use {@link fullPreset} instead. Will be removed in v0.2.0. */
+export declare const fullStalkerPreset: typeof fullPreset;
+/**
+ * Minimal preset: human NPCs and factions only.
+ * No monsters, anomalies, or surge.
+ *
+ * @example
+ * ```ts
+ * const alife = new ALifeKernel(ports);
+ * minimalPreset(alife);
+ * alife.init();
+ * ```
+ */
+export declare function minimalPreset(kernel: ALifeKernel): ALifeKernel;
+//# sourceMappingURL=presets.d.ts.map

package/dist/plugins/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/plugins/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAQ3D;AAED,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,mBAAa,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAM9D"}

package/dist/plugins/presets.js

@@ -0,0 +1,50 @@
+import { FactionsPlugin } from './FactionsPlugin';
+import { NPCTypesPlugin } from './NPCTypesPlugin';
+import { CombatSchemaPlugin } from './CombatSchemaPlugin';
+import { MonstersPlugin } from './MonstersPlugin';
+import { AnomaliesPlugin } from './AnomaliesPlugin';
+import { SpawnPlugin } from './SpawnPlugin';
+/**
+ * Install all built-in plugins for a full simulation:
+ * factions, NPC types, combat schemas, monsters, anomalies, and spawn.
+ *
+ * Stub plugins (Surge, Squad, Social, Trade) are not included until
+ * they have real implementations. Re-add them via `kernel.use()` as needed.
+ *
+ * @example
+ * ```ts
+ * const alife = new ALifeKernel(ports);
+ * fullPreset(alife);
+ * alife.init();
+ * ```
+ */
+export function fullPreset(kernel) {
+    return kernel
+        .use(new FactionsPlugin())
+        .use(new NPCTypesPlugin())
+        .use(new CombatSchemaPlugin())
+        .use(new SpawnPlugin())
+        .use(new MonstersPlugin())
+        .use(new AnomaliesPlugin());
+}
+/** @deprecated Use {@link fullPreset} instead. Will be removed in v0.2.0. */
+export const fullStalkerPreset = fullPreset;
+/**
+ * Minimal preset: human NPCs and factions only.
+ * No monsters, anomalies, or surge.
+ *
+ * @example
+ * ```ts
+ * const alife = new ALifeKernel(ports);
+ * minimalPreset(alife);
+ * alife.init();
+ * ```
+ */
+export function minimalPreset(kernel) {
+    return kernel
+        .use(new FactionsPlugin())
+        .use(new NPCTypesPlugin())
+        .use(new CombatSchemaPlugin())
+        .use(new SpawnPlugin());
+}
+//# sourceMappingURL=presets.js.map

package/dist/plugins/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/plugins/presets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,OAAO,MAAM;SACV,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;SACzB,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;SACzB,GAAG,CAAC,IAAI,kBAAkB,EAAE,CAAC;SAC7B,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC;SACtB,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;SACzB,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC/C,OAAO,MAAM;SACV,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;SACzB,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;SACzB,GAAG,CAAC,IAAI,kBAAkB,EAAE,CAAC;SAC7B,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;AAC5B,CAAC"}