@sharpee/character 0.9.106

package/apply.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Apply compiled character data to an entity (ADR-141)
+ *
+ * Convenience function that creates a CharacterModelTrait from compiled
+ * builder output, registers custom predicates, and adds the trait to
+ * the entity.
+ *
+ * Public interface: applyCharacter.
+ * Owner context: @sharpee/character
+ */
+import { IFEntity, CharacterModelTrait } from "../world-model/index";
+import { CompiledCharacter } from './character-builder';
+/**
+ * Apply a compiled character to an entity.
+ *
+ * Creates the CharacterModelTrait, registers custom predicates,
+ * and adds the trait to the entity. Returns the trait for further
+ * programmatic manipulation if needed.
+ *
+ * @param entity - The NPC entity to apply the character model to
+ * @param compiled - Output of CharacterBuilder.compile()
+ * @returns The created CharacterModelTrait instance
+ */
+export declare function applyCharacter(entity: IFEntity, compiled: CompiledCharacter): CharacterModelTrait;
+//# sourceMappingURL=apply.d.ts.map

package/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/character/src/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,QAAQ,EACR,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,iBAAiB,GAC1B,mBAAmB,CAYrB"}

package/apply.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Apply compiled character data to an entity (ADR-141)
+ *
+ * Convenience function that creates a CharacterModelTrait from compiled
+ * builder output, registers custom predicates, and adds the trait to
+ * the entity.
+ *
+ * Public interface: applyCharacter.
+ * Owner context: @sharpee/character
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyCharacter = applyCharacter;
+const world_model_1 = require("../world-model/index.js");
+/**
+ * Apply a compiled character to an entity.
+ *
+ * Creates the CharacterModelTrait, registers custom predicates,
+ * and adds the trait to the entity. Returns the trait for further
+ * programmatic manipulation if needed.
+ *
+ * @param entity - The NPC entity to apply the character model to
+ * @param compiled - Output of CharacterBuilder.compile()
+ * @returns The created CharacterModelTrait instance
+ */
+function applyCharacter(entity, compiled) {
+    const trait = new world_model_1.CharacterModelTrait(compiled.traitData);
+    // Register custom predicates
+    for (const [name, fn] of compiled.customPredicates) {
+        trait.registerPredicate(name, fn);
+    }
+    // Add trait to entity
+    entity.add(trait);
+    return trait;
+}
+//# sourceMappingURL=apply.js.map

package/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/apply.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAmBH,wCAeC;AAhCD,sDAG8B;AAG9B;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAC5B,MAAgB,EAChB,QAA2B;IAE3B,MAAM,KAAK,GAAG,IAAI,iCAAmB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE1D,6BAA6B;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACnD,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,sBAAsB;IACtB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/character-builder.d.ts

