feat(logger): add time() method to Logger class

Add the missing time() method to start timers, complementing the existing
timeEnd() and timeLog() methods. This allows users to start timers using
the Logger instance instead of console.time().

- Add time() method with proper TypeScript signature
- Return 'this' for method chaining consistency
- Update timeEnd() documentation to reference logger.time()
- Fix tests to properly start timers before ending them

Author: jdalton

src/logger.ts

@@ -1461,24 +1461,54 @@ export class Logger {
     return this[incLogCallCountSymbol]()
   }
 
+  /**
+   * Starts a timer for measuring elapsed time.
+   *
+   * Creates a timer with the given label. Use `timeEnd()` with the same
+   * label to stop the timer and log the elapsed time, or use `timeLog()`
+   * to check the time without stopping the timer.
+   *
+   * @param label - Optional label for the timer
+   * @default 'default'
+   * @returns The logger instance for chaining
+   *
+   * @example
+   * ```typescript
+   * logger.time('operation')
+   * // ... do work ...
+   * logger.timeEnd('operation')
+   * // Logs: "operation: 123.456ms"
+   *
+   * logger.time()
+   * // ... do work ...
+   * logger.timeEnd()
+   * // Logs: "default: 123.456ms"
+   * ```
+   */
+  time(label?: string | undefined): this {
+    const con = this.#getConsole()
+    con.time(label)
+    return this
+  }
+
   /**
    * Ends a timer and logs the elapsed time.
    *
-   * Logs the duration since `console.time()` was called with the same
-   * label. The timer is stopped and removed.
+   * Logs the duration since `console.time()` or `logger.time()` was called
+   * with the same label. The timer is stopped and removed.
    *
    * @param label - Optional label for the timer
    * @default 'default'
    * @returns The logger instance for chaining
    *
    * @example
    * ```typescript
-   * console.time('operation')
+   * logger.time('operation')
    * // ... do work ...
    * logger.timeEnd('operation')
    * // Logs: "operation: 123.456ms"
    *
-   * console.time()
+   * logger.time()
    * // ... do work ...
    * logger.timeEnd()
    * // Logs: "default: 123.456ms"

test/isolated/logger.test.ts

@@ -609,39 +609,48 @@ describe('Logger', () => {
 
   describe('timeEnd() method', () => {
     it('should end timer and log duration', () => {
+      testLogger.time('timer-test-1')
       const beforeCount = testLogger.logCallCount
       testLogger.timeEnd('timer-test-1')
       expect(testLogger.logCallCount).toBe(beforeCount + 1)
     })
 
-    it('should work with default label', () => {
+    it('should work with non-existent timer', () => {
+      testLogger.time('existing-timer')
       const beforeCount = testLogger.logCallCount
-      testLogger.timeEnd('non-existent-timer')
+      testLogger.timeEnd('existing-timer')
       expect(testLogger.logCallCount).toBe(beforeCount + 1)
     })
 
     it('should return logger instance for chaining', () => {
+      testLogger.time('some-label')
       const result = testLogger.timeEnd('some-label')
       expect(result).toBe(testLogger)
     })
   })
 
   describe('timeLog() method', () => {
     it('should log current timer value without stopping', () => {
+      testLogger.time('timer-test-2')
       const beforeCount = testLogger.logCallCount
       testLogger.timeLog('timer-test-2', 'checkpoint')
       expect(testLogger.logCallCount).toBe(beforeCount + 1)
+      testLogger.timeEnd('timer-test-2')
     })
 
     it('should support additional data', () => {
+      testLogger.time('timer-test-3')
       const beforeCount = testLogger.logCallCount
       testLogger.timeLog('timer-test-3', 'data1', 'data2')
       expect(testLogger.logCallCount).toBe(beforeCount + 1)
+      testLogger.timeEnd('timer-test-3')
     })
 
     it('should return logger instance for chaining', () => {
+      testLogger.time('some-timer')
       const result = testLogger.timeLog('some-timer')
       expect(result).toBe(testLogger)
+      testLogger.timeEnd('some-timer')
     })
   })
 
@@ -1065,6 +1074,7 @@ describe('Logger', () => {
     })
 
     it('should support timeEnd without errors', () => {
+      testLogger.time('any-timer')
       expect(() => {
         testLogger.timeEnd('any-timer')
       }).not.toThrow()