@gitsense/gsc-utils 0.2.24 → 0.2.27

package/src/GitSenseChatUtils.js

@@ -1,12 +1,12 @@
 /*
  * Component: GitSenseChatUtils
- * Block-UUID: d7cdbb94-f335-4f85-bdc4-0dd3ae95127e
- * Parent-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
- * Version: 2.1.5
- * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules, and now includes ConfigUtils and EnvUtils.
+ * Block-UUID: c1b6c4d3-7959-4eb6-8022-6cd7aa59240d
+ * Parent-UUID: 1793b3a8-4881-4306-bfdf-673eef503679
+ * Version: 2.7.0
+ * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules, and now includes ConfigUtils, EnvUtils, ObjectUtils, MetaRawResultUtils, and CompactChatUtils.
  * Language: JavaScript
- * Created-at: 2025-04-15T16:04:26.780Z
- * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4), Qwen 3 Coder 480B - Cerebras (v2.1.5)
+ * Created-at: 2025-10-17T17:13:04.663Z
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3), Gemini 2.5 Flash (v2.1.4), Qwen 3 Coder 480B - Cerebras (v2.1.5), Qwen 3 Coder 480B - Cerebras (v2.2.0), Qwen 3 Coder 480B - Cerebras (v2.2.1), Claude Haiku 4.5 (v2.3.0), Qwen 3 Coder 480B - Cerebras (v2.4.0), Qwen 3 Coder 480B - Cerebras (v2.5.0), GLM-4.6 (v2.6.0), GLM-4.6 (v2.7.0)
  */
 
 
@@ -22,8 +22,21 @@ const LLMUtils = require('./LLMUtils');
 const JsonUtils = require('./JsonUtils');
 const DateUtils = require('./DateUtils');
 const FormatterUtils = require('./FormatterUtils');
+const MarkdownUtils = require('./MarkdownUtils');
 const ConfigUtils = require('./ConfigUtils');
 const EnvUtils = require('./EnvUtils');