@@ -0,0 +1,282 @@
+/**
+ * Fluent character builder (ADR-141)
+ *
+ * Authors describe characters in words; the builder accumulates state
+ * and compiles it into CharacterModelTrait data, event handlers, and
+ * state mutation rules.
+ *
+ * Public interface: CharacterBuilder, TriggerBuilder.
+ * Owner context: @sharpee/character
+ */
+import { PersonalityExpr, DispositionWord, Mood, ThreatLevel, CognitiveProfile, ConfidenceWord, LucidityConfig, PerceptionFilterConfig, PerceivedEvent, CharacterPredicate, ICharacterModelData } from "../world-model/index";
+import { CognitivePresetName } from './cognitive-presets';
+import { VocabularyExtension } from './vocabulary-extension';
+/** A compiled state mutation triggered by an event or condition. */
+export interface CompiledTrigger {
+    triggerName: string;
+    condition?: string;
+    mutations: TriggerMutation[];
+}
+/** A single mutation within a trigger. */
+export type TriggerMutation = {
+    type: 'setMood';
+    mood: Mood | string;
+} | {
+    type: 'setDisposition';
+    entityId: string;
+    word: DispositionWord;
+} | {
+    type: 'setThreat';
+    level: ThreatLevel;
+} | {
+    type: 'adjustThreat';
+    delta: number;
+} | {
+    type: 'becomesLucid';
+};
+/**
+ * Fluent chain for defining state transitions on triggers.
+ *
+ * Usage: `builder.on('player threatens').becomes('panicked').feelsAbout('player', 'wary of')`
+ */
+export declare class TriggerBuilder {
+    private trigger;
+    private parentBuilder;
+    constructor(triggerName: string, parent: CharacterBuilder);
+    /**
+     * Add a condition predicate to this trigger.
+     *
+     * @param predicate - Predicate name that must be true for this trigger to fire
+     * @returns this for chaining
+     */
+    if(predicate: string): TriggerBuilder;
+    /**
+     * Set the NPC's mood when this trigger fires.
+     *
+     * @param mood - Mood word
+     * @returns this for chaining
+     */
+    becomes(mood: Mood | string): TriggerBuilder;
+    /**
+     * Set the NPC's disposition toward an entity when this trigger fires.
+     *
+     * @param entityId - Target entity
+     * @param word - Disposition word
+     * @returns this for chaining
+     */
+    feelsAbout(entityId: string, word: DispositionWord): TriggerBuilder;
+    /**
+     * Set the NPC's threat level when this trigger fires.
+     *
+     * @param level - Threat level word or numeric delta prefixed with + or -
+     * @returns this for chaining
+     */
+    shift(dimension: 'threat', level: ThreatLevel): TriggerBuilder;
+    /**
+     * Enter a lucid window when this trigger fires.
+     *
+     * @returns this for chaining
+     */
+    becomesLucid(): TriggerBuilder;
+    /**
+     * Finalize this trigger and return the parent builder.
+     *
+     * @returns The parent CharacterBuilder
+     */
+    done(): CharacterBuilder;
+    /**
+     * Start a new trigger, auto-finalizing this one.
+     * Allows chaining `.on()` directly from a trigger without calling `.done()`.
+     *
+     * @param triggerName - Event type or condition name for the next trigger
+     * @returns A new TriggerBuilder
+     */
+    on(triggerName: string): TriggerBuilder;
+    /**
+     * Compile the builder, auto-finalizing this trigger.
+     * Allows calling `.compile()` directly from a trigger chain.
+     *
+     * @returns Compiled character data
+     */
+    compile(): CompiledCharacter;
+    /** @internal Get the compiled trigger without finalizing. */
+    _getTrigger(): CompiledTrigger;
+}
+/**
+ * Fluent builder for defining NPC characters.
+ *
+ * Accumulates character state declarations and compiles them into
+ * CharacterModelTrait constructor data, event handler functions,
+ * and state mutation rules.
+ */
+export declare class CharacterBuilder {
+    private _id;
+    private _personality;
+    private _dispositions;
+    private _mood;
+    private _threat;
+    private _cognitiveProfile;
+    private _knowledge;
+    private _beliefs;
+    private _goals;
+    private _lucidityConfig?;
+    private _perceptionFilters?;
+    private _perceivedEvents;
+    private _triggers;
+    private _customPredicates;
+    private _activeTriggerBuilder?;
+    private _vocabExtension?;
+    /**
+     * Create a new character builder.
+     *
+     * @param id - Character identifier (matches the NPC entity ID)
+     */
+    constructor(id: string);
+    /** The character ID. */
+    get id(): string;
+    /**
+     * Set personality traits.
+     *
+     * @param traits - Personality expressions like 'very honest', 'cowardly'
+     * @returns this for chaining
+     */
+    personality(...traits: (PersonalityExpr | string)[]): CharacterBuilder;
+    /**
+     * Set disposition toward an entity using a word.
+     *
+     * @param entityId - Target entity
+     * @param word - Disposition word
+     * @returns this for chaining
+     */
+    dispositionToward(entityId: string, word: DispositionWord): CharacterBuilder;
+    /** Shorthand: set disposition toward entity to 'devoted to'. */
+    loyalTo(entityId: string): CharacterBuilder;
+    /** Shorthand: set disposition toward entity to 'likes'. */
+    likes(entityId: string): CharacterBuilder;
+    /** Shorthand: set disposition toward entity to 'trusts'. */
+    trusts(entityId: string): CharacterBuilder;
+    /** Shorthand: set disposition toward entity to 'dislikes'. */
+    dislikes(entityId: string): CharacterBuilder;
+    /** Shorthand: set disposition toward entity to 'wary of'. */
+    distrusts(entityId: string): CharacterBuilder;
+    /**
+     * Set the starting mood.
+     *
+     * @param word - Mood word
+     * @returns this for chaining
+     */
+    mood(word: Mood | string): CharacterBuilder;
+    /**
+     * Set the starting threat level.
+     *
+     * @param level - Threat level word
+     * @returns this for chaining
+     */
+    threat(level: ThreatLevel): CharacterBuilder;
+    /**
+     * Set the cognitive profile from a named preset or partial override.
+     *
+     * @param profile - A preset name string or partial CognitiveProfile object
+     * @returns this for chaining
+     */
+    cognitiveProfile(profile: CognitivePresetName | string | Partial<CognitiveProfile>): CharacterBuilder;
+    /**
+     * Declare that the NPC knows about a topic.
+     *
+     * @param topic - What the NPC knows about
+     * @param opts - Optional: how they know and how confident
+     * @returns this for chaining
+     */
+    knows(topic: string, opts?: {
+        witnessed?: boolean;
+        confidence?: ConfidenceWord;
+    }): CharacterBuilder;
+    /**
+     * Declare a belief the NPC holds (may differ from facts).
+     *
+     * @param topic - What the belief is about
+     * @param opts - Strength and resistance
+     * @returns this for chaining
+     */
+    believes(topic: string, opts?: {
+        strength?: ConfidenceWord;
+        resistance?: 'none' | 'reinterprets' | 'ignores';
+    }): CharacterBuilder;
+    /**
+     * Add a goal with priority.
+     *
+     * @param id - Goal identifier
+     * @param priority - Numeric priority (higher = more important)
+     * @returns this for chaining
+     */
+    goal(id: string, priority: number): CharacterBuilder;
+    /**
+     * Configure lucidity windows.
+     *
+     * @param config - Lucidity window configuration
+     * @returns this for chaining
+     */
+    lucidity(config: LucidityConfig): CharacterBuilder;
+    /**
+     * Configure perception filters (for filtered perception).
+     *
+     * @param config - Categories to miss and amplify
+     * @returns this for chaining
+     */
+    filters(config: PerceptionFilterConfig): CharacterBuilder;
+    /**
+     * Define a hallucinated perceived event (for augmented perception).
+     *
+     * @param topic - Topic of the hallucinated event
+     * @param opts - When it occurs and how it's stored
+     * @returns this for chaining
+     */
+    perceives(topic: string, opts: PerceivedEvent): CharacterBuilder;
+    /**
+     * Begin a trigger chain for a named event or condition.
+     *
+     * @param triggerName - Event type or condition name
+     * @returns A TriggerBuilder for fluent chaining
+     */
+    on(triggerName: string): TriggerBuilder;
+    /** @internal Called by TriggerBuilder.done() to register and clear the active trigger. */
+    _finalizeTrigger(trigger: CompiledTrigger): void;
+    /** @internal Kept for backward compat — delegates to _finalizeTrigger. */
+    _addTrigger(trigger: CompiledTrigger): void;
+    /** @internal Finalize any pending trigger builder that wasn't explicitly done(). */
+    private _finalizePendingTrigger;
+    /**
+     * Register a custom predicate function.
+     *
+     * @param name - Predicate name
+     * @param fn - Function that evaluates against CharacterModelTrait state
+     * @returns this for chaining
+     */
+    definePredicate(name: string, fn: CharacterPredicate): CharacterBuilder;
+    /**
+     * Attach a vocabulary extension for story-specific words.
+     *
+     * @param ext - VocabularyExtension instance
+     * @returns this for chaining
+     */
+    withVocabulary(ext: VocabularyExtension): CharacterBuilder;
+    /**
+     * Compile the builder state into CharacterModelTrait constructor data,
+     * compiled event handlers, and custom predicates.
+     *
+     * @returns Compiled character data
+     */
+    compile(): CompiledCharacter;
+}
+/** The output of CharacterBuilder.compile(). */
+export interface CompiledCharacter {
+    /** Character ID. */
+    id: string;
+    /** Data for constructing CharacterModelTrait. */
+    traitData: ICharacterModelData;
+    /** Compiled trigger rules for event-driven state mutations. */
+    triggers: CompiledTrigger[];
+    /** Custom predicates to register on the trait after construction. */
+    customPredicates: Map<string, CharacterPredicate>;
+}
+//# sourceMappingURL=character-builder.d.ts.map

