declare namespace callsites {
    interface CallSite {
        /**
        Returns the value of `this`.
        */
        getThis(): unknown | undefined;

        /**
        Returns the type of `this` as a string. This is the name of the function stored in the constructor field of `this`, if available, otherwise the object's `[[Class]]` internal property.
        */
        getTypeName(): string | null;

        /**
        Returns the current function.
        */
        getFunction(): Function | undefined;

        /**
        Returns the name of the current function, typically its `name` property. If a name property is not available an attempt will be made to try to infer a name from the function's context.
        */
        getFunctionName(): string | null;

        /**
        Returns the name of the property of `this` or one of its prototypes that holds the current function.
        */
        getMethodName(): string | undefined;

        /**
        Returns the name of the script if this function was defined in a script.
        */
        getFileName(): string | null;

        /**
        Returns the current line number if this function was defined in a script.
        */
        getLineNumber(): number | null;

        /**
        Returns the current column number if this function was defined in a script.
        */
        getColumnNumber(): number | null;

        /**
        Returns a string representing the location where `eval` was called if this function was created using a call to `eval`.
        */
        getEvalOrigin(): string | undefined;

        /**
        Returns `true` if this is a top-level invocation, that is, if it's a global object.
        */
        isToplevel(): boolean;

        /**
        Returns `true` if this call takes place in code defined by a call to `eval`.
        */
        isEval(): boolean;

        /**
        Returns `true` if this call is in native V8 code.
        */
        isNative(): boolean;

        /**
        Returns `true` if this is a constructor call.
        */
        isConstructor(): boolean;
    }
}

declare const callsites: {
    /**
    Get callsites from the V8 stack trace API.

    @returns An array of `CallSite` objects.

    @example
    ```
    import callsites = require('callsites');

    function unicorn() {
        console.log(callsites()[0].getFileName());
        //=> '/Users/sindresorhus/dev/callsites/test.js'
    }

    unicorn();
    ```
    */
    (): callsites.CallSite[];

    // TODO: Remove this for the next major release, refactor the whole definition to:
    // declare function callsites(): callsites.CallSite[];
    // export = callsites;
    default: typeof callsites;
};

export = callsites;