Document more findings around soft assertions

Author: dprevost-LMI

docs/Framework.md

@@ -68,10 +68,33 @@ beforeAll(async () => {
     expect.extend(matchers as Record<string, any>);
 });
 ```
-For the soft assertion, it needs to expose the `createSoftExpect` first.
 
+For the soft assertion, the `createSoftExpect` is currently not correctly exposed but the below works:
+```ts
+// @ts-ignore
+import * as createSoftExpect from "expect-webdriverio/lib/softExpect";
+
+beforeAll(async () => {
+  Object.defineProperty(expect, "soft", {
+    value: <T = unknown>(actual: T) => createSoftExpect.default(actual),
+  });
+
+  // Add soft assertions utility methods
+  Object.defineProperty(expect, "getSoftFailures", {
+    value: (testId?: string) => SoftAssertService.getInstance().getFailures(testId),
+  });
+
+  Object.defineProperty(expect, "assertSoftFailures", {
+    value: (testId?: string) => SoftAssertService.getInstance().assertNoFailures(testId),
+  });
+
+  Object.defineProperty(expect, "clearSoftFailures", {
+    value: (testId?: string) => SoftAssertService.getInstance().clearFailures(testId),
+  });
+});
+```
 
-As shown below, no imports are required and we can use WDIO matchers directly on Jest's `expect`:
+Then as shown below, no imports are required and we can use WDIO matchers directly on Jest's `expect`:
 ```ts
 describe('My tests', async () => {
 

test/softAssertions.test.ts

@@ -7,7 +7,7 @@ vi.mock('@wdio/globals')
 
 describe('Soft Assertions', () => {
     // Setup a mock element for testing
-    let el: any
+    let el: ChainablePromiseElement
 
     beforeEach(async () => {
         el = $('sel')
@@ -106,6 +106,20 @@ describe('Soft Assertions', () => {
             // Should be no failures now
             expect(expectWdio.getSoftFailures().length).toBe(0)
         })
+
+        // TODO: Soft are currently not supporting basic matchers like toBe or toEqual.To fix one day!
+        it.skip('should support basic text matching', async () => {
+            const softService = SoftAssertService.getInstance()
+            softService.setCurrentTest('test-7', 'test name', 'test file')
+            const text = await el.getText()
+
+            expectWdio.soft(text).toEqual('!Actual Text')
+
+            const failures = expectWdio.getSoftFailures()
+            expect(failures.length).toBe(1)
+            expect(failures[0].matcherName).toBe('toHaveText')
+        })
+
     })
 
     describe('SoftAssertService hooks', () => {