@alife-sdk/core 0.1.0

package/dist/registry/AnomalyTypeRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnomalyTypeRegistry.js","sourceRoot":"","sources":["../../src/registry/AnomalyTypeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkBtC,SAAS,QAAQ,CAAC,CAAyB;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,CAAC,eAAe,IAAI,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACvE,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrD,IAAI,CAAC,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,CAAC,cAAc,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClG,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wGAAwG;AACxG,MAAM,OAAO,mBAAoB,SAAQ,QAAwC;IAC/E;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/registry/BehaviorSchemeRegistry.d.ts

@@ -0,0 +1,21 @@
+import { Registry } from './Registry';
+/** Definition of an NPC behavior scheme used by the terrain behavior engine. */
+export interface IBehaviorSchemeDefinition {
+    /** Human-readable display name. */
+    readonly name: string;
+    /** True if the NPC stays at a fixed position (e.g. camp, sleep). */
+    readonly isStationary: boolean;
+    /** True if the scheme needs a patrol route to operate. */
+    readonly requiresRoute: boolean;
+    /** Restrict to nighttime hours only. Cannot combine with dayOnly. */
+    readonly nightOnly: boolean;
+    /** Restrict to daytime hours only. Cannot combine with nightOnly. */
+    readonly dayOnly: boolean;
+}
+/** Registry of behavior schemes. Validates mutual exclusion of nightOnly/dayOnly. Call registerDefaults() for the 6 built-in schemes. */
+export declare class BehaviorSchemeRegistry extends Registry<string, IBehaviorSchemeDefinition> {
+    constructor();
+    /** Register the 6 built-in behavior schemes (guard, patrol, camp, sleep, camper, wander). Returns `this` for chaining. */
+    registerDefaults(): this;
+}
+//# sourceMappingURL=BehaviorSchemeRegistry.d.ts.map

package/dist/registry/BehaviorSchemeRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviorSchemeRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/BehaviorSchemeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAQD,yIAAyI;AACzI,qBAAa,sBAAuB,SAAQ,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;;IAKrF,0HAA0H;IAC1H,gBAAgB,IAAI,IAAI;CASzB"}

package/dist/registry/BehaviorSchemeRegistry.js

@@ -0,0 +1,24 @@
+import { Registry } from './Registry';
+function validate(c) {
+    const errors = [];
+    if (c.nightOnly && c.dayOnly)
+        errors.push('cannot be both nightOnly and dayOnly');
+    return errors;
+}
+/** Registry of behavior schemes. Validates mutual exclusion of nightOnly/dayOnly. Call registerDefaults() for the 6 built-in schemes. */
+export class BehaviorSchemeRegistry extends Registry {
+    constructor() {
+        super({ name: 'BehaviorSchemeRegistry', validate });
+    }
+    /** Register the 6 built-in behavior schemes (guard, patrol, camp, sleep, camper, wander). Returns `this` for chaining. */
+    registerDefaults() {
+        return this
+            .register('guard', { name: 'Guard', isStationary: false, requiresRoute: false, nightOnly: false, dayOnly: false })
+            .register('patrol', { name: 'Patrol', isStationary: false, requiresRoute: true, nightOnly: false, dayOnly: false })
+            .register('camp', { name: 'Camp', isStationary: true, requiresRoute: false, nightOnly: false, dayOnly: false })
+            .register('sleep', { name: 'Sleep', isStationary: true, requiresRoute: false, nightOnly: true, dayOnly: false })
+            .register('camper', { name: 'Camper', isStationary: true, requiresRoute: false, nightOnly: false, dayOnly: false })
+            .register('wander', { name: 'Wander', isStationary: false, requiresRoute: false, nightOnly: false, dayOnly: false });
+    }
+}
+//# sourceMappingURL=BehaviorSchemeRegistry.js.map

