@sharpee/character 0.9.106 → 0.9.107

package/influence/builder.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Influence builder API (ADR-146 layer 5)
+ *
+ * Fluent builder for defining NPC influences and resistances.
+ * Returns from CharacterBuilder.influence(name) and compiles to
+ * InfluenceDef stored in CompiledCharacter.influenceDefs.
+ *
+ * Public interface: InfluenceBuilder.
+ * Owner context: @sharpee/character / influence
+ */
+import { InfluenceMode, InfluenceRange, InfluenceDuration, InfluenceEffect, InfluenceSchedule, InfluenceDef } from './influence-types';
+/**
+ * Fluent builder for a single influence definition.
+ *
+ * Usage:
+ * ```
+ * builder.influence('seduction')
+ *   .mode('passive')
+ *   .range('proximity')
+ *   .effect({ focus: 'clouded', mood: 'distracted' })
+ *   .duration('while present')
+ *   .witnessed('ginger-brushes-against-{target}')
+ *   .resisted('ginger-brushes-against-{target}-no-effect')
+ *   .done()
+ * ```
+ */
+export declare class InfluenceBuilder<TParent> {
+    private readonly _name;
+    private readonly _parent;
+    private readonly _finalize;
+    private _mode;
+    private _range;
+    private _effect;
+    private _duration;
+    private _witnessed?;
+    private _resisted?;
+    private _schedule?;
+    private _onPlayerAction?;
+    private _lingeringTurns?;
+    private _lingeringClearCondition?;
+    /**
+     * Create a new influence builder.
+     *
+     * @param name - Author-defined influence name
+     * @param parent - Parent builder to return to on .done()
+     * @param finalize - Callback to register the compiled InfluenceDef
+     */
+    constructor(name: string, parent: TParent, finalize: (def: InfluenceDef) => void);
+    /**
+     * Set the influence mode.
+     *
+     * @param mode - 'passive' or 'active'
+     * @returns this for chaining
+     */
+    mode(mode: InfluenceMode): InfluenceBuilder<TParent>;
+    /**
+     * Set the influence range.
+     *
+     * @param range - 'proximity', 'targeted', or 'room'
+     * @returns this for chaining
+     */
+    range(range: InfluenceRange): InfluenceBuilder<TParent>;
+    /**
+     * Set the effect mutations applied to targets.
+     *
+     * @param effect - Character state mutations
+     * @returns this for chaining
+     */
+    effect(effect: InfluenceEffect): InfluenceBuilder<TParent>;
+    /**
+     * Set the duration type.
+     *
+     * @param duration - 'while present', 'momentary', or 'lingering'
+     * @returns this for chaining
+     */
+    duration(duration: InfluenceDuration): InfluenceBuilder<TParent>;
+    /**
+     * Set the message ID when the target is affected.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    witnessed(messageId: string): InfluenceBuilder<TParent>;
+    /**
+     * Set the message ID when the target resists.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    resisted(messageId: string): InfluenceBuilder<TParent>;
+    /**
+     * Set scheduling conditions for passive influences.
+     *
+     * @param schedule - Schedule with predicate conditions
+     * @returns this for chaining
+     */
+    schedule(schedule: InfluenceSchedule): InfluenceBuilder<TParent>;
+    /**
+     * Set the message ID when PC tries to act while under this influence.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    onPlayerAction(messageId: string): InfluenceBuilder<TParent>;
+    /**
+     * Set lingering duration in turns.
+     *
+     * @param turns - Number of turns the effect persists
+     * @returns this for chaining
+     */
+    lingeringTurns(turns: number): InfluenceBuilder<TParent>;
+    /**
+     * Set a predicate condition that clears a lingering effect.
+     *
+     * @param condition - Predicate condition
+     * @returns this for chaining
+     */
+    clearsWhen(condition: string): InfluenceBuilder<TParent>;
+    /**
+     * Finalize this influence definition and return the parent builder.
+     *
+     * @returns The parent builder
+     */
+    done(): TParent;
+    /**
+     * Compile the parent builder, auto-finalizing this influence.
+     *
+     * @returns Compiled character data (delegates to parent's compile())
+     */
+    compile(): ReturnType<TParent extends {
+        compile(): infer R;
+    } ? () => R : never>;
+    /** @internal Build the InfluenceDef without finalizing. */
+    _buildDef(): InfluenceDef;
+}
+//# sourceMappingURL=builder.d.ts.map

