@dcyfr/ai 1.0.3 → 2.1.0

package/dist/ai/src/personas/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Personas module - Agent persona and brand voice management
+ * @module @dcyfr/ai/personas
+ * @license MIT
+ */
+export * from './types';
+export * from './voice-resolver';
+export * from './persona-loader';
+export * from './hooks/before-llm-call';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/src/personas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/personas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/ai/src/personas/index.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Personas module - Agent persona and brand voice management
+ * @module @dcyfr/ai/personas
+ * @license MIT
+ */
+export * from './types.js';
+export * from './voice-resolver.js';
+export * from './persona-loader.js';
+export * from './hooks/before-llm-call.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/src/personas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/ai/src/personas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/ai/src/personas/persona-loader.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview PersonaLoader — loads and validates agent persona profiles from
+ * the filesystem, with fallback to a default persona.
+ * @module @dcyfr/ai/personas/persona-loader
+ * @license MIT
+ */
+import type { AgentPersona, PersonaLoadResult, PersonaLoaderOptions } from './types';
+/**
+ * Validates an AgentPersona object and returns a list of validation errors.
+ * An empty array indicates a valid persona.
+ */
+export declare function validatePersona(persona: unknown): string[];
+/**
+ * Clears the persona loader cache (useful in tests).
+ */
+export declare function clearPersonaCache(): void;
+/**
+ * Loads an agent persona by name from the filesystem.
+ *
+ * Resolution order:
+ * 1. Cache (if `useCache: true`)
+ * 2. `<baseDir>/<agentName>/agent.json`
+ * 3. `<baseDir>/<agentName>.json`
+ * 4. Default persona (if `allowFallback: true`)
+ *
+ * @param agentName - The agent identifier (e.g., 'dcyfr-engineer')
+ * @param options - Loader options
+ * @returns PersonaLoadResult with loaded persona and metadata
+ *
+ * @example
+ * ```typescript
+ * const { persona } = loadPersona('dcyfr-engineer');
+ * const voice = resolveVoice(persona);
+ * ```
+ */
+export declare function loadPersona(agentName: string, options?: PersonaLoaderOptions): PersonaLoadResult;
+/**
+ * Convenience wrapper: loads a persona and returns only the AgentPersona.
+ * Throws if the persona cannot be loaded and `allowFallback` is false.
+ */
+export declare function getPersona(agentName: string, options?: PersonaLoaderOptions): AgentPersona;
+//# sourceMappingURL=persona-loader.d.ts.map

package/dist/ai/src/personas/persona-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-loader.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/personas/persona-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAe,MAAM,SAAS,CAAC;AA8BlG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAgC1D;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACjC,iBAAiB,CA2EnB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAG1F"}

package/dist/ai/src/personas/persona-loader.js

