Function resolve_function_call

internal/cbm/lsp/php_lsp.c:1594–1678

/* ── call resolution ────────────────────────────────────────────── */

static void resolve_function_call(PHPLSPContext *ctx, TSNode call, CBMResolvedKind kind) {
    TSNode fn = ts_node_child_by_field_name(call, "function", 8);
    if (ts_node_is_null(fn))
        return;
    char *name = php_node_text(ctx, fn);
    if (!name)
        return;

    /* In PHP, `$handler(...)` is syntactically a function-call expression but
     * a typed object value dispatches to its materialized `__invoke` method.
     * This is precise only for a first-class callable and a receiver type whose
     * exact method exists in the registry; otherwise leave it unresolved so
     * the usage pipeline can retain ordinary value semantics. */
    if (kind == CBM_RESOLVED_CALL_REFERENCE && strcmp(ts_node_type(fn), "variable_name") == 0) {
        const CBMType *receiver = php_eval_expr_type(ctx, fn);
        const char *class_qn = NULL;
        if (receiver && receiver->kind == CBM_TYPE_NAMED) {
            class_qn = receiver->data.named.qualified_name;
        } else if (receiver && receiver->kind == CBM_TYPE_TEMPLATE) {
            class_qn = receiver->data.template_type.template_name;
        }
        const CBMRegisteredFunc *invoke =
            class_qn ? php_lookup_method(ctx, class_qn, "__invoke") : NULL;
        if (invoke && invoke->qualified_name) {
            emit_resolved_reason_kind(ctx, invoke->qualified_name, "php_invokable_reference", 0.95f,
                                      name, kind);
        }
        return;
    }

    /* `use function Foo\\bar;` mapping. */
    const char *target = find_use(ctx, name, CBM_PHP_USE_FUNCTION);
    if (target) {
        const CBMRegisteredFunc *f = cbm_registry_lookup_func(ctx->registry, target);
        if (f) {
            emit_resolved_kind(ctx, f->qualified_name, "php_function_namespaced", 0.95f, kind);
            return;
        }
    }

    /* Current namespace, then global fallback. */
    if (ctx->current_namespace_qn && ctx->current_namespace_qn[0]) {
        const char *ns_qn = cbm_arena_sprintf(ctx->arena, "%s.%s", ctx->current_namespace_qn, name);
        const CBMRegisteredFunc *f = cbm_registry_lookup_func(ctx->registry, ns_qn);
        if (f) {
            emit_resolved_kind(ctx, f->qualified_name, "php_function_namespaced", 0.95f, kind);
            return;
        }
    }

    /* Look for any free function with this short_name. Prefer the one in the
     * file's project (i.e. with the longest module-prefix overlap). */
    const CBMRegisteredFunc *best = NULL;
    int best_score = -1;
    for (int i = 0; ctx->registry && i < ctx->registry->func_count; i++) {
        const CBMRegisteredFunc *cand = &ctx->registry->funcs[i];
        if (cand->receiver_type)
            continue;