package/influence/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/influence/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB,CAAC,OAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAoB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,wBAAwB,CAAC,CAAS;IAE1C;;;;;;OAMG;gBACS,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI;IAMhF;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAKpD;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAKvD;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAK1D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAKhE;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAKvD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAKtD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAKhE;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAK5D;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAKxD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAKxD;;;;OAIG;IACH,IAAI,IAAI,OAAO;IAKf;;;;OAIG;IACH,OAAO,IAAI,UAAU,CAAC,OAAO,SAAS;QAAE,OAAO,IAAI,MAAM,CAAC,CAAA;KAAE,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC;IAK/E,2DAA2D;IAC3D,SAAS,IAAI,YAAY;CAkB1B"}

package/influence/builder.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Influence builder API (ADR-146 layer 5)
+ *
+ * Fluent builder for defining NPC influences and resistances.
+ * Returns from CharacterBuilder.influence(name) and compiles to
+ * InfluenceDef stored in CompiledCharacter.influenceDefs.
+ *
+ * Public interface: InfluenceBuilder.
+ * Owner context: @sharpee/character / influence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InfluenceBuilder = void 0;
+/**
+ * Fluent builder for a single influence definition.
+ *
+ * Usage:
+ * ```
+ * builder.influence('seduction')
+ *   .mode('passive')
+ *   .range('proximity')
+ *   .effect({ focus: 'clouded', mood: 'distracted' })
+ *   .duration('while present')
+ *   .witnessed('ginger-brushes-against-{target}')
+ *   .resisted('ginger-brushes-against-{target}-no-effect')
+ *   .done()
+ * ```
+ */
+class InfluenceBuilder {
+    _name;
+    _parent;
+    _finalize;
+    _mode = 'passive';
+    _range = 'proximity';
+    _effect = {};
+    _duration = 'while present';
+    _witnessed;
+    _resisted;
+    _schedule;
+    _onPlayerAction;
+    _lingeringTurns;
+    _lingeringClearCondition;
+    /**
+     * Create a new influence builder.
+     *
+     * @param name - Author-defined influence name
+     * @param parent - Parent builder to return to on .done()
+     * @param finalize - Callback to register the compiled InfluenceDef
+     */
+    constructor(name, parent, finalize) {
+        this._name = name;
+        this._parent = parent;
+        this._finalize = finalize;
+    }
+    /**
+     * Set the influence mode.
+     *
+     * @param mode - 'passive' or 'active'
+     * @returns this for chaining
+     */
+    mode(mode) {
+        this._mode = mode;
+        return this;
+    }
+    /**
+     * Set the influence range.
+     *
+     * @param range - 'proximity', 'targeted', or 'room'
+     * @returns this for chaining
+     */
+    range(range) {
+        this._range = range;
+        return this;
+    }
+    /**
+     * Set the effect mutations applied to targets.
+     *
+     * @param effect - Character state mutations
+     * @returns this for chaining
+     */
+    effect(effect) {
+        this._effect = { ...effect };
+        return this;
+    }
+    /**
+     * Set the duration type.
+     *
+     * @param duration - 'while present', 'momentary', or 'lingering'
+     * @returns this for chaining
+     */
+    duration(duration) {
+        this._duration = duration;
+        return this;
+    }
+    /**
+     * Set the message ID when the target is affected.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    witnessed(messageId) {
+        this._witnessed = messageId;
+        return this;
+    }
+    /**
+     * Set the message ID when the target resists.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    resisted(messageId) {
+        this._resisted = messageId;
+        return this;
+    }
+    /**
+     * Set scheduling conditions for passive influences.
+     *
+     * @param schedule - Schedule with predicate conditions
+     * @returns this for chaining
+     */
+    schedule(schedule) {
+        this._schedule = { ...schedule };
+        return this;
+    }
+    /**
+     * Set the message ID when PC tries to act while under this influence.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    onPlayerAction(messageId) {
+        this._onPlayerAction = messageId;
+        return this;
+    }
+    /**
+     * Set lingering duration in turns.
+     *
+     * @param turns - Number of turns the effect persists
+     * @returns this for chaining
+     */
+    lingeringTurns(turns) {
+        this._lingeringTurns = turns;
+        return this;
+    }
+    /**
+     * Set a predicate condition that clears a lingering effect.
+     *
+     * @param condition - Predicate condition
+     * @returns this for chaining
+     */
+    clearsWhen(condition) {
+        this._lingeringClearCondition = condition;
+        return this;
+    }
+    /**
+     * Finalize this influence definition and return the parent builder.
+     *
+     * @returns The parent builder
+     */
+    done() {
+        this._finalize(this._buildDef());
+        return this._parent;
+    }
+    /**
+     * Compile the parent builder, auto-finalizing this influence.
+     *
+     * @returns Compiled character data (delegates to parent's compile())
+     */
+    compile() {
+        const parent = this.done();
+        return parent.compile();
+    }
+    /** @internal Build the InfluenceDef without finalizing. */
+    _buildDef() {
+        const def = {
+            name: this._name,
+            mode: this._mode,
+            range: this._range,
+            effect: { ...this._effect },
+            duration: this._duration,
+        };
+        if (this._witnessed !== undefined)
+            def.witnessed = this._witnessed;
+        if (this._resisted !== undefined)
+            def.resisted = this._resisted;
+        if (this._schedule !== undefined)
+            def.schedule = { ...this._schedule };
+        if (this._onPlayerAction !== undefined)
+            def.onPlayerAction = this._onPlayerAction;
+        if (this._lingeringTurns !== undefined)
+            def.lingeringTurns = this._lingeringTurns;
+        if (this._lingeringClearCondition !== undefined)
+            def.lingeringClearCondition = this._lingeringClearCondition;
+        return def;
+    }
+}
+exports.InfluenceBuilder = InfluenceBuilder;
+//# sourceMappingURL=builder.js.map

