cotx-engine 0.1.0

package/dist/core/parser/entry-point-scoring.js

@@ -0,0 +1,377 @@
+/**
+ * Entry Point Scoring
+ *
+ * Calculates entry point scores for process detection based on:
+ * 1. Call ratio (existing algorithm - callees / (callers + 1))
+ * 2. Export status (exported functions get higher priority)
+ * 3. Name patterns (functions matching entry point patterns like handle*, on*, *Controller)
+ * 4. Framework detection (path-based detection for Next.js, Express, Django, etc.)
+ *
+ * This module is language-agnostic - language-specific patterns are defined per language.
+ */
+import { detectFrameworkFromPath } from './framework-detection.js';
+import { SupportedLanguages } from '../shared/index.js';
+// ============================================================================
+// NAME PATTERNS - All 13 supported languages
+// ============================================================================
+/**
+ * Common entry point naming patterns by language.
+ * These patterns indicate functions that are likely feature entry points.
+ *
+ * Universal patterns are separated from per-language patterns so the per-language
+ * table can use `satisfies Record<SupportedLanguages, RegExp[]>` for compile-time
+ * exhaustiveness — the compiler catches any missing language entry.
+ */
+const UNIVERSAL_ENTRY_POINT_PATTERNS = [
+    /^(main|init|bootstrap|start|run|setup|configure)$/i,
+    /^handle[A-Z]/, // handleLogin, handleSubmit
+    /^on[A-Z]/, // onClick, onSubmit
+    /Handler$/, // RequestHandler
+    /Controller$/, // UserController
+    /^process[A-Z]/, // processPayment
+    /^execute[A-Z]/, // executeQuery
+    /^perform[A-Z]/, // performAction
+    /^dispatch[A-Z]/, // dispatchEvent
+    /^trigger[A-Z]/, // triggerAction
+    /^fire[A-Z]/, // fireEvent
+    /^emit[A-Z]/, // emitEvent
+];
+export const ENTRY_POINT_PATTERNS = {
+    // JavaScript/TypeScript
+    [SupportedLanguages.JavaScript]: [
+        /^use[A-Z]/, // React hooks (useEffect, etc.)
+    ],
+    [SupportedLanguages.TypeScript]: [
+        /^use[A-Z]/, // React hooks
+    ],
+    // Python
+    [SupportedLanguages.Python]: [
+        /^app$/, // Flask/FastAPI app
+        /^(get|post|put|delete|patch)_/i, // REST conventions
+        /^api_/, // API functions
+        /^view_/, // Django views
+    ],
+    // Java
+    [SupportedLanguages.Java]: [
+        /^do[A-Z]/, // doGet, doPost (Servlets)
+        /^create[A-Z]/, // Factory patterns
+        /^build[A-Z]/, // Builder patterns
+        /Service$/, // UserService
+    ],
+    // Kotlin
+    [SupportedLanguages.Kotlin]: [
+        /^on(Create|Start|Resume|Pause|Stop|Destroy)$/, // Android lifecycle
+        /^do[A-Z]/, // doGet, doPost (shared JVM Servlet pattern)
+        /^create[A-Z]/, // Factory patterns
+        /^build[A-Z]/, // Builder patterns
+        /ViewModel$/, // MVVM pattern (Android)
+        /^module$/, // Ktor module entry point
+        /Service$/, // Service classes
+    ],
+    // C#
+    [SupportedLanguages.CSharp]: [
+        /^(Get|Post|Put|Delete|Patch)/, // ASP.NET action methods
+        /Action$/, // MVC actions
+        /^On[A-Z]/, // Event handlers / Blazor lifecycle
+        /Async$/, // Async entry points
+        /^Configure$/, // Startup.Configure
+        /^ConfigureServices$/, // Startup.ConfigureServices
+        /^Handle$/, // MediatR / generic handler
+        /^Execute$/, // Command pattern
+        /^Invoke$/, // Middleware Invoke
+        /^Map[A-Z]/, // Minimal API MapGet, MapPost
+        /Service$/, // Service classes
+        /^Seed/, // Database seeding
+    ],
+    // Go
+    [SupportedLanguages.Go]: [
+        /Handler$/, // http.Handler pattern
+        /^Serve/, // ServeHTTP
+        /^New[A-Z]/, // Constructor pattern (returns new instance)
+        /^Make[A-Z]/, // Make functions
+    ],
+    // Rust
+    [SupportedLanguages.Rust]: [
+        /^(get|post|put|delete)_handler$/i,
+        /^handle_/, // handle_request
+        /^new$/, // Constructor pattern
+        /^run$/, // run entry point
+        /^spawn/, // Async spawn
+    ],
+    // C - explicit main() boost plus common C entry point conventions
+    [SupportedLanguages.C]: [
+        /^main$/, // THE entry point
+        /^init_/, // init_server, init_client
+        /_init$/, // module_init, server_init
+        /^start_/, // start_server
+        /_start$/, // thread_start
+        /^run_/, // run_loop
+        /_run$/, // event_run
+        /^stop_/, // stop_server
+        /_stop$/, // service_stop
+        /^open_/, // open_connection
+        /_open$/, // file_open
+        /^close_/, // close_connection
+        /_close$/, // socket_close
+        /^create_/, // create_session
+        /_create$/, // object_create
+        /^destroy_/, // destroy_session
+        /_destroy$/, // object_destroy
+        /^handle_/, // handle_request
+        /_handler$/, // signal_handler
+        /_callback$/, // event_callback
+        /^cmd_/, // tmux: cmd_new_window, cmd_attach_session
+        /^server_/, // server_start, server_loop
+        /^client_/, // client_connect
+        /^session_/, // session_create
+        /^window_/, // window_resize (tmux)
+        /^key_/, // key_press
+        /^input_/, // input_parse
+        /^output_/, // output_write
+        /^notify_/, // notify_client
+        /^control_/, // control_start
+    ],
+    // C++ - same as C plus OOP/template patterns
+    [SupportedLanguages.CPlusPlus]: [
+        /^main$/, // THE entry point
+        /^init_/,
+        /_init$/,
+        /^Create[A-Z]/, // Factory patterns
+        /^create_/,
+        /^Run$/, // Run methods
+        /^run$/,
+        /^Start$/, // Start methods
+        /^start$/,
+        /^handle_/,
+        /_handler$/,
+        /_callback$/,
+        /^OnEvent/, // Event callbacks
+        /^on_/,
+        /::Run$/, // Class::Run
+        /::Start$/, // Class::Start
+        /::Init$/, // Class::Init
+        /::Execute$/, // Class::Execute
+    ],
+    // Swift / iOS
+    [SupportedLanguages.Swift]: [
+        /^viewDidLoad$/, // UIKit lifecycle
+        /^viewWillAppear$/, // UIKit lifecycle
+        /^viewDidAppear$/, // UIKit lifecycle
+        /^viewWillDisappear$/, // UIKit lifecycle
+        /^viewDidDisappear$/, // UIKit lifecycle
+        /^application\(/, // AppDelegate methods
+        /^scene\(/, // SceneDelegate methods
+        /^body$/, // SwiftUI View.body
+        /Coordinator$/, // Coordinator pattern
+        /^sceneDidBecomeActive$/, // SceneDelegate lifecycle
+        /^sceneWillResignActive$/, // SceneDelegate lifecycle
+        /^didFinishLaunchingWithOptions$/, // AppDelegate
+        /ViewController$/, // ViewController classes
+        /^configure[A-Z]/, // Configuration methods
+        /^setup[A-Z]/, // Setup methods
+        /^makeBody$/, // SwiftUI ViewModifier
+    ],
+    // PHP / Laravel
+    [SupportedLanguages.PHP]: [
+        /Controller$/, // UserController (class name convention)
+        /^handle$/, // Job::handle(), Listener::handle()
+        /^execute$/, // Command::execute()
+        /^boot$/, // ServiceProvider::boot()
+        /^register$/, // ServiceProvider::register()
+        /^__invoke$/, // Invokable controllers/actions
+        /^(index|show|store|update|destroy|create|edit)$/, // RESTful resource methods
+        /^(get|post|put|delete|patch)[A-Z]/, // Explicit HTTP method actions
+        /^run$/, // Command/Job run()
+        /^fire$/, // Event fire()
+        /^dispatch$/, // Dispatchable jobs
+        /Service$/, // UserService (Service layer)
+        /Repository$/, // UserRepository (Repository pattern)
+        /^find$/, // Repository::find()
+        /^findAll$/, // Repository::findAll()
+        /^save$/, // Repository::save()
+        /^delete$/, // Repository::delete()
+    ],
+    // Ruby
+    [SupportedLanguages.Ruby]: [
+        /^call$/, // Service objects (MyService.call)
+        /^perform$/, // Background jobs (Sidekiq, ActiveJob)
+        /^execute$/, // Command pattern
+    ],
+    // Dart / Flutter
+    [SupportedLanguages.Dart]: [
+        /^main$/, // App entry
+        /^build$/, // Widget.build — fundamental Flutter render entry point
+        /^createState$/, // StatefulWidget.createState
+        /^initState$/, // State lifecycle initialization
+        /^dispose$/, // State lifecycle teardown
+        /^didChangeDependencies$/, // State lifecycle — InheritedWidget changes
+        /^didUpdateWidget$/, // State lifecycle — widget rebuild with new config
+        /^runApp$/, // App entry point
+        /^onEvent$/, // BLoC event handler
+        /^mapEventToState$/, // Legacy BLoC pattern
+    ],
+    [SupportedLanguages.Vue]: [], // Vue uses TypeScript queries — entry points handled via TS patterns
+};
+/** Pre-computed merged patterns (universal + language-specific) to avoid per-call array allocation. */
+const MERGED_ENTRY_POINT_PATTERNS = Object.fromEntries(Object.values(SupportedLanguages).map((lang) => [
+    lang,
+    [...UNIVERSAL_ENTRY_POINT_PATTERNS, ...(ENTRY_POINT_PATTERNS[lang] ?? [])],
+]));
+// ============================================================================
+// UTILITY PATTERNS - Functions that should be penalized
+// ============================================================================
+/**
+ * Patterns that indicate utility/helper functions (NOT entry points)
+ * These get penalized in scoring
+ */
+const UTILITY_PATTERNS = [
+    /^(get|set|is|has|can|should|will|did)[A-Z]/, // Accessors/predicates
+    /^_/, // Private by convention
+    /^(format|parse|validate|convert|transform)/i, // Transformation utilities
+    /^(log|debug|error|warn|info)$/i, // Logging
+    /^(to|from)[A-Z]/, // Conversions
+    /^(encode|decode)/i, // Encoding utilities
+    /^(serialize|deserialize)/i, // Serialization
+    /^(clone|copy|deep)/i, // Cloning utilities
+    /^(merge|extend|assign)/i, // Object utilities
+    /^(filter|map|reduce|sort|find)/i, // Collection utilities (standalone)
+    /Helper$/,
+    /Util$/,
+    /Utils$/,
+    /^utils?$/i,
+    /^helpers?$/i,
+];
+// ============================================================================
+// MAIN SCORING FUNCTION
+// ============================================================================
+/**
+ * Calculate an entry point score for a function/method
+ *
+ * Higher scores indicate better entry point candidates.
+ * Score = baseScore × exportMultiplier × nameMultiplier
+ *
+ * @param name - Function/method name
+ * @param language - Programming language
+ * @param isExported - Whether the function is exported/public
+ * @param callerCount - Number of functions that call this function
+ * @param calleeCount - Number of functions this function calls
+ * @returns Score and array of reasons explaining the score
+ */
+export function calculateEntryPointScore(name, language, isExported, callerCount, calleeCount, filePath = '') {
+    const reasons = [];
+    // Must have outgoing calls to be an entry point (we need to trace forward)
+    if (calleeCount === 0) {
+        return { score: 0, reasons: ['no-outgoing-calls'] };
+    }
+    // Base score: call ratio (existing algorithm)
+    // High ratio = calls many, called by few = likely entry point
+    const baseScore = calleeCount / (callerCount + 1);
+    reasons.push(`base:${baseScore.toFixed(2)}`);
+    // Export bonus: exported/public functions are more likely entry points
+    const exportMultiplier = isExported ? 2.0 : 1.0;
+    if (isExported) {
+        reasons.push('exported');
+    }
+    // Name pattern scoring
+    let nameMultiplier = 1.0;
+    // Check negative patterns first (utilities get penalized)
+    if (UTILITY_PATTERNS.some((p) => p.test(name))) {
+        nameMultiplier = 0.3; // Significant penalty
+        reasons.push('utility-pattern');
+    }
+    else {
+        // Check positive patterns
+        const allPatterns = MERGED_ENTRY_POINT_PATTERNS[language];
+        if (allPatterns?.some((p) => p.test(name))) {
+            nameMultiplier = 1.5; // Bonus for matching entry point pattern
+            reasons.push('entry-pattern');
+        }
+    }
+    // Framework detection bonus (Phase 2)
+    let frameworkMultiplier = 1.0;
+    if (filePath) {
+        const frameworkHint = detectFrameworkFromPath(filePath);
+        if (frameworkHint) {
+            frameworkMultiplier = frameworkHint.entryPointMultiplier;
+            reasons.push(`framework:${frameworkHint.reason}`);
+        }
+    }
+    // Calculate final score
+    const finalScore = baseScore * exportMultiplier * nameMultiplier * frameworkMultiplier;
+    return {
+        score: finalScore,
+        reasons,
+    };
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Check if a file path is a test file (should be excluded from entry points)
+ * Covers common test file patterns across all supported languages
+ */
+export function isTestFile(filePath) {
+    const p = filePath.toLowerCase().replace(/\\/g, '/');
+    return (
+    // JavaScript/TypeScript test patterns
+    p.includes('.test.') ||
+        p.includes('.spec.') ||
+        p.includes('__tests__/') ||
+        p.includes('__mocks__/') ||
+        // Generic test folders
+        p.includes('/test/') ||
+        p.includes('/tests/') ||
+        p.includes('/testing/') ||
+        // Python test patterns
+        p.endsWith('_test.py') ||
+        p.includes('/test_') ||
+        // Go test patterns
+        p.endsWith('_test.go') ||
+        // Java test patterns
+        p.includes('/src/test/') ||
+        // Rust test patterns (inline tests are different, but test files)
+        p.includes('/tests/') ||
+        // Swift/iOS test patterns
+        p.endsWith('tests.swift') ||
+        p.endsWith('test.swift') ||
+        p.includes('uitests/') ||
+        // C# test patterns
+        p.endsWith('tests.cs') ||
+        p.endsWith('test.cs') ||
+        p.includes('.tests/') ||
+        p.includes('.test/') ||
+        p.includes('.integrationtests/') ||
+        p.includes('.unittests/') ||
+        p.includes('/testproject/') ||
+        // PHP/Laravel test patterns
+        p.endsWith('test.php') ||
+        p.endsWith('spec.php') ||
+        p.includes('/tests/feature/') ||
+        p.includes('/tests/unit/') ||
+        // Ruby test patterns
+        p.endsWith('_spec.rb') ||
+        p.endsWith('_test.rb') ||
+        p.includes('/spec/') ||
+        p.includes('/test/fixtures/'));
+}
+/**
+ * Check if a file path is likely a utility/helper file
+ * These might still have entry points but should be lower priority
+ */
+export function isUtilityFile(filePath) {
+    const p = filePath.toLowerCase().replace(/\\/g, '/');
+    return (p.includes('/utils/') ||
+        p.includes('/util/') ||
+        p.includes('/helpers/') ||
+        p.includes('/helper/') ||
+        p.includes('/common/') ||
+        p.includes('/shared/') ||
+        p.includes('/lib/') ||
+        p.endsWith('/utils.ts') ||
+        p.endsWith('/utils.js') ||
+        p.endsWith('/helpers.ts') ||
+        p.endsWith('/helpers.js') ||
+        p.endsWith('_utils.py') ||
+        p.endsWith('_helpers.py'));
+}
+//# sourceMappingURL=entry-point-scoring.js.map

package/dist/core/parser/entry-point-scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point-scoring.js","sourceRoot":"","sources":["../../../src/core/parser/entry-point-scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,+EAA+E;AAC/E,6CAA6C;AAC7C,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,8BAA8B,GAAa;IAC/C,oDAAoD;IACpD,cAAc,EAAE,4BAA4B;IAC5C,UAAU,EAAE,oBAAoB;IAChC,UAAU,EAAE,iBAAiB;IAC7B,aAAa,EAAE,iBAAiB;IAChC,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,eAAe;IAChC,eAAe,EAAE,gBAAgB;IACjC,gBAAgB,EAAE,gBAAgB;IAClC,eAAe,EAAE,gBAAgB;IACjC,YAAY,EAAE,YAAY;IAC1B,YAAY,EAAE,YAAY;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,wBAAwB;IACxB,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE;QAC/B,WAAW,EAAE,gCAAgC;KAC9C;IACD,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE;QAC/B,WAAW,EAAE,cAAc;KAC5B;IAED,SAAS;IACT,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE;QAC3B,OAAO,EAAE,oBAAoB;QAC7B,gCAAgC,EAAE,mBAAmB;QACrD,OAAO,EAAE,gBAAgB;QACzB,QAAQ,EAAE,eAAe;KAC1B;IAED,OAAO;IACP,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;QACzB,UAAU,EAAE,2BAA2B;QACvC,cAAc,EAAE,mBAAmB;QACnC,aAAa,EAAE,mBAAmB;QAClC,UAAU,EAAE,cAAc;KAC3B;IAED,SAAS;IACT,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE;QAC3B,8CAA8C,EAAE,oBAAoB;QACpE,UAAU,EAAE,6CAA6C;QACzD,cAAc,EAAE,mBAAmB;QACnC,aAAa,EAAE,mBAAmB;QAClC,YAAY,EAAE,yBAAyB;QACvC,UAAU,EAAE,0BAA0B;QACtC,UAAU,EAAE,kBAAkB;KAC/B;IAED,KAAK;IACL,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE;QAC3B,8BAA8B,EAAE,yBAAyB;QACzD,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,oCAAoC;QAChD,QAAQ,EAAE,qBAAqB;QAC/B,aAAa,EAAE,oBAAoB;QACnC,qBAAqB,EAAE,4BAA4B;QACnD,UAAU,EAAE,4BAA4B;QACxC,WAAW,EAAE,kBAAkB;QAC/B,UAAU,EAAE,oBAAoB;QAChC,WAAW,EAAE,8BAA8B;QAC3C,UAAU,EAAE,kBAAkB;QAC9B,OAAO,EAAE,mBAAmB;KAC7B;IAED,KAAK;IACL,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE;QACvB,UAAU,EAAE,uBAAuB;QACnC,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,6CAA6C;QAC1D,YAAY,EAAE,iBAAiB;KAChC;IAED,OAAO;IACP,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;QACzB,kCAAkC;QAClC,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,sBAAsB;QAC/B,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,cAAc;KACzB;IAED,kEAAkE;IAClE,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE;QACtB,QAAQ,EAAE,kBAAkB;QAC5B,QAAQ,EAAE,2BAA2B;QACrC,QAAQ,EAAE,2BAA2B;QACrC,SAAS,EAAE,eAAe;QAC1B,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,WAAW;QACpB,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,kBAAkB;QAC5B,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,mBAAmB;QAC9B,SAAS,EAAE,eAAe;QAC1B,UAAU,EAAE,iBAAiB;QAC7B,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,iBAAiB;QAC9B,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,iBAAiB;QAC/B,OAAO,EAAE,2CAA2C;QACpD,UAAU,EAAE,4BAA4B;QACxC,UAAU,EAAE,iBAAiB;QAC7B,WAAW,EAAE,iBAAiB;QAC9B,UAAU,EAAE,uBAAuB;QACnC,OAAO,EAAE,YAAY;QACrB,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,eAAe;QAC3B,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,gBAAgB;KAC9B;IAED,6CAA6C;IAC7C,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE;QAC9B,QAAQ,EAAE,kBAAkB;QAC5B,QAAQ;QACR,QAAQ;QACR,cAAc,EAAE,mBAAmB;QACnC,UAAU;QACV,OAAO,EAAE,cAAc;QACvB,OAAO;QACP,SAAS,EAAE,gBAAgB;QAC3B,SAAS;QACT,UAAU;QACV,WAAW;QACX,YAAY;QACZ,UAAU,EAAE,kBAAkB;QAC9B,MAAM;QACN,QAAQ,EAAE,aAAa;QACvB,UAAU,EAAE,eAAe;QAC3B,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,iBAAiB;KAChC;IAED,cAAc;IACd,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;QAC1B,eAAe,EAAE,kBAAkB;QACnC,kBAAkB,EAAE,kBAAkB;QACtC,iBAAiB,EAAE,kBAAkB;QACrC,qBAAqB,EAAE,kBAAkB;QACzC,oBAAoB,EAAE,kBAAkB;QACxC,gBAAgB,EAAE,sBAAsB;QACxC,UAAU,EAAE,wBAAwB;QACpC,QAAQ,EAAE,oBAAoB;QAC9B,cAAc,EAAE,sBAAsB;QACtC,wBAAwB,EAAE,0BAA0B;QACpD,yBAAyB,EAAE,0BAA0B;QACrD,iCAAiC,EAAE,cAAc;QACjD,iBAAiB,EAAE,yBAAyB;QAC5C,iBAAiB,EAAE,wBAAwB;QAC3C,aAAa,EAAE,gBAAgB;QAC/B,YAAY,EAAE,uBAAuB;KACtC;IAED,gBAAgB;IAChB,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE;QACxB,aAAa,EAAE,yCAAyC;QACxD,UAAU,EAAE,oCAAoC;QAChD,WAAW,EAAE,qBAAqB;QAClC,QAAQ,EAAE,0BAA0B;QACpC,YAAY,EAAE,8BAA8B;QAC5C,YAAY,EAAE,gCAAgC;QAC9C,iDAAiD,EAAE,2BAA2B;QAC9E,mCAAmC,EAAE,+BAA+B;QACpE,OAAO,EAAE,oBAAoB;QAC7B,QAAQ,EAAE,eAAe;QACzB,YAAY,EAAE,oBAAoB;QAClC,UAAU,EAAE,8BAA8B;QAC1C,aAAa,EAAE,sCAAsC;QACrD,QAAQ,EAAE,qBAAqB;QAC/B,WAAW,EAAE,wBAAwB;QACrC,QAAQ,EAAE,qBAAqB;QAC/B,UAAU,EAAE,uBAAuB;KACpC;IAED,OAAO;IACP,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;QACzB,QAAQ,EAAE,mCAAmC;QAC7C,WAAW,EAAE,uCAAuC;QACpD,WAAW,EAAE,kBAAkB;KAChC;IAED,iBAAiB;IACjB,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;QACzB,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,wDAAwD;QACnE,eAAe,EAAE,6BAA6B;QAC9C,aAAa,EAAE,iCAAiC;QAChD,WAAW,EAAE,2BAA2B;QACxC,yBAAyB,EAAE,4CAA4C;QACvE,mBAAmB,EAAE,mDAAmD;QACxE,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,qBAAqB;QAClC,mBAAmB,EAAE,sBAAsB;KAC5C;IACD,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,qEAAqE;CACrD,CAAC;AAEjD,uGAAuG;AACvG,MAAM,2BAA2B,GAAG,MAAM,CAAC,WAAW,CACpD,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9C,IAAI;IACJ,CAAC,GAAG,8BAA8B,EAAE,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;CAC3E,CAAC,CACqC,CAAC;AAE1C,+EAA+E;AAC/E,wDAAwD;AACxD,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,gBAAgB,GAAa;IACjC,4CAA4C,EAAE,uBAAuB;IACrE,IAAI,EAAE,wBAAwB;IAC9B,6CAA6C,EAAE,2BAA2B;IAC1E,gCAAgC,EAAE,UAAU;IAC5C,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,qBAAqB;IAC1C,2BAA2B,EAAE,gBAAgB;IAC7C,qBAAqB,EAAE,oBAAoB;IAC3C,yBAAyB,EAAE,mBAAmB;IAC9C,iCAAiC,EAAE,oCAAoC;IACvE,SAAS;IACT,OAAO;IACP,QAAQ;IACR,WAAW;IACX,aAAa;CACd,CAAC;AAWF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,QAA4B,EAC5B,UAAmB,EACnB,WAAmB,EACnB,WAAmB,EACnB,WAAmB,EAAE;IAErB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,8CAA8C;IAC9C,8DAA8D;IAC9D,MAAM,SAAS,GAAG,WAAW,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,QAAQ,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE7C,uEAAuE;IACvE,MAAM,gBAAgB,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,uBAAuB;IACvB,IAAI,cAAc,GAAG,GAAG,CAAC;IAEzB,0DAA0D;IAC1D,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC/C,cAAc,GAAG,GAAG,CAAC,CAAC,sBAAsB;QAC5C,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,0BAA0B;QAC1B,MAAM,WAAW,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QAE1D,IAAI,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC3C,cAAc,GAAG,GAAG,CAAC,CAAC,yCAAyC;YAC/D,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,IAAI,mBAAmB,GAAG,GAAG,CAAC;IAC9B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,aAAa,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,aAAa,EAAE,CAAC;YAClB,mBAAmB,GAAG,aAAa,CAAC,oBAAoB,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,aAAa,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,cAAc,GAAG,mBAAmB,CAAC;IAEvF,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,OAAO;KACR,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAErD,OAAO;IACL,sCAAsC;IACtC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxB,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxB,uBAAuB;QACvB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvB,uBAAuB;QACvB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,mBAAmB;QACnB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,qBAAqB;QACrB,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxB,kEAAkE;QAClE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,0BAA0B;QAC1B,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QACzB,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,mBAAmB;QACnB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAChC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QACzB,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC3B,4BAA4B;QAC5B,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC7B,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC1B,qBAAqB;QACrB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAErD,OAAO,CACL,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QACzB,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QACzB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvB,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC1B,CAAC;AACJ,CAAC"}

package/dist/core/parser/export-detection.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Export Detection
+ *
+ * Determines whether a symbol (function, class, etc.) is exported/public
+ * in its language. This is a pure function — safe for use in worker threads.
+ *
+ * Shared between parse-worker.ts (worker pool) and parsing-processor.ts (sequential fallback).
+ */
+import { type SyntaxNode } from './utils/ast-helpers.js';
+/** Handler type: given a node and symbol name, return true if the symbol is exported/public. */
+export type ExportChecker = (node: SyntaxNode, name: string) => boolean;
+/** JS/TS: walk ancestors looking for export_statement or export_specifier. */
+export declare const tsExportChecker: ExportChecker;
+/** Python: public if no leading underscore (convention). */
+export declare const pythonExportChecker: ExportChecker;
+/** Java: check for 'public' modifier — modifiers are siblings of the name node, not parents. */
+export declare const javaExportChecker: ExportChecker;
+/**
+ * C#: modifier nodes are SIBLINGS of the name node inside the declaration.
+ * Walk up to the declaration node, then scan its direct children.
+ */
+export declare const csharpExportChecker: ExportChecker;
+/** Go: uppercase first letter = exported. */
+export declare const goExportChecker: ExportChecker;
+/**
+ * Rust: visibility_modifier is a SIBLING of the name node within the declaration node
+ * (function_item, struct_item, etc.), not a parent. Walk up to the declaration node,
+ * then scan its direct children.
+ */
+export declare const rustExportChecker: ExportChecker;
+/**
+ * Kotlin: default visibility is public (unlike Java).
+ * visibility_modifier is inside modifiers, a sibling of the name node within the declaration.
+ */
+export declare const kotlinExportChecker: ExportChecker;
+/**
+ * C/C++: functions without 'static' storage class have external linkage by default,
+ * making them globally accessible (equivalent to exported). Only functions explicitly
+ * marked 'static' are file-scoped (not exported). C++ anonymous namespaces
+ * (namespace { ... }) also give internal linkage.
+ */
+export declare const cCppExportChecker: ExportChecker;
+/** PHP: check for visibility modifier or top-level scope. */
+export declare const phpExportChecker: ExportChecker;
+/**
+ * Swift: treat symbols as exported unless explicitly marked private/fileprivate.
+ *
+ * Swift's default access level is `internal`, which means visible to all files
+ * in the same module/target. Since cotx-engine indexes at the target level,
+ * `internal` symbols should be treated as exported (cross-file visible).
+ * Only `private` and `fileprivate` symbols are truly file-scoped.
+ */
+export declare const swiftExportChecker: ExportChecker;
+/** Ruby: all top-level definitions are public (no export syntax). */
+export declare const rubyExportChecker: ExportChecker;
+/** Dart: public if no leading underscore (convention, same as Python). */
+export declare const dartExportChecker: ExportChecker;