feat: improvements to onGroup, onTest, tap, and onSuite hooks

Earlier these hooks were added when new instances were registered.
Now, they are executed for pre-registered instances too

src/group/main.ts

@@ -155,6 +155,7 @@ export class Group<Context extends Record<any, any>> extends Macroable {
    * Tap into each test and configure it
    */
   tap(callback: (test: Test<Context, any>) => void): this {
+    this.tests.forEach((test) => callback(test))
     this.#tapsCallbacks.push(callback)
     return this
   }

src/runner.ts

@@ -116,6 +116,7 @@ export class Runner<Context extends Record<any, any>> extends Macroable {
    * Tap into each suite and configure it
    */
   onSuite(callback: (suite: Suite<Context>) => void): this {
+    this.suites.forEach((suite) => callback(suite))
     this.#configureSuiteCallbacks.push(callback)
     return this
   }

src/suite/main.ts

@@ -88,6 +88,12 @@ export class Suite<Context extends Record<any, any>> extends Macroable {
    * Tap into each test and configure it
    */
   onTest(callback: (test: Test<Context, any>) => void): this {
+    this.stack.forEach((testOrGroup) => {
+      if (testOrGroup instanceof Test) {
+        callback(testOrGroup)
+      }
+    })
+
     this.#configureTestCallbacks.push(callback)
     return this
   }
@@ -96,6 +102,12 @@ export class Suite<Context extends Record<any, any>> extends Macroable {
    * Tap into each group and configure it
    */
   onGroup(callback: (group: Group<Context>) => void): this {
+    this.stack.forEach((testOrGroup) => {
+      if (testOrGroup instanceof Group) {
+        callback(testOrGroup)
+      }
+    })
+
     this.#configureGroupCallbacks.push(callback)
     return this
   }

test/runner/configure.spec.ts

@@ -72,4 +72,32 @@ test.describe('configure | runner', () => {
     runner.registerReporter(listReporter)
     assert.deepEqual(runner.reporters, new Set([listReporter]))
   })
+
+  test('tap into suites after they have been registered', async () => {
+    const emitter = new Emitter()
+
+    const runner = new Runner(emitter)
+    const refiner = new Refiner()
+
+    /**
+     * First add a suite to the runner
+     */
+    const unitSuite = new Suite('unit', emitter, refiner)
+    runner.add(unitSuite)
+
+    /**
+     * Next define the hook
+     */
+    runner.onSuite((suite) => (suite.name = `configured:${suite.name}`))
+
+    /**
+     * Add another suite to the runner
+     */
+    const functionalSuite = new Suite('functional', emitter, refiner)
+    runner.add(functionalSuite)
+
+    assert.deepEqual(runner.suites, [unitSuite, functionalSuite])
+    assert.equal(unitSuite.name, 'configured:unit')
+    assert.equal(functionalSuite.name, 'configured:functional')
+  })
 })

test/suite/configure.spec.ts

@@ -77,4 +77,63 @@ test.describe('configure', () => {
 
     assert.equal(testInstance.options.timeout, 0)
   })
+
+  test('tap into tests after they have been registered', async () => {
+    const emitter = new Emitter()
+    const refiner = new Refiner({})
+
+    const suite = new Suite<TestContext>('sample suite', new Emitter(), refiner)
+    const testInstance = new Test('2 + 2 = 4', new TestContext(), emitter, refiner)
+    const test1Instance = new Test('2 + 2 = 4', new TestContext(), emitter, refiner)
+
+    /**
+     * First add test to suite
+     */
+    suite.add(testInstance)
+
+    /**
+     * Define the hook afterwards
+     */
+    suite.onTest((t) => t.tags(['@hooked'], 'append'))
+
+    /**
+     * Add another test
+     */
+    suite.add(test1Instance)
+
+    assert.deepEqual(testInstance.options.tags, ['@hooked'])
+    assert.deepEqual(test1Instance.options.tags, ['@hooked'])
+  })
+
+  test('tap into groups after they have been registered', async () => {
+    const emitter = new Emitter()
+    const refiner = new Refiner({})
+
+    const suite = new Suite<TestContext>('sample suite', new Emitter(), refiner)
+    const group = new Group<TestContext>('sample group', emitter, refiner)
+    const testInstance = new Test('2 + 2 = 4', new TestContext(), emitter, refiner)
+
+    const group1 = new Group<TestContext>('sample group', emitter, refiner)
+    const test1Instance = new Test('2 + 2 = 4', new TestContext(), emitter, refiner)
+
+    /**
+     * First add test to group and group to suite
+     */
+    group.add(testInstance)
+    suite.add(group)
+
+    /**
+     * Define hook
+     */
+    suite.onGroup((g) => g.tap((t) => t.tags(['@hooked'], 'append')))
+
+    /**
+     * Add another group to suite and test to the group
+     */
+    suite.add(group1)
+    group1.add(test1Instance)
+
+    assert.deepEqual(testInstance.options.tags, ['@hooked'])
+    assert.deepEqual(test1Instance.options.tags, ['@hooked'])
+  })
 })