package/influence/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/influence/builder.ts"],"names":[],"mappings":"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"}

package/influence/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * NPC influence exports (ADR-146)
+ *
+ * Influence definitions, evaluation engine, duration tracking,
+ * and PC influence handling.
+ *
+ * Public interface: All re-exported types, classes, and functions.
+ * Owner context: @sharpee/character / influence
+ */
+export { type InfluenceMode, type InfluenceRange, type InfluenceDuration, type InfluenceEffect, type InfluenceSchedule, type InfluenceDef, type ResistanceDef, type ActiveInfluenceEffect, type InfluenceResult, } from './influence-types';
+export { type InfluenceRoomEntity, checkResistance, evaluatePassiveInfluences, evaluateActiveInfluence, } from './influence-evaluator';
+export { InfluenceTracker } from './influence-duration';
+export { type PcInfluenceResult, evaluatePcInfluence, } from './pc-influence';
+export { InfluenceBuilder } from './builder';
+export { InfluenceMessages, type InfluenceMessageId, } from './influence-messages';
+//# sourceMappingURL=index.d.ts.map

package/influence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/influence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,mBAAmB,EACxB,eAAe,EACf,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EACL,KAAK,iBAAiB,EACtB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC"}

package/influence/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * NPC influence exports (ADR-146)
+ *
+ * Influence definitions, evaluation engine, duration tracking,
+ * and PC influence handling.
+ *
+ * Public interface: All re-exported types, classes, and functions.
+ * Owner context: @sharpee/character / influence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InfluenceMessages = exports.InfluenceBuilder = exports.evaluatePcInfluence = exports.InfluenceTracker = exports.evaluateActiveInfluence = exports.evaluatePassiveInfluences = exports.checkResistance = void 0;
+var influence_evaluator_1 = require("./influence-evaluator");
+Object.defineProperty(exports, "checkResistance", { enumerable: true, get: function () { return influence_evaluator_1.checkResistance; } });
+Object.defineProperty(exports, "evaluatePassiveInfluences", { enumerable: true, get: function () { return influence_evaluator_1.evaluatePassiveInfluences; } });
+Object.defineProperty(exports, "evaluateActiveInfluence", { enumerable: true, get: function () { return influence_evaluator_1.evaluateActiveInfluence; } });
+var influence_duration_1 = require("./influence-duration");
+Object.defineProperty(exports, "InfluenceTracker", { enumerable: true, get: function () { return influence_duration_1.InfluenceTracker; } });
+var pc_influence_1 = require("./pc-influence");
+Object.defineProperty(exports, "evaluatePcInfluence", { enumerable: true, get: function () { return pc_influence_1.evaluatePcInfluence; } });
+var builder_1 = require("./builder");
+Object.defineProperty(exports, "InfluenceBuilder", { enumerable: true, get: function () { return builder_1.InfluenceBuilder; } });
+var influence_messages_1 = require("./influence-messages");
+Object.defineProperty(exports, "InfluenceMessages", { enumerable: true, get: function () { return influence_messages_1.InfluenceMessages; } });
+//# sourceMappingURL=index.js.map

package/influence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/influence/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAcH,6DAK+B;AAH7B,sHAAA,eAAe,OAAA;AACf,gIAAA,yBAAyB,OAAA;AACzB,8HAAA,uBAAuB,OAAA;AAGzB,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AAEzB,+CAGwB;AADtB,mHAAA,mBAAmB,OAAA;AAGrB,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA;AAEzB,2DAG8B;AAF5B,uHAAA,iBAAiB,OAAA"}

