@sharpee/character 0.9.106 → 0.9.107

package/conversation/response-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-types.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/conversation/response-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMvD;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,KAAK,GACL,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,aAAa,CAAC;AAMlB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,MAAM,EAAE,cAAc,CAAC;IAEvB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC;IAEvC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAMD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,MAAM,EAAE,cAAc,CAAC;IAEvB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB,+DAA+D;IAC/D,IAAI,EAAE,IAAI,CAAC;IAEX,wEAAwE;IACxE,SAAS,EAAE,SAAS,CAAC;IAErB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,MAAM,EAAE,cAAc,CAAC;IAEvB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE1C,4DAA4D;IAC5D,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;CAC3C;AAMD,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IAEd,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;AAM1D,0CAA0C;AAC1C,wBAAgB,wBAAwB,IAAI,kBAAkB,CAK7D;AAED,sCAAsC;AACtC,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/conversation/response-types.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Conversation response types (ADR-142)
+ *
+ * Type definitions for constraint-based response selection:
+ * ResponseAction, ResponseCandidate, ResponseIntent, and
+ * conversation/evidence tracking records.
+ *
+ * Public interface: ResponseAction, ResponseCandidate, ResponseIntent,
+ *   ConversationRecord, ConversationEntry, EvidenceRecord, EvidenceEntry.
+ * Owner context: @sharpee/character / conversation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConversationRecord = createConversationRecord;
+exports.createEvidenceRecord = createEvidenceRecord;
+// ---------------------------------------------------------------------------
+// Factory helpers
+// ---------------------------------------------------------------------------
+/** Create an empty ConversationRecord. */
+function createConversationRecord() {
+    return {
+        responses: new Map(),
+        history: new Map(),
+    };
+}
+/** Create an empty EvidenceRecord. */
+function createEvidenceRecord() {
+    return new Map();
+}
+//# sourceMappingURL=response-types.js.map

package/conversation/response-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-types.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/character/src/conversation/response-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AA0IH,4DAKC;AAGD,oDAEC;AAfD,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,0CAA0C;AAC1C,SAAgB,wBAAwB;IACtC,OAAO;QACL,SAAS,EAAE,IAAI,GAAG,EAAE;QACpB,OAAO,EAAE,IAAI,GAAG,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,sCAAsC;AACtC,SAAgB,oBAAoB;IAClC,OAAO,IAAI,GAAG,EAAE,CAAC;AACnB,CAAC"}