@@ -0,0 +1,162 @@
+/**
+ * @fileoverview PersonaLoader — loads and validates agent persona profiles from
+ * the filesystem, with fallback to a default persona.
+ * @module @dcyfr/ai/personas/persona-loader
+ * @license MIT
+ */
+// ---------------------------------------------------------------------------
+// Default persona
+// ---------------------------------------------------------------------------
+const DEFAULT_PERSONA = {
+    name: 'default',
+    title: 'DCYFR Agent',
+    role: 'General-purpose AI assistant',
+    capabilities: ['analysis', 'writing', 'code-review', 'explanation'],
+    voice_tone: 'collaborative-expert',
+};
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+const VALID_TONE_PROFILES = new Set([
+    'precise',
+    'conversational',
+    'technical',
+    'empathetic',
+    'collaborative-expert',
+    'patient',
+    'diagnostic',
+    'urgent',
+    'enthusiastic',
+]);
+/**
+ * Validates an AgentPersona object and returns a list of validation errors.
+ * An empty array indicates a valid persona.
+ */
+export function validatePersona(persona) {
+    const errors = [];
+    if (!persona || typeof persona !== 'object') {
+        return ['Persona must be a non-null object'];
+    }
+    const p = persona;
+    if (typeof p['name'] !== 'string' || p['name'].trim() === '') {
+        errors.push('name must be a non-empty string');
+    }
+    if (typeof p['title'] !== 'string' || p['title'].trim() === '') {
+        errors.push('title must be a non-empty string');
+    }
+    if (!Array.isArray(p['capabilities'])) {
+        errors.push('capabilities must be an array');
+    }
+    if (p['voice_tone'] !== null && p['voice_tone'] !== undefined) {
+        if (typeof p['voice_tone'] !== 'string' || !VALID_TONE_PROFILES.has(p['voice_tone'])) {
+            errors.push(`voice_tone must be null or one of: ${[...VALID_TONE_PROFILES].join(', ')}`);
+        }
+    }
+    if (p['personality_overrides'] !== undefined) {
+        if (typeof p['personality_overrides'] !== 'object' || p['personality_overrides'] === null) {
+            errors.push('personality_overrides must be an object if present');
+        }
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Cache
+// ---------------------------------------------------------------------------
+const _personaCache = new Map();
+/**
+ * Clears the persona loader cache (useful in tests).
+ */
+export function clearPersonaCache() {
+    _personaCache.clear();
+}
+// ---------------------------------------------------------------------------
+// PersonaLoader
+// ---------------------------------------------------------------------------
+/**
+ * Loads an agent persona by name from the filesystem.
+ *
+ * Resolution order:
+ * 1. Cache (if `useCache: true`)
+ * 2. `<baseDir>/<agentName>/agent.json`
+ * 3. `<baseDir>/<agentName>.json`
+ * 4. Default persona (if `allowFallback: true`)
+ *
+ * @param agentName - The agent identifier (e.g., 'dcyfr-engineer')
+ * @param options - Loader options
+ * @returns PersonaLoadResult with loaded persona and metadata
+ *
+ * @example
+ * ```typescript
+ * const { persona } = loadPersona('dcyfr-engineer');
+ * const voice = resolveVoice(persona);
+ * ```
+ */
+export function loadPersona(agentName, options = {}) {
+    const { baseDir = 'agents', allowFallback = true, useCache = true, validate = true, } = options;
+    const cacheKey = `${baseDir}:${agentName}`;
+    if (useCache && _personaCache.has(cacheKey)) {
+        return {
+            persona: _personaCache.get(cacheKey),
+            source: 'cache',
+        };
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const fs = require('node:fs');
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const path = require('node:path');
+        const candidates = [
+            path.resolve(process.cwd(), baseDir, agentName, 'agent.json'),
+            path.resolve(process.cwd(), baseDir, `${agentName}.json`),
+        ];
+        for (const candidate of candidates) {
+            if (!fs.existsSync(candidate))
+                continue;
+            const raw = fs.readFileSync(candidate, 'utf-8');
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                const errors = [`Failed to parse JSON at ${candidate}`];
+                if (!allowFallback) {
+                    return { persona: DEFAULT_PERSONA, source: 'fallback', path: candidate, errors };
+                }
+                return { persona: DEFAULT_PERSONA, source: 'fallback', path: candidate, errors };
+            }
+            const errors = validate ? validatePersona(parsed) : [];
+            if (errors.length > 0 && !allowFallback) {
+                return { persona: DEFAULT_PERSONA, source: 'fallback', path: candidate, errors };
+            }
+            const persona = parsed;
+            if (useCache) {
+                _personaCache.set(cacheKey, persona);
+            }
+            return { persona, source: 'file', path: candidate, errors: errors.length > 0 ? errors : undefined };
+        }
+    }
+    catch {
+        // Filesystem unavailable — fall through to default
+    }
+    if (!allowFallback) {
+        // Return default persona but flag it as not found
+        return {
+            persona: { ...DEFAULT_PERSONA, name: agentName },
+            source: 'fallback',
+            errors: [`Agent '${agentName}' not found and fallback is disabled`],
+        };
+    }
+    return {
+        persona: { ...DEFAULT_PERSONA, name: agentName },
+        source: 'fallback',
+    };
+}
+/**
+ * Convenience wrapper: loads a persona and returns only the AgentPersona.
+ * Throws if the persona cannot be loaded and `allowFallback` is false.
+ */
+export function getPersona(agentName, options) {
+    const result = loadPersona(agentName, options);
+    return result.persona;
+}
+//# sourceMappingURL=persona-loader.js.map

package/dist/ai/src/personas/persona-loader.js.map

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

package/dist/ai/src/personas/types.d.ts

@@ -0,0 +1,199 @@
+/**
+ * @fileoverview Brand voice and agent persona type definitions for DCYFR AI framework
+ * @module @dcyfr/ai/personas/types
+ * @license MIT
+ */
+/**
+ * Tone profile for different communication scenarios
+ */
+export type ToneProfile = 'precise' | 'conversational' | 'technical' | 'empathetic' | 'collaborative-expert' | 'patient' | 'diagnostic' | 'urgent' | 'enthusiastic';
+/**
+ * Personality trait score (0.0 = none, 1.0 = maximum)
+ */
+export interface PersonalityTraits {
+    warmth: number;
+    formality: number;
+    humor?: number;
+    directness: number;
+    technicality: number;
+    empathy: number;
+}
+/**
+ * Situational tone adjustment
+ */
+export interface SituationalTone {
+    tone: string;
+    warmth: number;
+    formality: number;
+}
+/**
+ * Core brand identity
+ */
+export interface BrandIdentity {
+    name: string;
+    tagline: string;
+    archetype: string;
+    description: string;
+}
+/**
+ * Core voice attributes
+ */
+export interface CoreVoice {
+    attributes: string[];
+    personality_traits: PersonalityTraits;
+    perspective: 'first-person' | 'first-person-plural' | 'second-person' | 'third-person';
+    pronouns: string;
+}
+/**
+ * Tone spectrum with default and situational variants
+ */
+export interface ToneSpectrum {
+    default: ToneProfile;
+    situational: Record<string, SituationalTone>;
+}
+/**
+ * Workspace-level brand voice (from DCYFR_CONTEXT.json)
+ */
+export interface BrandVoice {
+    version: string;
+    identity: BrandIdentity;
+    core_voice: CoreVoice;
+    tone_spectrum: ToneSpectrum;
+}
+/**
+ * Agent-specific persona configuration
+ */
+export interface AgentPersona {
+    /**
+     * Agent identifier (e.g., 'dcyfr-engineer', 'dcyfr-analyst')
+     */
+    name: string;
+    /**
+     * Human-readable display title
+     */
+    title: string;
+    /**
+     * Agent role description
+     */
+    role: string;
+    /**
+     * Primary capabilities
+     */
+    capabilities: string[];
+    /**
+     * Voice tone override (null = use brand default)
+     */
+    voice_tone: ToneProfile | null;
+    /**
+     * Personality trait overrides (null = use brand defaults)
+     */
+    personality_overrides?: Partial<PersonalityTraits>;
+    /**
+     * Context-specific prompt injections
+     */
+    context_injections?: {
+        before_prompt?: string;
+        after_prompt?: string;
+        system_prefix?: string;
+    };
+    /**
+     * Custom metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Voice resolver options
+ */
+export interface VoiceResolverOptions {
+    /**
+     * Enable voice resolution (default: true)
+     */
+    enabled?: boolean;
+    /**
+     * Override tone (null = use persona default)
+     */
+    tone?: ToneProfile | null;
+    /**
+     * Verbosity level (0 = minimal, 5 = maximum)
+     */
+    verbosity?: number;
+    /**
+     * Include personality trait scores in output
+     */
+    includeTraits?: boolean;
+    /**
+     * Custom brand voice (null = load from DCYFR_CONTEXT)
+     */
+    brandVoice?: BrandVoice | null;
+}
+/**
+ * Resolved voice output
+ */
+export interface ResolvedVoice {
+    /**
+     * System prompt prefix (inject before main prompt)
+     */
+    systemPrefix: string;
+    /**
+     * Applied tone profile
+     */
+    appliedTone: ToneProfile;
+    /**
+     * Merged personality traits
+     */
+    personalityTraits: PersonalityTraits;
+    /**
+     * Agent name
+     */
+    agentName: string;
+    /**
+     * Resolution metadata
+     */
+    metadata: {
+        resolvedFrom: 'brand' | 'persona' | 'override';
+        timestamp: string;
+    };
+}
+/**
+ * Persona loader options
+ */
+export interface PersonaLoaderOptions {
+    /**
+     * Base directory for agent profiles (default: 'agents/')
+     */
+    baseDir?: string;
+    /**
+     * Allow fallback to default persona (default: true)
+     */
+    allowFallback?: boolean;
+    /**
+     * Cache loaded personas (default: true)
+     */
+    useCache?: boolean;
+    /**
+     * Validate against AgentPersona schema (default: true)
+     */
+    validate?: boolean;
+}
+/**
+ * Persona load result
+ */
+export interface PersonaLoadResult {
+    /**
+     * Loaded persona
+     */
+    persona: AgentPersona;
+    /**
+     * Load source
+     */
+    source: 'file' | 'cache' | 'fallback';
+    /**
+     * Load path (if loaded from file)
+     */
+    path?: string;
+    /**
+     * Validation errors (if any)
+     */
+    errors?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ai/src/personas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/personas/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,YAAY,GACZ,sBAAsB,GACtB,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,WAAW,EAAE,cAAc,GAAG,qBAAqB,GAAG,eAAe,GAAG,cAAc,CAAC;IACvF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,SAAS,CAAC;IACtB,aAAa,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,WAAW,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEnD;;OAEG;IACH,kBAAkB,CAAC,EAAE;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACJ,aAAa,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;OAEG;IACH,iBAAiB,EAAE,iBAAiB,CAAC;IAErC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE;QACR,YAAY,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;QAC/C,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAEtC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/ai/src/personas/types.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Brand voice and agent persona type definitions for DCYFR AI framework
+ * @module @dcyfr/ai/personas/types
+ * @license MIT
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ai/src/personas/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../packages/ai/src/personas/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/ai/src/personas/voice-resolver.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview VoiceResolver — merges workspace brand voice with agent persona
+ * to produce a rendered system prompt prefix.
+ * @module @dcyfr/ai/personas/voice-resolver
+ * @license MIT
+ */
+import type { AgentPersona, BrandVoice, ResolvedVoice, ToneProfile, VoiceResolverOptions } from './types';
+/**
+ * Renders the persona identity block as a prompt fragment.
+ */
+export declare function renderPersonaBlock(persona: AgentPersona): string;
+/**
+ * Returns tone guideline text for a given tone profile.
+ */
+export declare function applyToneGuidelines(tone: ToneProfile): string;
+/**
+ * Loads the brand voice from DCYFR_CONTEXT.json. Falls back to the built-in
+ * default if the file is unavailable or malformed.
+ */
+export declare function loadBrandVoice(contextPath?: string): BrandVoice;
+/**
+ * Clears the brand voice cache (useful in tests).
+ */
+export declare function clearBrandVoiceCache(): void;
+/**
+ * Resolves the effective voice for an agent by merging workspace brand voice
+ * with persona-specific overrides, then renders a system prompt prefix.
+ *
+ * @param persona - The agent persona to resolve voice for
+ * @param options - Resolver options (tone override, verbosity, etc.)
+ * @returns ResolvedVoice containing the system prompt prefix and metadata
+ *
+ * @example
+ * ```typescript
+ * const voice = resolveVoice(engineerPersona, { verbosity: 2 });
+ * systemPrompt = voice.systemPrefix + '\n\n' + userPrompt;
+ * ```
+ */
+export declare function resolveVoice(persona: AgentPersona, options?: VoiceResolverOptions): ResolvedVoice;
+//# sourceMappingURL=voice-resolver.d.ts.map

package/dist/ai/src/personas/voice-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-resolver.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/personas/voice-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAEV,aAAa,EACb,WAAW,EACX,oBAAoB,EACrB,MAAM,SAAS,CAAC;AA+CjB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAgBhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAuB7D;AAoBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAkC/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAuEf"}