add JSDoc for default option

.changeset/six-pianos-explode.md

@@ -2,16 +2,22 @@
 "ajv-ts": patch
 ---
 
-Add async keyword support
+Add `async` keyword support
 
 example:
 
 ```ts
 const obj = s.object({}).async()
 
 obj.schema // {type: 'object', $async: true}
+// make sync schema
+obj.sync() // {type: 'object', $async: false}
+
+// or completely remove the `$async` keyword form schema
+obj.sync(true) // {type: 'object'}
 ```
 
 ## fixes/refactories
 
 - refactor `safeParse` logic.
+- update JSDoc for `default` method

src/builder.ts

@@ -206,7 +206,13 @@ abstract class SchemaBuilder<
     return this
   }
 
-  /** Define default value */
+  /**
+   * Option `default` keywords throws exception during schema compilation when used in:
+   * - not in `properties` or `items` subschemas
+   * - in schemas inside `anyOf`, `oneOf` and `not` ({@link https://github.com/ajv-validator/ajv/issues/42 #42})
+   * - in `if` schema
+   * - in schemas generated by user-defined _macro_ keywords
+   */
   default(value: Output) {
     (this.schema as AnySchema).default = value
     return this;