From dd19408bd1898bd9907096501b3ac3b9a9f1c008 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20S=C4=99dzik?= <s.sedzik@smartrecruiters.com>
Date: Thu, 4 Jan 2024 12:52:37 +0100
Subject: [PATCH 1/4] feat: add `@debug` decorator

---
 README.md              | 29 ++++++++++++++++++++++++++++-
 lib/debug.decorator.ts | 19 +++++++++++++++++++
 lib/index.ts           |  3 ++-
 lib/tag.decorator.ts   |  1 +
 4 files changed, 50 insertions(+), 2 deletions(-)
 create mode 100644 lib/debug.decorator.ts

diff --git a/README.md b/README.md
index eeae62c..b4ae049 100644
--- a/README.md
+++ b/README.md
@@ -335,6 +335,33 @@ class MyTestSuite {
 - `description` (optional) - description of annotation.
 
 
+### Run test(s) or suite(s) in debug mode: `@debug()`
+Runs a `@test`(s) or `@suite`(s) in debug mode.
+`@test`(s) or `@suite`(s) lacking the `@debug` decorator will be excluded.
+Learn more about debug mode: https://playwright.dev/docs/debug
+
+```ts
+import { suite, test, debug, TestArgs } from 'playwright-decorators';
+
+// Debug selected test suite(s)
+@debug() // <-- Decorate suite with @debug()
+@suite()
+class DebugTestSuite {
+}
+
+// Or debug selected test(s)
+@suite()
+class TestSuite {
+    @debug() // <-- Decorate test with @debug()
+    @test()
+    async test({ page }: TestArgs) {
+        // ...
+    }
+}
+```
+
+Then run playwright tests as usual, i.e `npx playwright test`.
+> For debugging purposes, it is recommended to run tests only for one project / browser.
 
 ### Custom decorators
 Custom decorators can be created using `createTestDecorator` and `createSuiteDecorator` functions.
@@ -409,7 +436,7 @@ const customSuiteAndTestDecorator = createSuiteAndTestDecorator(
     // custom suite decorator code
   },
   ({ test }) => {
-    // code test decorator code
+    // custom@test decorator code
   }
 )
 ```
diff --git a/lib/debug.decorator.ts b/lib/debug.decorator.ts
new file mode 100644
index 0000000..c77a133
--- /dev/null
+++ b/lib/debug.decorator.ts
@@ -0,0 +1,19 @@
+import { createSuiteAndTestDecorator } from './custom'
+
+/**
+ * Runs a @test or @suite in debug mode.
+ * @test(s) or @suite(s) lacking the @debug decorator will be excluded.
+ * Learn more about debug mode: https://playwright.dev/docs/debug
+ */
+export const debug = () =>
+  createSuiteAndTestDecorator(
+    'debug',
+    ({ suite }) => {
+      process.env.PWDEBUG = '1'
+      suite.only = true
+    },
+    ({ test }) => {
+      process.env.PWDEBUG = '1'
+      test.only = true
+    }
+  )
diff --git a/lib/index.ts b/lib/index.ts
index 498f697..c32a124 100644
--- a/lib/index.ts
+++ b/lib/index.ts
@@ -19,9 +19,10 @@ export { fail } from './fail.decorator'
 export { fixme } from './fixme.decorator'
 export { only } from './only.decorator'
 export { annotation } from './annotation.decorator'
+export { tag } from './tag.decorator'
 
 // helpers
-export { tag } from './tag.decorator'
+export { debug } from './debug.decorator'
 
 // common
 export { type TestInfo, type TestArgs } from './common'
diff --git a/lib/tag.decorator.ts b/lib/tag.decorator.ts
index b98f118..b44b8f9 100644
--- a/lib/tag.decorator.ts
+++ b/lib/tag.decorator.ts
@@ -2,6 +2,7 @@ import { createSuiteAndTestDecorator } from './custom'
 
 const tagsAsPlaywrightAnnotations = (tags: string[]): string =>
   tags.map((tag) => `@${tag}`).join(' ')
+
 /**
  * Adds tags to `@test` or `@suite`.
  * You can later run test(s) or suite(s) with specific tag, using `npx playwright test --grep "@nameOfTag"` command.

From 208d226dac97de84dfd7b9ad72b93c8232732b32 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20S=C4=99dzik?= <s.sedzik@smartrecruiters.com>
Date: Thu, 4 Jan 2024 12:55:13 +0100
Subject: [PATCH 2/4] chore: generate changeset

---
 .changeset/ninety-pants-speak.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 .changeset/ninety-pants-speak.md

diff --git a/.changeset/ninety-pants-speak.md b/.changeset/ninety-pants-speak.md
new file mode 100644
index 0000000..43b2257
--- /dev/null
+++ b/.changeset/ninety-pants-speak.md
@@ -0,0 +1,29 @@
+---
+'playwright-decorators': minor
+---
+
+Add `@debug` decorator
+
+Runs a `@test`(s) or `@suite`(s) in debug mode.
+`@test`(s) or `@suite`(s) lacking the `@debug` decorator will be excluded.
+Learn more about debug mode: https://playwright.dev/docs/debug
+
+```ts
+import { suite, test, debug, TestArgs } from 'playwright-decorators';
+
+// Debug selected test suite(s)
+@debug() // <-- Decorate suite with @debug()
+@suite()
+class DebugTestSuite {
+}
+
+// Or debug selected test(s)
+@suite()
+class TestSuite {
+    @debug() // <-- Decorate test with @debug()
+    @test()
+    async test({ page }: TestArgs) {
+        // ...
+    }
+}
+```

From ece5aa56055b0b7de4086c61a0263263d8ed967e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20S=C4=99dzik?=
 <30985766+SebastianSedzik@users.noreply.github.com>
Date: Thu, 4 Jan 2024 13:16:40 +0100
Subject: [PATCH 3/4] docs: update typo in readme

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b4ae049..5178579 100644
--- a/README.md
+++ b/README.md
@@ -436,7 +436,7 @@ const customSuiteAndTestDecorator = createSuiteAndTestDecorator(
     // custom suite decorator code
   },
   ({ test }) => {
-    // custom@test decorator code
+    // custom test decorator code
   }
 )
 ```

