@docusaurus/logger 3.5.2 → 3.6.0-canary-6132

package/lib/index.d.ts

@@ -4,37 +4,13 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { ReportingSeverity } from '@docusaurus/types';
-type InterpolatableValue = string | number | (string | number)[];
-declare function interpolate(msgs: TemplateStringsArray, ...values: InterpolatableValue[]): string;
-declare function info(msg: unknown): void;
-declare function info(msg: TemplateStringsArray, ...values: [InterpolatableValue, ...InterpolatableValue[]]): void;
-declare function warn(msg: unknown): void;
-declare function warn(msg: TemplateStringsArray, ...values: [InterpolatableValue, ...InterpolatableValue[]]): void;
-declare function error(msg: unknown): void;
-declare function error(msg: TemplateStringsArray, ...values: [InterpolatableValue, ...InterpolatableValue[]]): void;
-declare function success(msg: unknown): void;
-declare function success(msg: TemplateStringsArray, ...values: [InterpolatableValue, ...InterpolatableValue[]]): void;
-declare function newLine(): void;
-/**
- * Takes a message and reports it according to the severity that the user wants.
- *
- * - `ignore`: completely no-op
- * - `log`: uses the `INFO` log level
- * - `warn`: uses the `WARN` log level
- * - `throw`: aborts the process, throws the error.
- *
- * Since the logger doesn't have logging level filters yet, these severities
- * mostly just differ by their colors.
- *
- * @throws In addition to throwing when `reportingSeverity === "throw"`, this
- * function also throws if `reportingSeverity` is not one of the above.
- */
-declare function report(reportingSeverity: ReportingSeverity): typeof success;
-declare const logger: {
+import OriginalLogger from './logger';
+export default OriginalLogger;
+export declare const logger: {
     red: (msg: string | number) => string;
     yellow: (msg: string | number) => string;
     green: (msg: string | number) => string;
+    cyan: (msg: string | number) => string;
     bold: (msg: string | number) => string;
     dim: (msg: string | number) => string;
     path: (msg: unknown) => string;
@@ -43,13 +19,28 @@ declare const logger: {
     code: (msg: unknown) => string;
     subdue: (msg: unknown) => string;
     num: (msg: unknown) => string;
-    interpolate: typeof interpolate;
-    info: typeof info;
-    warn: typeof warn;
-    error: typeof error;
-    success: typeof success;
-    report: typeof report;
-    newLine: typeof newLine;
+    interpolate: (msgs: TemplateStringsArray, ...values: (string | number | (string | number)[])[]) => string;
+    info: {
+        (msg: unknown): void;
+        (msg: TemplateStringsArray, values_0: string | number | (string | number)[], ...values: (string | number | (string | number)[])[]): void;
+    };
+    warn: {
+        (msg: unknown): void;
+        (msg: TemplateStringsArray, values_0: string | number | (string | number)[], ...values: (string | number | (string | number)[])[]): void;
+    };
+    error: {
+        (msg: unknown): void;
+        (msg: TemplateStringsArray, values_0: string | number | (string | number)[], ...values: (string | number | (string | number)[])[]): void;
+    };
+    success: {
+        (msg: unknown): void;
+        (msg: TemplateStringsArray, values_0: string | number | (string | number)[], ...values: (string | number | (string | number)[])[]): void;
+    };
+    report: (reportingSeverity: import("@docusaurus/types").ReportingSeverity) => {
+        (msg: unknown): void;
+        (msg: TemplateStringsArray, values_0: string | number | (string | number)[], ...values: (string | number | (string | number)[])[]): void;
+    };
+    newLine: () => void;
 };
-export = logger;
+export { PerfLogger } from './perfLogger';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAEzD,KAAK,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AASjE,iBAAS,WAAW,CAClB,IAAI,EAAE,oBAAoB,EAC1B,GAAG,MAAM,EAAE,mBAAmB,EAAE,GAC/B,MAAM,CAkCR;AAYD,iBAAS,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;AAClC,iBAAS,IAAI,CACX,GAAG,EAAE,oBAAoB,EACzB,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,GACzD,IAAI,CAAC;AAUR,iBAAS,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;AAClC,iBAAS,IAAI,CACX,GAAG,EAAE,oBAAoB,EACzB,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,GACzD,IAAI,CAAC;AAYR,iBAAS,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;AACnC,iBAAS,KAAK,CACZ,GAAG,EAAE,oBAAoB,EACzB,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,GACzD,IAAI,CAAC;AAYR,iBAAS,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;AACrC,iBAAS,OAAO,CACd,GAAG,EAAE,oBAAoB,EACzB,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,GACzD,IAAI,CAAC;AAuBR,iBAAS,OAAO,IAAI,IAAI,CAEvB;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,OAAO,CAepE;AAED,QAAA,MAAM,MAAM;eACC,MAAM,GAAG,MAAM,KAAG,MAAM;kBACrB,MAAM,GAAG,MAAM,KAAG,MAAM;iBACzB,MAAM,GAAG,MAAM,KAAG,MAAM;gBACzB,MAAM,GAAG,MAAM,KAAG,MAAM;eACzB,MAAM,GAAG,MAAM,KAAG,MAAM;gBAzKlB,OAAO,KAAG,MAAM;eACjB,OAAO,KAAG,MAAM;gBACf,OAAO,KAAG,MAAM;gBAChB,OAAO,KAAG,MAAM;kBACd,OAAO,KAAG,MAAM;eACnB,OAAO,KAAG,MAAM;;;;;;;;CAkLjC,CAAC;AAIF,SAAS,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,cAAc,MAAM,UAAU,CAAC;AAEtC,eAAe,cAAc,CAAC;AAM9B,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAiB,CAAC;AAErC,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC"}

package/lib/index.js

@@ -5,129 +5,16 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerfLogger = exports.logger = void 0;
 const tslib_1 = require("tslib");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const path = (msg) => chalk_1.default.cyan.underline(`"${String(msg)}"`);
-const url = (msg) => chalk_1.default.cyan.underline(msg);
-const name = (msg) => chalk_1.default.blue.bold(msg);
-const code = (msg) => chalk_1.default.cyan(`\`${String(msg)}\``);
-const subdue = (msg) => chalk_1.default.gray(msg);
-const num = (msg) => chalk_1.default.yellow(msg);
-function interpolate(msgs, ...values) {
-    let res = '';
-    values.forEach((value, idx) => {
-        const flag = msgs[idx].match(/[a-z]+=$/);
-        res += msgs[idx].replace(/[a-z]+=$/, '');
-        const format = (() => {
-            if (!flag) {
-                return (a) => a;
-            }
-            switch (flag[0]) {
-                case 'path=':
-                    return path;
-                case 'url=':
-                    return url;
-                case 'number=':
-                    return num;
-                case 'name=':
-                    return name;
-                case 'subdue=':
-                    return subdue;
-                case 'code=':
-                    return code;
-                default:
-                    throw new Error('Bad Docusaurus logging message. This is likely an internal bug, please report it.');
-            }
-        })();
-        res += Array.isArray(value)
-            ? `\n- ${value.map((v) => format(v)).join('\n- ')}`
-            : format(value);
-    });
-    res += msgs.slice(-1)[0];
-    return res;
-}
-function stringify(msg) {
-    if (String(msg) === '[object Object]') {
-        return JSON.stringify(msg);
-    }
-    if (msg instanceof Date) {
-        return msg.toUTCString();
-    }
-    return String(msg);
-}
-function info(msg, ...values) {
-    console.info(`${chalk_1.default.cyan.bold('[INFO]')} ${values.length === 0
-        ? stringify(msg)
-        : interpolate(msg, ...values)}`);
-}
-function warn(msg, ...values) {
-    console.warn(chalk_1.default.yellow(`${chalk_1.default.bold('[WARNING]')} ${values.length === 0
-        ? stringify(msg)
-        : interpolate(msg, ...values)}`));
-}
-function error(msg, ...values) {
-    console.error(chalk_1.default.red(`${chalk_1.default.bold('[ERROR]')} ${values.length === 0
-        ? stringify(msg)
-        : interpolate(msg, ...values)}`));
-}
-function success(msg, ...values) {
-    console.log(`${chalk_1.default.green.bold('[SUCCESS]')} ${values.length === 0
-        ? stringify(msg)
-        : interpolate(msg, ...values)}`);
-}
-function throwError(msg, ...values) {
-    throw new Error(values.length === 0
-        ? stringify(msg)
-        : interpolate(msg, ...values));
-}
-function newLine() {
-    console.log();
-}
-/**
- * Takes a message and reports it according to the severity that the user wants.
- *
- * - `ignore`: completely no-op
- * - `log`: uses the `INFO` log level
- * - `warn`: uses the `WARN` log level
- * - `throw`: aborts the process, throws the error.
- *
- * Since the logger doesn't have logging level filters yet, these severities
- * mostly just differ by their colors.
- *
- * @throws In addition to throwing when `reportingSeverity === "throw"`, this
- * function also throws if `reportingSeverity` is not one of the above.
- */
-function report(reportingSeverity) {
-    const reportingMethods = {
-        ignore: () => { },
-        log: info,
-        warn,
-        throw: throwError,
-    };
-    if (!Object.prototype.hasOwnProperty.call(reportingMethods, reportingSeverity)) {
-        throw new Error(`Unexpected "reportingSeverity" value: ${reportingSeverity}.`);
-    }
-    return reportingMethods[reportingSeverity];
-}
-const logger = {
-    red: (msg) => chalk_1.default.red(msg),
-    yellow: (msg) => chalk_1.default.yellow(msg),
-    green: (msg) => chalk_1.default.green(msg),
-    bold: (msg) => chalk_1.default.bold(msg),
-    dim: (msg) => chalk_1.default.dim(msg),
-    path,
-    url,
-    name,
-    code,
-    subdue,
-    num,
-    interpolate,
-    info,
-    warn,
-    error,
-    success,
-    report,
-    newLine,
-};
-module.exports = logger;
+const logger_1 = tslib_1.__importDefault(require("./logger"));
+exports.default = logger_1.default;
+// Extra named export to avoid problems in ESM modules
+// Notably: core .mjs CLI + create-docusaurus
+// See https://github.com/facebook/docusaurus/pull/6661
+// See https://github.com/facebook/docusaurus/pull/7295
+exports.logger = logger_1.default;
+var perfLogger_1 = require("./perfLogger");
+Object.defineProperty(exports, "PerfLogger", { enumerable: true, get: function () { return perfLogger_1.PerfLogger; } });
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;AAEH,8DAAsC;AAEtC,kBAAe,gBAAc,CAAC;AAE9B,sDAAsD;AACtD,6CAA6C;AAC7C,uDAAuD;AACvD,uDAAuD;AAC1C,QAAA,MAAM,GAAG,gBAAc,CAAC;AAErC,2CAAwC;AAAhC,wGAAA,UAAU,OAAA"}

package/lib/logger.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { ReportingSeverity } from '@docusaurus/types';
+type InterpolatableValue = string | number | (string | number)[];
+declare function interpolate(msgs: TemplateStringsArray, ...values: InterpolatableValue[]): string;
+declare function info(msg: unknown): void;
+declare function info(msg: TemplateStringsArray, ...values: [InterpolatableValue, ...InterpolatableValue[]]): void;
+declare function warn(msg: unknown): void;
+declare function warn(msg: TemplateStringsArray, ...values: [InterpolatableValue, ...InterpolatableValue[]]): void;
+declare function error(msg: unknown): void;
+declare function error(msg: TemplateStringsArray, ...values: [InterpolatableValue, ...InterpolatableValue[]]): void;
+declare function success(msg: unknown): void;
+declare function success(msg: TemplateStringsArray, ...values: [InterpolatableValue, ...InterpolatableValue[]]): void;
+declare function newLine(): void;
+/**
+ * Takes a message and reports it according to the severity that the user wants.
+ *
+ * - `ignore`: completely no-op
+ * - `log`: uses the `INFO` log level
+ * - `warn`: uses the `WARN` log level
+ * - `throw`: aborts the process, throws the error.
+ *
+ * Since the logger doesn't have logging level filters yet, these severities
+ * mostly just differ by their colors.
+ *
+ * @throws In addition to throwing when `reportingSeverity === "throw"`, this
+ * function also throws if `reportingSeverity` is not one of the above.
+ */
+declare function report(reportingSeverity: ReportingSeverity): typeof success;
+declare const logger: {
+    red: (msg: string | number) => string;
+    yellow: (msg: string | number) => string;
+    green: (msg: string | number) => string;
+    cyan: (msg: string | number) => string;
+    bold: (msg: string | number) => string;
+    dim: (msg: string | number) => string;
+    path: (msg: unknown) => string;
+    url: (msg: unknown) => string;
+    name: (msg: unknown) => string;
+    code: (msg: unknown) => string;
+    subdue: (msg: unknown) => string;
+    num: (msg: unknown) => string;
+    interpolate: typeof interpolate;
+    info: typeof info;
+    warn: typeof warn;
+    error: typeof error;
+    success: typeof success;
+    report: typeof report;
+    newLine: typeof newLine;
+};
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAEzD,KAAK,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AASjE,iBAAS,WAAW,CAClB,IAAI,EAAE,oBAAoB,EAC1B,GAAG,MAAM,EAAE,mBAAmB,EAAE,GAC/B,MAAM,CAkCR;AAYD,iBAAS,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;AAClC,iBAAS,IAAI,CACX,GAAG,EAAE,oBAAoB,EACzB,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,GACzD,IAAI,CAAC;AAUR,iBAAS,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;AAClC,iBAAS,IAAI,CACX,GAAG,EAAE,oBAAoB,EACzB,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,GACzD,IAAI,CAAC;AAYR,iBAAS,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;AACnC,iBAAS,KAAK,CACZ,GAAG,EAAE,oBAAoB,EACzB,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,GACzD,IAAI,CAAC;AAYR,iBAAS,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;AACrC,iBAAS,OAAO,CACd,GAAG,EAAE,oBAAoB,EACzB,GAAG,MAAM,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAAC,GACzD,IAAI,CAAC;AAuBR,iBAAS,OAAO,IAAI,IAAI,CAEvB;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,OAAO,CAepE;AAED,QAAA,MAAM,MAAM;eACC,MAAM,GAAG,MAAM,KAAG,MAAM;kBACrB,MAAM,GAAG,MAAM,KAAG,MAAM;iBACzB,MAAM,GAAG,MAAM,KAAG,MAAM;gBACzB,MAAM,GAAG,MAAM,KAAG,MAAM;gBACxB,MAAM,GAAG,MAAM,KAAG,MAAM;eACzB,MAAM,GAAG,MAAM,KAAG,MAAM;gBA1KlB,OAAO,KAAG,MAAM;eACjB,OAAO,KAAG,MAAM;gBACf,OAAO,KAAG,MAAM;gBAChB,OAAO,KAAG,MAAM;kBACd,OAAO,KAAG,MAAM;eACnB,OAAO,KAAG,MAAM;;;;;;;;CAmLjC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/lib/logger.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const path = (msg) => chalk_1.default.cyan.underline(`"${String(msg)}"`);
+const url = (msg) => chalk_1.default.cyan.underline(msg);
+const name = (msg) => chalk_1.default.blue.bold(msg);
+const code = (msg) => chalk_1.default.cyan(`\`${String(msg)}\``);
+const subdue = (msg) => chalk_1.default.gray(msg);
+const num = (msg) => chalk_1.default.yellow(msg);
+function interpolate(msgs, ...values) {
+    let res = '';
+    values.forEach((value, idx) => {
+        const flag = msgs[idx].match(/[a-z]+=$/);
+        res += msgs[idx].replace(/[a-z]+=$/, '');
+        const format = (() => {
+            if (!flag) {
+                return (a) => a;
+            }
+            switch (flag[0]) {
+                case 'path=':
+                    return path;
+                case 'url=':
+                    return url;
+                case 'number=':
+                    return num;
+                case 'name=':
+                    return name;
+                case 'subdue=':
+                    return subdue;
+                case 'code=':
+                    return code;
+                default:
+                    throw new Error('Bad Docusaurus logging message. This is likely an internal bug, please report it.');
+            }
+        })();
+        res += Array.isArray(value)
+            ? `\n- ${value.map((v) => format(v)).join('\n- ')}`
+            : format(value);
+    });
+    res += msgs.slice(-1)[0];
+    return res;
+}
+function stringify(msg) {
+    if (String(msg) === '[object Object]') {
+        return JSON.stringify(msg);
+    }
+    if (msg instanceof Date) {
+        return msg.toUTCString();
+    }
+    return String(msg);
+}
+function info(msg, ...values) {
+    console.info(`${chalk_1.default.cyan.bold('[INFO]')} ${values.length === 0
+        ? stringify(msg)
+        : interpolate(msg, ...values)}`);
+}
+function warn(msg, ...values) {
+    console.warn(chalk_1.default.yellow(`${chalk_1.default.bold('[WARNING]')} ${values.length === 0
+        ? stringify(msg)
+        : interpolate(msg, ...values)}`));
+}
+function error(msg, ...values) {
+    console.error(chalk_1.default.red(`${chalk_1.default.bold('[ERROR]')} ${values.length === 0
+        ? stringify(msg)
+        : interpolate(msg, ...values)}`));
+}
+function success(msg, ...values) {
+    console.log(`${chalk_1.default.green.bold('[SUCCESS]')} ${values.length === 0
+        ? stringify(msg)
+        : interpolate(msg, ...values)}`);
+}
+function throwError(msg, ...values) {
+    throw new Error(values.length === 0
+        ? stringify(msg)
+        : interpolate(msg, ...values));
+}
+function newLine() {
+    console.log();
+}
+/**
+ * Takes a message and reports it according to the severity that the user wants.
+ *
+ * - `ignore`: completely no-op
+ * - `log`: uses the `INFO` log level
+ * - `warn`: uses the `WARN` log level
+ * - `throw`: aborts the process, throws the error.
+ *
+ * Since the logger doesn't have logging level filters yet, these severities
+ * mostly just differ by their colors.
+ *
+ * @throws In addition to throwing when `reportingSeverity === "throw"`, this
+ * function also throws if `reportingSeverity` is not one of the above.
+ */
+function report(reportingSeverity) {
+    const reportingMethods = {
+        ignore: () => { },
+        log: info,
+        warn,
+        throw: throwError,
+    };
+    if (!Object.prototype.hasOwnProperty.call(reportingMethods, reportingSeverity)) {
+        throw new Error(`Unexpected "reportingSeverity" value: ${reportingSeverity}.`);
+    }
+    return reportingMethods[reportingSeverity];
+}
+const logger = {
+    red: (msg) => chalk_1.default.red(msg),
+    yellow: (msg) => chalk_1.default.yellow(msg),
+    green: (msg) => chalk_1.default.green(msg),
+    cyan: (msg) => chalk_1.default.cyan(msg),
+    bold: (msg) => chalk_1.default.bold(msg),
+    dim: (msg) => chalk_1.default.dim(msg),
+    path,
+    url,
+    name,
+    code,
+    subdue,
+    num,
+    interpolate,
+    info,
+    warn,
+    error,
+    success,
+    report,
+    newLine,
+};
+exports.default = logger;
+//# sourceMappingURL=logger.js.map

package/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/lib/perfLogger.d.ts

@@ -0,0 +1,9 @@
+type PerfLoggerAPI = {
+    start: (label: string) => void;
+    end: (label: string) => void;
+    log: (message: string) => void;
+    async: <Result>(label: string, asyncFn: () => Result | Promise<Result>) => Promise<Result>;
+};
+export declare const PerfLogger: PerfLoggerAPI;
+export {};
+//# sourceMappingURL=perfLogger.d.ts.map

package/lib/perfLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perfLogger.d.ts","sourceRoot":"","sources":["../src/perfLogger.ts"],"names":[],"mappings":"AA8BA,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KACpC,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAuIF,eAAO,MAAM,UAAU,EAAE,aAAkC,CAAC"}

package/lib/perfLogger.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerfLogger = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const async_hooks_1 = require("async_hooks");
+const logger_1 = tslib_1.__importDefault(require("./logger"));
+// For now this is a private env variable we use internally
+// But we'll want to expose this feature officially some day
+const PerfDebuggingEnabled = process.env.DOCUSAURUS_PERF_LOGGER === 'true';
+const Thresholds = {
+    min: 5,
+    yellow: 100,
+    red: 1000,
+};
+const PerfPrefix = logger_1.default.yellow(`[PERF]`);
+// This is what enables to "see the parent stack" for each log
+// Parent1 > Parent2 > Parent3 > child trace
+const ParentPrefix = new async_hooks_1.AsyncLocalStorage();
+function applyParentPrefix(label) {
+    const parentPrefix = ParentPrefix.getStore();
+    return parentPrefix ? `${parentPrefix} > ${label}` : label;
+}
+function getMemory() {
+    // Before reading memory stats, we explicitly call the GC
+    // Note: this only works when Node.js option "--expose-gc" is provided
+    globalThis.gc?.();
+    return process.memoryUsage();
+}
+function createPerfLogger() {
+    if (!PerfDebuggingEnabled) {
+        const noop = () => { };
+        return {
+            start: noop,
+            end: noop,
+            log: noop,
+            async: async (_label, asyncFn) => asyncFn(),
+        };
+    }
+    const formatDuration = (duration) => {
+        if (duration > Thresholds.red) {
+            return logger_1.default.red(`${(duration / 1000).toFixed(2)} seconds!`);
+        }
+        else if (duration > Thresholds.yellow) {
+            return logger_1.default.yellow(`${duration.toFixed(2)} ms`);
+        }
+        else {
+            return logger_1.default.green(`${duration.toFixed(2)} ms`);
+        }
+    };
+    const formatMemory = (memory) => {
+        const fmtHead = (bytes) => logger_1.default.cyan(`${(bytes / 1000000).toFixed(0)}mb`);
+        return logger_1.default.dim(`(${fmtHead(memory.before.heapUsed)} -> ${fmtHead(memory.after.heapUsed)})`);
+    };
+    const formatStatus = (error) => {
+        return error ? logger_1.default.red('[KO]') : ''; // logger.green('[OK]');
+    };
+    const printPerfLog = ({ label, duration, memory, error, }) => {
+        if (duration < Thresholds.min) {
+            return;
+        }
+        console.log(`${PerfPrefix}${formatStatus(error)} ${label} - ${formatDuration(duration)} - ${formatMemory(memory)}`);
+    };
+    const start = (label) => performance.mark(label, {
+        detail: {
+            memoryUsage: getMemory(),
+        },
+    });
+    const end = (label) => {
+        const { duration, detail: { memoryUsage }, } = performance.measure(label);
+        performance.clearMarks(label);
+        printPerfLog({
+            label: applyParentPrefix(label),
+            duration,
+            memory: {
+                before: memoryUsage,
+                after: getMemory(),
+            },
+            error: undefined,
+        });
+    };
+    const log = (label) => console.log(`${PerfPrefix} ${applyParentPrefix(label)}`);
+    const async = async (label, asyncFn) => {
+        const finalLabel = applyParentPrefix(label);
+        const before = performance.now();
+        const memoryBefore = getMemory();
+        const asyncEnd = ({ error }) => {
+            const memoryAfter = getMemory();
+            const duration = performance.now() - before;
+            printPerfLog({
+                error,
+                label: finalLabel,
+                duration,
+                memory: {
+                    before: memoryBefore,
+                    after: memoryAfter,
+                },
+            });
+        };
+        try {
+            const result = await ParentPrefix.run(finalLabel, () => asyncFn());
+            asyncEnd({ error: undefined });
+            return result;
+        }
+        catch (e) {
+            asyncEnd({ error: e });
+            throw e;
+        }
+    };
+    return {
+        start,
+        end,
+        log,
+        async,
+    };
+}
+exports.PerfLogger = createPerfLogger();
+//# sourceMappingURL=perfLogger.js.map

package/lib/perfLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perfLogger.js","sourceRoot":"","sources":["../src/perfLogger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/logger",
-  "version": "3.5.2",
+  "version": "3.6.0-canary-6132",
   "description": "An encapsulated logger for semantically formatting console messages.",
   "main": "./lib/index.js",
   "repository": {
@@ -29,5 +29,5 @@
   "devDependencies": {
     "@types/supports-color": "^8.1.1"
   },
-  "gitHead": "eeec303dd773774ed5a023884800da0b061f6942"
+  "gitHead": "4930a868b86cafcb0786e2ddc6d400459127c4f6"
 }

package/src/index.ts

@@ -5,196 +5,14 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import chalk from 'chalk';
-import type {ReportingSeverity} from '@docusaurus/types';
+import OriginalLogger from './logger';
 
-type InterpolatableValue = string | number | (string | number)[];
+export default OriginalLogger;
 
-const path = (msg: unknown): string => chalk.cyan.underline(`"${String(msg)}"`);
-const url = (msg: unknown): string => chalk.cyan.underline(msg);
-const name = (msg: unknown): string => chalk.blue.bold(msg);
-const code = (msg: unknown): string => chalk.cyan(`\`${String(msg)}\``);
-const subdue = (msg: unknown): string => chalk.gray(msg);
-const num = (msg: unknown): string => chalk.yellow(msg);
+// Extra named export to avoid problems in ESM modules
+// Notably: core .mjs CLI + create-docusaurus
+// See https://github.com/facebook/docusaurus/pull/6661
+// See https://github.com/facebook/docusaurus/pull/7295
+export const logger = OriginalLogger;
 
-function interpolate(
-  msgs: TemplateStringsArray,
-  ...values: InterpolatableValue[]
-): string {
-  let res = '';
-  values.forEach((value, idx) => {
-    const flag = msgs[idx]!.match(/[a-z]+=$/);
-    res += msgs[idx]!.replace(/[a-z]+=$/, '');
-    const format = (() => {
-      if (!flag) {
-        return (a: string | number) => a;
-      }
-      switch (flag[0]) {
-        case 'path=':
-          return path;
-        case 'url=':
-          return url;
-        case 'number=':
-          return num;
-        case 'name=':
-          return name;
-        case 'subdue=':
-          return subdue;
-        case 'code=':
-          return code;
-        default:
-          throw new Error(
-            'Bad Docusaurus logging message. This is likely an internal bug, please report it.',
-          );
-      }
-    })();
-    res += Array.isArray(value)
-      ? `\n- ${value.map((v) => format(v)).join('\n- ')}`
-      : format(value);
-  });
-  res += msgs.slice(-1)[0];
-  return res;
-}
-
-function stringify(msg: unknown): string {
-  if (String(msg) === '[object Object]') {
-    return JSON.stringify(msg);
-  }
-  if (msg instanceof Date) {
-    return msg.toUTCString();
-  }
-  return String(msg);
-}
-
-function info(msg: unknown): void;
-function info(
-  msg: TemplateStringsArray,
-  ...values: [InterpolatableValue, ...InterpolatableValue[]]
-): void;
-function info(msg: unknown, ...values: InterpolatableValue[]): void {
-  console.info(
-    `${chalk.cyan.bold('[INFO]')} ${
-      values.length === 0
-        ? stringify(msg)
-        : interpolate(msg as TemplateStringsArray, ...values)
-    }`,
-  );
-}
-function warn(msg: unknown): void;
-function warn(
-  msg: TemplateStringsArray,
-  ...values: [InterpolatableValue, ...InterpolatableValue[]]
-): void;
-function warn(msg: unknown, ...values: InterpolatableValue[]): void {
-  console.warn(
-    chalk.yellow(
-      `${chalk.bold('[WARNING]')} ${
-        values.length === 0
-          ? stringify(msg)
-          : interpolate(msg as TemplateStringsArray, ...values)
-      }`,
-    ),
-  );
-}
-function error(msg: unknown): void;
-function error(
-  msg: TemplateStringsArray,
-  ...values: [InterpolatableValue, ...InterpolatableValue[]]
-): void;
-function error(msg: unknown, ...values: InterpolatableValue[]): void {
-  console.error(
-    chalk.red(
-      `${chalk.bold('[ERROR]')} ${
-        values.length === 0
-          ? stringify(msg)
-          : interpolate(msg as TemplateStringsArray, ...values)
-      }`,
-    ),
-  );
-}
-function success(msg: unknown): void;
-function success(
-  msg: TemplateStringsArray,
-  ...values: [InterpolatableValue, ...InterpolatableValue[]]
-): void;
-function success(msg: unknown, ...values: InterpolatableValue[]): void {
-  console.log(
-    `${chalk.green.bold('[SUCCESS]')} ${
-      values.length === 0
-        ? stringify(msg)
-        : interpolate(msg as TemplateStringsArray, ...values)
-    }`,
-  );
-}
-function throwError(msg: unknown): void;
-function throwError(
-  msg: TemplateStringsArray,
-  ...values: [InterpolatableValue, ...InterpolatableValue[]]
-): void;
-function throwError(msg: unknown, ...values: InterpolatableValue[]): void {
-  throw new Error(
-    values.length === 0
-      ? stringify(msg)
-      : interpolate(msg as TemplateStringsArray, ...values),
-  );
-}
-
-function newLine(): void {
-  console.log();
-}
-
-/**
- * Takes a message and reports it according to the severity that the user wants.
- *
- * - `ignore`: completely no-op
- * - `log`: uses the `INFO` log level
- * - `warn`: uses the `WARN` log level
- * - `throw`: aborts the process, throws the error.
- *
- * Since the logger doesn't have logging level filters yet, these severities
- * mostly just differ by their colors.
- *
- * @throws In addition to throwing when `reportingSeverity === "throw"`, this
- * function also throws if `reportingSeverity` is not one of the above.
- */
-function report(reportingSeverity: ReportingSeverity): typeof success {
-  const reportingMethods = {
-    ignore: () => {},
-    log: info,
-    warn,
-    throw: throwError,
-  };
-  if (
-    !Object.prototype.hasOwnProperty.call(reportingMethods, reportingSeverity)
-  ) {
-    throw new Error(
-      `Unexpected "reportingSeverity" value: ${reportingSeverity}.`,
-    );
-  }
-  return reportingMethods[reportingSeverity];
-}
-
-const logger = {
-  red: (msg: string | number): string => chalk.red(msg),
-  yellow: (msg: string | number): string => chalk.yellow(msg),
-  green: (msg: string | number): string => chalk.green(msg),
-  bold: (msg: string | number): string => chalk.bold(msg),
-  dim: (msg: string | number): string => chalk.dim(msg),
-  path,
-  url,
-  name,
-  code,
-  subdue,
-  num,
-  interpolate,
-  info,
-  warn,
-  error,
-  success,
-  report,
-  newLine,
-};
-
-// TODO remove when migrating to ESM
-// logger can only be default-imported in ESM with this
-export = logger;
+export {PerfLogger} from './perfLogger';

package/src/logger.ts

@@ -0,0 +1,199 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import chalk from 'chalk';
+import type {ReportingSeverity} from '@docusaurus/types';
+
+type InterpolatableValue = string | number | (string | number)[];
+
+const path = (msg: unknown): string => chalk.cyan.underline(`"${String(msg)}"`);
+const url = (msg: unknown): string => chalk.cyan.underline(msg);
+const name = (msg: unknown): string => chalk.blue.bold(msg);
+const code = (msg: unknown): string => chalk.cyan(`\`${String(msg)}\``);
+const subdue = (msg: unknown): string => chalk.gray(msg);
+const num = (msg: unknown): string => chalk.yellow(msg);
+
+function interpolate(
+  msgs: TemplateStringsArray,
+  ...values: InterpolatableValue[]
+): string {
+  let res = '';
+  values.forEach((value, idx) => {
+    const flag = msgs[idx]!.match(/[a-z]+=$/);
+    res += msgs[idx]!.replace(/[a-z]+=$/, '');
+    const format = (() => {
+      if (!flag) {
+        return (a: string | number) => a;
+      }
+      switch (flag[0]) {
+        case 'path=':
+          return path;
+        case 'url=':
+          return url;
+        case 'number=':
+          return num;
+        case 'name=':
+          return name;
+        case 'subdue=':
+          return subdue;
+        case 'code=':
+          return code;
+        default:
+          throw new Error(
+            'Bad Docusaurus logging message. This is likely an internal bug, please report it.',
+          );
+      }
+    })();
+    res += Array.isArray(value)
+      ? `\n- ${value.map((v) => format(v)).join('\n- ')}`
+      : format(value);
+  });
+  res += msgs.slice(-1)[0];
+  return res;
+}
+
+function stringify(msg: unknown): string {
+  if (String(msg) === '[object Object]') {
+    return JSON.stringify(msg);
+  }
+  if (msg instanceof Date) {
+    return msg.toUTCString();
+  }
+  return String(msg);
+}
+
+function info(msg: unknown): void;
+function info(
+  msg: TemplateStringsArray,
+  ...values: [InterpolatableValue, ...InterpolatableValue[]]
+): void;
+function info(msg: unknown, ...values: InterpolatableValue[]): void {
+  console.info(
+    `${chalk.cyan.bold('[INFO]')} ${
+      values.length === 0
+        ? stringify(msg)
+        : interpolate(msg as TemplateStringsArray, ...values)
+    }`,
+  );
+}
+function warn(msg: unknown): void;
+function warn(
+  msg: TemplateStringsArray,
+  ...values: [InterpolatableValue, ...InterpolatableValue[]]
+): void;
+function warn(msg: unknown, ...values: InterpolatableValue[]): void {
+  console.warn(
+    chalk.yellow(
+      `${chalk.bold('[WARNING]')} ${
+        values.length === 0
+          ? stringify(msg)
+          : interpolate(msg as TemplateStringsArray, ...values)
+      }`,
+    ),
+  );
+}
+function error(msg: unknown): void;
+function error(
+  msg: TemplateStringsArray,
+  ...values: [InterpolatableValue, ...InterpolatableValue[]]
+): void;
+function error(msg: unknown, ...values: InterpolatableValue[]): void {
+  console.error(
+    chalk.red(
+      `${chalk.bold('[ERROR]')} ${
+        values.length === 0
+          ? stringify(msg)
+          : interpolate(msg as TemplateStringsArray, ...values)
+      }`,
+    ),
+  );
+}
+function success(msg: unknown): void;
+function success(
+  msg: TemplateStringsArray,
+  ...values: [InterpolatableValue, ...InterpolatableValue[]]
+): void;
+function success(msg: unknown, ...values: InterpolatableValue[]): void {
+  console.log(
+    `${chalk.green.bold('[SUCCESS]')} ${
+      values.length === 0
+        ? stringify(msg)
+        : interpolate(msg as TemplateStringsArray, ...values)
+    }`,
+  );
+}
+function throwError(msg: unknown): void;
+function throwError(
+  msg: TemplateStringsArray,
+  ...values: [InterpolatableValue, ...InterpolatableValue[]]
+): void;
+function throwError(msg: unknown, ...values: InterpolatableValue[]): void {
+  throw new Error(
+    values.length === 0
+      ? stringify(msg)
+      : interpolate(msg as TemplateStringsArray, ...values),
+  );
+}
+
+function newLine(): void {
+  console.log();
+}
+
+/**
+ * Takes a message and reports it according to the severity that the user wants.
+ *
+ * - `ignore`: completely no-op
+ * - `log`: uses the `INFO` log level
+ * - `warn`: uses the `WARN` log level
+ * - `throw`: aborts the process, throws the error.
+ *
+ * Since the logger doesn't have logging level filters yet, these severities
+ * mostly just differ by their colors.
+ *
+ * @throws In addition to throwing when `reportingSeverity === "throw"`, this
+ * function also throws if `reportingSeverity` is not one of the above.
+ */
+function report(reportingSeverity: ReportingSeverity): typeof success {
+  const reportingMethods = {
+    ignore: () => {},
+    log: info,
+    warn,
+    throw: throwError,
+  };
+  if (
+    !Object.prototype.hasOwnProperty.call(reportingMethods, reportingSeverity)
+  ) {
+    throw new Error(
+      `Unexpected "reportingSeverity" value: ${reportingSeverity}.`,
+    );
+  }
+  return reportingMethods[reportingSeverity];
+}
+
+const logger = {
+  red: (msg: string | number): string => chalk.red(msg),
+  yellow: (msg: string | number): string => chalk.yellow(msg),
+  green: (msg: string | number): string => chalk.green(msg),
+  cyan: (msg: string | number): string => chalk.cyan(msg),
+  bold: (msg: string | number): string => chalk.bold(msg),
+  dim: (msg: string | number): string => chalk.dim(msg),
+  path,
+  url,
+  name,
+  code,
+  subdue,
+  num,
+  interpolate,
+  info,
+  warn,
+  error,
+  success,
+  report,
+  newLine,
+};
+
+export default logger;

package/src/perfLogger.ts

@@ -0,0 +1,174 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import {AsyncLocalStorage} from 'async_hooks';
+import logger from './logger';
+
+// For now this is a private env variable we use internally
+// But we'll want to expose this feature officially some day
+const PerfDebuggingEnabled: boolean =
+  process.env.DOCUSAURUS_PERF_LOGGER === 'true';
+
+const Thresholds = {
+  min: 5,
+  yellow: 100,
+  red: 1000,
+};
+
+const PerfPrefix = logger.yellow(`[PERF]`);
+
+// This is what enables to "see the parent stack" for each log
+// Parent1 > Parent2 > Parent3 > child trace
+const ParentPrefix = new AsyncLocalStorage<string>();
+function applyParentPrefix(label: string) {
+  const parentPrefix = ParentPrefix.getStore();
+  return parentPrefix ? `${parentPrefix} > ${label}` : label;
+}
+
+type PerfLoggerAPI = {
+  start: (label: string) => void;
+  end: (label: string) => void;
+  log: (message: string) => void;
+  async: <Result>(
+    label: string,
+    asyncFn: () => Result | Promise<Result>,
+  ) => Promise<Result>;
+};
+
+type Memory = {
+  before: NodeJS.MemoryUsage;
+  after: NodeJS.MemoryUsage;
+};
+
+function getMemory(): NodeJS.MemoryUsage {
+  // Before reading memory stats, we explicitly call the GC
+  // Note: this only works when Node.js option "--expose-gc" is provided
+  globalThis.gc?.();
+
+  return process.memoryUsage();
+}
+
+function createPerfLogger(): PerfLoggerAPI {
+  if (!PerfDebuggingEnabled) {
+    const noop = () => {};
+    return {
+      start: noop,
+      end: noop,
+      log: noop,
+      async: async (_label, asyncFn) => asyncFn(),
+    };
+  }
+
+  const formatDuration = (duration: number): string => {
+    if (duration > Thresholds.red) {
+      return logger.red(`${(duration / 1000).toFixed(2)} seconds!`);
+    } else if (duration > Thresholds.yellow) {
+      return logger.yellow(`${duration.toFixed(2)} ms`);
+    } else {
+      return logger.green(`${duration.toFixed(2)} ms`);
+    }
+  };
+
+  const formatMemory = (memory: Memory): string => {
+    const fmtHead = (bytes: number) =>
+      logger.cyan(`${(bytes / 1000000).toFixed(0)}mb`);
+    return logger.dim(
+      `(${fmtHead(memory.before.heapUsed)} -> ${fmtHead(
+        memory.after.heapUsed,
+      )})`,
+    );
+  };
+
+  const formatStatus = (error: Error | undefined): string => {
+    return error ? logger.red('[KO]') : ''; // logger.green('[OK]');
+  };
+
+  const printPerfLog = ({
+    label,
+    duration,
+    memory,
+    error,
+  }: {
+    label: string;
+    duration: number;
+    memory: Memory;
+    error: Error | undefined;
+  }) => {
+    if (duration < Thresholds.min) {
+      return;
+    }
+    console.log(
+      `${PerfPrefix}${formatStatus(error)} ${label} - ${formatDuration(
+        duration,
+      )} - ${formatMemory(memory)}`,
+    );
+  };
+
+  const start: PerfLoggerAPI['start'] = (label) =>
+    performance.mark(label, {
+      detail: {
+        memoryUsage: getMemory(),
+      },
+    });
+
+  const end: PerfLoggerAPI['end'] = (label) => {
+    const {
+      duration,
+      detail: {memoryUsage},
+    } = performance.measure(label);
+    performance.clearMarks(label);
+    printPerfLog({
+      label: applyParentPrefix(label),
+      duration,
+      memory: {
+        before: memoryUsage,
+        after: getMemory(),
+      },
+      error: undefined,
+    });
+  };
+
+  const log: PerfLoggerAPI['log'] = (label: string) =>
+    console.log(`${PerfPrefix} ${applyParentPrefix(label)}`);
+
+  const async: PerfLoggerAPI['async'] = async (label, asyncFn) => {
+    const finalLabel = applyParentPrefix(label);
+    const before = performance.now();
+    const memoryBefore = getMemory();
+
+    const asyncEnd = ({error}: {error: Error | undefined}) => {
+      const memoryAfter = getMemory();
+      const duration = performance.now() - before;
+      printPerfLog({
+        error,
+        label: finalLabel,
+        duration,
+        memory: {
+          before: memoryBefore,
+          after: memoryAfter,
+        },
+      });
+    };
+
+    try {
+      const result = await ParentPrefix.run(finalLabel, () => asyncFn());
+      asyncEnd({error: undefined});
+      return result;
+    } catch (e) {
+      asyncEnd({error: e as Error});
+      throw e;
+    }
+  };
+
+  return {
+    start,
+    end,
+    log,
+    async,
+  };
+}
+
+export const PerfLogger: PerfLoggerAPI = createPerfLogger();