logger.ts

const header = '[TSD-JSDoc]';

let isVerbose = false;

export function setVerbose(value: boolean)
{
    isVerbose = value;
}

export function warn(msg: string, data?: any)
{
    if (typeof(console) === 'undefined')
        return;

    let prefix = header;
    if (data && data.meta)
    {
        const meta = data.meta;
        prefix = `${prefix} ${meta.filename}:${meta.lineno}:${meta.columnno}`;
    }

    console.warn(`${prefix} ${msg}`);

    if (isVerbose && arguments.length > 1)
    {
        console.warn(data);
    }

    if (isDebug)
    {
        // `console.warn()` pushes in stderr.
        // Let's push the message in stdout with `console.log()` as well, as `debug()` does for a better debugging experience.
        console.log(`${header} WARN: ${msg}`);
        if (arguments.length > 1)
        {
            console.log(data);
        }
    }
}

let isDebug = false;

export function setDebug(value: boolean)
{
    isDebug = value;
}

export function debug(msg: string, data?: any)
{
    if (typeof(console) === 'undefined')
        return;

    if (isDebug)
    {
        // Mix of tsd-jsdoc header with the jsdoc pattern on 'debug' option activated.
        console.log(`${header} DEBUG: ${msg}`);
        if (arguments.length > 1)
        {
            console.log(data);
        }
    }
}

export function docletDebugInfo(doclet: TAnyDoclet) : string {
    let debugInfo = `{longname='${doclet.longname}', kind='${doclet.kind}'`;
    if ((doclet.kind !== 'package') && doclet.meta)
    {
        if (doclet.meta.code.id)
            debugInfo += `, id='${doclet.meta.code.id}'`;
        if (doclet.meta.range)
            debugInfo += `, range=[${doclet.meta.range[0]}-${doclet.meta.range[1]}]`;
        else if (doclet.meta.lineno)
            debugInfo += `, lineno=${doclet.meta.lineno}`;
    }
    debugInfo += `}`;
    return debugInfo;
}