package/conversation/topic-registry.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Topic registry and resolution (ADR-142)
+ *
+ * Authors define topics with keyword sets and optional relationships.
+ * The registry resolves free-text player input to authored topics
+ * using exact normalized word matching with neighborhood fallback.
+ *
+ * Public interface: TopicDef, TopicRegistry.
+ * Owner context: @sharpee/character / conversation
+ */
+import { CharacterModelTrait } from "../../world-model/index";
+/** An authored topic definition with keywords, relationships, and availability. */
+export interface TopicDef {
+    /** The canonical topic name (used as key). */
+    name: string;
+    /**
+     * Exact keyword set for matching player input.
+     * Stored normalized (lowercase, trimmed). Each entry can be
+     * a single word or a multi-word phrase.
+     */
+    keywords: string[];
+    /**
+     * Related topic names — the neighborhood for fallback matching.
+     * When the player's input doesn't match any topic exactly but
+     * matches a related topic, the NPC can redirect.
+     */
+    related?: string[];
+    /**
+     * Predicate names that must all be satisfied for this topic to be
+     * available to the player. Evaluated against the NPC's character state.
+     * If empty or undefined, the topic is always available.
+     */
+    availableWhen?: string[];
+}
+/** The result of resolving player text to a topic. */
+export type TopicResolution = {
+    type: 'exact';
+    topic: TopicDef;
+} | {
+    type: 'related';
+    topic: TopicDef;
+    via: TopicDef;
+} | {
+    type: 'none';
+};
+/**
+ * Registry of authored topics for a single NPC.
+ *
+ * Topics are defined once during character building. At runtime,
+ * the registry resolves player free-text input to the best matching
+ * topic, considering keyword matches and topic neighborhoods.
+ */
+export declare class TopicRegistry {
+    private readonly topics;
+    /**
+     * Register a topic definition.
+     *
+     * @param def - The topic definition to register
+     * @throws Error if a topic with the same name is already registered
+     */
+    define(def: TopicDef): void;
+    /**
+     * Get a topic by its canonical name.
+     *
+     * @param name - The topic name
+     * @returns The topic definition, or undefined
+     */
+    get(name: string): TopicDef | undefined;
+    /**
+     * Check whether a topic is available given the NPC's current state.
+     *
+     * @param name - The topic name
+     * @param npcTrait - The NPC's CharacterModelTrait for predicate evaluation
+     * @returns True if the topic exists and its availability predicates are satisfied
+     */
+    isAvailable(name: string, npcTrait: CharacterModelTrait): boolean;
+    /**
+     * Resolve player free-text input to a topic.
+     *
+     * Resolution algorithm:
+     * 1. Normalize input to lowercase words
+     * 2. Score each available topic by keyword hits (exact word match)
+     * 3. If any topic has hits, select the one with the most hits (exact match)
+     * 4. If no exact match, check if input matches keywords of any related topic
+     *    and redirect through the neighborhood
+     * 5. If no match at all, return { type: 'none' }
+     *
+     * @param text - Raw text from the player (e.g., "the murder weapon")
+     * @param npcTrait - The NPC's CharacterModelTrait for availability checks
+     * @returns Resolution result: exact match, related redirect, or no match
+     */
+    resolve(text: string, npcTrait: CharacterModelTrait): TopicResolution;
+    /**
+     * Search for a related-topic redirect when no exact match was found.
+     *
+     * For each available topic with related topics, checks if the input
+     * matches any related topic's keywords. Returns the first match as
+     * a redirect resolution.
+     *
+     * @param inputWords - Input split into normalized words
+     * @param inputNormalized - Full normalized input string
+     * @param npcTrait - The NPC's CharacterModelTrait for availability checks
+     * @returns Related redirect resolution, or { type: 'none' }
+     */
+    private findRelatedRedirect;
+    /**
+     * Get all registered topic names.
+     *
+     * @returns Array of topic names
+     */
+    getTopicNames(): string[];
+    /**
+     * Get all topics that are currently available to the player.
+     *
+     * @param npcTrait - The NPC's CharacterModelTrait for predicate evaluation
+     * @returns Array of available topic definitions
+     */
+    getAvailableTopics(npcTrait: CharacterModelTrait): TopicDef[];
+    /**
+     * Score how well the input matches a keyword set.
+     * Each keyword that appears as a word or phrase in the input scores 1.
+     *
+     * @param inputWords - Input split into normalized words
+     * @param inputNormalized - Full normalized input string
+     * @param keywords - The topic's keyword set (already normalized)
+     * @returns Number of keyword hits
+     */
+    private scoreKeywordMatch;
+}
+//# sourceMappingURL=topic-registry.d.ts.map

package/conversation/topic-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-registry.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/conversation/topic-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM3D,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD,sDAAsD;AACtD,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMrB;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAY3B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO;IAWjE;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,eAAe;IA0BrE;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;;;OAIG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,QAAQ,EAAE;IAc7D;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;CAmB1B"}

