/**
 * Semantic analyzer for detecting application entrypoint patterns in Python
 * source code.
 */
/**
 * Check if Python source code contains or exports:
 * - A top-level 'app' callable (e.g., Flask, FastAPI, Sanic apps)
 * - A top-level 'application' callable (e.g., Django )
 * - A top-level 'handler' class (e.g., BaseHTTPRequestHandler subclass)
 *
 * This function uses a WASM-based Python parser (ruff_python_ast) for
 * accurate AST analysis without requiring a Python runtime.
 *
 * @param source - The Python source code to analyze
 * @returns Promise that resolves to true if an app or handler is found, false otherwise.
 *          Returns false for invalid Python syntax.
 *
 * @example
 * ```typescript
 * import { containsAppOrHandler } from '@vercel/python-analysis';
 *
 * const hasApp = await containsAppOrHandler(`
 * from flask import Flask
 * app = Flask(__name__)
 * `);
 * console.log(hasApp); // true
 * ```
 */
export declare function containsAppOrHandler(source: string): Promise<boolean>;
/**
 * Extract the string value of a top-level constant with the given name.
 * Only considers simple assignments (NAME = "string") and annotated assignments
 * (NAME: str = "string") at module level. Returns the first matching string
 * value, or null if not found or the value is not a string literal.
 *
 * @param source - Python source code
 * @param name - Constant name (e.g. "VERSION", "APP_NAME")
 * @returns The string value or null
 */
export declare function getStringConstant(source: string, name: string): Promise<string | null>;
/**
 * Parse manage.py content for DJANGO_SETTINGS_MODULE (e.g. from
 * os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'app.settings')).
 * Uses the WASM Python parser to extract the value from the AST.
 *
 * @param content - Raw content of manage.py
 * @returns The settings module string (e.g. 'app.settings') or null if not found
 */
export declare function parseDjangoSettingsModule(content: string): Promise<string | null>;