@loonylabs/llm-middleware 2.0.0

package/dist/middleware/services/llm/utils/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./debug-llm.utils"), exports);
+__exportStar(require("./text-analysis.utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/middleware/services/llm/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/middleware/services/llm/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,wDAAsC"}

package/dist/middleware/services/llm/utils/text-analysis.utils.d.ts

@@ -0,0 +1,75 @@
+export interface WordFrequency {
+    word: string;
+    count: number;
+    percentage: number;
+}
+export interface StemFrequency {
+    stem: string;
+    exampleWord: string;
+    count: number;
+    percentage: number;
+    words: string[];
+}
+/**
+ * Text analysis utilities for analyzing AI-generated content
+ * Provides word frequency and stem analysis with German language support
+ */
+export declare class TextAnalyzer {
+    /**
+     * German stop words to be filtered out during analysis
+     */
+    private static readonly GERMAN_STOP_WORDS;
+    /**
+     * English stop words for multilingual support
+     */
+    private static readonly ENGLISH_STOP_WORDS;
+    /**
+     * Filter and clean text for analysis
+     * @param text Text to clean
+     * @returns Array of filtered words
+     */
+    static prepareText(text: string): string[];
+    /**
+     * Simple German stemmer that removes common endings
+     * @param word Word to stem
+     * @returns Word stem
+     */
+    static germanStemmer(word: string): string;
+    /**
+     * Analyze word frequency in text
+     * @param text Text to analyze
+     * @param topN Number of most frequent words to return
+     * @returns Array of word frequency objects sorted by frequency
+     */
+    static analyzeWordFrequency(text: string, topN?: number): WordFrequency[];
+    /**
+     * Analyze word repetitions based on word stems
+     * @param text Text to analyze
+     * @param topN Number of most frequent stems to return
+     * @returns Array of stem frequency objects
+     */
+    static analyzeStemFrequency(text: string, topN?: number): StemFrequency[];
+    /**
+     * Generate markdown table for word frequency analysis
+     * @param frequencies Word frequencies
+     * @returns Markdown formatted table
+     */
+    static generateWordFrequencyTable(frequencies: WordFrequency[]): string;
+    /**
+     * Generate markdown table for stem frequency analysis
+     * @param frequencies Stem frequencies
+     * @returns Markdown formatted table
+     */
+    static generateStemFrequencyTable(frequencies: StemFrequency[]): string;
+    /**
+     * Create complete markdown sections for text analysis
+     * @param text Text to analyze
+     * @param topN Number of most frequent words to analyze
+     * @returns Object with markdown sections for word frequency and stem analysis
+     */
+    static generateTextAnalysisMarkdown(text: string, topN?: number): {
+        wordFrequencySection: string;
+        stemFrequencySection: string;
+    };
+}
+//# sourceMappingURL=text-analysis.utils.d.ts.map

package/dist/middleware/services/llm/utils/text-analysis.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-analysis.utils.d.ts","sourceRoot":"","sources":["../../../../../src/middleware/services/llm/utils/text-analysis.utils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAOtC;IAEH;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAQvC;IAEH;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAoB1C;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA2B1C;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,aAAa,EAAE;IAuB7E;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,aAAa,EAAE;IAiC7E;;;;OAIG;IACH,MAAM,CAAC,0BAA0B,CAAC,WAAW,EAAE,aAAa,EAAE,GAAG,MAAM;IAUvE;;;;OAIG;IACH,MAAM,CAAC,0BAA0B,CAAC,WAAW,EAAE,aAAa,EAAE,GAAG,MAAM;IAUvE;;;;;OAKG;IACH,MAAM,CAAC,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG;QACpE,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;KAC9B;CA8BF"}

package/dist/middleware/services/llm/utils/text-analysis.utils.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextAnalyzer = void 0;
+/**
+ * Text analysis utilities for analyzing AI-generated content
+ * Provides word frequency and stem analysis with German language support
+ */
+class TextAnalyzer {
+    /**
+     * Filter and clean text for analysis
+     * @param text Text to clean
+     * @returns Array of filtered words
+     */
+    static prepareText(text) {
+        if (!text)
+            return [];
+        // Clean text: remove punctuation and convert to lowercase
+        const cleanedText = text.toLowerCase()
+            .replace(/[.,\/#!$%\^&\*;:{}=\-_`~()]/g, ' ')
+            .replace(/\s+/g, ' ');
+        // Split into words
+        const words = cleanedText.split(' ');
+        // Filter words with less than 3 characters, stop words, and numbers
+        return words.filter(word => word.length >= 3 &&
+            !this.GERMAN_STOP_WORDS.has(word) &&
+            !this.ENGLISH_STOP_WORDS.has(word) &&
+            !/^\d+$/.test(word));
+    }
+    /**
+     * Simple German stemmer that removes common endings
+     * @param word Word to stem
+     * @returns Word stem
+     */
+    static germanStemmer(word) {
+        if (word.length <= 3)
+            return word;
+        let stem = word.toLowerCase();
+        // Step 1: Remove plural and case endings
+        const endings = [
+            'innen', 'erin', 'ern', 'en', 'es', 'er', 'em', 'e', 's', 'n'
+        ];
+        for (const ending of endings) {
+            if (stem.endsWith(ending) && stem.length - ending.length >= 3) {
+                stem = stem.slice(0, -ending.length);
+                break; // Only remove one ending
+            }
+        }
+        // Step 2: Convert umlauts for better matching of related words
+        stem = stem
+            .replace(/ä/g, 'a')
+            .replace(/ö/g, 'o')
+            .replace(/ü/g, 'u')
+            .replace(/ß/g, 'ss');
+        return stem;
+    }
+    /**
+     * Analyze word frequency in text
+     * @param text Text to analyze
+     * @param topN Number of most frequent words to return
+     * @returns Array of word frequency objects sorted by frequency
+     */
+    static analyzeWordFrequency(text, topN = 50) {
+        const filteredWords = this.prepareText(text);
+        if (filteredWords.length === 0)
+            return [];
+        const totalWords = filteredWords.length;
+        // Count word frequency
+        const wordFrequency = {};
+        filteredWords.forEach(word => {
+            wordFrequency[word] = (wordFrequency[word] || 0) + 1;
+        });
+        // Sort by frequency and return top N with percentage
+        return Object.entries(wordFrequency)
+            .map(([word, count]) => ({
+            word,
+            count,
+            percentage: (count / totalWords) * 100
+        }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, topN);
+    }
+    /**
+     * Analyze word repetitions based on word stems
+     * @param text Text to analyze
+     * @param topN Number of most frequent stems to return
+     * @returns Array of stem frequency objects
+     */
+    static analyzeStemFrequency(text, topN = 50) {
+        const filteredWords = this.prepareText(text);
+        if (filteredWords.length === 0)
+            return [];
+        const totalWords = filteredWords.length;
+        // Count stem frequency and track word variations
+        const stemFrequency = {};
+        filteredWords.forEach(word => {
+            const stem = this.germanStemmer(word);
+            if (!stemFrequency[stem]) {
+                stemFrequency[stem] = { count: 0, words: new Set() };
+            }
+            stemFrequency[stem].count += 1;
+            stemFrequency[stem].words.add(word);
+        });
+        // Sort by frequency and return top N with percentage
+        return Object.entries(stemFrequency)
+            .map(([stem, { count, words }]) => ({
+            stem,
+            exampleWord: Array.from(words)[0], // First occurrence as example
+            count,
+            percentage: (count / totalWords) * 100,
+            words: Array.from(words).sort() // Sorted list of all word forms
+        }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, topN);
+    }
+    /**
+     * Generate markdown table for word frequency analysis
+     * @param frequencies Word frequencies
+     * @returns Markdown formatted table
+     */
+    static generateWordFrequencyTable(frequencies) {
+        if (frequencies.length === 0)
+            return '';
+        return `| Word | Frequency | Percentage |
+|------|-----------|------------|
+${frequencies.map(({ word, count, percentage }) => `| ${word} | ${count} | ${percentage.toFixed(2)}% |`).join('\n')}`;
+    }
+    /**
+     * Generate markdown table for stem frequency analysis
+     * @param frequencies Stem frequencies
+     * @returns Markdown formatted table
+     */
+    static generateStemFrequencyTable(frequencies) {
+        if (frequencies.length === 0)
+            return '';
+        return `| Stem | Example | Frequency | Percentage | Word Forms |
+|------|---------|-----------|------------|------------|
+${frequencies.map(({ stem, exampleWord, count, percentage, words }) => `| ${stem} | ${exampleWord} | ${count} | ${percentage.toFixed(2)}% | ${words.slice(0, 5).join(', ')}${words.length > 5 ? ` (+${words.length - 5} more)` : ''} |`).join('\n')}`;
+    }
+    /**
+     * Create complete markdown sections for text analysis
+     * @param text Text to analyze
+     * @param topN Number of most frequent words to analyze
+     * @returns Object with markdown sections for word frequency and stem analysis
+     */
+    static generateTextAnalysisMarkdown(text, topN = 50) {
+        let wordFrequencySection = '';
+        let stemFrequencySection = '';
+        if (text) {
+            // Word frequency analysis
+            const wordFrequency = this.analyzeWordFrequency(text, topN);
+            if (wordFrequency.length > 0) {
+                const totalAnalyzedWords = this.prepareText(text).length;
+                wordFrequencySection = `## Word Repetition Analysis (Top ${topN})
+Analyzed words after filtering: ${totalAnalyzedWords}
+
+${this.generateWordFrequencyTable(wordFrequency)}
+`;
+            }
+            // Stem frequency analysis
+            const stemFrequency = this.analyzeStemFrequency(text, topN);
+            if (stemFrequency.length > 0) {
+                stemFrequencySection = `## Stem Analysis (Top ${topN})
+${this.generateStemFrequencyTable(stemFrequency)}
+`;
+            }
+        }
+        return {
+            wordFrequencySection,
+            stemFrequencySection
+        };
+    }
+}
+exports.TextAnalyzer = TextAnalyzer;
+/**
+ * German stop words to be filtered out during analysis
+ */
+TextAnalyzer.GERMAN_STOP_WORDS = new Set([
+    'der', 'die', 'das', 'ein', 'eine', 'und', 'oder', 'aber', 'den', 'dem', 'des', 'ist', 'sind',
+    'war', 'wird', 'werden', 'wurden', 'zu', 'zur', 'zum', 'in', 'im', 'an', 'am', 'auf', 'aus',
+    'mit', 'bei', 'von', 'für', 'um', 'durch', 'über', 'unter', 'vor', 'nach', 'ihr', 'ihre',
+    'sein', 'seine', 'hat', 'haben', 'hatte', 'hatten', 'es', 'sie', 'er', 'wir', 'sich', 'nicht',
+    'als', 'auch', 'so', 'dann', 'noch', 'nur', 'schon', 'sehr', 'wie', 'was', 'wenn', 'weil',
+    'dass', 'daß', 'da', 'wo', 'wer', 'nun', 'mir', 'dir', 'mich', 'dich', 'ihm', 'ihn'
+]);
+/**
+ * English stop words for multilingual support
+ */
+TextAnalyzer.ENGLISH_STOP_WORDS = new Set([
+    'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for', 'of', 'with', 'by',
+    'from', 'up', 'about', 'into', 'through', 'during', 'before', 'after', 'above', 'below',
+    'between', 'among', 'throughout', 'despite', 'towards', 'upon', 'concerning', 'is', 'are',
+    'was', 'were', 'been', 'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would',
+    'could', 'should', 'may', 'might', 'must', 'can', 'shall', 'this', 'that', 'these', 'those',
+    'i', 'you', 'he', 'she', 'it', 'we', 'they', 'me', 'him', 'her', 'us', 'them', 'my', 'your',
+    'his', 'her', 'its', 'our', 'their', 'what', 'which', 'who', 'when', 'where', 'why', 'how'
+]);
+//# sourceMappingURL=text-analysis.utils.js.map

package/dist/middleware/services/llm/utils/text-analysis.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-analysis.utils.js","sourceRoot":"","sources":["../../../../../src/middleware/services/llm/utils/text-analysis.utils.ts"],"names":[],"mappings":"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"}

package/dist/middleware/services/model-parameter-manager/index.d.ts

@@ -0,0 +1,2 @@
+export * from './model-parameter-manager.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/services/model-parameter-manager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/middleware/services/model-parameter-manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC"}

package/dist/middleware/services/model-parameter-manager/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./model-parameter-manager.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/middleware/services/model-parameter-manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/middleware/services/model-parameter-manager/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oEAAkD"}

package/dist/middleware/services/model-parameter-manager/model-parameter-manager.service.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Interface for model parameters used in AI requests.
+ * All parameters are optional except temperature.
+ */
+export interface ModelParameters {
+    /**
+     * Controls randomness in generation (0.0 = deterministic, 2.0 = very random).
+     * - 0.0-0.3: Factual, focused output
+     * - 0.4-0.7: Balanced
+     * - 0.8-1.2: Creative, varied
+     * Range: 0.0-2.0, Default: 0.8
+     */
+    temperature: number;
+    /**
+     * Penalizes token repetition (higher = less repetition).
+     * Range: 0.0-2.0, Default: 1.1
+     */
+    repeatPenalty?: number;
+    /**
+     * Nucleus sampling threshold - limits token selection to cumulative probability.
+     * Range: 0.0-1.0, Default: 0.9
+     */
+    topP?: number;
+    /**
+     * Limits token selection to k most likely tokens.
+     * Range: 1-100, Default: 40
+     */
+    topK?: number;
+    /**
+     * Penalizes tokens proportional to their frequency (reduces overused words).
+     * Range: -2.0-2.0, Default: 0.0
+     */
+    frequencyPenalty?: number;
+    /**
+     * Penalizes all previously used tokens equally (encourages new concepts).
+     * Range: -2.0-2.0, Default: 0.0
+     */
+    presencePenalty?: number;
+    /**
+     * Number of previous tokens to consider for repetition penalty.
+     * Use -1 to consider entire context window (num_ctx).
+     * Range: 0-2048 or -1, Default: 64
+     */
+    repeatLastN?: number;
+    /**
+     * Maximum number of tokens to generate in the response.
+     * Controls output length.
+     * Range: 1+, Default: 128 (model-specific)
+     */
+    numPredict?: number;
+    /**
+     * Context window size in tokens.
+     * Larger values allow model to reference more previous text.
+     * Range: 128-4096+ (model-specific), Default: 2048
+     */
+    numCtx?: number;
+    /**
+     * Number of tokens to process in parallel during generation.
+     * Higher values = faster but more memory usage.
+     * Range: 1-512, Default: 512 (model-specific)
+     */
+    numBatch?: number;
+}
+/**
+ * Interface for parameter overrides that can be applied to default model parameters.
+ * All parameters are optional - only specify what you want to override.
+ */
+export interface ModelParameterOverrides {
+    /** Override the base temperature setting */
+    temperatureOverride?: number;
+    /** Repeat penalty override */
+    repeatPenalty?: number;
+    /** Nucleus sampling (top-p) override */
+    topP?: number;
+    /** Top-k sampling override */
+    topK?: number;
+    /** Frequency penalty override */
+    frequencyPenalty?: number;
+    /** Presence penalty override */
+    presencePenalty?: number;
+    /** Repeat last N tokens override */
+    repeatLastN?: number;
+    /** Maximum tokens to generate (Ollama: num_predict) */
+    num_predict?: number;
+    /** Context window size (Ollama: num_ctx) */
+    num_ctx?: number;
+    /** Batch size for parallel processing (Ollama: num_batch) */
+    num_batch?: number;
+}
+/**
+ * Interface for model configuration from models.config
+ */
+export interface ModelConfig {
+    temperature?: number;
+    maxTokens?: number;
+    contextLength?: number;
+}
+/**
+ * Service for managing and validating model parameters for AI requests
+ * Handles parameter combination, validation, and conversion to API formats
+ */
+export declare class ModelParameterManagerService {
+    private static readonly DEFAULT_TEMPERATURE;
+    /**
+     * Get the effective model parameters, combining config defaults and use case overrides
+     * @param modelConfig The model configuration from models.config
+     * @param overrides Optional overrides from the use case
+     * @returns Final model parameters to use
+     */
+    static getEffectiveParameters(modelConfig: ModelConfig, overrides?: ModelParameterOverrides): ModelParameters;
+    /**
+     * Validate parameter values are within acceptable ranges
+     * @param parameters The parameters to validate
+     * @returns Validated parameters with any out-of-range values corrected
+     */
+    static validateParameters(parameters: ModelParameters): ModelParameters;
+    /**
+     * Create parameter subset for logging (only non-undefined values)
+     * @param parameters The parameters to filter
+     * @returns Object with only defined parameters
+     */
+    static getDefinedParameters(parameters: ModelParameters): Record<string, any>;
+    /**
+     * Create parameter object for Ollama API request
+     * @param parameters The validated parameters
+     * @returns Object suitable for the Ollama API options field
+     */
+    static toOllamaOptions(parameters: ModelParameters): Record<string, any>;
+    /**
+     * Create default parameters for a given model type or use case
+     *
+     * Available presets:
+     * - 'creative' / 'creative_writing': Optimized for novels, stories, narrative fiction
+     * - 'factual': Optimized for reports, documentation, journalism
+     * - 'poetic': Optimized for poetry, lyrics, artistic expression
+     * - 'dialogue': Optimized for character dialogue, conversational content
+     * - 'technical': Optimized for code documentation, technical guides
+     * - 'marketing': Optimized for advertisements, promotional content
+     * - 'analytical': General analytical tasks (legacy)
+     * - 'balanced': General balanced approach (default)
+     *
+     * @param modelType The type of model or use case
+     * @returns Default parameters for the model type
+     *
+     * For detailed documentation about each preset, see docs/OLLAMA_PARAMETERS.md
+     */
+    static getDefaultParametersForType(modelType: string): ModelParameters;
+    /**
+     * Compare two parameter sets and return the differences
+     * @param params1 First parameter set
+     * @param params2 Second parameter set
+     * @returns Object showing differences
+     */
+    static compareParameters(params1: ModelParameters, params2: ModelParameters): Record<string, {
+        from: any;
+        to: any;
+    }>;
+    /**
+     * Generate a summary string of the parameters for logging
+     * @param parameters The parameters to summarize
+     * @returns Human-readable parameter summary
+     */
+    static summarizeParameters(parameters: ModelParameters): string;
+}
+//# sourceMappingURL=model-parameter-manager.service.d.ts.map

package/dist/middleware/services/model-parameter-manager/model-parameter-manager.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-parameter-manager.service.d.ts","sourceRoot":"","sources":["../../../../src/middleware/services/model-parameter-manager/model-parameter-manager.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAO;IAElD;;;;;OAKG;WACW,sBAAsB,CAClC,WAAW,EAAE,WAAW,EACxB,SAAS,GAAE,uBAA4B,GACtC,eAAe;IAelB;;;;OAIG;WACW,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe;IAkE9E;;;;OAIG;WACW,oBAAoB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAoCpF;;;;OAIG;WACW,eAAe,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAsC/E;;;;;;;;;;;;;;;;;OAiBG;WACW,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe;IAqG7E;;;;;OAKG;WACW,iBAAiB,CAC7B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,EAAE,EAAE,GAAG,CAAA;KAAE,CAAC;IAoBzC;;;;OAIG;WACW,mBAAmB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM;CAKvE"}