package/influence/influence-duration.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Influence duration tracking (ADR-146 layer 3)
+ *
+ * Tracks active influence effects and manages their expiration:
+ * 'while present' clears when influencer leaves room,
+ * 'momentary' clears after one turn,
+ * 'lingering' clears after authored turns or when a condition is met.
+ *
+ * Public interface: InfluenceTracker.
+ * Owner context: @sharpee/character / influence
+ */
+import { ActiveInfluenceEffect, InfluenceEffect, InfluenceDuration } from './influence-types';
+/**
+ * Tracks and manages active influence effects across turns.
+ *
+ * The tracker maintains a list of currently active effects and
+ * provides methods to add, query, and expire them.
+ */
+export declare class InfluenceTracker {
+    private effects;
+    /**
+     * Record a new active influence effect.
+     *
+     * @param influenceName - The influence name
+     * @param influencerId - The influencer entity ID
+     * @param targetId - The target entity ID
+     * @param effect - The applied effect mutations
+     * @param options - Duration, timing, and clear condition options
+     */
+    track(influenceName: string, influencerId: string, targetId: string, effect: InfluenceEffect, options: {
+        duration: InfluenceDuration;
+        turn: number;
+        lingeringTurns?: number;
+        clearCondition?: string;
+    }): void;
+    /**
+     * Get all active effects on a specific target.
+     *
+     * @param targetId - The target entity ID
+     * @returns Active effects affecting this target
+     */
+    getEffectsOn(targetId: string): ActiveInfluenceEffect[];
+    /**
+     * Get all active effects from a specific influencer.
+     *
+     * @param influencerId - The influencer entity ID
+     * @returns Active effects from this influencer
+     */
+    getEffectsFrom(influencerId: string): ActiveInfluenceEffect[];
+    /**
+     * Check if a target is under a specific influence.
+     *
+     * @param targetId - The target entity ID
+     * @param influenceName - The influence name
+     * @returns true if the target is currently under this influence
+     */
+    isUnderInfluence(targetId: string, influenceName: string): boolean;
+    /**
+     * Expire 'while present' effects when the influencer leaves a room.
+     *
+     * @param influencerId - The influencer who left
+     * @param roomEntityIds - Entity IDs still in the room (targets to clear)
+     * @returns Effects that were cleared
+     */
+    expireOnDeparture(influencerId: string, roomEntityIds?: string[]): ActiveInfluenceEffect[];
+    /**
+     * Expire 'momentary' effects and check lingering expiration.
+     * Call once per turn.
+     *
+     * @param currentTurn - The current turn number
+     * @param evaluatePredicate - Function to evaluate clear conditions (targetId, predicate) => boolean
+     * @returns Effects that were cleared
+     */
+    expireTurn(currentTurn: number, evaluatePredicate?: (targetId: string, predicate: string) => boolean): ActiveInfluenceEffect[];
+    /** Get the count of active effects. */
+    get count(): number;
+    /** Export for serialization. */
+    toJSON(): ActiveInfluenceEffect[];
+    /** Restore from serialized data. */
+    static fromJSON(data: ActiveInfluenceEffect[]): InfluenceTracker;
+}
+//# sourceMappingURL=influence-duration.d.ts.map

package/influence/influence-duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"influence-duration.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/influence/influence-duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA+B;IAE9C;;;;;;;;OAQG;IACH,KAAK,CACH,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE;QACP,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,IAAI;IAuBP;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAIvD;;;;;OAKG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAI7D;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;IAMlE;;;;;;OAMG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,qBAAqB,EAAE;IAe1F;;;;;;;OAOG;IACH,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,GACnE,qBAAqB,EAAE;IAoC1B,uCAAuC;IACvC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,gCAAgC;IAChC,MAAM,IAAI,qBAAqB,EAAE;IAIjC,oCAAoC;IACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,EAAE,GAAG,gBAAgB;CAKjE"}

