glin-profanity 2.1.0 → 2.3.3

package/lib/esm/packages/js/src/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Glin-Profanity: Lightweight and efficient profanity detection and filtering.
+ *
+ * Provides multi-language support, context-aware filtering, and customizable
+ * configurations for detecting and filtering profane language in text inputs.
+ */
+export { checkProfanity, checkProfanityAsync, isWordProfane } from './core';
+export type { ProfanityCheckerConfig, ProfanityCheckResult } from './core/types';
+export { useProfanityChecker } from './hooks/useProfanityChecker';
+export { Filter } from './filters/Filter';
+export { SeverityLevel } from './types/types';
+export type { Language, CheckProfanityResult, FilterConfig, FilteredProfanityResult, Match, ContextAwareConfig } from './types/types';

package/lib/esm/packages/js/src/index.js

@@ -0,0 +1,15 @@
+/**
+ * Glin-Profanity: Lightweight and efficient profanity detection and filtering.
+ *
+ * Provides multi-language support, context-aware filtering, and customizable
+ * configurations for detecting and filtering profane language in text inputs.
+ */
+// Core API (framework-agnostic)
+export { checkProfanity, checkProfanityAsync, isWordProfane } from './core';
+// React-specific
+export { useProfanityChecker } from './hooks/useProfanityChecker';
+// Advanced/Low-level
+export { Filter } from './filters/Filter';
+// Legacy types (maintain compatibility)
+export { SeverityLevel } from './types/types';
+//# sourceMappingURL=index.js.map

package/lib/esm/packages/js/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gCAAgC;AAChC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACd,MAAM,QAAQ,CAAC;AAOhB,iBAAiB;AACjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,qBAAqB;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/lib/esm/packages/js/src/nlp/contextAnalyzer.d.ts

@@ -0,0 +1,35 @@
+import { Language } from '../types/types';
+export interface ContextAnalysisResult {
+    contextScore: number;
+    reason: string;
+    isWhitelisted: boolean;
+}
+export interface ContextConfig {
+    contextWindow: number;
+    language: Language;
+    domainWhitelists?: string[];
+}
+export declare class ContextAnalyzer {
+    private contextWindow;
+    private language;
+    private domainWhitelists;
+    constructor(config: ContextConfig);
+    /**
+     * Analyzes the context around a profanity match to determine if it should be flagged
+     */
+    analyzeContext(text: string, matchWord: string, matchIndex: number): ContextAnalysisResult;
+    private tokenize;
+    private findWordIndex;
+    private checkPhraseContext;
+    private isDomainWhitelisted;
+    private calculateSentimentScore;
+    private generateReason;
+    /**
+     * Updates the domain whitelist for this analyzer instance
+     */
+    updateDomainWhitelist(newWhitelist: string[]): void;
+    /**
+     * Adds words to the domain whitelist
+     */
+    addToDomainWhitelist(words: string[]): void;
+}

package/lib/esm/packages/js/src/nlp/contextAnalyzer.js

