@carbon/ai-chat-components 0.5.0 → 0.6.0-rc.0

package/es/components/code-snippet/src/codemirror/language-controller.d.ts

@@ -0,0 +1,38 @@
+import { Compartment } from "@codemirror/state";
+import { LanguageSupport } from "@codemirror/language";
+import { EditorView } from "codemirror";
+interface LanguageStateUpdate {
+    detectedLanguage?: string | null;
+    lockLabel?: boolean;
+}
+interface LanguageControllerConfig {
+    getLanguageAttribute(): string;
+    getContent(): string;
+    isHighlightEnabled(): boolean;
+    getEditorView(): EditorView | undefined;
+    getLanguageCompartment(): Compartment;
+    isLanguageLabelLocked(): boolean;
+    getDefaultLanguage(): string;
+    updateState(update: LanguageStateUpdate): void;
+}
+export declare class LanguageController {
+    private readonly config;
+    private pendingLanguageLoad;
+    private languageDetectionTimeout;
+    private highlightingDetectionTimeout;
+    private editableLanguageDetectionTimeout;
+    private canDetectForHighlighting;
+    constructor(config: LanguageControllerConfig);
+    resolveLanguageSupport(): Promise<LanguageSupport | null>;
+    handleStreamingLanguageDetection(): Promise<void>;
+    detectLanguageForEditable(content: string): void;
+    reset(): void;
+    dispose(): void;
+    private lockDetectedLanguageFromContent;
+    private scheduleHighlightingDetectionReset;
+    private clearLanguageDetectionTimeout;
+    private clearHighlightingDetectionTimeout;
+    private clearEditableDetectionTimeout;
+    private disposeTimers;
+}
+export type { LanguageStateUpdate };

package/es/components/code-snippet/src/codemirror/language-controller.js

