@alife-sdk/core 0.1.0

package/dist/schema/validators.d.ts

@@ -0,0 +1,32 @@
+export declare function assertDefined<T>(value: T | undefined | null, name: string): asserts value is T;
+export declare function assertString(value: unknown, name: string): asserts value is string;
+export declare function assertNumber(value: unknown, name: string): asserts value is number;
+export declare function assertNumberInRange(value: unknown, name: string, min: number, max: number): asserts value is number;
+export declare function assertBoolean(value: unknown, name: string): asserts value is boolean;
+export declare function assertArray(value: unknown, name: string): asserts value is unknown[];
+export declare function assertObject(value: unknown, name: string): asserts value is Record<string, unknown>;
+export type ValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    errors: string[];
+};
+/**
+ * Creates a reusable validator function from an array of rule functions.
+ *
+ * Each rule receives the raw input and returns `null` if valid or an error
+ * string if invalid. The validator runs ALL rules and collects ALL errors
+ * (not fail-fast) so the caller gets a complete diagnostic on first attempt.
+ */
+export declare function createValidator<_T>(name: string, rules: Array<(input: unknown) => string | null>): (input: unknown) => ValidationResult;
+/**
+ * Validates raw JSON input against the IMonsterDefinition shape.
+ * Runs all rules and returns a complete list of errors.
+ */
+export declare const validateMonsterDefinition: (input: unknown) => ValidationResult;
+/**
+ * Validates raw JSON input against the IFactionDefinition shape.
+ * Runs all rules and returns a complete list of errors.
+ */
+export declare const validateFactionDefinition: (input: unknown) => ValidationResult;
+//# sourceMappingURL=validators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/schema/validators.ts"],"names":[],"mappings":"AAOA,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,EAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,IAAI,CAAC,CAIpB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAIlF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAMlF;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,IAAI,MAAM,CAKzB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAIpF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,EAAE,CAIpF;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM1C;AAMD,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAMpF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC,GAC9C,CAAC,KAAK,EAAE,OAAO,KAAK,gBAAgB,CAatC;AAkHD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,gBACY,CAAC;AAkDzE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,gBACY,CAAC"}

package/dist/schema/validators.js