package/character-builder.d.ts.map

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

package/character-builder.js

@@ -0,0 +1,475 @@
+"use strict";
+/**
+ * Fluent character builder (ADR-141)
+ *
+ * Authors describe characters in words; the builder accumulates state
+ * and compiles it into CharacterModelTrait data, event handlers, and
+ * state mutation rules.
+ *
+ * Public interface: CharacterBuilder, TriggerBuilder.
+ * Owner context: @sharpee/character
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CharacterBuilder = exports.TriggerBuilder = void 0;
+const world_model_1 = require("../world-model/index.js");
+const cognitive_presets_1 = require("./cognitive-presets");
+/**
+ * Fluent chain for defining state transitions on triggers.
+ *
+ * Usage: `builder.on('player threatens').becomes('panicked').feelsAbout('player', 'wary of')`
+ */
+class TriggerBuilder {
+    trigger;
+    parentBuilder;
+    constructor(triggerName, parent) {
+        this.trigger = { triggerName, mutations: [] };
+        this.parentBuilder = parent;
+    }
+    /**
+     * Add a condition predicate to this trigger.
+     *
+     * @param predicate - Predicate name that must be true for this trigger to fire
+     * @returns this for chaining
+     */
+    if(predicate) {
+        this.trigger.condition = predicate;
+        return this;
+    }
+    /**
+     * Set the NPC's mood when this trigger fires.
+     *
+     * @param mood - Mood word
+     * @returns this for chaining
+     */
+    becomes(mood) {
+        this.trigger.mutations.push({ type: 'setMood', mood });
+        return this;
+    }
+    /**
+     * Set the NPC's disposition toward an entity when this trigger fires.
+     *
+     * @param entityId - Target entity
+     * @param word - Disposition word
+     * @returns this for chaining
+     */
+    feelsAbout(entityId, word) {
+        this.trigger.mutations.push({ type: 'setDisposition', entityId, word });
+        return this;
+    }
+    /**
+     * Set the NPC's threat level when this trigger fires.
+     *
+     * @param level - Threat level word or numeric delta prefixed with + or -
+     * @returns this for chaining
+     */
+    shift(dimension, level) {
+        this.trigger.mutations.push({ type: 'setThreat', level });
+        return this;
+    }
+    /**
+     * Enter a lucid window when this trigger fires.
+     *
+     * @returns this for chaining
+     */
+    becomesLucid() {
+        this.trigger.mutations.push({ type: 'becomesLucid' });
+        return this;
+    }
+    /**
+     * Finalize this trigger and return the parent builder.
+     *
+     * @returns The parent CharacterBuilder
+     */
+    done() {
+        this.parentBuilder._finalizeTrigger(this.trigger);
+        return this.parentBuilder;
+    }
+    /**
+     * Start a new trigger, auto-finalizing this one.
+     * Allows chaining `.on()` directly from a trigger without calling `.done()`.
+     *
+     * @param triggerName - Event type or condition name for the next trigger
+     * @returns A new TriggerBuilder
+     */
+    on(triggerName) {
+        return this.done().on(triggerName);
+    }
+    /**
+     * Compile the builder, auto-finalizing this trigger.
+     * Allows calling `.compile()` directly from a trigger chain.
+     *
+     * @returns Compiled character data
+     */
+    compile() {
+        return this.done().compile();
+    }
+    /** @internal Get the compiled trigger without finalizing. */
+    _getTrigger() {
+        return this.trigger;
+    }
+}
+exports.TriggerBuilder = TriggerBuilder;
+// ---------------------------------------------------------------------------
+// Character builder
+// ---------------------------------------------------------------------------
+/**
+ * Fluent builder for defining NPC characters.
+ *
+ * Accumulates character state declarations and compiles them into
+ * CharacterModelTrait constructor data, event handler functions,
+ * and state mutation rules.
+ */
+class CharacterBuilder {
+    _id;
+    _personality = new Map();
+    _dispositions = new Map();
+    _mood = 'calm';
+    _threat = 'safe';
+    _cognitiveProfile = { ...world_model_1.STABLE_COGNITIVE_PROFILE };
+    _knowledge = new Map();
+    _beliefs = new Map();
+    _goals = new Map();
+    _lucidityConfig;
+    _perceptionFilters;
+    _perceivedEvents = new Map();
+    _triggers = [];
+    _customPredicates = new Map();
+    _activeTriggerBuilder;
+    _vocabExtension;
+    /**
+     * Create a new character builder.
+     *
+     * @param id - Character identifier (matches the NPC entity ID)
+     */
+    constructor(id) {
+        this._id = id;
+    }
+    /** The character ID. */
+    get id() {
+        return this._id;
+    }
+    // =========================================================================
+    // Personality
+    // =========================================================================
+    /**
+     * Set personality traits.
+     *
+     * @param traits - Personality expressions like 'very honest', 'cowardly'
+     * @returns this for chaining
+     */
+    personality(...traits) {
+        for (const expr of traits) {
+            const [trait, value] = (0, world_model_1.parsePersonalityExpr)(expr);
+            this._personality.set(trait, value);
+        }
+        return this;
+    }
+    // =========================================================================
+    // Disposition shortcuts
+    // =========================================================================
+    /**
+     * Set disposition toward an entity using a word.
+     *
+     * @param entityId - Target entity
+     * @param word - Disposition word
+     * @returns this for chaining
+     */
+    dispositionToward(entityId, word) {
+        this._dispositions.set(entityId, (0, world_model_1.dispositionToValue)(word));
+        return this;
+    }
+    /** Shorthand: set disposition toward entity to 'devoted to'. */
+    loyalTo(entityId) {
+        return this.dispositionToward(entityId, 'devoted to');
+    }
+    /** Shorthand: set disposition toward entity to 'likes'. */
+    likes(entityId) {
+        return this.dispositionToward(entityId, 'likes');
+    }
+    /** Shorthand: set disposition toward entity to 'trusts'. */
+    trusts(entityId) {
+        return this.dispositionToward(entityId, 'trusts');
+    }
+    /** Shorthand: set disposition toward entity to 'dislikes'. */
+    dislikes(entityId) {
+        return this.dispositionToward(entityId, 'dislikes');
+    }
+    /** Shorthand: set disposition toward entity to 'wary of'. */
+    distrusts(entityId) {
+        return this.dispositionToward(entityId, 'wary of');
+    }
+    // =========================================================================
+    // Mood
+    // =========================================================================
+    /**
+     * Set the starting mood.
+     *
+     * @param word - Mood word
+     * @returns this for chaining
+     */
+    mood(word) {
+        this._mood = word;
+        return this;
+    }
+    // =========================================================================
+    // Threat
+    // =========================================================================
+    /**
+     * Set the starting threat level.
+     *
+     * @param level - Threat level word
+     * @returns this for chaining
+     */
+    threat(level) {
+        this._threat = level;
+        return this;
+    }
+    // =========================================================================
+    // Cognitive profile
+    // =========================================================================
+    /**
+     * Set the cognitive profile from a named preset or partial override.
+     *
+     * @param profile - A preset name string or partial CognitiveProfile object
+     * @returns this for chaining
+     */
+    cognitiveProfile(profile) {
+        if (typeof profile === 'string') {
+            if ((0, cognitive_presets_1.isCognitivePreset)(profile)) {
+                this._cognitiveProfile = { ...cognitive_presets_1.COGNITIVE_PRESETS[profile] };
+            }
+            else {
+                throw new Error(`Unknown cognitive preset: '${profile}'. Available: ${Object.keys(cognitive_presets_1.COGNITIVE_PRESETS).join(', ')}`);
+            }
+        }
+        else {
+            this._cognitiveProfile = { ...world_model_1.STABLE_COGNITIVE_PROFILE, ...profile };
+        }
+        return this;
+    }
+    // =========================================================================
+    // Knowledge
+    // =========================================================================
+    /**
+     * Declare that the NPC knows about a topic.
+     *
+     * @param topic - What the NPC knows about
+     * @param opts - Optional: how they know and how confident
+     * @returns this for chaining
+     */
+    knows(topic, opts) {
+        this._knowledge.set(topic, {
+            source: opts?.witnessed ? 'witnessed' : 'assumed',
+            confidence: opts?.confidence ?? 'believes',
+            turn: 0,
+        });
+        return this;
+    }
+    // =========================================================================
+    // Beliefs
+    // =========================================================================
+    /**
+     * Declare a belief the NPC holds (may differ from facts).
+     *
+     * @param topic - What the belief is about
+     * @param opts - Strength and resistance
+     * @returns this for chaining
+     */
+    believes(topic, opts) {
+        this._beliefs.set(topic, {
+            strength: opts?.strength ?? 'believes',
+            resistance: opts?.resistance ?? 'none',
+        });
+        return this;
+    }
+    // =========================================================================
+    // Goals
+    // =========================================================================
+    /**
+     * Add a goal with priority.
+     *
+     * @param id - Goal identifier
+     * @param priority - Numeric priority (higher = more important)
+     * @returns this for chaining
+     */
+    goal(id, priority) {
+        this._goals.set(id, priority);
+        return this;
+    }
+    // =========================================================================
+    // Lucidity
+    // =========================================================================
+    /**
+     * Configure lucidity windows.
+     *
+     * @param config - Lucidity window configuration
+     * @returns this for chaining
+     */
+    lucidity(config) {
+        this._lucidityConfig = config;
+        return this;
+    }
+    // =========================================================================
+    // Perception
+    // =========================================================================
+    /**
+     * Configure perception filters (for filtered perception).
+     *
+     * @param config - Categories to miss and amplify
+     * @returns this for chaining
+     */
+    filters(config) {
+        this._perceptionFilters = config;
+        return this;
+    }
+    /**
+     * Define a hallucinated perceived event (for augmented perception).
+     *
+     * @param topic - Topic of the hallucinated event
+     * @param opts - When it occurs and how it's stored
+     * @returns this for chaining
+     */
+    perceives(topic, opts) {
+        this._perceivedEvents.set(topic, opts);
+        return this;
+    }
+    // =========================================================================
+    // Triggers (.on() chains)
+    // =========================================================================
+    /**
+     * Begin a trigger chain for a named event or condition.
+     *
+     * @param triggerName - Event type or condition name
+     * @returns A TriggerBuilder for fluent chaining
+     */
+    on(triggerName) {
+        // Finalize any pending trigger builder
+        this._finalizePendingTrigger();
+        const tb = new TriggerBuilder(triggerName, this);
+        this._activeTriggerBuilder = tb;
+        return tb;
+    }
+    /** @internal Called by TriggerBuilder.done() to register and clear the active trigger. */
+    _finalizeTrigger(trigger) {
+        this._triggers.push(trigger);
+        this._activeTriggerBuilder = undefined;
+    }
+    /** @internal Kept for backward compat — delegates to _finalizeTrigger. */
+    _addTrigger(trigger) {
+        this._finalizeTrigger(trigger);
+    }
+    /** @internal Finalize any pending trigger builder that wasn't explicitly done(). */
+    _finalizePendingTrigger() {
+        if (this._activeTriggerBuilder) {
+            this._finalizeTrigger(this._activeTriggerBuilder._getTrigger());
+        }
+    }
+    // =========================================================================
+    // Custom predicates
+    // =========================================================================
+    /**
+     * Register a custom predicate function.
+     *
+     * @param name - Predicate name
+     * @param fn - Function that evaluates against CharacterModelTrait state
+     * @returns this for chaining
+     */
+    definePredicate(name, fn) {
+        this._customPredicates.set(name, fn);
+        return this;
+    }
+    // =========================================================================
+    // Vocabulary extension
+    // =========================================================================
+    /**
+     * Attach a vocabulary extension for story-specific words.
+     *
+     * @param ext - VocabularyExtension instance
+     * @returns this for chaining
+     */
+    withVocabulary(ext) {
+        this._vocabExtension = ext;
+        return this;
+    }
+    // =========================================================================
+    // Compilation
+    // =========================================================================
+    /**
+     * Compile the builder state into CharacterModelTrait constructor data,
+     * compiled event handlers, and custom predicates.
+     *
+     * @returns Compiled character data
+     */
+    compile() {
+        // Finalize any pending trigger
+        this._finalizePendingTrigger();
+        // Build personality record
+        const personality = {};
+        for (const [trait, value] of this._personality) {
+            personality[trait] = value;
+        }
+        // Build dispositions record
+        const dispositions = {};
+        for (const [entityId, value] of this._dispositions) {
+            dispositions[entityId] = value;
+        }
+        // Resolve mood — check custom vocabulary if not a platform mood
+        let moodWord = this._mood;
+        let moodValence;
+        let moodArousal;
+        if (!(this._mood in world_model_1.MOOD_AXES)) {
+            if (this._vocabExtension?.hasCustomMood(this._mood)) {
+                const custom = this._vocabExtension.getCustomMood(this._mood);
+                moodValence = custom.valence;
+                moodArousal = custom.arousal;
+                moodWord = undefined; // will use raw axes
+            }
+        }
+        // Build knowledge record
+        const knowledge = {};
+        for (const [topic, fact] of this._knowledge) {
+            knowledge[topic] = { source: fact.source, confidence: fact.confidence, turnLearned: fact.turn };
+        }
+        // Build beliefs record
+        const beliefs = {};
+        for (const [topic, belief] of this._beliefs) {
+            beliefs[topic] = belief;
+        }
+        // Build goals array
+        const goals = Array.from(this._goals.entries())
+            .map(([id, priority]) => ({ id, priority }))
+            .sort((a, b) => b.priority - a.priority);
+        // Build perceived events
+        const perceivedEvents = {};
+        for (const [topic, pe] of this._perceivedEvents) {
+            perceivedEvents[topic] = pe;
+        }
+        // Assemble trait data
+        const traitData = {
+            personality: personality,
+            dispositions,
+            ...(moodValence !== undefined
+                ? { moodValence, moodArousal: moodArousal }
+                : { mood: moodWord }),
+            threat: this._threat,
+            cognitiveProfile: this._cognitiveProfile,
+            knowledge,
+            beliefs,
+            goals,
+            lucidityConfig: this._lucidityConfig,
+            currentLucidityState: this._lucidityConfig?.baseline,
+            perceptionFilters: this._perceptionFilters,
+            perceivedEvents,
+        };
+        // Collect custom predicates
+        const customPredicates = new Map(this._customPredicates);
+        return {
+            id: this._id,
+            traitData,
+            triggers: [...this._triggers],
+            customPredicates,
+        };
+    }
+}
+exports.CharacterBuilder = CharacterBuilder;
+//# sourceMappingURL=character-builder.js.map

