refactor: project rewrite p2

- re-implement logging
- allow `esbuild` plugin to be disabled

Signed-off-by: Lexus Drumgold <[email protected]>

Author: unicornware

__fixtures__/pkg/reverse/tsconfig.json

@@ -18,7 +18,6 @@
     "resolveJsonModule": true,
     "sourceMap": true,
     "target": "es2024",
-    "traceResolution": true,
     "verbatimModuleSyntax": true
   },
   "exclude": ["coverage", "dist", "node_modules"],

__tests__/reporters/verbose.mts

@@ -4,9 +4,9 @@
  * @see https://vitest.dev/advanced/reporters#exported-reporters
  */
 
+import colors, { type Colors } from '@flex-development/colors'
 import type { Task, TaskResultPack } from '@vitest/runner'
 import { getNames, getTests } from '@vitest/runner/utils'
-import colors, { type Colors } from 'tinyrainbow'
 import type { RunnerTask, RunnerTestFile } from 'vitest'
 import type { ConfigEnv } from 'vitest/config'
 import { DefaultReporter, type Reporter } from 'vitest/reporters'

eslint.base.config.mjs

@@ -633,6 +633,7 @@ export default [
       'no-redeclare': 0,
       'no-restricted-imports': 0,
       'no-return-await': 0,
+      'no-setter-return': 0,
       'no-shadow': 0,
       'no-sparse-arrays': 0,
       'no-throw-literal': 0,

eslint.config.mjs

@@ -29,9 +29,10 @@ export default [
     ]
   },
   {
-    files: ['src/providers/logger.service.mts'],
+    files: ['**/*.+(cts|mts|ts|tsx)'],
+    ignores: ['**/*.{md,mdx}/*.+(cts|mts|ts|tsx)'],
     rules: {
-      '@typescript-eslint/unified-signatures': 0
+      '@typescript-eslint/only-throw-error': [2, { allow: ['Failure'] }]
     }
   }
 ]

package.json

@@ -140,6 +140,7 @@
     "@flex-development/errnode": "3.1.1",
     "@flex-development/fst-util-from-fs": "1.0.0-alpha.1",
     "@flex-development/is-builtin": "3.2.0",
+    "@flex-development/log": "flex-development/log#commit=194e98812fbbffceb6e2158b849706c597175207",
     "@flex-development/mlly": "1.0.0-alpha.20",
     "@flex-development/pathe": "4.0.1",
     "@flex-development/tsconfig-types": "5.1.0",
@@ -151,7 +152,7 @@
     "devlop": "1.1.0",
     "json5": "2.2.3",
     "magic-string": "0.30.17",