package/dist/registry/BehaviorSchemeRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviorSchemeRegistry.js","sourceRoot":"","sources":["../../src/registry/BehaviorSchemeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgBtC,SAAS,QAAQ,CAAC,CAA4B;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAClF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yIAAyI;AACzI,MAAM,OAAO,sBAAuB,SAAQ,QAA2C;IACrF;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,0HAA0H;IAC1H,gBAAgB;QACd,OAAO,IAAI;aACR,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aACjH,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aAClH,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aAC9G,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aAC/G,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aAClH,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACzH,CAAC;CACF"}

package/dist/registry/DamageTypeRegistry.d.ts

@@ -0,0 +1,17 @@
+import { Registry } from './Registry';
+/** Definition of a damage type (e.g. 'physical', 'fire', 'psi'). */
+export interface IDamageTypeDefinition {
+    /** Human-readable display name. */
+    readonly name: string;
+    /** Base resistance applied when a faction has no explicit override [0, 1]. */
+    readonly defaultImmunity: number;
+    /** Morale delta applied when an NPC takes damage of this type. Negative = demoralising. */
+    readonly moraleImpact: number;
+}
+/** Registry of damage types. Validates defaultImmunity [0, 1]. Call registerDefaults() for the standard 5 types. */
+export declare class DamageTypeRegistry extends Registry<string, IDamageTypeDefinition> {
+    constructor();
+    /** Register the 5 built-in damage types (physical, fire, radiation, chemical, psi). Returns `this` for chaining. */
+    registerDefaults(): this;
+}
+//# sourceMappingURL=DamageTypeRegistry.d.ts.map

package/dist/registry/DamageTypeRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DamageTypeRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/DamageTypeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,oEAAoE;AACpE,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAUD,oHAAoH;AACpH,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;;IAK7E,oHAAoH;IACpH,gBAAgB,IAAI,IAAI;CAQzB"}

package/dist/registry/DamageTypeRegistry.js

@@ -0,0 +1,24 @@
+import { Registry } from './Registry';
+function validate(c) {
+    const errors = [];
+    if (c.defaultImmunity < 0 || c.defaultImmunity > 1) {
+        errors.push('defaultImmunity must be in [0, 1]');
+    }
+    return errors;
+}
+/** Registry of damage types. Validates defaultImmunity [0, 1]. Call registerDefaults() for the standard 5 types. */
+export class DamageTypeRegistry extends Registry {
+    constructor() {
+        super({ name: 'DamageTypeRegistry', validate });
+    }
+    /** Register the 5 built-in damage types (physical, fire, radiation, chemical, psi). Returns `this` for chaining. */
+    registerDefaults() {
+        return this
+            .register('physical', { name: 'Physical', defaultImmunity: 0, moraleImpact: -0.15 })
+            .register('fire', { name: 'Fire', defaultImmunity: 0, moraleImpact: -0.2 })
+            .register('radiation', { name: 'Radiation', defaultImmunity: 0, moraleImpact: -0.1 })
+            .register('chemical', { name: 'Chemical', defaultImmunity: 0, moraleImpact: -0.1 })
+            .register('psi', { name: 'PSI', defaultImmunity: 0, moraleImpact: -0.25 });
+    }
+}
+//# sourceMappingURL=DamageTypeRegistry.js.map

package/dist/registry/DamageTypeRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DamageTypeRegistry.js","sourceRoot":"","sources":["../../src/registry/DamageTypeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAYtC,SAAS,QAAQ,CAAC,CAAwB;IACxC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oHAAoH;AACpH,MAAM,OAAO,kBAAmB,SAAQ,QAAuC;IAC7E;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,oHAAoH;IACpH,gBAAgB;QACd,OAAO,IAAI;aACR,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC;aACnF,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC;aAC1E,QAAQ,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC;aACpF,QAAQ,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,EAAE,CAAC;aAClF,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/dist/registry/FactionRegistry.d.ts