package/character-builder.js.map

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

package/cognitive-presets.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Named cognitive profile presets (ADR-141)
+ *
+ * Documented example profiles for common cognitive conditions.
+ * These are starting points for authors, not platform-level constants.
+ * Authors override any dimension via the builder's cognitiveProfile() method.
+ *
+ * Public interface: COGNITIVE_PRESETS, CognitivePresetName.
+ * Owner context: @sharpee/character
+ */
+import { CognitiveProfile } from "../world-model/index";
+/** Names of built-in cognitive presets. */
+export type CognitivePresetName = 'stable' | 'schizophrenic' | 'ptsd' | 'dementia' | 'dissociative' | 'tbi' | 'obsessive' | 'intoxicated';
+/**
+ * Named cognitive profile presets.
+ *
+ * Each maps to the five-dimensional profile from ADR-141's condition table.
+ * Authors select a preset as a starting point, then override individual
+ * dimensions as needed for their character.
+ */
+export declare const COGNITIVE_PRESETS: Record<CognitivePresetName, CognitiveProfile>;
+/**
+ * Check if a string is a valid cognitive preset name.
+ *
+ * @param name - String to check
+ * @returns True if the name is a recognized preset
+ */
+export declare function isCognitivePreset(name: string): name is CognitivePresetName;
+//# sourceMappingURL=cognitive-presets.d.ts.map