@@ -0,0 +1,199 @@
+// Positive sentiment indicators
+const POSITIVE_INDICATORS = new Set([
+    'amazing', 'awesome', 'excellent', 'fantastic', 'great', 'love', 'wonderful',
+    'brilliant', 'perfect', 'incredible', 'outstanding', 'superb', 'magnificent',
+    'marvelous', 'spectacular', 'phenomenal', 'terrific', 'fabulous', 'divine',
+    'best', 'good', 'nice', 'cool', 'sweet', 'rad', 'sick', 'dope', 'fire',
+    'lit', 'epic', 'legendary', 'godlike', 'insane', 'crazy', 'wild', 'beast',
+    'movie', 'film', 'show', 'song', 'music', 'game', 'book', 'restaurant',
+    'food', 'dish', 'meal', 'place', 'spot', 'location', 'experience'
+]);
+// Negative sentiment indicators
+const NEGATIVE_INDICATORS = new Set([
+    'hate', 'terrible', 'awful', 'horrible', 'disgusting', 'pathetic', 'stupid',
+    'idiot', 'moron', 'loser', 'worthless', 'useless', 'garbage', 'trash',
+    'suck', 'sucks', 'worst', 'bad', 'ugly', 'gross', 'nasty', 'annoying',
+    'irritating', 'frustrating', 'disappointing', 'lame', 'weak', 'fail',
+    'you', 'your', 'yourself', 'u', 'ur', 'ure', 'youre'
+]);
+// Domain-specific positive contexts
+const GAMING_POSITIVE = new Set([
+    'player', 'gamer', 'team', 'squad', 'clan', 'guild', 'match', 'game',
+    'round', 'level', 'boss', 'raid', 'quest', 'achievement', 'skill',
+    'build', 'loadout', 'strategy', 'tactic', 'play', 'move', 'combo'
+]);
+// Common positive phrases that might contain flagged words
+const POSITIVE_PHRASES = new Map([
+    ['the bomb', 0.9], // "this movie is the bomb"
+    ['da bomb', 0.9], // slang for "the best"
+    ['bomb.com', 0.9], // website reference
+    ['bomb diggity', 0.9], // slang for excellent
+    ['photo bomb', 0.8], // photography term
+    ['bath bomb', 0.8], // cosmetic product
+    ['bomb squad', 0.7], // could be neutral/positive in gaming
+]);
+// Negative phrases that should remain flagged
+const NEGATIVE_PHRASES = new Map([
+    ['you are', 0.1], // "you are [profanity]"
+    ['ur a', 0.1], // "ur a [profanity]"
+    ['such a', 0.2], // "such a [profanity]"
+    ['fucking', 0.1], // intensifier, usually negative
+    ['damn', 0.2], // mild profanity, context dependent
+]);
+export class ContextAnalyzer {
+    constructor(config) {
+        this.contextWindow = config.contextWindow;
+        this.language = config.language;
+        this.domainWhitelists = new Set(config.domainWhitelists || []);
+    }
+    /**
+     * Analyzes the context around a profanity match to determine if it should be flagged
+     */
+    analyzeContext(text, matchWord, matchIndex) {
+        const words = this.tokenize(text);
+        const matchWordIndex = this.findWordIndex(words, matchIndex);
+        if (matchWordIndex === -1) {
+            return {
+                contextScore: 0.5,
+                reason: 'Could not locate match in tokenized text',
+                isWhitelisted: false
+            };
+        }
+        // Extract context window
+        const startIndex = Math.max(0, matchWordIndex - this.contextWindow);
+        const endIndex = Math.min(words.length, matchWordIndex + this.contextWindow + 1);
+        const contextWords = words.slice(startIndex, endIndex);
+        const contextText = contextWords.join(' ').toLowerCase();
+        // Check for exact phrase matches first
+        const phraseResult = this.checkPhraseContext(contextText, matchWord);
+        if (phraseResult) {
+            return phraseResult;
+        }
+        // Check domain-specific whitelists
+        if (this.isDomainWhitelisted(contextWords, matchWord)) {
+            return {
+                contextScore: 0.8,
+                reason: 'Domain-specific whitelist match',
+                isWhitelisted: true
+            };
+        }
+        // Perform sentiment analysis
+        const sentimentScore = this.calculateSentimentScore(contextWords, matchWordIndex - startIndex);
+        return {
+            contextScore: sentimentScore,
+            reason: this.generateReason(sentimentScore, contextWords),
+            isWhitelisted: false
+        };
+    }
+    tokenize(text) {
+        // Simple tokenization - split on whitespace and punctuation
+        return text.toLowerCase()
+            .replace(/[^\w\s]/g, ' ')
+            .split(/\s+/)
+            .filter(word => word.length > 0);
+    }
+    findWordIndex(words, charIndex) {
+        // This is a simplified approach - in production, you'd want more robust mapping
+        // For now, we'll estimate based on the character position
+        let currentPos = 0;
+        for (let i = 0; i < words.length; i++) {
+            if (currentPos >= charIndex) {
+                return Math.max(0, i - 1);
+            }
+            currentPos += words[i].length + 1; // +1 for space
+        }
+        return words.length - 1;
+    }
+    checkPhraseContext(contextText, matchWord) {
+        // Check positive phrases
+        for (const [phrase, score] of POSITIVE_PHRASES.entries()) {
+            if (contextText.includes(phrase)) {
+                return {
+                    contextScore: score,
+                    reason: `Positive phrase detected: "${phrase}"`,
+                    isWhitelisted: true
+                };
+            }
+        }
+        // Check negative phrases
+        for (const [phrase, score] of NEGATIVE_PHRASES.entries()) {
+            if (contextText.includes(phrase)) {
+                return {
+                    contextScore: score,
+                    reason: `Negative phrase detected: "${phrase}"`,
+                    isWhitelisted: false
+                };
+            }
+        }
+        return null;
+    }
+    isDomainWhitelisted(contextWords, matchWord) {
+        // Check if any domain whitelist words are present
+        for (const word of contextWords) {
+            if (this.domainWhitelists.has(word) || GAMING_POSITIVE.has(word)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    calculateSentimentScore(contextWords, matchPosition) {
+        let positiveCount = 0;
+        let negativeCount = 0;
+        let totalWords = contextWords.length;
+        // Weight words closer to the match more heavily
+        for (let i = 0; i < contextWords.length; i++) {
+            const word = contextWords[i];
+            const distance = Math.abs(i - matchPosition);
+            const weight = Math.max(0.1, 1 - (distance * 0.2)); // Closer words have higher weight
+            if (POSITIVE_INDICATORS.has(word)) {
+                positiveCount += weight;
+            }
+            else if (NEGATIVE_INDICATORS.has(word)) {
+                negativeCount += weight;
+            }
+        }
+        // Calculate base score
+        const totalSentiment = positiveCount + negativeCount;
+        if (totalSentiment === 0) {
+            return 0.5; // Neutral if no sentiment indicators
+        }
+        const rawScore = positiveCount / totalSentiment;
+        // Apply context-specific adjustments
+        let adjustedScore = rawScore;
+        // If there are personal pronouns (you, your), lean towards negative
+        const hasPersonalPronouns = contextWords.some(word => ['you', 'your', 'u', 'ur'].includes(word));
+        if (hasPersonalPronouns && rawScore < 0.7) {
+            adjustedScore *= 0.7; // Reduce score when personal pronouns are present
+        }
+        // If there are object/thing references, lean towards positive
+        const hasObjectReferences = contextWords.some(word => ['movie', 'song', 'game', 'book', 'show', 'this', 'that', 'it'].includes(word));
+        if (hasObjectReferences && rawScore > 0.3) {
+            adjustedScore = Math.min(1, adjustedScore * 1.3); // Boost score for object references
+        }
+        return Math.max(0, Math.min(1, adjustedScore));
+    }
+    generateReason(score, contextWords) {
+        if (score >= 0.7) {
+            return 'Positive context detected - likely not profanity';
+        }
+        else if (score <= 0.3) {
+            return 'Negative context detected - likely profanity';
+        }
+        else {
+            return 'Neutral context - uncertain classification';
+        }
+    }
+    /**
+     * Updates the domain whitelist for this analyzer instance
+     */
+    updateDomainWhitelist(newWhitelist) {
+        this.domainWhitelists = new Set(newWhitelist);
+    }
+    /**
+     * Adds words to the domain whitelist
+     */
+    addToDomainWhitelist(words) {
+        words.forEach(word => this.domainWhitelists.add(word.toLowerCase()));
+    }
+}
+//# sourceMappingURL=contextAnalyzer.js.map

package/lib/esm/packages/js/src/nlp/contextAnalyzer.js.map

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

package/lib/esm/packages/js/src/types/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Type definitions for glin-profanity JavaScript/TypeScript package.
+ * Unified API that mirrors the Python package structure.
+ */
+/** Severity levels for profanity matches - unified with Python */
+export declare enum SeverityLevel {
+    EXACT = 1,
+    FUZZY = 2
+}
+/** Supported languages - unified list with Python */
+export type Language = 'arabic' | 'chinese' | 'czech' | 'danish' | 'english' | 'esperanto' | 'finnish' | 'french' | 'german' | 'hindi' | 'hungarian' | 'italian' | 'japanese' | 'korean' | 'norwegian' | 'persian' | 'polish' | 'portuguese' | 'russian' | 'spanish' | 'swedish' | 'thai' | 'turkish';
+/** Represents a profanity match in text - unified with Python */
+export interface Match {
+    word: string;
+    index: number;
+    severity: SeverityLevel;
+    contextScore?: number;
+    reason?: string;
+    isWhitelisted?: boolean;
+}
+/** Result of profanity check operation - unified field names */
+export interface CheckProfanityResult {
+    containsProfanity: boolean;
+    profaneWords: string[];
+    processedText?: string;
+    severityMap?: Record<string, SeverityLevel>;
+    matches?: Match[];
+    contextScore?: number;
+    reason?: string;
+}
+/** Configuration for context-aware filtering - unified with Python */
+export interface ContextAwareConfig {
+    enableContextAware?: boolean;
+    contextWindow?: number;
+    confidenceThreshold?: number;
+    domainWhitelists?: Record<string, string[]>;
+}
+/** Main filter configuration options - unified with Python */
+export interface FilterConfig extends ContextAwareConfig {
+    languages?: Language[];
+    allLanguages?: boolean;
+    caseSensitive?: boolean;
+    wordBoundaries?: boolean;
+    customWords?: string[];
+    replaceWith?: string;
+    severityLevels?: boolean;
+    ignoreWords?: string[];
+    logProfanity?: boolean;
+    allowObfuscatedMatch?: boolean;
+    fuzzyToleranceLevel?: number;
+}
+/** Result with minimum severity filtering */
+export interface FilteredProfanityResult {
+    result: CheckProfanityResult;
+    filteredWords: string[];
+}

package/lib/esm/packages/js/src/types/types.js

@@ -0,0 +1,11 @@
+/**
+ * Type definitions for glin-profanity JavaScript/TypeScript package.
+ * Unified API that mirrors the Python package structure.
+ */
+/** Severity levels for profanity matches - unified with Python */
+export var SeverityLevel;
+(function (SeverityLevel) {
+    SeverityLevel[SeverityLevel["EXACT"] = 1] = "EXACT";
+    SeverityLevel[SeverityLevel["FUZZY"] = 2] = "FUZZY";
+})(SeverityLevel || (SeverityLevel = {}));
+//# sourceMappingURL=types.js.map

package/lib/esm/packages/js/src/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/types/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kEAAkE;AAClE,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,mDAAS,CAAA;IACT,mDAAS,CAAA;AACX,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB"}

package/lib/esm/shared/dictionaries/spanish.json

@@ -0,0 +1,72 @@
+{
+    "words": [
+        "sesinato",
+        "asno",
+        "bastardo",
+        "Bollera",
+        "Cabron",
+        "Cabrón",
+        "Caca",
+        "Chupada",
+        "Chupapollas",
+        "Chupetón",
+        "concha",
+        "Concha de tu madre",
+        "Coño",
+        "Coprofagía",
+        "Culo",
+        "Drogas",
+        "Esperma",
+        "Fiesta de salchichas",
+        "Follador",
+        "Follar",
+        "Gilipichis",
+        "Gilipollas",
+        "Hacer una paja",
+        "Haciendo el amor",
+        "Heroína",
+        "Hija de puta",
+        "Hijaputa",
+        "Hijo de puta",
+        "Hijoputa",
+        "Idiota",
+        "Imbécil",
+        "infierno",
+        "Jilipollas",
+        "Kapullo",
+        "Lameculos",
+        "Maciza",
+        "Macizorra",
+        "maldito",
+        "Mamada",
+        "Marica",
+        "Maricón",
+        "Mariconazo",
+        "martillo",
+        "Mierda",
+        "Nazi",
+        "Orina",
+        "Pedo",
+        "Pervertido",
+        "Pezón",
+        "Pinche",
+        "Pis",
+        "Prostituta",
+        "Puta",
+        "Racista",
+        "Ramera",
+        "Sádico",
+        "Semen",
+        "Sexo",
+        "Sexo oral",
+        "Soplagaitas",
+        "Soplapollas",
+        "Tetas grandes",
+        "Tía buena",
+        "Travesti",
+        "Trio",
+        "Verga",
+        "vete a la mierda",
+        "Vulva"
+    ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glin-profanity",
-  "version": "2.1.0",
+  "version": "2.3.3",
   "description": "Glin-Profanity is a lightweight and efficient npm package designed to detect and filter profane language in text inputs across multiple languages. Whether you’re building a chat application, a comment section, or any platform where user-generated content is involved, Glin-Profanity helps you maintain a clean and respectful environment.",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.js",
@@ -24,7 +24,12 @@
   "scripts": {
     "build:cjs": "tsc -p tsconfig.commonjs.json",
     "build:esm": "tsc -p tsconfig.esm.json",
-    "build": "npm run build:cjs && npm run build:esm"
+    "build": "npm run build:cjs && npm run build:esm",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:ci": "jest --ci --coverage --watchAll=false",
+    "semantic-release": "semantic-release"
   },
   "repository": {
     "type": "git",
@@ -72,5 +77,23 @@
     "profanity-moderation-module"
   ],
   "author": "glinr",
-  "license": "ISC"
+  "license": "ISC",
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.3",
+    "@semantic-release/npm": "^12.0.2",
+    "@testing-library/jest-dom": "^6.6.4",
+    "@testing-library/react": "^16.3.0",
+    "@types/jest": "^30.0.0",
+    "@types/react": "^18.3.3",
+    "@types/react-dom": "^18.3.0",
+    "jest": "^30.0.5",
+    "jest-environment-jsdom": "^30.0.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "semantic-release": "^24.2.7",
+    "ts-jest": "^29.4.0",
+    "typescript": "^5.8.3"
+  }
 }

package/lib/cjs/data/dictionary.js

@@ -1,52 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const arabic_json_1 = __importDefault(require("./arabic.json"));
-const chinese_json_1 = __importDefault(require("./chinese.json"));
-const czech_json_1 = __importDefault(require("./czech.json"));
-const danish_json_1 = __importDefault(require("./danish.json"));
-const esperanto_json_1 = __importDefault(require("./esperanto.json"));
-const english_json_1 = __importDefault(require("./english.json"));
-const finnish_json_1 = __importDefault(require("./finnish.json"));
-const german_json_1 = __importDefault(require("./german.json"));
-const hindi_json_1 = __importDefault(require("./hindi.json"));
-const hungarian_json_1 = __importDefault(require("./hungarian.json"));
-const korean_json_1 = __importDefault(require("./korean.json"));
-const Norwegian_json_1 = __importDefault(require("./Norwegian.json"));
-const persian_json_1 = __importDefault(require("./persian.json"));
-const polish_json_1 = __importDefault(require("./polish.json"));
-const portuguese_json_1 = __importDefault(require("./portuguese.json"));
-const russian_json_1 = __importDefault(require("./russian.json"));
-const french_json_1 = __importDefault(require("./french.json"));
-const italian_json_1 = __importDefault(require("./italian.json"));
-const japanese_json_1 = __importDefault(require("./japanese.json"));
-const turkish_json_1 = __importDefault(require("./turkish.json"));
-const swedish_json_1 = __importDefault(require("./swedish.json"));
-const thai_json_1 = __importDefault(require("./thai.json"));
-exports.default = {
-    arabic: arabic_json_1.default.words,
-    chinese: chinese_json_1.default.words,
-    czech: czech_json_1.default.words,
-    danish: danish_json_1.default.words,
-    english: english_json_1.default.words,
-    esperanto: esperanto_json_1.default.words,
-    finnish: finnish_json_1.default.words,
-    french: french_json_1.default.words,
-    german: german_json_1.default.words,
-    hindi: hindi_json_1.default.words,
-    hungarian: hungarian_json_1.default.words,
-    italian: italian_json_1.default.words,
-    japanese: japanese_json_1.default.words,
-    korean: korean_json_1.default.words,
-    norwegian: Norwegian_json_1.default.words,
-    persian: persian_json_1.default.words,
-    polish: polish_json_1.default.words,
-    portuguese: portuguese_json_1.default.words,
-    russian: russian_json_1.default.words,
-    turkish: turkish_json_1.default.words,
-    swedish: swedish_json_1.default.words,
-    thai: thai_json_1.default.words,
-};
-//# sourceMappingURL=dictionary.js.map

package/lib/cjs/data/dictionary.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dictionary.js","sourceRoot":"","sources":["../../../src/data/dictionary.ts"],"names":[],"mappings":";;;;;AAAA,gEAAmC;AACnC,kEAAqC;AACrC,8DAAiC;AACjC,gEAAmC;AACnC,sEAAyC;AACzC,kEAAqC;AACrC,kEAAqC;AACrC,gEAAmC;AACnC,8DAAiC;AACjC,sEAAyC;AACzC,gEAAmC;AACnC,sEAAyC;AACzC,kEAAqC;AACrC,gEAAmC;AACnC,wEAA2C;AAC3C,kEAAqC;AACrC,gEAAmC;AACnC,kEAAqC;AACrC,oEAAuC;AACvC,kEAAqC;AACrC,kEAAqC;AACrC,4DAA+B;AAC/B,kBAAe;IACb,MAAM,EAAE,qBAAM,CAAC,KAAK;IACpB,OAAO,EAAE,sBAAO,CAAC,KAAK;IACtB,KAAK,EAAE,oBAAK,CAAC,KAAK;IAClB,MAAM,EAAE,qBAAM,CAAC,KAAK;IACpB,OAAO,EAAE,sBAAO,CAAC,KAAK;IACtB,SAAS,EAAE,wBAAS,CAAC,KAAK;IAC1B,OAAO,EAAE,sBAAO,CAAC,KAAK;IACtB,MAAM,EAAE,qBAAM,CAAC,KAAK;IACpB,MAAM,EAAE,qBAAM,CAAC,KAAK;IACpB,KAAK,EAAE,oBAAK,CAAC,KAAK;IAClB,SAAS,EAAE,wBAAS,CAAC,KAAK;IAC1B,OAAO,EAAE,sBAAO,CAAC,KAAK;IACtB,QAAQ,EAAE,uBAAQ,CAAC,KAAK;IACxB,MAAM,EAAE,qBAAM,CAAC,KAAK;IACpB,SAAS,EAAE,wBAAS,CAAC,KAAK;IAC1B,OAAO,EAAE,sBAAO,CAAC,KAAK;IACtB,MAAM,EAAE,qBAAM,CAAC,KAAK;IACpB,UAAU,EAAE,yBAAU,CAAC,KAAK;IAC5B,OAAO,EAAE,sBAAO,CAAC,KAAK;IACtB,OAAO,EAAE,sBAAO,CAAC,KAAK;IACtB,OAAO,EAAE,sBAAO,CAAC,KAAK;IACtB,IAAI,EAAE,mBAAI,CAAC,KAAK;CACjB,CAAC"}