@@ -0,0 +1,220 @@
+/**
+ * Copyright IBM Corp. 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import { LanguageDescription } from '@codemirror/language';
+import { languages } from './language-data.js';
+import { mapLanguageName, detectLanguage } from './language-utils.js';
+
+/*
+ *  Copyright IBM Corp. 2025
+ *
+ *  This source code is licensed under the Apache-2.0 license found in the
+ *  LICENSE file in the root directory of this source tree.
+ *
+ *  @license
+ */
+function loadLanguageSupport(langDesc) {
+    return langDesc.load();
+}
+class LanguageController {
+    constructor(config) {
+        this.config = config;
+        this.pendingLanguageLoad = null;
+        this.languageDetectionTimeout = null;
+        this.highlightingDetectionTimeout = null;
+        this.editableLanguageDetectionTimeout = null;
+        this.canDetectForHighlighting = true;
+    }
+    async resolveLanguageSupport() {
+        const languageAttr = this.config.getLanguageAttribute();
+        const content = this.config.getContent();
+        let languageToUse = languageAttr
+            ? (mapLanguageName(languageAttr) ?? languageAttr)
+            : "";
+        if (!languageToUse && content) {
+            const trimmed = content.trim();
+            if (trimmed) {
+                const detected = detectLanguage(trimmed);
+                languageToUse = detected ?? "";
+            }
+        }
+        // Use default language for empty editable content
+        if (!languageToUse && this.config.getDefaultLanguage()) {
+            const trimmed = content.trim();
+            if (!trimmed) {
+                languageToUse = this.config.getDefaultLanguage();
+            }
+        }
+        if (!languageToUse) {
+            this.config.updateState({ detectedLanguage: null, lockLabel: false });
+            return null;
+        }
+        const langDesc = LanguageDescription.matchLanguageName(languages, languageToUse, true);
+        const detectedLanguage = langDesc ? languageToUse : null;
+        this.config.updateState({
+            detectedLanguage,
+            lockLabel: Boolean(languageAttr && detectedLanguage),
+        });
+        if (!this.config.isHighlightEnabled() || !langDesc) {
+            return null;
+        }
+        try {
+            return await loadLanguageSupport(langDesc);
+        }
+        catch (error) {
+            console.warn(`Failed to load language support for "${languageToUse}"`);
+            return null;
+        }
+    }
+    async handleStreamingLanguageDetection() {
+        if (this.config.getLanguageAttribute()) {
+            return;
+        }
+        const trimmed = this.config.getContent().trim();
+        if (!trimmed) {
+            return;
+        }
+        if (!this.config.isLanguageLabelLocked() &&
+            this.config.isHighlightEnabled() &&
+            this.canDetectForHighlighting) {
+            const detected = detectLanguage(trimmed);
+            if (detected) {
+                const langDesc = LanguageDescription.matchLanguageName(languages, detected, true);
+                if (langDesc && !this.pendingLanguageLoad) {
+                    this.pendingLanguageLoad = loadLanguageSupport(langDesc)
+                        .then((support) => {
+                        const view = this.config.getEditorView();
+                        if (!view) {
+                            return;
+                        }
+                        view.dispatch({
+                            effects: this.config
+                                .getLanguageCompartment()
+                                .reconfigure([support]),
+                        });
+                    })
+                        .catch((_error) => {
+                        console.warn(`Failed to load language support for "${detected}"`);
+                    })
+                        .finally(() => {
+                        this.pendingLanguageLoad = null;
+                    });
+                    this.canDetectForHighlighting = false;
+                    this.scheduleHighlightingDetectionReset();
+                }
+            }
+        }
+        this.clearLanguageDetectionTimeout();
+        if (!this.config.isLanguageLabelLocked()) {
+            this.languageDetectionTimeout = window.setTimeout(() => {
+                this.languageDetectionTimeout = null;
+                this.lockDetectedLanguageFromContent();
+            }, 200);
+        }
+    }
+    detectLanguageForEditable(content) {
+        if (this.config.getLanguageAttribute()) {
+            return;
+        }
+        const trimmed = content.trim();
+        if (!trimmed) {
+            this.config.updateState({ detectedLanguage: null, lockLabel: false });
+            return;
+        }
+        this.clearEditableDetectionTimeout();
+        this.editableLanguageDetectionTimeout = window.setTimeout(() => {
+            this.editableLanguageDetectionTimeout = null;
+            const detected = detectLanguage(trimmed);
+            if (!detected) {
+                return;
+            }
+            const langDesc = LanguageDescription.matchLanguageName(languages, detected, true);
+            if (!langDesc) {
+                return;
+            }
+            this.config.updateState({ detectedLanguage: detected, lockLabel: true });
+            if (this.config.isHighlightEnabled() && !this.pendingLanguageLoad) {
+                this.pendingLanguageLoad = loadLanguageSupport(langDesc)
+                    .then((support) => {
+                    const view = this.config.getEditorView();
+                    if (!view) {
+                        return;
+                    }
+                    view.dispatch({
+                        effects: this.config
+                            .getLanguageCompartment()
+                            .reconfigure([support]),
+                    });
+                })
+                    .catch((_error) => {
+                    console.warn(`Failed to load language support for "${detected}"`);
+                })
+                    .finally(() => {
+                    this.pendingLanguageLoad = null;
+                });
+            }
+        }, 200);
+    }
+    reset() {
+        this.disposeTimers();
+        this.pendingLanguageLoad = null;
+        this.canDetectForHighlighting = true;
+        this.config.updateState({ detectedLanguage: null, lockLabel: false });
+    }
+    dispose() {
+        this.disposeTimers();
+        this.pendingLanguageLoad = null;
+    }
+    lockDetectedLanguageFromContent() {
+        if (this.config.getLanguageAttribute() ||
+            this.config.isLanguageLabelLocked()) {
+            return;
+        }
+        const trimmed = this.config.getContent().trim();
+        if (!trimmed) {
+            return;
+        }
+        const detected = detectLanguage(trimmed);
+        if (!detected) {
+            return;
+        }
+        this.config.updateState({ detectedLanguage: detected, lockLabel: true });
+    }
+    scheduleHighlightingDetectionReset() {
+        this.clearHighlightingDetectionTimeout();
+        this.highlightingDetectionTimeout = window.setTimeout(() => {
+            this.canDetectForHighlighting = true;
+            this.highlightingDetectionTimeout = null;
+        }, 200);
+    }
+    clearLanguageDetectionTimeout() {
+        if (this.languageDetectionTimeout !== null) {
+            window.clearTimeout(this.languageDetectionTimeout);
+            this.languageDetectionTimeout = null;
+        }
+    }
+    clearHighlightingDetectionTimeout() {
+        if (this.highlightingDetectionTimeout !== null) {
+            window.clearTimeout(this.highlightingDetectionTimeout);
+            this.highlightingDetectionTimeout = null;
+        }
+    }
+    clearEditableDetectionTimeout() {
+        if (this.editableLanguageDetectionTimeout !== null) {
+            window.clearTimeout(this.editableLanguageDetectionTimeout);
+            this.editableLanguageDetectionTimeout = null;
+        }
+    }
+    disposeTimers() {
+        this.clearLanguageDetectionTimeout();
+        this.clearHighlightingDetectionTimeout();
+        this.clearEditableDetectionTimeout();
+    }
+}
+
+export { LanguageController };
+//# sourceMappingURL=language-controller.js.map

package/es/components/code-snippet/src/codemirror/language-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-controller.js","sources":["../../../../../src/components/code-snippet/src/codemirror/language-controller.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/es/components/code-snippet/src/codemirror/language-data.d.ts

@@ -0,0 +1,6 @@
+import { LanguageDescription } from "@codemirror/language";
+/**
+An array of language descriptions for known language packages.
+*/
+declare const languages: LanguageDescription[];
+export { languages };