feat: support color options

pkg/src/message.js

@@ -1,15 +1,27 @@
-import c from 'picocolors'
+import picocolors from 'picocolors'
 import {
   formatMessagePath as fp,
   getPkgPathValue,
   replaceLast
 } from './utils.js'
 
+const picoHasColors = picocolors.createColors(true)
+const picoNoColors = picocolors.createColors(false)
+
 /**
  * @param {import('../index.d.ts').Message} m
  * @param {import('./utils.js').Pkg} pkg
+ * @param {import('../utils.d.ts').FormatMessageOpt} opt
  */
-export function formatMessage(m, pkg) {
+export function formatMessage(m, pkg, opt = {}) {
+  /** @type { import("picocolors/types.js").Colors } */
+  let c = picocolors
+  if (opt.color === true) {
+    c = picoHasColors
+  } else if (opt.color === false) {
+    c = picoNoColors
+  }
+
   /** @param {string[]} path */
   const pv = (path) => getPkgPathValue(pkg, path)
 

pkg/utils.d.ts

@@ -2,9 +2,20 @@ import type { Message } from './index.js'
 
 type Pkg = Record<string, any>
 
+export interface FormatMessageOpt {
+  /**
+   * Used to determine if the returned string contains color.
+   * - true: Force has color.
+   * - false: Force no color.
+   * - undefined: Default to whether the environment supports color (already handled by picocolors by default).
+   */
+  color?: boolean | undefined
+}
+
 export declare function formatMessagePath(path: string[]): string
 export declare function getPkgPathValue(pkg: Pkg, path: string[]): any
 export declare function formatMessage(
   msg: Message,
-  pkg: Pkg
+  pkg: Pkg,
+  opt?: FormatMessageOpt
 ): string | undefined