+const DomUtils = require('./DomUtils');
+const ObjectUtils = require('./ObjectUtils');
+const SVGUtils = require('./SVGUtils');
+const StringUtils = require('./SharedUtils/stringUtils');
+const LanguageNameUtils = require('./LanguageNameUtils');
+const MetaRawResultUtils = require('./MetaRawResultUtils');
+const CompactChatUtils = require('./CompactChatUtils');
+
+const {
+    normalizeLanguageName,
+    isKnownLanguage,
+} = LanguageNameUtils;
 
 const {
     formatAge,
@@ -31,15 +44,15 @@ const {
     compareDates,
     normalizeDateTime,
     getTimeDifference,
-    formatTimeDifference
+    formatTimeDifference,
 } = DateUtils;
 
 const {
-    estimateTokens
+    estimateTokens,
 } = LLMUtils;
 
 const {
-    detectJsonComments
+    detectJsonComments,
 } = JsonUtils;
 
 const {
@@ -104,6 +117,7 @@ const {
     removeCodeBlockMarkers,
     updateCodeBlockByIndex,
     deleteCodeBlockByIndex,
+    getLineage,
 } = CodeBlockUtils;
 
 const {
@@ -140,13 +154,45 @@ const {
     formatTokens,
 } = FormatterUtils;
 
+const {
+    createMarkdownRenderer,
+    removeSignature,
+} = MarkdownUtils;
+
 const {
     parseContextSection,
     extractContextSections,
     extractContextItemsOverviewTableRows,
+    getContextFiles,
     formatContextContent,
 } = ContextUtils;
 
+const {
+    trimObjectStrings
+} = ObjectUtils;
+
+const {
+    splitWithLimit,
+    capitalize,
+    titleCase,
+    camelCase,
+    kebabCase,
+    snakeCase,
+    constantCase,
+    pascalCase,
+    trimWhitespace,
+    truncate,
+} = StringUtils;
+
+const {
+    extractMetaRawResultMappings,
+    isMetaRawResultMessage,
+    parseMetaRawResultContent,
+    parseTableRow,
+    parseSize,
+    parseTokens
+} = MetaRawResultUtils;
+
 
 /**
  * GitSenseChatUtils class provides a unified interface to code block and patch utilities.
@@ -349,17 +395,22 @@ class GitSenseChatUtils {
         // Uses function from CodeBlockUtils
         return CodeBlockUtils.isValidISOTimestamp(timestamp);
     }
+
+    /**
+     * Creates a configured markdown-it renderer instance.
+     * @param {Object} hljs - An instance of highlight.js.
+     * @param {Object} [hstyle={}] - Optional styles for highlighted code blocks.
+     * @param {Object} [nhstyle={}] - Optional styles for non-highlighted code blocks.
+     * @returns {Object} A configured markdown-it instance.
+     */
+    createMarkdownRenderer(hljs, hstyle, nhstyle) {
+        return MarkdownUtils.createMarkdownRenderer(hljs, hstyle, nhstyle);
+    }
 }
 
 // Export the main class, the aggregated CodeBlockUtils, PatchUtils,
 // and individual functions for backward compatibility or direct use.
 module.exports = {
-    // New Utility Modules
-    DateUtils,
-    FormatterUtils,
-
-    // Date Utility Functions
-
     // Main class
     GitSenseChatUtils,
 
@@ -376,9 +427,18 @@ module.exports = {
     JsonUtils,
     ConfigUtils,
     DateUtils,
+    LanguageNameUtils,
     FormatterUtils,
-
+    MarkdownUtils,
     EnvUtils,
+    DomUtils,
+    ObjectUtils,
+    StringUtils,
+    SVGUtils,
+    MetaRawResultUtils,
+    CompactChatUtils,
+    ReferenceMessageUtils: CompactChatUtils.ReferenceMessageUtils,
+    CompactedMessageUtils: CompactChatUtils.CompactedMessageUtils,
 
     // --- Individual Function Exports (sourced correctly) ---
 
@@ -396,6 +456,10 @@ module.exports = {
     // Timestamp (from CodeBlockUtils)
     isValidISOTimestamp,
 
+    // Language Name Utilities (from LanguageNameUtils)
+    normalizeLanguageName,
+    isKnownLanguage,
+
     // Patch Detection/Integration (from CodeBlockUtils)
     containsPatch,
 
@@ -463,6 +527,25 @@ module.exports = {
     // Formatter Utils
     formatBytes,
     formatTokens,
+    
+    // Object Utils
+    trimObjectStrings,
+
+    // String Utils
+    splitWithLimit,
+    capitalize,
+    titleCase,
+    camelCase,
+    kebabCase,
+    snakeCase,
+    constantCase,
+    pascalCase,
+    trimWhitespace,
+    truncate,
+
+    // Markdown Utils
+    createMarkdownRenderer,
+    removeSignature,
 
     // GS Tool Block
     isToolBlock,
@@ -479,8 +562,17 @@ module.exports = {
     getApiKey,
 
     // Context Utils
+    getContextFiles,
     parseContextSection,
     extractContextSections,
     extractContextItemsOverviewTableRows,
     formatContextContent,
+
+    // MetaRawResult Utils
+    extractMetaRawResultMappings,
+    isMetaRawResultMessage,
+    parseMetaRawResultContent,
+    parseTableRow,
+    parseSize,
+    parseTokens,
 };

package/src/LanguageNameUtils.js

@@ -0,0 +1,171 @@
+/*
+ * Component: Language Name Utils 
+ * Block-UUID: 313abeab-2bb3-49d1-8693-e9e88aa97113
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Utility for converting common lowercase language names and aliases to their proper capitalization
+ * Language: JavaScript
+ * Created-at: 2025-10-19T23:25:09.231Z
+ * Authors: Qwen 3 Coder 480B - Cerebras (v1.0.0)
+ */
+
+
+/**
+ * A mapping of language aliases to their properly capitalized names
+ */
+const LANGUAGE_NAME_MAP = {
+  // Core Programming Languages
+  'javascript': 'JavaScript',
+  'js': 'JavaScript',
+  'typescript': 'TypeScript',
+  'ts': 'TypeScript',
+  'python': 'Python',
+  'py': 'Python',
+  'java': 'Java',
+  'c': 'C',
+  'c++': 'C++',
+  'cpp': 'C++',
+  'c#': 'C#',
+  'csharp': 'C#',
+  'go': 'Go',
+  'rust': 'Rust',
+  'rs': 'Rust',
+  'swift': 'Swift',
+  'kotlin': 'Kotlin',
+  'ruby': 'Ruby',
+  'rb': 'Ruby',
+  'php': 'PHP',
+  'perl': 'Perl',
+  'scala': 'Scala',
+  'r': 'R',
+  'matlab': 'MATLAB',
+  
+  // Web Development & Templating
+  'html': 'HTML',
+  'css': 'CSS',
+  'xml': 'XML',
+  'json': 'JSON',
+  'yaml': 'YAML',
+  'yml': 'YAML',
+  'markdown': 'Markdown',
+  'md': 'Markdown',
+  'jsx': 'JSX',
+  'tsx': 'TSX',
+  'sass': 'Sass',
+  'scss': 'SCSS',
+  'less': 'Less',
+  'vue': 'Vue',
+  'svelte': 'Svelte',
+  
+  // Infrastructure & DevOps
+  'dockerfile': 'Dockerfile',
+  'terraform': 'Terraform',
+  'hcl': 'HCL',
+  'groovy': 'Groovy',
+  'gradle': 'Gradle',
+  'cmake': 'CMake',
+  'make': 'Make',
+  
+  // Shell/Scripting Languages
+  'bash': 'Bash',
+  'shell': 'Shell',
+  'powershell': 'PowerShell',
+  'ps': 'PowerShell',
+  
+  // Database/Query Languages
+  'sql': 'SQL',
+  'mysql': 'MySQL',
+  'postgresql': 'PostgreSQL',
+  'postgres': 'PostgreSQL',
+  'mongodb': 'MongoDB',
+  'redis': 'Redis',
+  
+  // Data & Configuration Formats
+  'toml': 'TOML',
+  'ini': 'INI',
+  'protobuf': 'Protocol Buffers',
+  'proto': 'Protocol Buffers',
+  'avro': 'Avro',
+  
+  // Documentation & Markup
+  'rst': 'reStructuredText',
+  'asciidoc': 'AsciiDoc',
+  'tex': 'TeX',
+  'latex': 'LaTeX',
+  
+  // Specialized & Niche Languages
+  'dart': 'Dart',
+  'lua': 'Lua',
+  'haskell': 'Haskell',
+  'elixir': 'Elixir',
+  'erlang': 'Erlang',
+  'clojure': 'Clojure',
+  'f#': 'F#',
+  'fortran': 'Fortran',
+  'cobol': 'COBOL',
+  'pascal': 'Pascal',
+  'delphi': 'Delphi',
+  'objective-c': 'Objective-C',
+  'objc': 'Objective-C',
+  'assembly': 'Assembly',
+  'asm': 'Assembly',
+  'solidity': 'Solidity',
+  'julia': 'Julia',
+  'zig': 'Zig',
+  'ocaml': 'OCaml',
+  'gdscript': 'GDScript',
+  'lisp': 'Lisp',
+  'move': 'Move',
+  'cairo': 'Cairo',
+  'vyper': 'Vyper',
+  
+  // Legacy & Foundational
+  'vb.net': 'VB.NET',
+  'vbnet': 'VB.NET'
+};
+
+/**
+ * Normalizes a language name or alias to its proper capitalization
+ * @param {string} language - The language name or alias to normalize
+ * @returns {string} The properly capitalized language name, or the original input if not found
+ */
+function normalizeLanguageName(language) {
+  if (!language) return language;
+  
+  const lowerLanguage = language.toLowerCase();
+  return LANGUAGE_NAME_MAP[lowerLanguage] || language;
+}
+
+/**
+ * Checks if a language name or alias is known to the normalizer
+ * @param {string} language - The language name or alias to check
+ * @returns {boolean} True if the language is known, false otherwise
+ */
+function isKnownLanguage(language) {
+  if (!language) return false;
+  
+  return LANGUAGE_NAME_MAP.hasOwnProperty(language.toLowerCase());
+}
+
+/**
+ * Gets all known language aliases
+ * @returns {string[]} Array of all known language aliases
+ */
+function getKnownLanguageAliases() {
+  return Object.keys(LANGUAGE_NAME_MAP);
+}
+
+/**
+ * Gets the mapping of language aliases to their normalized names
+ * @returns {Object} The language name mapping object
+ */
+function getLanguageNameMap() {
+  return { ...LANGUAGE_NAME_MAP };
+}
+
+module.exports = {
+  normalizeLanguageName,
+  isKnownLanguage,
+  getKnownLanguageAliases,
+  getLanguageNameMap
+};

package/src/MarkdownUtils.js

@@ -0,0 +1,127 @@
+/*
+ * Component: Markdown Utilities
+ * Block-UUID: 1e1b9db3-c1c6-45a7-80d8-7f7bc093e433
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utilities for configuring and using markdown-it with highlight.js for rendering Markdown content with syntax highlighting. Designed for use within GitSense Chat UI components.
+ * Language: JavaScript
+ * Created-at: 2025-10-15T23:48:15.318Z
+ * Authors: Qwen 3 Coder 480B - Cerebras (v1.0.0)
+ */
+
+
+const { h } = require('./DomUtils');
+
+/**
+ * Creates a configured markdown renderer instance.
+ * This renderer integrates markdown-it for Markdown processing and highlight.js for syntax highlighting
+ * within code blocks, replicating the style used in the main GitSense Chat conversation view.
+ *
+ * @param {Object} hljs - An instance of highlight.js.
+ * @param {Object} [hstyle={}] - Optional custom styles for highlighted code blocks. Merged with defaults.
+ * @param {Object} [nhstyle={}] - Optional custom styles for non-highlighted code blocks. Merged with defaults.
+ * @returns {Object} A configured markdown-it instance.
+ */
+function createMarkdownRenderer(hljs, hstyle = {}, nhstyle = {}) {
+    const MarkDownIt = require("markdown-it");
+
+    const defaultHighlightStyle = {
+        backgroundColor: '#fafafa',
+        border: '1px solid #ddd',
+        marginTop: '5px',
+        overflow: 'auto',
+        maxHeight: '500px'
+    };
+
+    const defaultNoHighlightStyle = {
+        marginTop: '5px',
+        overflow: 'auto',
+        maxHeight: '800px'
+    };
+
+    // Merge default and custom styles
+    const highlightStyle = { ...defaultHighlightStyle, ...hstyle };
+    const noHighlightStyle = { ...defaultNoHighlightStyle, ...nhstyle };
+
+    // Configure markdown-it with a custom highlight function
+    const md = new MarkDownIt({
+        html: false, // Can be overridden if needed
+        highlight: function (str, lang) {
+            // Attempt to highlight if the language is supported
+            if (lang && hljs.getLanguage(lang)) {
+                try {
+                    // Use highlight.js to generate the highlighted code HTML
+                    const highlightedCode = hljs.highlight(str, { language: lang, ignoreIllegals: true }).value;
+
+                    // Create the inner code element with the highlighted content
+                    // and the language label prepended.
+                    const codeElement = h.createCode({
+                        html: `<span class='gs-chat-lang'>${lang}</span>\n\n${highlightedCode}`,
+                        style: {
+                            fontSize: '13px'
+                        }
+                    });
+
+                    // Wrap the code element in a pre tag with styling
+                    const preElement = h.createPre({
+                        cls: 'hljs', // Standard class for highlight.js containers
+                        style: highlightStyle,
+                        append: [codeElement]
+                    });
+
+                    // Return the outer HTML of the pre element to be injected into the Markdown output
+                    return preElement.outerHTML;
+                } catch (error) {
+                    // Gracefully handle highlight.js errors
+                    console.warn("Syntax highlighting failed for language:", lang, error);
+                }
+            }
+
+            // Fallback for unsupported languages or highlighting errors
+            const escapedCode = md.utils.escapeHtml(str);
+            const codeElement = h.createCode({
+                html: escapedCode
+            });
+
+            const preElement = h.createPre({
+                cls: 'hljs',
+                style: noHighlightStyle,
+                append: [codeElement]
+            });
+
+            return preElement.outerHTML;
+        }
+    });
+
+    // --- Register Common markdown-it Plugins ---
+    // These are commonly used in GitSense Chat and should be included by default.
+    // The integrator can choose to disable them or add more via md.disable() or md.use() after creation.
+    md.use(require('markdown-it-anchor'), { level: 1 }); // Add anchors to headings
+    md.use(require('markdown-it-attrs'), { allowedAttributes: ['id'] }); // Allow custom attributes like {#custom-id}
+
+    return md;
+}
+
+/**
+ * This function removes any existing LLM author signature. After streaming, the backend will
+ * add the LLM author signature as a regular Markdown line, which is why we are matching for
+ * a paragraph. The signature is important for processing, but we don't want the user to see
+ * it.
+ *
+ * @param {HTMLElement} body - The DOM element containing the rendered markdown HTML.
+ * @param {string} model - The name of the model to include in the signature.
+ */
+function removeSignature(body) {
+    if (!body) {
+        console.warn('MarkdownUtils.removeSignature: Invalid body.');
+        return;
+    }
+
+    const llmSignatureRegex = new RegExp(`<p>Authored by [^<]+</p>$`, 'i');
+    body.innerHTML = body.innerHTML.replace(llmSignatureRegex, '');
+}
+
+module.exports = {
+    createMarkdownRenderer,
+    removeSignature,
+};

package/src/MessageUtils.js

@@ -363,7 +363,7 @@ function getMessageContentType(messageContent) {
         return 'regular'; // Handle non-string input gracefully
     }
     const trimmedContent = messageContent.trimStart(); // Check from the beginning, ignoring leading whitespace
-    if (trimmedContent.startsWith('## FILE CONTENT')) {
+    if (trimmedContent.startsWith('## FILE CONTENT') || trimmedContent.startsWith('## REFERENCE FILE CONTENT')) {
         return 'file-content-context';
     } else if (trimmedContent.startsWith('## OVERVIEW')) {
         return 'overview-context';