feat(browser): support custom kind in page.mark (#10302)

Author: AriPerkkio

api/browser/context.md

@@ -82,11 +82,11 @@ export const page: {
   /**
    * Add a trace marker when browser tracing is enabled.
    */
-  mark(name: string, options?: { stack?: string }): Promise<void>
+  mark(name: string, options?: { stack?: string; kind?: BrowserTraceEntryKind }): Promise<void>
   /**
    * Group multiple operations under a trace marker when browser tracing is enabled.
    */
-  mark<T>(name: string, body: () => T | Promise<T>, options?: { stack?: string }): Promise<T>
+  mark<T>(name: string, body: () => T | Promise<T>, options?: { stack?: string; kind?: BrowserTraceEntryKind }): Promise<T>
   /**
    * Extend default `page` object with custom methods.
    */
@@ -127,18 +127,20 @@ The `path` is also ignored in that case.
 ### mark
 
 ```ts
-function mark(name: string, options?: { stack?: string }): Promise<void>
+function mark(name: string, options?: { stack?: string; kind?: BrowserTraceEntryKind }): Promise<void>
 function mark<T>(
   name: string,
   body: () => T | Promise<T>,
-  options?: { stack?: string },
+  options?: { stack?: string; kind?: BrowserTraceEntryKind },
 ): Promise<T>
 ```
 
 Adds a named marker to the trace timeline for the current test.
 
 Pass `options.stack` to override the callsite location in trace metadata. This is useful for wrapper libraries that need to preserve the end-user source location.
 
+Pass `options.kind` to categorize your marker as specific type, for example as `'action'`.
+
 If you pass a callback, Vitest creates a trace group with this name, runs the callback, and closes the group automatically.
 
 ```ts
@@ -151,7 +153,7 @@ await page.mark('after submit')
 await page.mark('submit flow', async () => {
   await page.getByRole('textbox', { name: 'Email' }).fill('john@example.com')
   await page.getByRole('button', { name: 'Submit' }).click()
-})
+}, { kind: 'action' })
 ```
 
 ::: tip

api/browser/locators.md

@@ -846,13 +846,15 @@ The `path` is also ignored in that case.
 ### mark
 
 ```ts
-function mark(name: string, options?: { stack?: string }): Promise<void>
+function mark(name: string, options?: { stack?: string; kind?: BrowserTraceEntryKind }): Promise<void>
 ```
 
 Adds a named marker to the trace timeline and uses the current locator as marker context.
 
 Pass `options.stack` to override the callsite location in trace metadata. This is useful for wrapper libraries that need to preserve the end-user source location.
 
+Pass `options.kind` to categorize your marker as specific type, for example as `'action'`.
+
 ```ts
 import { page } from 'vitest/browser'