@stackguide/mcp-server 3.1.0 → 3.2.0

package/dist/services/parsers/types.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Language Parser Types
+ * Type definitions for the multi-language parsing system
+ * @version 3.2.0
+ */
+import type { CodeIssue } from '../../config/types.js';
+/**
+ * Supported programming languages
+ */
+export type SupportedLanguage = 'typescript' | 'javascript' | 'python' | 'go' | 'rust' | 'ruby' | 'php' | 'java' | 'csharp' | 'unknown';
+/**
+ * Language-specific rule for semantic analysis
+ */
+export interface LanguageRule {
+    id: string;
+    name: string;
+    description: string;
+    language: SupportedLanguage;
+    severity: 'error' | 'warning' | 'info';
+    category: string;
+    enabled: boolean;
+    priority: number;
+    /**
+     * Check function that analyzes parsed code
+     */
+    check: (context: ParseContext) => ParseIssue | null;
+}
+/**
+ * Context passed to language-specific rules
+ */
+export interface ParseContext {
+    /** Original source code */
+    code: string;
+    /** File path */
+    filePath: string;
+    /** Detected language */
+    language: SupportedLanguage;
+    /** Parsed symbols/tokens */
+    symbols: ParsedSymbol[];
+    /** Imports/dependencies found */
+    imports: ImportInfo[];
+    /** Functions/methods found */
+    functions: FunctionInfo[];
+    /** Classes/structs found */
+    classes: ClassInfo[];
+    /** Variables/constants found */
+    variables: VariableInfo[];
+    /** Comments found */
+    comments: CommentInfo[];
+    /** Get line content by number (1-indexed) */
+    getLine: (lineNumber: number) => string;
+    /** Get lines in range */
+    getLines: (start: number, end: number) => string[];
+    /** Check if code contains pattern */
+    containsPattern: (pattern: RegExp) => boolean;
+    /** Find all matches of pattern */
+    findPatternMatches: (pattern: RegExp) => PatternMatch[];
+}
+/**
+ * Result from a language rule check
+ */
+export interface ParseIssue {
+    hasIssue: boolean;
+    message: string;
+    line?: number;
+    column?: number;
+    endLine?: number;
+    endColumn?: number;
+    details?: string;
+    suggestion?: string;
+    code?: string;
+}
+/**
+ * Generic parsed symbol
+ */
+export interface ParsedSymbol {
+    type: 'function' | 'class' | 'variable' | 'import' | 'export' | 'decorator' | 'annotation' | 'macro' | 'trait' | 'interface' | 'enum' | 'struct' | 'module' | 'other';
+    name: string;
+    line: number;
+    column: number;
+    endLine?: number;
+    endColumn?: number;
+    modifiers?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Import/dependency information
+ */
+export interface ImportInfo {
+    module: string;
+    items: string[];
+    alias?: string;
+    line: number;
+    isDefault?: boolean;
+    isNamespace?: boolean;
+    isRelative?: boolean;
+}
+/**
+ * Function/method information
+ */
+export interface FunctionInfo {
+    name: string;
+    line: number;
+    endLine?: number;
+    parameters: ParameterInfo[];
+    returnType?: string;
+    isAsync?: boolean;
+    isGenerator?: boolean;
+    isExported?: boolean;
+    isPublic?: boolean;
+    decorators?: string[];
+    annotations?: string[];
+    docstring?: string;
+    complexity?: number;
+    bodyLines?: number;
+}
+/**
+ * Parameter information
+ */
+export interface ParameterInfo {
+    name: string;
+    type?: string;
+    defaultValue?: string;
+    isOptional?: boolean;
+    isRest?: boolean;
+}
+/**
+ * Class/struct information
+ */
+export interface ClassInfo {
+    name: string;
+    line: number;
+    endLine?: number;
+    baseClasses?: string[];
+    interfaces?: string[];
+    traits?: string[];
+    members: MemberInfo[];
+    isExported?: boolean;
+    isAbstract?: boolean;
+    decorators?: string[];
+    annotations?: string[];
+    docstring?: string;
+}
+/**
+ * Class/struct member information
+ */
+export interface MemberInfo {
+    name: string;
+    type: 'field' | 'method' | 'property' | 'constructor' | 'static';
+    visibility?: 'public' | 'private' | 'protected' | 'internal';
+    dataType?: string;
+    line: number;
+    isStatic?: boolean;
+    isReadonly?: boolean;
+}
+/**
+ * Variable/constant information
+ */
+export interface VariableInfo {
+    name: string;
+    line: number;
+    type?: string;
+    isConst?: boolean;
+    isExported?: boolean;
+    scope?: 'global' | 'module' | 'function' | 'block';
+    value?: string;
+}
+/**
+ * Comment information
+ */
+export interface CommentInfo {
+    text: string;
+    line: number;
+    endLine?: number;
+    type: 'line' | 'block' | 'doc';
+    isTodo?: boolean;
+    isFixme?: boolean;
+}
+/**
+ * Pattern match result
+ */
+export interface PatternMatch {
+    match: string;
+    line: number;
+    column: number;
+    groups?: Record<string, string>;
+}
+/**
+ * Parse result from a language parser
+ */
+export interface ParseResult {
+    language: SupportedLanguage;
+    filePath: string;
+    symbols: ParsedSymbol[];
+    imports: ImportInfo[];
+    functions: FunctionInfo[];
+    classes: ClassInfo[];
+    variables: VariableInfo[];
+    comments: CommentInfo[];
+    errors: ParseError[];
+    parseTime: number;
+}
+/**
+ * Parse error
+ */
+export interface ParseError {
+    message: string;
+    line?: number;
+    column?: number;
+    severity: 'error' | 'warning';
+}
+/**
+ * Language parser interface
+ */
+export interface LanguageParser {
+    /** Language this parser handles */
+    readonly language: SupportedLanguage;
+    /** File extensions this parser handles */
+    readonly extensions: string[];
+    /** Parse source code */
+    parse(code: string, filePath: string): ParseResult;
+    /** Get language-specific rules */
+    getRules(): LanguageRule[];
+    /** Analyze code using language-specific rules */
+    analyze(code: string, filePath: string): CodeIssue[];
+    /** Check if parser can handle this file */
+    canHandle(filePath: string): boolean;
+}
+/**
+ * Parser factory function type
+ */
+export type ParserFactory = () => LanguageParser;
+/**
+ * File extension to language mapping
+ */
+export declare const EXTENSION_LANGUAGE_MAP: Record<string, SupportedLanguage>;
+/**
+ * Get language from file path
+ */
+export declare function getLanguageFromPath(filePath: string): SupportedLanguage;
+//# sourceMappingURL=types.d.ts.map

package/dist/services/parsers/types.d.ts.map

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

package/dist/services/parsers/types.js

@@ -0,0 +1,47 @@
+/**
+ * Language Parser Types
+ * Type definitions for the multi-language parsing system
+ * @version 3.2.0
+ */
+/**
+ * File extension to language mapping
+ */
+export const EXTENSION_LANGUAGE_MAP = {
+    // TypeScript
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+    '.mts': 'typescript',
+    '.cts': 'typescript',
+    // JavaScript
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.mjs': 'javascript',
+    '.cjs': 'javascript',
+    // Python
+    '.py': 'python',
+    '.pyi': 'python',
+    '.pyw': 'python',
+    // Go
+    '.go': 'go',
+    // Rust
+    '.rs': 'rust',
+    // Ruby
+    '.rb': 'ruby',
+    '.rake': 'ruby',
+    '.gemspec': 'ruby',
+    // PHP
+    '.php': 'php',
+    '.phtml': 'php',
+    // Java
+    '.java': 'java',
+    // C#
+    '.cs': 'csharp',
+};
+/**
+ * Get language from file path
+ */
+export function getLanguageFromPath(filePath) {
+    const ext = filePath.substring(filePath.lastIndexOf('.')).toLowerCase();
+    return EXTENSION_LANGUAGE_MAP[ext] || 'unknown';
+}
+//# sourceMappingURL=types.js.map

package/dist/services/parsers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/parsers/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmRH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsC;IACvE,aAAa;IACb,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IAEpB,aAAa;IACb,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IAEpB,SAAS;IACT,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAEhB,KAAK;IACL,KAAK,EAAE,IAAI;IAEX,OAAO;IACP,KAAK,EAAE,MAAM;IAEb,OAAO;IACP,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,MAAM;IAElB,MAAM;IACN,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;IAEf,OAAO;IACP,OAAO,EAAE,MAAM;IAEf,KAAK;IACL,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACxE,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackguide/mcp-server",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "MCP Server for dynamic language and framework context loading - Compatible with Cursor and GitHub Copilot",
   "main": "dist/index.js",
   "bin": {