BREAKING CHANGE(docs): Update documentation and examples to unify async and sync assertions, add custom matcher guides, and update package configuration

ts/namespaces/object.ts

@@ -0,0 +1,39 @@
+import { Assertion } from '../smartexpect.classes.assertion.js';
+
+/**
+ * Namespace for object-specific matchers
+ */
+export class ObjectMatchers<T extends object> {
+  constructor(private assertion: Assertion<T>) {}
+
+  toEqual(expected: any) {
+    return this.assertion.toEqual(expected);
+  }
+
+  toMatchObject(expected: object) {
+    return this.assertion.toMatchObject(expected);
+  }
+
+  toBeInstanceOf(constructor: any) {
+    return this.assertion.toBeInstanceOf(constructor);
+  }
+
+  toHaveProperty(property: string, value?: any) {
+    return this.assertion.toHaveProperty(property, value);
+  }
+
+  toHaveDeepProperty(path: string[]) {
+    return this.assertion.toHaveDeepProperty(path);
+  }
+  toBeNull() {
+    return this.assertion.toBeNull();
+  }
+
+  toBeUndefined() {
+    return this.assertion.toBeUndefined();
+  }
+
+  toBeNullOrUndefined() {
+    return this.assertion.toBeNullOrUndefined();
+  }
+}