@@ -0,0 +1,41 @@
+import { Registry } from './Registry';
+/** Loadout preferences that influence offline weapon/armor selection for faction NPCs. */
+export interface IEquipmentPreference {
+    /** Preferred weapon type string (e.g. 'rifle', 'shotgun'). */
+    readonly preferredWeapon: string;
+    /** Preferred armor tier string. */
+    readonly preferredArmor: string;
+    /** Tendency toward offensive behavior [0, 1]. Higher = more likely to PATROL/ATTACK. */
+    readonly aggressiveness: number;
+    /** Tendency toward defensive behavior [0, 1]. Higher = more likely to CAMP/GUARD. */
+    readonly cautiousness: number;
+}
+/** Controls how the spawn system maintains faction population balance. */
+export interface IFactionSpawnRules {
+    /** Target fraction of total NPC population for this faction [0, 1]. */
+    readonly targetRatio: number;
+    /** Allowed deviation from targetRatio before the balancer intervenes [0, 1]. */
+    readonly balanceTolerance: number;
+}
+/** Complete definition of a faction for registration in FactionRegistry. */
+export interface IFactionDefinition {
+    /** Human-readable display name. */
+    readonly name: string;
+    /** Immutable starting relations to other factions. Key = factionId, value = [-100, 100]. */
+    readonly baseRelations: Readonly<Record<string, number>>;
+    /** Base resistance per damage type. Key = damageTypeId, value = [0, 1] (0 = none, 1 = immune). */
+    readonly immunities: Readonly<Record<string, number>>;
+    /** Default loadout preferences for NPCs of this faction. */
+    readonly defaultEquipment: Partial<IEquipmentPreference>;
+    /** Population balance parameters. */
+    readonly spawnRules: IFactionSpawnRules;
+    /** Arbitrary extension data (e.g. UI color, description). */
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/** Type-safe registry of faction definitions. Validates relations [-100, 100] and immunities [0, 1] on register(). */
+export declare class FactionRegistry extends Registry<string, IFactionDefinition> {
+    constructor();
+    /** @override Adds self-relation guard on top of base validation. */
+    register(id: string, config: IFactionDefinition): this;
+}
+//# sourceMappingURL=FactionRegistry.d.ts.map

package/dist/registry/FactionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactionRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/FactionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mCAAmC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,wFAAwF;IACxF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,qFAAqF;IACrF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,kGAAkG;IAClG,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzD,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAcD,sHAAsH;AACtH,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;;IAKvE,oEAAoE;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;CAMhE"}

package/dist/registry/FactionRegistry.js

@@ -0,0 +1,29 @@
+import { Registry } from './Registry';
+function validate(c) {
+    const errors = [];
+    if (!c.name)
+        errors.push('name must not be empty');
+    for (const [id, v] of Object.entries(c.baseRelations)) {
+        if (v < -100 || v > 100)
+            errors.push(`relation "${id}" must be in [-100, 100]`);
+    }
+    for (const [id, v] of Object.entries(c.immunities)) {
+        if (v < 0 || v > 1)
+            errors.push(`immunity "${id}" must be in [0, 1]`);
+    }
+    return errors;
+}
+/** Type-safe registry of faction definitions. Validates relations [-100, 100] and immunities [0, 1] on register(). */
+export class FactionRegistry extends Registry {
+    constructor() {
+        super({ name: 'FactionRegistry', validate });
+    }
+    /** @override Adds self-relation guard on top of base validation. */
+    register(id, config) {
+        if (id in config.baseRelations) {
+            throw new Error(`[FactionRegistry] Faction "${id}" cannot define a relation to itself`);
+        }
+        return super.register(id, config);
+    }
+}
+//# sourceMappingURL=FactionRegistry.js.map

package/dist/registry/FactionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactionRegistry.js","sourceRoot":"","sources":["../../src/registry/FactionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAsCtC,SAAS,QAAQ,CAAC,CAAqB;IACrC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,CAAC,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACnD,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;IAClF,CAAC;IACD,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sHAAsH;AACtH,MAAM,OAAO,eAAgB,SAAQ,QAAoC;IACvE;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,oEAAoE;IAC3D,QAAQ,CAAC,EAAU,EAAE,MAA0B;QACtD,IAAI,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,sCAAsC,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/registry/MonsterRegistry.d.ts

@@ -0,0 +1,44 @@
+import { Registry } from './Registry';
+/** Blueprint for a monster archetype (e.g. 'dog', 'bloodsucker', 'controller'). */
+export interface IMonsterDefinition {
+    /** Human-readable display name. */
+    readonly name: string;
+    /** Base hit points (> 0). */
+    readonly hp: number;
+    /** Movement speed (px/s, > 0). */
+    readonly speed: number;
+    /** Melee damage per hit (> 0). */
+    readonly damage: number;
+    /** Melee attack range (px, > 0). */
+    readonly attackRange: number;
+    /** Sensory detection radius (px, > 0). */
+    readonly detectionRange: number;
+    /** Field of view (degrees, (0, 360]). */
+    readonly fov: number;
+    /** Pack spawn size as [min, max] tuple. min ≥ 1, min ≤ max. */
+    readonly packSize: readonly [number, number];
+    /** Ability IDs this monster can use (e.g. 'charge', 'stalk', 'leap', 'psi_attack'). */
+    readonly abilities: readonly string[];
+    /** Three-radius lair system (px). Must satisfy: inner < patrol < outer. */
+    readonly lair: {
+        readonly inner: number;
+        readonly patrol: number;
+        readonly outer: number;
+    };
+    /** Threat tier (1–5). Affects brain decisions and terrain scoring. */
+    readonly rank: number;
+    /** Optional faction override. Defaults to 'monster' if omitted. */
+    readonly faction?: string;
+}
+/** Configuration for MonsterRegistry rank validation bounds. */
+export interface IMonsterRegistryConfig {
+    /** Minimum allowed rank value. Default: 1. */
+    readonly rankMin?: number;
+    /** Maximum allowed rank value. Default: 5. */
+    readonly rankMax?: number;
+}
+/** Type-safe registry of monster definitions. Validates lair radius ordering, pack size, and rank bounds. */
+export declare class MonsterRegistry extends Registry<string, IMonsterDefinition> {
+    constructor(config?: IMonsterRegistryConfig);
+}
+//# sourceMappingURL=MonsterRegistry.d.ts.map

package/dist/registry/MonsterRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonsterRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/MonsterRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,uFAAuF;IACvF,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3F,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAuBD,6GAA6G;AAC7G,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;gBAC3D,MAAM,CAAC,EAAE,sBAAsB;CAQ5C"}

package/dist/registry/MonsterRegistry.js

@@ -0,0 +1,43 @@
+import { Registry } from './Registry';
+const DEFAULT_RANK_MIN = 1;
+const DEFAULT_RANK_MAX = 5;
+function createValidator(rankMin, rankMax) {
+    return (c) => {
+        const errors = [];
+        if (c.hp <= 0)
+            errors.push('hp must be > 0');
+        if (c.speed <= 0)
+            errors.push('speed must be > 0');
+        if (c.damage <= 0)
+            errors.push('damage must be > 0');
+        if (c.attackRange <= 0)
+            errors.push('attackRange must be > 0');
+        if (c.detectionRange <= 0)
+            errors.push('detectionRange must be > 0');
+        if (c.fov <= 0 || c.fov > 360)
+            errors.push('fov must be in (0, 360]');
+        if (c.packSize[0] < 1)
+            errors.push('packSize min must be >= 1');
+        if (c.packSize[0] > c.packSize[1])
+            errors.push('packSize min must be <= max');
+        if (c.lair.inner >= c.lair.patrol)
+            errors.push('lair.inner must be < lair.patrol');
+        if (c.lair.patrol >= c.lair.outer)
+            errors.push('lair.patrol must be < lair.outer');
+        if (c.rank < rankMin || c.rank > rankMax)
+            errors.push(`rank must be ${rankMin}-${rankMax}`);
+        return errors;
+    };
+}
+/** Type-safe registry of monster definitions. Validates lair radius ordering, pack size, and rank bounds. */
+export class MonsterRegistry extends Registry {
+    constructor(config) {
+        const rankMin = config?.rankMin ?? DEFAULT_RANK_MIN;
+        const rankMax = config?.rankMax ?? DEFAULT_RANK_MAX;
+        if (rankMin > rankMax) {
+            throw new Error(`[MonsterRegistry] rankMin (${rankMin}) must be <= rankMax (${rankMax})`);
+        }
+        super({ name: 'MonsterRegistry', validate: createValidator(rankMin, rankMax) });
+    }
+}
+//# sourceMappingURL=MonsterRegistry.js.map

package/dist/registry/MonsterRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonsterRegistry.js","sourceRoot":"","sources":["../../src/registry/MonsterRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAsCtC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,SAAS,eAAe,CAAC,OAAe,EAAE,OAAe;IACvD,OAAO,CAAC,CAAqB,EAAY,EAAE;QACzC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACrD,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC/D,IAAI,CAAC,CAAC,cAAc,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACrE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAChE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC9E,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACnF,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACnF,IAAI,CAAC,CAAC,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,IAAI,GAAG,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;QAC5F,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,6GAA6G;AAC7G,MAAM,OAAO,eAAgB,SAAQ,QAAoC;IACvE,YAAY,MAA+B;QACzC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,gBAAgB,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,gBAAgB,CAAC;QACpD,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,yBAAyB,OAAO,GAAG,CAAC,CAAC;QAC5F,CAAC;QACD,KAAK,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;CACF"}

package/dist/registry/NPCTypeRegistry.d.ts

@@ -0,0 +1,34 @@
+import { Registry } from './Registry';
+import type { IEquipmentPreference } from './FactionRegistry';
+/** Blueprint for a humanoid NPC archetype (e.g. 'stalker_rookie', 'monolith_sniper'). */
+export interface INPCTypeDefinition {
+    /** Human-readable display name. */
+    readonly name: string;
+    /** Default faction ID. Must be registered in FactionRegistry. */
+    readonly faction: string;
+    /** Base hit points (> 0). */
+    readonly hp: number;
+    /** Movement speed (px/s, > 0). */
+    readonly speed: number;
+    /** Base damage per hit. */
+    readonly damage: number;
+    /** Maximum engagement distance (px). */
+    readonly attackRange: number;
+    /** Visual detection radius (px). */
+    readonly detectionRange: number;
+    /** Field of view (degrees, (0, 360]). */
+    readonly fov: number;
+    /** Power tier (1–5). Affects equipment, GOAP eligibility (≥ 5), and terrain job suitability. */
+    readonly rank: number;
+    /** Hit probability factor [0, 1]. */
+    readonly accuracy: number;
+    /** HP fraction [0, 1] at which the NPC prefers retreat behavior. */
+    readonly retreatThreshold: number;
+    /** Per-type loadout overrides (merged with faction defaults). */
+    readonly equipmentPreference?: Partial<IEquipmentPreference>;
+}
+/** Type-safe registry of NPC type definitions. Validates hp > 0, rank 1–5, accuracy [0, 1]. */
+export declare class NPCTypeRegistry extends Registry<string, INPCTypeDefinition> {
+    constructor();
+}
+//# sourceMappingURL=NPCTypeRegistry.d.ts.map

package/dist/registry/NPCTypeRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NPCTypeRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/NPCTypeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC9D;AAWD,+FAA+F;AAC/F,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;;CAIxE"}

package/dist/registry/NPCTypeRegistry.js

@@ -0,0 +1,20 @@
+import { Registry } from './Registry';
+function validate(c) {
+    const errors = [];
+    if (c.hp <= 0)
+        errors.push('hp must be > 0');
+    if (c.speed <= 0)
+        errors.push('speed must be > 0');
+    if (c.rank < 1 || c.rank > 5)
+        errors.push('rank must be 1-5');
+    if (c.accuracy < 0 || c.accuracy > 1)
+        errors.push('accuracy must be in [0, 1]');
+    return errors;
+}
+/** Type-safe registry of NPC type definitions. Validates hp > 0, rank 1–5, accuracy [0, 1]. */
+export class NPCTypeRegistry extends Registry {
+    constructor() {
+        super({ name: 'NPCTypeRegistry', validate });
+    }
+}
+//# sourceMappingURL=NPCTypeRegistry.js.map

package/dist/registry/NPCTypeRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NPCTypeRegistry.js","sourceRoot":"","sources":["../../src/registry/NPCTypeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA+BtC,SAAS,QAAQ,CAAC,CAAqB;IACrC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC9D,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+FAA+F;AAC/F,MAAM,OAAO,eAAgB,SAAQ,QAAoC;IACvE;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/registry/Registry.d.ts

@@ -0,0 +1,44 @@
+export interface RegistryOptions<TConfig> {
+    /** Human-readable name for error messages (e.g., 'MonsterRegistry'). */
+    name: string;
+    /** Optional validation function. Returns error messages array (empty = valid). */
+    validate?: (config: TConfig) => string[];
+}
+/**
+ * Generic, freezable, validated ID → config registry.
+ *
+ * Base class for all content registries. Supports unique ID enforcement,
+ * optional validation on register(), and freezing to prevent mutation after init().
+ *
+ * @typeParam TId     - String-like identifier type. Default: `string`.
+ * @typeParam TConfig - Shape of the stored configuration object.
+ */
+export declare class Registry<TId extends string = string, TConfig = unknown> {
+    private readonly entries;
+    private readonly name;
+    private readonly validate?;
+    private frozen;
+    constructor(options: RegistryOptions<TConfig>);
+    /** Register a new entry. Throws if frozen, the ID is duplicate, or validation fails. Returns `this` for chaining. */
+    register(id: TId, config: TConfig): this;
+    /** Retrieve an entry by ID. Throws if not found. */
+    get(id: TId): TConfig;
+    /** Retrieve an entry by ID, or `undefined` if not found. */
+    tryGet(id: TId): TConfig | undefined;
+    /** Check whether an ID is registered. */
+    has(id: TId): boolean;
+    /** Return all registered IDs as an array. */
+    ids(): TId[];
+    /** Number of registered entries. */
+    get size(): number;
+    /** Iterate over [id, config] pairs. */
+    [Symbol.iterator](): IterableIterator<[TId, TConfig]>;
+    /** Lock the registry. All subsequent register() calls will throw. Called automatically by ALifeKernel.init(). */
+    freeze(): void;
+    /** True if the registry has been frozen. */
+    get isFrozen(): boolean;
+    private ensureNotFrozen;
+    private ensureUnique;
+    private runValidation;
+}
+//# sourceMappingURL=Registry.d.ts.map

package/dist/registry/Registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../../src/registry/Registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,OAAO;IACtC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,qBAAa,QAAQ,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,GAAG,OAAO;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAgC;IAC1D,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC;IAK7C,qHAAqH;IACrH,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAQxC,oDAAoD;IACpD,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO;IAQrB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,GAAG,SAAS;IAIpC,yCAAyC;IACzC,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO;IAIrB,6CAA6C;IAC7C,GAAG,IAAI,GAAG,EAAE;IAIZ,oCAAoC;IACpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uCAAuC;IACvC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAIrD,iHAAiH;IACjH,MAAM,IAAI,IAAI;IAId,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;CAStB"}

package/dist/registry/Registry.js

@@ -0,0 +1,80 @@
+/**
+ * Generic, freezable, validated ID → config registry.
+ *
+ * Base class for all content registries. Supports unique ID enforcement,
+ * optional validation on register(), and freezing to prevent mutation after init().
+ *
+ * @typeParam TId     - String-like identifier type. Default: `string`.
+ * @typeParam TConfig - Shape of the stored configuration object.
+ */
+export class Registry {
+    constructor(options) {
+        this.entries = new Map();
+        this.frozen = false;
+        this.name = options.name;
+        this.validate = options.validate;
+    }
+    /** Register a new entry. Throws if frozen, the ID is duplicate, or validation fails. Returns `this` for chaining. */
+    register(id, config) {
+        this.ensureNotFrozen('register');
+        this.ensureUnique(id);
+        this.runValidation(id, config);
+        this.entries.set(id, config);
+        return this;
+    }
+    /** Retrieve an entry by ID. Throws if not found. */
+    get(id) {
+        const config = this.entries.get(id);
+        if (config === undefined && !this.entries.has(id)) {
+            throw new Error(`[${this.name}] ID "${id}" not found`);
+        }
+        return config;
+    }
+    /** Retrieve an entry by ID, or `undefined` if not found. */
+    tryGet(id) {
+        return this.entries.get(id);
+    }
+    /** Check whether an ID is registered. */
+    has(id) {
+        return this.entries.has(id);
+    }
+    /** Return all registered IDs as an array. */
+    ids() {
+        return [...this.entries.keys()];
+    }
+    /** Number of registered entries. */
+    get size() {
+        return this.entries.size;
+    }
+    /** Iterate over [id, config] pairs. */
+    [Symbol.iterator]() {
+        return this.entries.entries();
+    }
+    /** Lock the registry. All subsequent register() calls will throw. Called automatically by ALifeKernel.init(). */
+    freeze() {
+        this.frozen = true;
+    }
+    /** True if the registry has been frozen. */
+    get isFrozen() {
+        return this.frozen;
+    }
+    ensureNotFrozen(operation) {
+        if (this.frozen) {
+            throw new Error(`[${this.name}] Cannot ${operation}: registry is frozen`);
+        }
+    }
+    ensureUnique(id) {
+        if (this.entries.has(id)) {
+            throw new Error(`[${this.name}] ID "${id}" already registered`);
+        }
+    }
+    runValidation(id, config) {
+        if (!this.validate)
+            return;
+        const errors = this.validate(config);
+        if (errors.length > 0) {
+            throw new Error(`[${this.name}] Invalid config for "${id}": ${errors.join('; ')}`);
+        }
+    }
+}
+//# sourceMappingURL=Registry.js.map

package/dist/registry/Registry.js.map

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

package/dist/registry/TaskTypeRegistry.d.ts

@@ -0,0 +1,17 @@
+import { Registry } from './Registry';
+/** Definition of a SmartTerrain task type (e.g. patrol, guard, camp). */
+export interface ITaskTypeDefinition {
+    /** Human-readable display name. */
+    readonly name: string;
+    /** BehaviorScheme ID to activate when this task is assigned. */
+    readonly defaultBehavior: string;
+    /** Scheduling priority. Higher = assigned first when multiple tasks compete. */
+    readonly priority: number;
+}
+/** Registry of task types. Call registerDefaults() for the 4 built-in types (patrol, guard, camp, wander). */
+export declare class TaskTypeRegistry extends Registry<string, ITaskTypeDefinition> {
+    constructor();
+    /** Register the 4 built-in task types (patrol, guard, camp, wander). Returns `this` for chaining. */
+    registerDefaults(): this;
+}
+//# sourceMappingURL=TaskTypeRegistry.d.ts.map

package/dist/registry/TaskTypeRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskTypeRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/TaskTypeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,8GAA8G;AAC9G,qBAAa,gBAAiB,SAAQ,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;;IAKzE,qGAAqG;IACrG,gBAAgB,IAAI,IAAI;CAOzB"}

package/dist/registry/TaskTypeRegistry.js

@@ -0,0 +1,16 @@
+import { Registry } from './Registry';
+/** Registry of task types. Call registerDefaults() for the 4 built-in types (patrol, guard, camp, wander). */
+export class TaskTypeRegistry extends Registry {
+    constructor() {
+        super({ name: 'TaskTypeRegistry' });
+    }
+    /** Register the 4 built-in task types (patrol, guard, camp, wander). Returns `this` for chaining. */
+    registerDefaults() {
+        return this
+            .register('patrol', { name: 'Patrol', defaultBehavior: 'patrol', priority: 10 })
+            .register('guard', { name: 'Guard', defaultBehavior: 'guard', priority: 20 })
+            .register('camp', { name: 'Camp', defaultBehavior: 'camp', priority: 5 })
+            .register('wander', { name: 'Wander', defaultBehavior: 'wander', priority: 1 });
+    }
+}
+//# sourceMappingURL=TaskTypeRegistry.js.map

package/dist/registry/TaskTypeRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskTypeRegistry.js","sourceRoot":"","sources":["../../src/registry/TaskTypeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAYtC,8GAA8G;AAC9G,MAAM,OAAO,gBAAiB,SAAQ,QAAqC;IACzE;QACE,KAAK,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,qGAAqG;IACrG,gBAAgB;QACd,OAAO,IAAI;aACR,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;aAC/E,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;aAC5E,QAAQ,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;aACxE,QAAQ,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;CACF"}

package/dist/registry/index.d.ts

@@ -0,0 +1,19 @@
+export { Registry } from './Registry';
+export type { RegistryOptions } from './Registry';
+export { MonsterRegistry } from './MonsterRegistry';
+export type { IMonsterDefinition, IMonsterRegistryConfig } from './MonsterRegistry';
+export { FactionRegistry } from './FactionRegistry';
+export type { IFactionDefinition, IEquipmentPreference, IFactionSpawnRules } from './FactionRegistry';
+export { NPCTypeRegistry } from './NPCTypeRegistry';
+export type { INPCTypeDefinition } from './NPCTypeRegistry';
+export { DamageTypeRegistry } from './DamageTypeRegistry';
+export type { IDamageTypeDefinition } from './DamageTypeRegistry';
+export { AnomalyTypeRegistry } from './AnomalyTypeRegistry';
+export type { IAnomalyTypeDefinition } from './AnomalyTypeRegistry';
+export { AIStateRegistry } from './AIStateRegistry';
+export type { IStateHandler, ITransitionCondition, IAIStateDefinition } from './AIStateRegistry';
+export { BehaviorSchemeRegistry } from './BehaviorSchemeRegistry';
+export type { IBehaviorSchemeDefinition } from './BehaviorSchemeRegistry';
+export { TaskTypeRegistry } from './TaskTypeRegistry';
+export type { ITaskTypeDefinition } from './TaskTypeRegistry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,11 @@
+// registry sub-path barrel
+export { Registry } from './Registry';
+export { MonsterRegistry } from './MonsterRegistry';
+export { FactionRegistry } from './FactionRegistry';
+export { NPCTypeRegistry } from './NPCTypeRegistry';
+export { DamageTypeRegistry } from './DamageTypeRegistry';
+export { AnomalyTypeRegistry } from './AnomalyTypeRegistry';
+export { AIStateRegistry } from './AIStateRegistry';
+export { BehaviorSchemeRegistry } from './BehaviorSchemeRegistry';
+export { TaskTypeRegistry } from './TaskTypeRegistry';
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,3 @@
+export { assertDefined, assertString, assertNumber, assertNumberInRange, assertBoolean, assertArray, assertObject, createValidator, validateMonsterDefinition, validateFactionDefinition, } from './validators';
+export type { ValidationResult } from './validators';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,EACf,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,3 @@
+// schema sub-path barrel
+export { assertDefined, assertString, assertNumber, assertNumberInRange, assertBoolean, assertArray, assertObject, createValidator, validateMonsterDefinition, validateFactionDefinition, } from './validators';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,EACf,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,cAAc,CAAC"}