package/cognitive-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-presets.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/character/src/cognitive-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,2CAA2C;AAC3C,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,eAAe,GACf,MAAM,GACN,UAAU,GACV,cAAc,GACd,KAAK,GACL,WAAW,GACX,aAAa,CAAC;AAElB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,CAyD3E,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,mBAAmB,CAE3E"}

package/cognitive-presets.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Named cognitive profile presets (ADR-141)
+ *
+ * Documented example profiles for common cognitive conditions.
+ * These are starting points for authors, not platform-level constants.
+ * Authors override any dimension via the builder's cognitiveProfile() method.
+ *
+ * Public interface: COGNITIVE_PRESETS, CognitivePresetName.
+ * Owner context: @sharpee/character
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COGNITIVE_PRESETS = void 0;
+exports.isCognitivePreset = isCognitivePreset;
+/**
+ * Named cognitive profile presets.
+ *
+ * Each maps to the five-dimensional profile from ADR-141's condition table.
+ * Authors select a preset as a starting point, then override individual
+ * dimensions as needed for their character.
+ */
+exports.COGNITIVE_PRESETS = {
+    stable: {
+        perception: 'accurate',
+        beliefFormation: 'flexible',
+        coherence: 'focused',
+        lucidity: 'stable',
+        selfModel: 'intact',
+    },
+    schizophrenic: {
+        perception: 'augmented',
+        beliefFormation: 'resistant',
+        coherence: 'fragmented',
+        lucidity: 'episodic',
+        selfModel: 'uncertain',
+    },
+    ptsd: {
+        perception: 'filtered',
+        beliefFormation: 'rigid',
+        coherence: 'drifting',
+        lucidity: 'episodic',
+        selfModel: 'uncertain',
+    },
+    dementia: {
+        perception: 'filtered',
+        beliefFormation: 'rigid',
+        coherence: 'fragmented',
+        lucidity: 'fluctuating',
+        selfModel: 'fractured',
+    },
+    dissociative: {
+        perception: 'accurate',
+        beliefFormation: 'flexible',
+        coherence: 'focused',
+        lucidity: 'episodic',
+        selfModel: 'fractured',
+    },
+    tbi: {
+        perception: 'filtered',
+        beliefFormation: 'flexible',
+        coherence: 'drifting',
+        lucidity: 'fluctuating',
+        selfModel: 'uncertain',
+    },
+    obsessive: {
+        perception: 'accurate',
+        beliefFormation: 'resistant',
+        coherence: 'focused',
+        lucidity: 'stable',
+        selfModel: 'intact',
+    },
+    intoxicated: {
+        perception: 'filtered',
+        beliefFormation: 'flexible',
+        coherence: 'drifting',
+        lucidity: 'fluctuating',
+        selfModel: 'intact',
+    },
+};
+/**
+ * Check if a string is a valid cognitive preset name.
+ *
+ * @param name - String to check
+ * @returns True if the name is a recognized preset
+ */
+function isCognitivePreset(name) {
+    return name in exports.COGNITIVE_PRESETS;
+}
+//# sourceMappingURL=cognitive-presets.js.map