-    "rollup": "4.31.0",
+    "rollup": "4.34.4",
     "smob": "1.5.0"
   },
   "devDependencies": {
@@ -175,7 +176,7 @@
     "@types/eslint": "9.6.1",
     "@types/eslint__js": "8.42.3",
     "@types/is-ci": "3.0.4",
-    "@types/node": "22.10.7",
+    "@types/node": "22.13.1",
     "@types/node-notifier": "8.0.5",
     "@typescript-eslint/eslint-plugin": "8.21.1-alpha.2",
     "@typescript-eslint/parser": "8.21.1-alpha.2",

src/__tests__/make.spec.mts

@@ -18,23 +18,6 @@ describe('unit:make', () => {
     ...Parameters<typeof testSubject>,
     Fn<Parameters<typeof testSubject>, Fn<[Report], undefined>>?
   ]>([
-    [
-      null,
-      function assertion(this: void): Fn<[Report], undefined> {
-        return assert
-
-        /**
-         * @this {void}
-         *
-         * @param {Report} report
-         *  Build report
-         * @return {undefined}
-         */
-        function assert(report: Report): undefined {
-          return void expect(report).to.have.property('builds').be.of.length(0)
-        }
-      }
-    ],
     [
       reverse,
       function assertion(this: void): Fn<[Report], undefined> {
@@ -80,7 +63,7 @@ describe('unit:make', () => {
     assert = constant(constant(undefined))
   ) => {
     // Act
-    const result = await testSubject(config)
+    const result = await testSubject({ ...config, logLevel: 'silent' })
 
     // Expect
     expect(result).to.satisfy(isObjectPlain)

src/interfaces/__tests__/failure.spec-d.mts

@@ -0,0 +1,17 @@
+/**
+ * @file Type Tests - Failure
+ * @module mkbuild/interfaces/tests/unit-d/Failure
+ */
+
+import type TestSubject from '#interfaces/failure'
+import type { Message } from '@flex-development/mkbuild'
+
+describe('unit-d:interfaces/Failure', () => {
+  it('should extend Message', () => {
+    expectTypeOf<TestSubject>().toMatchTypeOf<Message>()
+  })
+
+  it('should match [level: "error"]', () => {
+    expectTypeOf<TestSubject>().toHaveProperty('level').toEqualTypeOf<'error'>()
+  })
+})

src/interfaces/__tests__/message.spec-d.mts

@@ -4,9 +4,12 @@
  */
 
 import type TestSubject from '#interfaces/message'
-import type { MessageLocation, RollupCode } from '@flex-development/mkbuild'
+import type {
+  LogType,
+  MessageLocation,
+  RollupCode
+} from '@flex-development/mkbuild'
 import type { Nilable } from '@flex-development/tutils'
-import type * as rollup from 'rollup'
 
 describe('unit-d:interfaces/Message', () => {
   it('should match [binding?: string | null | undefined]', () => {
@@ -19,10 +22,10 @@ describe('unit-d:interfaces/Message', () => {
     expectTypeOf<TestSubject>().toHaveProperty('cause').toEqualTypeOf<unknown>()
   })
 
-  it('should match [code: RollupCode]', () => {
+  it('should match [code?: RollupCode | null | undefined]', () => {
     expectTypeOf<TestSubject>()
       .toHaveProperty('code')
-      .toEqualTypeOf<RollupCode>()
+      .toEqualTypeOf<Nilable<RollupCode>>()
   })
 
   it('should match [exporter?: string | null | undefined]', () => {
@@ -61,10 +64,14 @@ describe('unit-d:interfaces/Message', () => {
       .toEqualTypeOf<Nilable<MessageLocation>>()
   })
 
-  it('should match [level: rollup.LogLevel]', () => {
+  it('should match [level: LogType]', () => {
+    expectTypeOf<TestSubject>().toHaveProperty('level').toEqualTypeOf<LogType>()
+  })
+
+  it('should match [message: string]', () => {
     expectTypeOf<TestSubject>()
-      .toHaveProperty('level')
-      .toEqualTypeOf<rollup.LogLevel>()
+      .toHaveProperty('message')
+      .toEqualTypeOf<string>()
   })
 
   it('should match [meta?: unknown]', () => {
@@ -107,10 +114,6 @@ describe('unit-d:interfaces/Message', () => {
       .toEqualTypeOf<Nilable<string>>()
   })
 
-  it('should match [text: string]', () => {
-    expectTypeOf<TestSubject>().toHaveProperty('text').toEqualTypeOf<string>()
-  })
-
   it('should match [url?: string | null | undefined]', () => {
     expectTypeOf<TestSubject>()
       .toHaveProperty('url')

src/interfaces/__tests__/result.spec-d.mts

@@ -4,7 +4,9 @@
  */
 
 import type TestSubject from '#interfaces/result'
+import type { Logger } from '@flex-development/log'
 import type {
+  Failure,
   Format,
   Message,
   OutputAsset,
@@ -15,16 +17,20 @@ import type { Nilable } from '@flex-development/tutils'
 import type { SerializedTimings } from 'rollup'
 
 describe('unit-d:interfaces/Result', () => {
-  it('should match [failure?: Error | null | undefined]', () => {
+  it('should match [failure?: Failure | null | undefined]', () => {
     expectTypeOf<TestSubject>()
       .toHaveProperty('failure')
-      .toEqualTypeOf<Nilable<Error>>()
+      .toEqualTypeOf<Nilable<Failure>>()
   })
 
   it('should match [format: Format]', () => {
     expectTypeOf<TestSubject>().toHaveProperty('format').toEqualTypeOf<Format>()
   })
 
+  it('should match [logger: Logger]', () => {
+    expectTypeOf<TestSubject>().toHaveProperty('logger').toEqualTypeOf<Logger>()
+  })
+
   it('should match [messages: Message[]]', () => {
     expectTypeOf<TestSubject>()
       .toHaveProperty('messages')

src/interfaces/__tests__/task.spec-d.mts

@@ -14,6 +14,7 @@ import type {
   FooterFn,
   Format,
   Input,
+  LogType,
   ResolveOptions,
   SanitizeFileNameFn,
   SourcemapFileNamesFn,
@@ -24,7 +25,7 @@ import type {
 import type { ModuleId } from '@flex-development/mlly'
 import type { Tsconfig } from '@flex-development/tsconfig-types'
 import type { Nilable } from '@flex-development/tutils'
-import type { HashCharacters, InputPluginOption, LogLevelOption } from 'rollup'
+import type { HashCharacters, InputPluginOption } from 'rollup'
 
 describe('unit-d:interfaces/Task', () => {
   it('should match [assetFileNames?: AssetFileNamesFn | string | null | undefined]', () => {
@@ -57,10 +58,10 @@ describe('unit-d:interfaces/Task', () => {
       .toEqualTypeOf<Nilable<EntryFileNamesFn | string>>()
   })
 
-  it('should match [esbuild?: EsbuildOptions | null | undefined]', () => {
+  it('should match [esbuild?: EsbuildOptions | false | null | undefined]', () => {
     expectTypeOf<TestSubject>()
       .toHaveProperty('esbuild')
-      .toEqualTypeOf<Nilable<EsbuildOptions>>()
+      .toEqualTypeOf<Nilable<EsbuildOptions | false>>()
   })
 
   it('should match [experimental?: ExperimentalOptions | null | undefined]', () => {
@@ -111,10 +112,10 @@ describe('unit-d:interfaces/Task', () => {
       .toEqualTypeOf<Nilable<Input>>()
   })
 
-  it('should match [logLevel?: LogLevelOption | null | undefined]', () => {
+  it('should match [logLevel?: LogType | "silent" | null | undefined]', () => {
     expectTypeOf<TestSubject>()
       .toHaveProperty('logLevel')
-      .toEqualTypeOf<Nilable<LogLevelOption>>()
+      .toEqualTypeOf<Nilable<LogType | 'silent'>>()
   })
 
   it('should match [maxParallelFileOps?: number | null | undefined]', () => {

src/interfaces/failure.mts

@@ -0,0 +1,22 @@
+/**
+ * @file Interfaces - Failure
+ * @module mkbuild/interfaces/Failure
+ */
+
+import type { Message } from '@flex-development/mkbuild'
+
+/**
+ * Build failure.
+ *
+ * @see {@linkcode Message}
+ */
+interface Failure extends Message {
+  /**
+   * Log level.
+   *
+   * @override
+   */
+  level: 'error'
+}
+
+export type { Failure as default }

src/interfaces/index.mts

@@ -9,6 +9,7 @@ export type { default as EsbuildOptions } from '#interfaces/esbuild-options'
 export type {
   default as ExperimentalOptions
 } from '#interfaces/experimental-options'
+export type { default as Failure } from '#interfaces/failure'
 export type { default as FileSystem } from '#interfaces/file-system'
 export type { default as Message } from '#interfaces/message'
 export type { default as MessageLocation } from '#interfaces/message-location'

src/interfaces/message.mts

@@ -3,8 +3,11 @@
  * @module mkbuild/interfaces/Message
  */
 
-import type { MessageLocation, RollupCode } from '@flex-development/mkbuild'
-import type * as rollup from 'rollup'
+import type {
+  LogType,
+  MessageLocation,
+  RollupCode
+} from '@flex-development/mkbuild'
 
 /**
  * Build message.
@@ -21,11 +24,11 @@ interface Message {
   cause?: unknown
 
   /**
-   * Message code.
+   * Log code.
    *
    * @see {@linkcode RollupCode}
    */
-  code: RollupCode
+  code?: RollupCode | null | undefined
 
   /**
    * Module id of exporting file.
@@ -62,9 +65,14 @@ interface Message {
   /**
    * Log level of message.
    *
-   * @see {@linkcode rollup.LogLevel}
+   * @see {@linkcode LogType}
    */
-  level: rollup.LogLevel
+  level: LogType
+
+  /**
+   * Message text.
+   */
+  message: string
 
   /**
    * Message metadata.
@@ -101,11 +109,6 @@ interface Message {
    */
   stack?: string | null | undefined
 
-  /**
-   * Message text.
-   */
-  text: string
-
   /**
    * Help URL.
    */

src/interfaces/result.mts

@@ -3,13 +3,16 @@
  * @module mkbuild/interfaces/Result
  */
 
+import type { Logger } from '@flex-development/log'
 import type {
+  Failure,
   Format,
   Message,
   OutputAsset,
   OutputChunk,
   RunnableTask
 } from '@flex-development/mkbuild'
+import type { PackageJson } from '@flex-development/pkg-types'
 import type { SerializedTimings } from 'rollup'
 
 /**
@@ -20,8 +23,10 @@ import type { SerializedTimings } from 'rollup'
 interface Result {
   /**
    * Build failure.
+   *
+   * @see {@linkcode Failure}
    */
-  failure?: Error | null | undefined
+  failure?: Failure | null | undefined
 
   /**
    * Output file format.
@@ -30,6 +35,13 @@ interface Result {
    */
   format: Format
 
+  /**
+   * Task logger.
+   *
+   * @see {@linkcode Logger}
+   */
+  logger: Logger
+
   /**
    * Build messages.
    *
@@ -52,6 +64,13 @@ interface Result {
    */
   outputs: (OutputAsset | OutputChunk)[]
 
+  /**
+   * Package manifest.
+   *
+   * @see {@linkcode PackageJson}
+   */
+  pkg: PackageJson
+
   /**
    * Absolute path to working directory.
    */