refactor: add deprecate annotation

Author: sxzz

src/core.ts

@@ -150,15 +150,17 @@ export function setup(
   }
 
   createDebug.namespaces = ''
-  createDebug.names = []
-  createDebug.skips = []
+  createDebug.formatters = {}
   createDebug.enable = enable
   createDebug.disable = disable
   createDebug.enabled = enabled
+
+  // deprecated
+  createDebug.names = []
+  createDebug.skips = []
   createDebug.selectColor = (ns) => selectColor(colors, ns)
   createDebug.formatArgs = formatArgs
   createDebug.log = log
-  createDebug.formatters = {}
 
   createDebug.enable(load())
 

src/types.ts

@@ -47,13 +47,30 @@ export interface Debug {
    */
   enabled: (namespaces: string) => boolean
 
+  formatters: Formatters
+  inspectOpts?: InspectOptions
+
+  /**
+   * @deprecated It will removed in the next major version.
+   */
   formatArgs: (this: Debugger, args: [string, ...any[]]) => void
-  log: (...args: any[]) => void
+  /**
+   * @deprecated It will removed in the next major version.
+   */
   selectColor: (namespace: string) => string | number
+  /**
+   * @deprecated It will removed in the next major version.
+   */
+  log: (...args: any[]) => void
 
+  /**
+   * @internal
+   * @deprecated It will removed in the next major version. This is internal cache.
+   */
   names: string[]
+  /**
+   * @internal
+   * @deprecated It will removed in the next major version. This is internal cache.
+   */
   skips: string[]
-
-  formatters: Formatters
-  inspectOpts?: InspectOptions
 }