package/cognitive-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-presets.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/cognitive-presets.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAuFH,8CAEC;AA1ED;;;;;;GAMG;AACU,QAAA,iBAAiB,GAAkD;IAC9E,MAAM,EAAE;QACN,UAAU,EAAE,UAAU;QACtB,eAAe,EAAE,UAAU;QAC3B,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,QAAQ;KACpB;IACD,aAAa,EAAE;QACb,UAAU,EAAE,WAAW;QACvB,eAAe,EAAE,WAAW;QAC5B,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,WAAW;KACvB;IACD,IAAI,EAAE;QACJ,UAAU,EAAE,UAAU;QACtB,eAAe,EAAE,OAAO;QACxB,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,WAAW;KACvB;IACD,QAAQ,EAAE;QACR,UAAU,EAAE,UAAU;QACtB,eAAe,EAAE,OAAO;QACxB,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,aAAa;QACvB,SAAS,EAAE,WAAW;KACvB;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,UAAU;QACtB,eAAe,EAAE,UAAU;QAC3B,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,WAAW;KACvB;IACD,GAAG,EAAE;QACH,UAAU,EAAE,UAAU;QACtB,eAAe,EAAE,UAAU;QAC3B,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,aAAa;QACvB,SAAS,EAAE,WAAW;KACvB;IACD,SAAS,EAAE;QACT,UAAU,EAAE,UAAU;QACtB,eAAe,EAAE,WAAW;QAC5B,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,QAAQ;KACpB;IACD,WAAW,EAAE;QACX,UAAU,EAAE,UAAU;QACtB,eAAe,EAAE,UAAU;QAC3B,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,aAAa;QACvB,SAAS,EAAE,QAAQ;KACpB;CACF,CAAC;AAEF;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,IAAI,yBAAiB,CAAC;AACnC,CAAC"}