package/influence/influence-duration.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Influence duration tracking (ADR-146 layer 3)
+ *
+ * Tracks active influence effects and manages their expiration:
+ * 'while present' clears when influencer leaves room,
+ * 'momentary' clears after one turn,
+ * 'lingering' clears after authored turns or when a condition is met.
+ *
+ * Public interface: InfluenceTracker.
+ * Owner context: @sharpee/character / influence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InfluenceTracker = void 0;
+/**
+ * Tracks and manages active influence effects across turns.
+ *
+ * The tracker maintains a list of currently active effects and
+ * provides methods to add, query, and expire them.
+ */
+class InfluenceTracker {
+    effects = [];
+    /**
+     * Record a new active influence effect.
+     *
+     * @param influenceName - The influence name
+     * @param influencerId - The influencer entity ID
+     * @param targetId - The target entity ID
+     * @param effect - The applied effect mutations
+     * @param options - Duration, timing, and clear condition options
+     */
+    track(influenceName, influencerId, targetId, effect, options) {
+        const { duration, turn, lingeringTurns, clearCondition } = options;
+        // Don't double-track the same influence on the same target from the same source
+        const existing = this.effects.findIndex(e => e.influenceName === influenceName &&
+            e.influencerId === influencerId &&
+            e.targetId === targetId);
+        if (existing >= 0)
+            return;
+        this.effects.push({
+            influenceName,
+            influencerId,
+            targetId,
+            effect: { ...effect },
+            duration,
+            appliedAtTurn: turn,
+            expiresAtTurn: lingeringTurns != null ? turn + lingeringTurns : undefined,
+            clearCondition,
+        });
+    }
+    /**
+     * Get all active effects on a specific target.
+     *
+     * @param targetId - The target entity ID
+     * @returns Active effects affecting this target
+     */
+    getEffectsOn(targetId) {
+        return this.effects.filter(e => e.targetId === targetId);
+    }
+    /**
+     * Get all active effects from a specific influencer.
+     *
+     * @param influencerId - The influencer entity ID
+     * @returns Active effects from this influencer
+     */
+    getEffectsFrom(influencerId) {
+        return this.effects.filter(e => e.influencerId === influencerId);
+    }
+    /**
+     * Check if a target is under a specific influence.
+     *
+     * @param targetId - The target entity ID
+     * @param influenceName - The influence name
+     * @returns true if the target is currently under this influence
+     */
+    isUnderInfluence(targetId, influenceName) {
+        return this.effects.some(e => e.targetId === targetId && e.influenceName === influenceName);
+    }
+    /**
+     * Expire 'while present' effects when the influencer leaves a room.
+     *
+     * @param influencerId - The influencer who left
+     * @param roomEntityIds - Entity IDs still in the room (targets to clear)
+     * @returns Effects that were cleared
+     */
+    expireOnDeparture(influencerId, roomEntityIds) {
+        const expired = [];
+        this.effects = this.effects.filter(e => {
+            if (e.influencerId === influencerId &&
+                e.duration === 'while present') {
+                expired.push(e);
+                return false;
+            }
+            return true;
+        });
+        return expired;
+    }
+    /**
+     * Expire 'momentary' effects and check lingering expiration.
+     * Call once per turn.
+     *
+     * @param currentTurn - The current turn number
+     * @param evaluatePredicate - Function to evaluate clear conditions (targetId, predicate) => boolean
+     * @returns Effects that were cleared
+     */
+    expireTurn(currentTurn, evaluatePredicate) {
+        const expired = [];
+        this.effects = this.effects.filter(e => {
+            // Momentary: expires after one turn (applied on turn N, gone on turn N+1)
+            if (e.duration === 'momentary' && currentTurn > e.appliedAtTurn) {
+                expired.push(e);
+                return false;
+            }
+            // Lingering with turn limit
+            if (e.duration === 'lingering' &&
+                e.expiresAtTurn !== undefined &&
+                currentTurn >= e.expiresAtTurn) {
+                expired.push(e);
+                return false;
+            }
+            // Lingering with clear condition
+            if (e.duration === 'lingering' &&
+                e.clearCondition &&
+                evaluatePredicate?.(e.targetId, e.clearCondition)) {
+                expired.push(e);
+                return false;
+            }
+            return true;
+        });
+        return expired;
+    }
+    /** Get the count of active effects. */
+    get count() {
+        return this.effects.length;
+    }
+    /** Export for serialization. */
+    toJSON() {
+        return this.effects.map(e => ({ ...e, effect: { ...e.effect } }));
+    }
+    /** Restore from serialized data. */
+    static fromJSON(data) {
+        const tracker = new InfluenceTracker();
+        tracker.effects = data.map(e => ({ ...e, effect: { ...e.effect } }));
+        return tracker;
+    }
+}
+exports.InfluenceTracker = InfluenceTracker;
+//# sourceMappingURL=influence-duration.js.map

package/influence/influence-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"influence-duration.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/influence/influence-duration.ts"],"names":[],"mappings":"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"}