@@ -0,0 +1,249 @@
+// ---------------------------------------------------------------------------
+// Assertion helpers — throw descriptive errors on invalid input
+// ---------------------------------------------------------------------------
+export function assertDefined(value, name) {
+    if (value === undefined || value === null) {
+        throw new Error(`${name} must be defined, got ${value === null ? 'null' : 'undefined'}`);
+    }
+}
+export function assertString(value, name) {
+    if (typeof value !== 'string') {
+        throw new Error(`${name} must be a string, got ${typeof value}`);
+    }
+}
+export function assertNumber(value, name) {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+        throw new Error(`${name} must be a number, got ${Number.isNaN(value) ? 'NaN' : typeof value}`);
+    }
+}
+export function assertNumberInRange(value, name, min, max) {
+    assertNumber(value, name);
+    if (value < min || value > max) {
+        throw new Error(`${name} must be in [${min}, ${max}], got ${value}`);
+    }
+}
+export function assertBoolean(value, name) {
+    if (typeof value !== 'boolean') {
+        throw new Error(`${name} must be a boolean, got ${typeof value}`);
+    }
+}
+export function assertArray(value, name) {
+    if (!Array.isArray(value)) {
+        throw new Error(`${name} must be an array, got ${typeof value}`);
+    }
+}
+export function assertObject(value, name) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${name} must be a plain object, got ${value === null ? 'null' : Array.isArray(value) ? 'array' : typeof value}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Generic validator factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a reusable validator function from an array of rule functions.
+ *
+ * Each rule receives the raw input and returns `null` if valid or an error
+ * string if invalid. The validator runs ALL rules and collects ALL errors
+ * (not fail-fast) so the caller gets a complete diagnostic on first attempt.
+ */
+export function createValidator(name, rules) {
+    return (input) => {
+        const errors = [];
+        for (const rule of rules) {
+            const error = rule(input);
+            if (error !== null) {
+                errors.push(`[${name}] ${error}`);
+            }
+        }
+        return errors.length === 0 ? { valid: true } : { valid: false, errors };
+    };
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+function isObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function checkString(obj, field) {
+    if (typeof obj[field] !== 'string' || obj[field].length === 0) {
+        return `"${field}" must be a non-empty string`;
+    }
+    return null;
+}
+function checkPositiveNumber(obj, field) {
+    const v = obj[field];
+    if (typeof v !== 'number' || Number.isNaN(v) || v <= 0) {
+        return `"${field}" must be a positive number`;
+    }
+    return null;
+}
+function checkNumberInRange(obj, field, min, max) {
+    const v = obj[field];
+    if (typeof v !== 'number' || Number.isNaN(v) || v < min || v > max) {
+        return `"${field}" must be a number in [${min}, ${max}]`;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Monster definition validator
+// ---------------------------------------------------------------------------
+const monsterRules = [
+    (input) => (isObject(input) ? null : 'input must be an object'),
+    (input) => {
+        if (!isObject(input))
+            return null; // guarded by rule above
+        return checkString(input, 'name');
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        return checkPositiveNumber(input, 'hp');
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        return checkPositiveNumber(input, 'speed');
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        return checkPositiveNumber(input, 'damage');
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        return checkPositiveNumber(input, 'attackRange');
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        return checkPositiveNumber(input, 'detectionRange');
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        return checkNumberInRange(input, 'fov', 0.01, 360);
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        const ps = input['packSize'];
+        if (!Array.isArray(ps) || ps.length !== 2)
+            return '"packSize" must be a [min, max] tuple';
+        if (typeof ps[0] !== 'number' || ps[0] < 1)
+            return '"packSize[0]" must be >= 1';
+        if (typeof ps[1] !== 'number')
+            return '"packSize[1]" must be a number';
+        if (ps[0] > ps[1])
+            return '"packSize" min must be <= max';
+        return null;
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        if (!Array.isArray(input['abilities']))
+            return '"abilities" must be an array';
+        return null;
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        const lair = input['lair'];
+        if (!isObject(lair))
+            return '"lair" must be an object with inner, patrol, outer';
+        const inner = lair['inner'];
+        const patrol = lair['patrol'];
+        const outer = lair['outer'];
+        if (typeof inner !== 'number' || typeof patrol !== 'number' || typeof outer !== 'number') {
+            return '"lair" fields must be numbers';
+        }
+        if (inner >= patrol)
+            return '"lair.inner" must be < "lair.patrol"';
+        if (patrol >= outer)
+            return '"lair.patrol" must be < "lair.outer"';
+        return null;
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        return checkNumberInRange(input, 'rank', 1, 5);
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        const faction = input['faction'];
+        if (faction !== undefined && typeof faction !== 'string') {
+            return '"faction" must be a string if provided';
+        }
+        return null;
+    },
+];
+/**
+ * Validates raw JSON input against the IMonsterDefinition shape.
+ * Runs all rules and returns a complete list of errors.
+ */
+export const validateMonsterDefinition = createValidator('MonsterDefinition', monsterRules);
+// ---------------------------------------------------------------------------
+// Faction definition validator
+// ---------------------------------------------------------------------------
+const factionRules = [
+    (input) => (isObject(input) ? null : 'input must be an object'),
+    (input) => {
+        if (!isObject(input))
+            return null;
+        return checkString(input, 'name');
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        const br = input['baseRelations'];
+        if (!isObject(br))
+            return '"baseRelations" must be an object';
+        for (const [id, v] of Object.entries(br)) {
+            if (typeof v !== 'number' || v < -100 || v > 100) {
+                return `"baseRelations.${id}" must be a number in [-100, 100]`;
+            }
+        }
+        return null;
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        const imm = input['immunities'];
+        if (!isObject(imm))
+            return '"immunities" must be an object';
+        for (const [id, v] of Object.entries(imm)) {
+            if (typeof v !== 'number' || v < 0 || v > 1) {
+                return `"immunities.${id}" must be a number in [0, 1]`;
+            }
+        }
+        return null;
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        const de = input['defaultEquipment'];
+        if (de !== undefined && !isObject(de))
+            return '"defaultEquipment" must be an object if provided';
+        return null;
+    },
+    (input) => {
+        if (!isObject(input))
+            return null;
+        const sr = input['spawnRules'];
+        if (!isObject(sr))
+            return '"spawnRules" must be an object';
+        if (typeof sr['targetRatio'] !== 'number')
+            return '"spawnRules.targetRatio" must be a number';
+        if (typeof sr['balanceTolerance'] !== 'number')
+            return '"spawnRules.balanceTolerance" must be a number';
+        return null;
+    },
+];
+/**
+ * Validates raw JSON input against the IFactionDefinition shape.
+ * Runs all rules and returns a complete list of errors.
+ */
+export const validateFactionDefinition = createValidator('FactionDefinition', factionRules);
+//# sourceMappingURL=validators.js.map

package/dist/schema/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/schema/validators.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,UAAU,aAAa,CAC3B,KAA2B,EAC3B,IAAY;IAEZ,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,yBAAyB,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,IAAY;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,0BAA0B,OAAO,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,IAAY;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,0BAA0B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAC9E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,IAAY,EACZ,GAAW,EACX,GAAW;IAEX,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1B,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gBAAgB,GAAG,KAAK,GAAG,UAAU,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,IAAY;IACxD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,2BAA2B,OAAO,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,IAAY;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,0BAA0B,OAAO,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAc,EACd,IAAY;IAEZ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,gCAAgC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CACjH,CAAC;IACJ,CAAC;AACH,CAAC;AAQD,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAA+C;IAE/C,OAAO,CAAC,KAAc,EAAoB,EAAE;QAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,GAA4B,EAAE,KAAa;IAC9D,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAK,GAAG,CAAC,KAAK,CAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAI,KAAK,8BAA8B,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,GAA4B,EAAE,KAAa;IACtE,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,KAAK,6BAA6B,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CACzB,GAA4B,EAC5B,KAAa,EACb,GAAW,EACX,GAAW;IAEX,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACnE,OAAO,IAAI,KAAK,0BAA0B,GAAG,KAAK,GAAG,GAAG,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,YAAY,GAA6C;IAC7D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC;IAC/D,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,wBAAwB;QAC3D,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACnD,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACtD,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,uCAAuC,CAAC;QAC1F,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,OAAO,4BAA4B,CAAC;QAChF,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,OAAO,gCAAgC,CAAC;QACvE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,+BAA+B,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAAE,OAAO,8BAA8B,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,oDAAoD,CAAC;QACjF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzF,OAAO,+BAA+B,CAAC;QACzC,CAAC;QACD,IAAI,KAAK,IAAI,MAAM;YAAE,OAAO,sCAAsC,CAAC;QACnE,IAAI,MAAM,IAAI,KAAK;YAAE,OAAO,sCAAsC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzD,OAAO,wCAAwC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GACpC,eAAe,CAAqB,mBAAmB,EAAE,YAAY,CAAC,CAAC;AAEzE,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,YAAY,GAA6C;IAC7D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC;IAC/D,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,mCAAmC,CAAC;QAC9D,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;gBACjD,OAAO,kBAAkB,EAAE,mCAAmC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,gCAAgC,CAAC;QAC5D,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5C,OAAO,eAAe,EAAE,8BAA8B,CAAC;YACzD,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACrC,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,kDAAkD,CAAC;QACjG,OAAO,IAAI,CAAC;IACd,CAAC;IACD,CAAC,KAAK,EAAE,EAAE;QACR,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,gCAAgC,CAAC;QAC3D,IAAI,OAAO,EAAE,CAAC,aAAa,CAAC,KAAK,QAAQ;YAAE,OAAO,2CAA2C,CAAC;QAC9F,IAAI,OAAO,EAAE,CAAC,kBAAkB,CAAC,KAAK,QAAQ;YAAE,OAAO,gDAAgD,CAAC;QACxG,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GACpC,eAAe,CAAqB,mBAAmB,EAAE,YAAY,CAAC,CAAC"}

package/dist/spawn/SpawnRegistry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Data-driven spawn management with cooldowns and faction balance.
+ *
+ * SpawnRegistry is a pure simulation object -- it never creates game objects.
+ * It tracks per-point cooldowns, live-count caps, and faction filters.
+ * External systems query eligible points and handle actual entity creation.
+ *
+ * Eligibility: cooldown expired AND activeCounts < maxNPCs.
+ */
+import type { Vec2 } from '../core/Vec2';
+export interface ISpawnPointConfig {
+    readonly id: string;
+    readonly terrainId: string;
+    readonly position: Vec2;
+    readonly factionId: string;
+    readonly maxNPCs: number;
+}
+export interface ISpawnRegistryState {
+    readonly cooldowns: Readonly<Record<string, number>>;
+    readonly activeCounts: Readonly<Record<string, number>>;
+}
+export declare class SpawnRegistry {
+    private readonly points;
+    private readonly cooldowns;
+    private readonly activeCounts;
+    private readonly defaultCooldownMs;
+    constructor(defaultCooldownMs?: number);
+    addPoint(config: ISpawnPointConfig): void;
+    removePoint(id: string): void;
+    getPoint(id: string): ISpawnPointConfig | undefined;
+    /** Get all spawn points eligible for spawning now. */
+    getEligiblePoints(): ISpawnPointConfig[];
+    /** Mark a spawn point as used (starts cooldown, increments active count). */
+    markSpawned(spawnPointId: string): void;
+    /** Record NPC death -- decrement active count for the spawn point. */
+    markDespawned(spawnPointId: string): void;
+    /** Tick cooldowns by the given delta. */
+    update(deltaMs: number): void;
+    /** Reset all cooldowns to zero (e.g., after a surge for mass respawn). */
+    resetAllCooldowns(): void;
+    /** Get all spawn points that belong to the given faction. */
+    getPointsByFaction(factionId: string): ISpawnPointConfig[];
+    get totalPoints(): number;
+    serialize(): ISpawnRegistryState;
+    restore(state: ISpawnRegistryState): void;
+    private isEligible;
+}
+//# sourceMappingURL=SpawnRegistry.d.ts.map

package/dist/spawn/SpawnRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpawnRegistry.d.ts","sourceRoot":"","sources":["../../src/spawn/SpawnRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAMzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAYD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAE1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,iBAAiB,GAAE,MAA4B;IAQ3D,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAMzC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAM7B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAQnD,sDAAsD;IACtD,iBAAiB,IAAI,iBAAiB,EAAE;IAgBxC,6EAA6E;IAC7E,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQvC,sEAAsE;IACtE,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAWzC,yCAAyC;IACzC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAY7B,0EAA0E;IAC1E,iBAAiB,IAAI,IAAI;IAUzB,6DAA6D;IAC7D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAU1D,IAAI,WAAW,IAAI,MAAM,CAExB;IAMD,SAAS,IAAI,mBAAmB;IAOhC,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAiBzC,OAAO,CAAC,UAAU;CASnB"}

package/dist/spawn/SpawnRegistry.js

@@ -0,0 +1,141 @@
+/**
+ * Data-driven spawn management with cooldowns and faction balance.
+ *
+ * SpawnRegistry is a pure simulation object -- it never creates game objects.
+ * It tracks per-point cooldowns, live-count caps, and faction filters.
+ * External systems query eligible points and handle actual entity creation.
+ *
+ * Eligibility: cooldown expired AND activeCounts < maxNPCs.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_COOLDOWN_MS = 30000;
+// ---------------------------------------------------------------------------
+// SpawnRegistry
+// ---------------------------------------------------------------------------
+export class SpawnRegistry {
+    constructor(defaultCooldownMs = DEFAULT_COOLDOWN_MS) {
+        this.points = new Map();
+        this.cooldowns = new Map();
+        this.activeCounts = new Map();
+        this.defaultCooldownMs = defaultCooldownMs;
+    }
+    // -----------------------------------------------------------------------
+    // Point management
+    // -----------------------------------------------------------------------
+    addPoint(config) {
+        this.points.set(config.id, config);
+        this.cooldowns.set(config.id, 0);
+        this.activeCounts.set(config.id, 0);
+    }
+    removePoint(id) {
+        this.points.delete(id);
+        this.cooldowns.delete(id);
+        this.activeCounts.delete(id);
+    }
+    getPoint(id) {
+        return this.points.get(id);
+    }
+    // -----------------------------------------------------------------------
+    // Eligibility
+    // -----------------------------------------------------------------------
+    /** Get all spawn points eligible for spawning now. */
+    getEligiblePoints() {
+        const eligible = [];
+        for (const [id, config] of this.points) {
+            if (this.isEligible(id, config)) {
+                eligible.push(config);
+            }
+        }
+        return eligible;
+    }
+    // -----------------------------------------------------------------------
+    // Spawn lifecycle
+    // -----------------------------------------------------------------------
+    /** Mark a spawn point as used (starts cooldown, increments active count). */
+    markSpawned(spawnPointId) {
+        if (!this.points.has(spawnPointId))
+            return;
+        this.cooldowns.set(spawnPointId, this.defaultCooldownMs);
+        const current = this.activeCounts.get(spawnPointId) ?? 0;
+        this.activeCounts.set(spawnPointId, current + 1);
+    }
+    /** Record NPC death -- decrement active count for the spawn point. */
+    markDespawned(spawnPointId) {
+        const current = this.activeCounts.get(spawnPointId);
+        if (current === undefined)
+            return;
+        this.activeCounts.set(spawnPointId, Math.max(0, current - 1));
+    }
+    // -----------------------------------------------------------------------
+    // Update
+    // -----------------------------------------------------------------------
+    /** Tick cooldowns by the given delta. */
+    update(deltaMs) {
+        for (const [id, remaining] of this.cooldowns) {
+            if (remaining > 0) {
+                this.cooldowns.set(id, Math.max(0, remaining - deltaMs));
+            }
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Batch operations
+    // -----------------------------------------------------------------------
+    /** Reset all cooldowns to zero (e.g., after a surge for mass respawn). */
+    resetAllCooldowns() {
+        for (const id of this.cooldowns.keys()) {
+            this.cooldowns.set(id, 0);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Queries
+    // -----------------------------------------------------------------------
+    /** Get all spawn points that belong to the given faction. */
+    getPointsByFaction(factionId) {
+        const result = [];
+        for (const config of this.points.values()) {
+            if (config.factionId === factionId) {
+                result.push(config);
+            }
+        }
+        return result;
+    }
+    get totalPoints() {
+        return this.points.size;
+    }
+    // -----------------------------------------------------------------------
+    // Serialisation
+    // -----------------------------------------------------------------------
+    serialize() {
+        return {
+            cooldowns: Object.fromEntries(this.cooldowns),
+            activeCounts: Object.fromEntries(this.activeCounts),
+        };
+    }
+    restore(state) {
+        for (const [id, value] of Object.entries(state.cooldowns)) {
+            if (this.cooldowns.has(id)) {
+                this.cooldowns.set(id, value);
+            }
+        }
+        for (const [id, value] of Object.entries(state.activeCounts)) {
+            if (this.activeCounts.has(id)) {
+                this.activeCounts.set(id, value);
+            }
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Private
+    // -----------------------------------------------------------------------
+    isEligible(id, config) {
+        const cooldown = this.cooldowns.get(id) ?? 0;
+        if (cooldown > 0)
+            return false;
+        const active = this.activeCounts.get(id) ?? 0;
+        if (active >= config.maxNPCs)
+            return false;
+        return true;
+    }
+}
+//# sourceMappingURL=SpawnRegistry.js.map

package/dist/spawn/SpawnRegistry.js.map

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

package/dist/spawn/index.d.ts

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

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

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

package/dist/spawn/index.js

@@ -0,0 +1,3 @@
+// spawn sub-path barrel
+export { SpawnRegistry } from './SpawnRegistry';
+//# sourceMappingURL=index.js.map

package/dist/spawn/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spawn/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/terrain/SmartTerrain.d.ts

@@ -0,0 +1,119 @@
+/**
+ * SmartTerrain -- a Zone with job slots, capacity, and NPC fitness scoring.
+ *
+ * NPCs evaluate available terrains and select the one with the highest
+ * fitness score. The terrain tracks its occupants and enforces capacity.
+ */
+import type { Vec2 } from '../core/Vec2';
+import type { IRandom } from '../ports/IRandom';
+import { Zone, type IZoneBounds } from './Zone';
+export interface IJobPreconditions {
+    readonly minRank?: number;
+    readonly dayOnly?: boolean;
+    readonly nightOnly?: boolean;
+    readonly factions?: readonly string[];
+}
+export interface IJobSlot {
+    readonly type: string;
+    readonly slots: number;
+    readonly position?: Vec2;
+    readonly routeId?: string;
+    readonly preconditions?: IJobPreconditions;
+}
+export interface ISpawnPoint {
+    readonly x: number;
+    readonly y: number;
+    readonly factionId: string;
+}
+export interface IPatrolRouteConfig {
+    readonly id: string;
+    readonly routeType: 'loop' | 'ping_pong' | 'one_way';
+    readonly waypoints: readonly Vec2[];
+}
+/** Tunable scoring weights for SmartTerrain fitness evaluation. */
+export interface IScoringConfig {
+    /** Distance penalty = dist / divisor. Default: 100. */
+    readonly distancePenaltyDivisor?: number;
+    /** Bonus applied when terrain is a shelter. Default: 50. */
+    readonly shelterBonus?: number;
+    /** Bonus when NPC rank >= terrain danger level. Default: 10. */
+    readonly rankMatchBonus?: number;
+    /** Random ± noise applied to fitness score. Default: 0 (deterministic). */
+    readonly scoringJitter?: number;
+    /**
+     * Use squared distance instead of sqrt for the distance penalty.
+     * Eliminates Math.sqrt per terrain per NPC but changes the penalty curve
+     * from linear to quadratic (nearby terrains are even more preferred).
+     * When true, uses distancePenaltySqDivisor (default: distancePenaltyDivisor²).
+     */
+    readonly useSquaredDistance?: boolean;
+    /** Squared-distance penalty divisor. Default: distancePenaltyDivisor². */
+    readonly distancePenaltySqDivisor?: number;
+}
+export interface ISmartTerrainConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly bounds: IZoneBounds;
+    readonly dangerLevel?: number;
+    readonly capacity: number;
+    readonly allowedFactions?: readonly string[];
+    readonly isShelter?: boolean;
+    readonly tags?: readonly string[];
+    readonly jobs?: readonly IJobSlot[];
+    readonly spawnPoints?: readonly ISpawnPoint[];
+    readonly patrolRoutes?: readonly IPatrolRouteConfig[];
+    readonly scoring?: IScoringConfig;
+    /** Injectable RNG for deterministic scoring jitter. Falls back to Math.random(). */
+    readonly random?: IRandom;
+}
+export declare class SmartTerrain extends Zone {
+    readonly capacity: number;
+    readonly allowedFactions: ReadonlySet<string>;
+    readonly isShelter: boolean;
+    readonly tags: ReadonlySet<string>;
+    readonly jobs: readonly IJobSlot[];
+    readonly spawnPoints: readonly ISpawnPoint[];
+    readonly patrolRoutes: ReadonlyMap<string, IPatrolRouteConfig>;
+    private readonly distancePenaltyDivisor;
+    private readonly useSquaredDistance;
+    private readonly distancePenaltySqDivisor;
+    private readonly shelterBonus;
+    private readonly rankMatchBonus;
+    private readonly scoringJitter;
+    private readonly random;
+    private readonly occupants;
+    constructor(config: ISmartTerrainConfig);
+    /** Number of NPCs currently assigned to this terrain. */
+    get occupantCount(): number;
+    /** Whether the terrain can accept another NPC. */
+    get hasCapacity(): boolean;
+    /**
+     * Register an NPC as an occupant.
+     * Returns false if the terrain is already at capacity.
+     */
+    addOccupant(npcId: string): boolean;
+    /** Remove an NPC from the occupant set. */
+    removeOccupant(npcId: string): void;
+    /** Check whether a given NPC is an occupant. */
+    hasOccupant(npcId: string): boolean;
+    /** Read-only view of the current occupant set. */
+    getOccupants(): ReadonlySet<string>;
+    /**
+     * Compute a fitness score for an NPC considering faction, distance,
+     * capacity, shelter status, and danger-to-rank matching.
+     *
+     * Scoring breakdown:
+     *   - Base = remaining capacity (capacity - occupantCount)
+     *   - Faction not allowed: -Infinity
+     *   - Distance penalty: -distance / 100
+     *   - Shelter bonus: +50 if isShelter
+     *   - Rank >= dangerLevel: +10
+     */
+    scoreFitness(npcFaction: string, npcPosition: Vec2, npcRank: number): number;
+    /**
+     * Check whether a faction is allowed in this terrain.
+     * An empty allowedFactions set means all factions are accepted.
+     */
+    acceptsFaction(factionId: string): boolean;
+}
+//# sourceMappingURL=SmartTerrain.d.ts.map

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

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