From e2f962fe927ae508bc228a66d0deee42bf712db1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20S=C4=99dzik?=
 <30985766+SebastianSedzik@users.noreply.github.com>
Date: Thu, 4 Jan 2024 13:21:27 +0100
Subject: [PATCH 4/4] docs: fix typos in readme

---
 README.md | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/README.md b/README.md
index 5178579..bde8319 100644
--- a/README.md
+++ b/README.md
@@ -78,8 +78,8 @@ class MyTestSuite {
 - `name` (optional) - name of the test. By default, name of the method.
 
 
-### Run method before all test in the suite: `@beforeAll()`
-Mark method as `beforeAll` book.
+### Run method before all tests in the suite: `@beforeAll()`
+Mark the method as `beforeAll` book.
 
 ```ts
 import { suite, test, beforeAll, TestArgs } from 'playwright-decorators';
@@ -95,7 +95,7 @@ class MyTestSuite {
 
 
 ### Run method before each test in the suite: `@beforeEach()`
-Mark method as `beforeEach` book.
+Mark the method as `beforeEach` book.
 
 ```ts
 import { suite, test, beforeEach, TestArgs } from 'playwright-decorators';
@@ -110,8 +110,8 @@ class MyTestSuite {
 ```
 
 
-### Run method after all test in the suite: `@afterAll()`
-Mark method as `afterAll` book.
+### Run method after all tests in the suite: `@afterAll()`
+Mark the method as `afterAll` book.
 
 ```ts
 import { suite, test, afterAll, TestArgs } from 'playwright-decorators';
@@ -127,7 +127,7 @@ class MyTestSuite {
 
 
 ### Run method after each test in the suite: `@afterEach()`
-Mark method as `afterEach` book.
+Mark the method as `afterEach` book.
 
 ```ts
 import { suite, test, afterEach, TestArgs } from 'playwright-decorators';
@@ -166,7 +166,7 @@ class MyTestSuite {
 ```
 
 #### Options
-- `reason` (optional) - reason of skipping. Will be displayed in the test report.
+- `reason` (optional) - the reason for skipping. Will be displayed in the test report.
 
 
 ### Mark test or suite as "should fail": `@fail(reason?: string)`
@@ -177,7 +177,7 @@ This is useful for documentation purposes to acknowledge that some functionality
 ```ts
 import { suite, test, fail, TestArgs } from 'playwright-decorators';
 
-// Mark suite as "fail", ensure that all tests from suite fail
+// Mark suite as "fail", and ensure that all tests from suite fail
 @fail() // <-- Decorate suite with @fail()
 @suite()
 class FailTestSuite {
@@ -195,7 +195,7 @@ class MyTestSuite {
 ```
 
 #### Options
-- `reason` (optional) - reason of marking as "should fail". Will be displayed in the test report.
+- `reason` (optional) - the reason for marking as "should fail". Will be displayed in the test report.
 
 
 ### Mark test or suite as "fixme", with the intention to fix it: `@fixme(reason?: string)`
@@ -223,7 +223,7 @@ class MyTestSuite {
 ```
 
 #### Options
-- `reason` (optional) - reason of marking as "fixme". Will be displayed in the test report.
+- `reason` (optional) - the reason for marking as "fixme". Will be displayed in the test report.
 
 
 ### Mark test or suite as "slow": `@slow(reason?: string)`
@@ -251,7 +251,7 @@ class MyTestSuite {
 ```
 
 #### Options
-- `reason` (optional) - reason of marking as "slow". Will be displayed in the test report.
+- `reason` (optional) - the reason for marking as "slow". Will be displayed in the test report.
 
 
 ### Run only selected test(s) or suite(s): `@only()`
@@ -304,7 +304,7 @@ class TestSuite {
 }
 ```
 
-To run test(s) or suite(s) for `x-api-consumer` tag (example above), please type and run below command:
+To run test(s) or suite(s) for `x-api-consumer` tag (example above), please type and run the below command:
 ```shell
 npx playwright test --grep "@x-api-consumer"
 ``` 
@@ -315,7 +315,7 @@ npx playwright test --grep "@x-api-consumer"
 
 ### Add custom annotation to test(s): `@annotate({type: string, description?: string})`
 Add custom annotation to a test.
-Annotations are accessible via test.info().annotations. Many reporters show annotations, for example 'html'.
+Annotations are accessible via `test.info().annotations`. Many reporters show annotations, for example 'html'.
 
 ```ts
 import { suite, test, annotation, TestArgs } from 'playwright-decorators';
@@ -360,12 +360,12 @@ class TestSuite {
 }
 ```
 
-Then run playwright tests as usual, i.e `npx playwright test`.
-> For debugging purposes, it is recommended to run tests only for one project / browser.
+Then run playwright tests as usual, i.e. `npx playwright test`.
+> For debugging purposes, running tests only for one project/browser is recommended.
 
 ### Custom decorators
 Custom decorators can be created using `createTestDecorator` and `createSuiteDecorator` functions.
-Simple usage examples are provided below. For more advanced examples, please refer to [example decorators](./examples/tests/decorators) directory.
+Simple usage examples are provided below. For more advanced examples, please take a look at [example decorators](./examples/tests/decorators) directory.
 
 #### Test decorator
 The `createTestDecorator` function enables the generation of custom test decorators.
@@ -407,7 +407,7 @@ Attempting to apply a custom suite decorator to a class that lacks the `@suite`
 import { suite, createSuiteDecorator } from 'playwright-decorators';
 
 const customSuiteDecorator = createSuiteDecorator('customSuiteDecorator', ({ suite }) => {
-  // run your custom code imadiately
+  // run your custom code immediately
   suite.name = 'Custom name';
 
   // or attach to specific hooks...