export declare const MODULE_DESCRIPTION_MAX_LENGTH = 120;
import type { BuiltinNormalExpressions, FunctionDocs } from '../../builtin/interface';
import type { AstNode } from '../../parser/types';
/**
 * Represents a Dvala module that can be imported dynamically.
 * Modules contain a collection of functions that are not part of the core bundle.
 */
export interface DvalaModule {
    /** The name of the module (e.g., 'grid', 'vec', 'mat') */
    name: string;
    /** Short description of what the module provides (max 120 chars). */
    description: string;
    /** The functions provided by this module, keyed by their short name (e.g., 'transpose') */
    functions: BuiltinNormalExpressions;
    /**
     * Optional Dvala source code that is evaluated at import time.
     * The source must evaluate to an object mapping function names to functions.
     * These are merged with (and may override) the TypeScript `functions`.
     */
    source?: string;
    /**
     * Docs for all functions in this module, including any defined in `source`.
     * The reference system uses this record as the sole source of truth for
     * function names and documentation. Not required for user-defined modules.
     */
    docs?: Record<string, FunctionDocs>;
    /** @internal Cached parsed AST nodes for the module source. */
    _cachedNodes?: AstNode[];
}
/**
 * Derives a docs record from a BuiltinNormalExpressions map.
 * Use this for modules whose docs are co-located inline on each function.
 */
export declare function moduleDocsFromFunctions(functions: BuiltinNormalExpressions): Record<string, FunctionDocs>;