package/conversation/topic-registry.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * Topic registry and resolution (ADR-142)
+ *
+ * Authors define topics with keyword sets and optional relationships.
+ * The registry resolves free-text player input to authored topics
+ * using exact normalized word matching with neighborhood fallback.
+ *
+ * Public interface: TopicDef, TopicRegistry.
+ * Owner context: @sharpee/character / conversation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicRegistry = void 0;
+// ---------------------------------------------------------------------------
+// Topic registry
+// ---------------------------------------------------------------------------
+/**
+ * Registry of authored topics for a single NPC.
+ *
+ * Topics are defined once during character building. At runtime,
+ * the registry resolves player free-text input to the best matching
+ * topic, considering keyword matches and topic neighborhoods.
+ */
+class TopicRegistry {
+    topics = new Map();
+    /**
+     * Register a topic definition.
+     *
+     * @param def - The topic definition to register
+     * @throws Error if a topic with the same name is already registered
+     */
+    define(def) {
+        if (this.topics.has(def.name)) {
+            throw new Error(`Topic '${def.name}' is already defined`);
+        }
+        // Normalize keywords at registration time
+        const normalized = {
+            ...def,
+            keywords: def.keywords.map(k => k.toLowerCase().trim()),
+        };
+        this.topics.set(def.name, normalized);
+    }
+    /**
+     * Get a topic by its canonical name.
+     *
+     * @param name - The topic name
+     * @returns The topic definition, or undefined
+     */
+    get(name) {
+        return this.topics.get(name);
+    }
+    /**
+     * Check whether a topic is available given the NPC's current state.
+     *
+     * @param name - The topic name
+     * @param npcTrait - The NPC's CharacterModelTrait for predicate evaluation
+     * @returns True if the topic exists and its availability predicates are satisfied
+     */
+    isAvailable(name, npcTrait) {
+        const topic = this.topics.get(name);
+        if (!topic)
+            return false;
+        if (!topic.availableWhen || topic.availableWhen.length === 0) {
+            return true;
+        }
+        return topic.availableWhen.every(pred => npcTrait.evaluate(pred));
+    }
+    /**
+     * Resolve player free-text input to a topic.
+     *
+     * Resolution algorithm:
+     * 1. Normalize input to lowercase words
+     * 2. Score each available topic by keyword hits (exact word match)
+     * 3. If any topic has hits, select the one with the most hits (exact match)
+     * 4. If no exact match, check if input matches keywords of any related topic
+     *    and redirect through the neighborhood
+     * 5. If no match at all, return { type: 'none' }
+     *
+     * @param text - Raw text from the player (e.g., "the murder weapon")
+     * @param npcTrait - The NPC's CharacterModelTrait for availability checks
+     * @returns Resolution result: exact match, related redirect, or no match
+     */
+    resolve(text, npcTrait) {
+        const inputWords = text.toLowerCase().trim().split(/\s+/);
+        const inputNormalized = text.toLowerCase().trim();
+        // Phase 1: Score each available topic by keyword hits
+        let bestTopic;
+        let bestScore = 0;
+        for (const topic of this.topics.values()) {
+            if (!this.isAvailable(topic.name, npcTrait))
+                continue;
+            const score = this.scoreKeywordMatch(inputWords, inputNormalized, topic.keywords);
+            if (score > bestScore) {
+                bestScore = score;
+                bestTopic = topic;
+            }
+        }
+        if (bestTopic) {
+            return { type: 'exact', topic: bestTopic };
+        }
+        // Phase 2: Check related topic neighborhoods
+        return this.findRelatedRedirect(inputWords, inputNormalized, npcTrait);
+    }
+    /**
+     * Search for a related-topic redirect when no exact match was found.
+     *
+     * For each available topic with related topics, checks if the input
+     * matches any related topic's keywords. Returns the first match as
+     * a redirect resolution.
+     *
+     * @param inputWords - Input split into normalized words
+     * @param inputNormalized - Full normalized input string
+     * @param npcTrait - The NPC's CharacterModelTrait for availability checks
+     * @returns Related redirect resolution, or { type: 'none' }
+     */
+    findRelatedRedirect(inputWords, inputNormalized, npcTrait) {
+        for (const topic of this.topics.values()) {
+            if (!this.isAvailable(topic.name, npcTrait))
+                continue;
+            if (topic.related) {
+                for (const relatedName of topic.related) {
+                    const relatedTopic = this.topics.get(relatedName);
+                    if (!relatedTopic)
+                        continue;
+                    const score = this.scoreKeywordMatch(inputWords, inputNormalized, relatedTopic.keywords);
+                    if (score > 0) {
+                        return { type: 'related', topic, via: relatedTopic };
+                    }
+                }
+            }
+        }
+        return { type: 'none' };
+    }
+    /**
+     * Get all registered topic names.
+     *
+     * @returns Array of topic names
+     */
+    getTopicNames() {
+        return Array.from(this.topics.keys());
+    }
+    /**
+     * Get all topics that are currently available to the player.
+     *
+     * @param npcTrait - The NPC's CharacterModelTrait for predicate evaluation
+     * @returns Array of available topic definitions
+     */
+    getAvailableTopics(npcTrait) {
+        const result = [];
+        for (const topic of this.topics.values()) {
+            if (this.isAvailable(topic.name, npcTrait)) {
+                result.push(topic);
+            }
+        }
+        return result;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Score how well the input matches a keyword set.
+     * Each keyword that appears as a word or phrase in the input scores 1.
+     *
+     * @param inputWords - Input split into normalized words
+     * @param inputNormalized - Full normalized input string
+     * @param keywords - The topic's keyword set (already normalized)
+     * @returns Number of keyword hits
+     */
+    scoreKeywordMatch(inputWords, inputNormalized, keywords) {
+        let score = 0;
+        for (const keyword of keywords) {
+            if (keyword.includes(' ')) {
+                // Multi-word phrase: check substring match in full input
+                if (inputNormalized.includes(keyword)) {
+                    score++;
+                }
+            }
+            else if (inputWords.includes(keyword)) {
+                // Single word: check exact word match
+                score++;
+            }
+        }
+        return score;
+    }
+}
+exports.TopicRegistry = TopicRegistry;
+//# sourceMappingURL=topic-registry.js.map

package/conversation/topic-registry.js.map

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

package/goals/builder.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Goal builder API (ADR-145 layer 5)
+ *
+ * Fluent builder for defining NPC goals with activation conditions,
+ * pursuit modes, behavior sequences, and interruption rules.
+ * Returns from CharacterBuilder.goal(id) and compiles to GoalDef
+ * stored in CompiledCharacter.goalDefs.
+ *
+ * Public interface: GoalBuilder.
+ * Owner context: @sharpee/character / goals
+ */
+import { GoalPriority, PursuitMode, GoalStep, GoalDef } from './goal-types';
+/**
+ * Fluent builder for a single goal definition.
+ *
+ * Usage:
+ * ```
+ * builder.goal('eliminate-player')
+ *   .activatesWhen('knows murder discovered', 'has weapon')
+ *   .priority('critical')
+ *   .mode('prepared')
+ *   .pursues([
+ *     { type: 'moveTo', target: 'study' },
+ *     { type: 'acquire', target: 'knife' },
+ *   ])
+ *   .actsWhen('alone with player')
+ *   .act('colonel-attacks-player')
+ *   .onInterrupt('colonel-retreats')
+ *   .resumeOnClear(true)
+ *   .done()
+ * ```
+ */
+export declare class GoalBuilder<TParent> {
+    private readonly _id;
+    private readonly _parent;
+    private readonly _finalize;
+    private readonly _activatesWhen;
+    private readonly _interruptedBy;
+    private _priority;
+    private _mode;
+    private _steps;
+    private readonly _actsWhen;
+    private _actMessageId?;
+    private _onInterrupt?;
+    private _resumeOnClear;
+    /**
+     * Create a new goal builder.
+     *
+     * @param id - Unique goal identifier
+     * @param parent - Parent builder to return to on .done()
+     * @param finalize - Callback to register the compiled GoalDef
+     */
+    constructor(id: string, parent: TParent, finalize: (def: GoalDef) => void);
+    /**
+     * Set predicate conditions that activate this goal.
+     *
+     * @param predicates - Predicate names (all must be true)
+     * @returns this for chaining
+     */
+    activatesWhen(...predicates: string[]): GoalBuilder<TParent>;
+    /**
+     * Set goal priority.
+     *
+     * @param priority - Priority word
+     * @returns this for chaining
+     */
+    priority(priority: GoalPriority): GoalBuilder<TParent>;
+    /**
+     * Set pursuit mode.
+     *
+     * @param mode - How the NPC pursues the goal
+     * @returns this for chaining
+     */
+    mode(mode: PursuitMode): GoalBuilder<TParent>;
+    /**
+     * Set the behavior sequence (for sequential and prepared modes).
+     *
+     * @param steps - Array of goal steps
+     * @returns this for chaining
+     */
+    pursues(steps: GoalStep[]): GoalBuilder<TParent>;
+    /**
+     * Set conditions for the final act (opportunistic/prepared modes).
+     *
+     * @param predicates - Predicate names (all must be true)
+     * @returns this for chaining
+     */
+    actsWhen(...predicates: string[]): GoalBuilder<TParent>;
+    /**
+     * Set the message ID for the final act.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    act(messageId: string): GoalBuilder<TParent>;
+    /**
+     * Set predicate conditions that interrupt (suspend) this goal.
+     *
+     * @param predicates - Predicate names
+     * @returns this for chaining
+     */
+    interruptedBy(...predicates: string[]): GoalBuilder<TParent>;
+    /**
+     * Set the message ID when the goal is interrupted.
+     *
+     * @param messageId - Message ID
+     * @returns this for chaining
+     */
+    onInterrupt(messageId: string): GoalBuilder<TParent>;
+    /**
+     * Set whether the goal resumes from where it left off after interruption.
+     *
+     * @param resume - Whether to resume
+     * @returns this for chaining
+     */
+    resumeOnClear(resume: boolean): GoalBuilder<TParent>;
+    /**
+     * Finalize this goal definition and return the parent builder.
+     *
+     * @returns The parent builder
+     */
+    done(): TParent;
+    /**
+     * Compile the parent builder, auto-finalizing this goal.
+     * Allows calling .compile() directly from a goal chain without .done().
+     *
+     * @returns Compiled character data (delegates to parent's compile())
+     */
+    compile(): ReturnType<TParent extends {
+        compile(): infer R;
+    } ? () => R : never>;
+    /** @internal Build the GoalDef without finalizing. */
+    _buildDef(): GoalDef;
+}
+//# sourceMappingURL=builder.d.ts.map

package/goals/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/character/src/goals/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,OAAO,EACR,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW,CAAC,OAAO;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;;;OAMG;gBACS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI;IAMzE;;;;;OAKG;IACH,aAAa,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;IAK5D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC;IAKtD;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC;IAK7C;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;IAKhD;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;IAKvD;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC;IAK5C;;;;;OAKG;IACH,aAAa,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;IAK5D;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC;IAKpD;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAKpD;;;;OAIG;IACH,IAAI,IAAI,OAAO;IAKf;;;;;OAKG;IACH,OAAO,IAAI,UAAU,CAAC,OAAO,SAAS;QAAE,OAAO,IAAI,MAAM,CAAC,CAAA;KAAE,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC;IAK/E,sDAAsD;IACtD,SAAS,IAAI,OAAO;CAiBrB"}