package/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @sharpee/character — Character model builder (ADR-141)
+ *
+ * Fluent builder API for defining NPC characters with rich internal state.
+ * Authors describe characters in words; the builder compiles to trait data
+ * consumed by CharacterModelTrait in @sharpee/world-model.
+ *
+ * Public interface: CharacterBuilder, TriggerBuilder, CompiledCharacter,
+ *   COGNITIVE_PRESETS, VocabularyExtension, applyCharacter.
+ * Owner context: @sharpee/character package
+ */
+export { CharacterBuilder, TriggerBuilder, type CompiledCharacter, type CompiledTrigger, type TriggerMutation, } from './character-builder';
+export { COGNITIVE_PRESETS, isCognitivePreset, type CognitivePresetName, } from './cognitive-presets';
+export { VocabularyExtension, type CustomMoodDef, type CustomPersonalityDef, } from './vocabulary-extension';
+export { applyCharacter } from './apply';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/character/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * @sharpee/character — Character model builder (ADR-141)
+ *
+ * Fluent builder API for defining NPC characters with rich internal state.
+ * Authors describe characters in words; the builder compiles to trait data
+ * consumed by CharacterModelTrait in @sharpee/world-model.
+ *
+ * Public interface: CharacterBuilder, TriggerBuilder, CompiledCharacter,
+ *   COGNITIVE_PRESETS, VocabularyExtension, applyCharacter.
+ * Owner context: @sharpee/character package
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyCharacter = exports.VocabularyExtension = exports.isCognitivePreset = exports.COGNITIVE_PRESETS = exports.TriggerBuilder = exports.CharacterBuilder = void 0;
+var character_builder_1 = require("./character-builder");
+Object.defineProperty(exports, "CharacterBuilder", { enumerable: true, get: function () { return character_builder_1.CharacterBuilder; } });
+Object.defineProperty(exports, "TriggerBuilder", { enumerable: true, get: function () { return character_builder_1.TriggerBuilder; } });
+var cognitive_presets_1 = require("./cognitive-presets");
+Object.defineProperty(exports, "COGNITIVE_PRESETS", { enumerable: true, get: function () { return cognitive_presets_1.COGNITIVE_PRESETS; } });
+Object.defineProperty(exports, "isCognitivePreset", { enumerable: true, get: function () { return cognitive_presets_1.isCognitivePreset; } });
+var vocabulary_extension_1 = require("./vocabulary-extension");
+Object.defineProperty(exports, "VocabularyExtension", { enumerable: true, get: function () { return vocabulary_extension_1.VocabularyExtension; } });
+var apply_1 = require("./apply");
+Object.defineProperty(exports, "applyCharacter", { enumerable: true, get: function () { return apply_1.applyCharacter; } });
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,yDAM6B;AAL3B,qHAAA,gBAAgB,OAAA;AAChB,mHAAA,cAAc,OAAA;AAMhB,yDAI6B;AAH3B,sHAAA,iBAAiB,OAAA;AACjB,sHAAA,iBAAiB,OAAA;AAInB,+DAIgC;AAH9B,2HAAA,mBAAmB,OAAA;AAKrB,iCAAyC;AAAhC,uGAAA,cAAc,OAAA"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@sharpee/character",
+  "version": "0.9.106",
+  "description": "Character model builder for Sharpee Interactive Fiction Platform (ADR-141)",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "dependencies": {
+    "@sharpee/world-model": "^0.9.106",
+    "@sharpee/stdlib": "^0.9.106"
+  },
+  "keywords": [
+    "interactive-fiction",
+    "if",
+    "text-adventure",
+    "sharpee",
+    "character",
+    "npc",
+    "builder"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/character"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/vocabulary-extension.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Story-specific vocabulary extension (ADR-141)
+ *
+ * Allows stories to add custom mood words and personality traits
+ * beyond the platform defaults. Extended vocabulary is validated
+ * by the builder and compiled into trait data.
+ *
+ * Public interface: VocabularyExtension, defineCustomMood, defineCustomPersonality.
+ * Owner context: @sharpee/character
+ */
+/** A custom mood definition with valence-arousal coordinates. */
+export interface CustomMoodDef {
+    name: string;
+    valence: number;
+    arousal: number;
+}
+/** A custom personality trait definition. */
+export interface CustomPersonalityDef {
+    name: string;
+}
+/**
+ * Registry of story-specific vocabulary extensions.
+ *
+ * Stories call defineCustomMood() and defineCustomPersonality()
+ * during initialization. The builder validates against both
+ * platform vocabulary and these extensions.
+ */
+export declare class VocabularyExtension {
+    private customMoods;
+    private customPersonalities;
+    /**
+     * Define a custom mood word with valence-arousal coordinates.
+     *
+     * @param name - The mood word (e.g., 'lovesick')
+     * @param valence - Valence value (-1 to 1)
+     * @param arousal - Arousal value (0 to 1)
+     */
+    defineMood(name: string, valence: number, arousal: number): void;
+    /**
+     * Define a custom personality trait name.
+     *
+     * @param name - The personality trait (e.g., 'righteous')
+     */
+    definePersonality(name: string): void;
+    /**
+     * Check if a mood word is a recognized custom mood.
+     *
+     * @param name - Mood word to check
+     * @returns True if it was registered via defineMood()
+     */
+    hasCustomMood(name: string): boolean;
+    /**
+     * Get a custom mood definition.
+     *
+     * @param name - Mood word to look up
+     * @returns The mood definition, or undefined
+     */
+    getCustomMood(name: string): CustomMoodDef | undefined;
+    /**
+     * Check if a personality trait is a recognized custom trait.
+     *
+     * @param name - Personality trait to check
+     * @returns True if it was registered via definePersonality()
+     */
+    hasCustomPersonality(name: string): boolean;
+    /**
+     * Get all registered custom mood names.
+     *
+     * @returns Array of custom mood names
+     */
+    getCustomMoodNames(): string[];
+    /**
+     * Get all registered custom personality names.
+     *
+     * @returns Array of custom personality trait names
+     */
+    getCustomPersonalityNames(): string[];
+}
+//# sourceMappingURL=vocabulary-extension.d.ts.map

package/vocabulary-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary-extension.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/character/src/vocabulary-extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,mBAAmB,CAA0B;IAErD;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhE;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAItD;;;;;OAKG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;OAIG;IACH,yBAAyB,IAAI,MAAM,EAAE;CAGtC"}

package/vocabulary-extension.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Story-specific vocabulary extension (ADR-141)
+ *
+ * Allows stories to add custom mood words and personality traits
+ * beyond the platform defaults. Extended vocabulary is validated
+ * by the builder and compiled into trait data.
+ *
+ * Public interface: VocabularyExtension, defineCustomMood, defineCustomPersonality.
+ * Owner context: @sharpee/character
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VocabularyExtension = void 0;
+/**
+ * Registry of story-specific vocabulary extensions.
+ *
+ * Stories call defineCustomMood() and defineCustomPersonality()
+ * during initialization. The builder validates against both
+ * platform vocabulary and these extensions.
+ */
+class VocabularyExtension {
+    customMoods = new Map();
+    customPersonalities = new Set();
+    /**
+     * Define a custom mood word with valence-arousal coordinates.
+     *
+     * @param name - The mood word (e.g., 'lovesick')
+     * @param valence - Valence value (-1 to 1)
+     * @param arousal - Arousal value (0 to 1)
+     */
+    defineMood(name, valence, arousal) {
+        this.customMoods.set(name, { name, valence, arousal });
+    }
+    /**
+     * Define a custom personality trait name.
+     *
+     * @param name - The personality trait (e.g., 'righteous')
+     */
+    definePersonality(name) {
+        this.customPersonalities.add(name);
+    }
+    /**
+     * Check if a mood word is a recognized custom mood.
+     *
+     * @param name - Mood word to check
+     * @returns True if it was registered via defineMood()
+     */
+    hasCustomMood(name) {
+        return this.customMoods.has(name);
+    }
+    /**
+     * Get a custom mood definition.
+     *
+     * @param name - Mood word to look up
+     * @returns The mood definition, or undefined
+     */
+    getCustomMood(name) {
+        return this.customMoods.get(name);
+    }
+    /**
+     * Check if a personality trait is a recognized custom trait.
+     *
+     * @param name - Personality trait to check
+     * @returns True if it was registered via definePersonality()
+     */
+    hasCustomPersonality(name) {
+        return this.customPersonalities.has(name);
+    }
+    /**
+     * Get all registered custom mood names.
+     *
+     * @returns Array of custom mood names
+     */
+    getCustomMoodNames() {
+        return Array.from(this.customMoods.keys());
+    }
+    /**
+     * Get all registered custom personality names.
+     *
+     * @returns Array of custom personality trait names
+     */
+    getCustomPersonalityNames() {
+        return Array.from(this.customPersonalities);
+    }
+}
+exports.VocabularyExtension = VocabularyExtension;
+//# sourceMappingURL=vocabulary-extension.js.map

package/vocabulary-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary-extension.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/vocabulary-extension.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAcH;;;;;;GAMG;AACH,MAAa,mBAAmB;IACtB,WAAW,GAA+B,IAAI,GAAG,EAAE,CAAC;IACpD,mBAAmB,GAAgB,IAAI,GAAG,EAAE,CAAC;IAErD;;;;;;OAMG;IACH,UAAU,CAAC,IAAY,EAAE,OAAe,EAAE,OAAe;QACvD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,IAAY;QAC5B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,yBAAyB;QACvB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9C,CAAC;CACF;AAvED,kDAuEC"}