Update docs

Author: marcospassos

README.md

@@ -159,7 +159,7 @@ To reset formatting and apply a new style:
 ```ts
 node.reset();
 
-console.log(node.toString({ indentationLevel: 2 }));
+console.log(node.toString({/* formatting options */}));
 ```
 
 Output:
@@ -179,6 +179,8 @@ Output:
 }
 ```
 
+Refer to the [Formatting](#formatting) section for details on available options.
+
 To update the document while preserving formatting, use the `update` method:
 
 ```ts
@@ -238,6 +240,130 @@ Output:
 }
 ```
 
+Here’s a drop-in README section that documents those options clearly, with concise tables and runnable examples.
+
+### Formatting
+
+When you call `toString(options)` you can control how the output is formatted.
+If an option is omitted, the formatter learns from the current document and keeps its style. If no style can be inferred, 
+the formatter falls back to a compact style with no extra spaces or indentation.
+
+### Options
+
+| Option                         | Type/Values            | Description                                            |
+|--------------------------------|------------------------|--------------------------------------------------------|
+| **indentationLevel**           | `number`               | Base indentation level for the document.               |
+| **indentationCharacter**       | `'space' \| 'tab'`     | Character used for indentation.                        |
+| **string.quote**               | `'single' \| 'double'` | Quotation style for string values.                     |
+| **property.quote**             | `'single' \| 'double'` | Quotation style for property keys.                     |
+| **property.unquoted**          | `boolean`              | Allow unquoted property keys when valid.               |
+| **array.indentationSize**      | `number`               | Indentation size for array entries.                    |
+| **array.trailingIndentation**  | `boolean`              | Indent closing bracket on a new line.                  |
+| **array.leadingIndentation**   | `boolean`              | Indent opening bracket on a new line.                  |
+| **array.entryIndentation**     | `boolean`              | Indent each array entry.                               |
+| **array.trailingComma**        | `boolean`              | Append a trailing comma after the last entry.          |
+| **array.commaSpacing**         | `boolean`              | Add space after commas in arrays.                      |
+| **array.colonSpacing**         | `boolean`              | Add space after colons in arrays (for objects inline). |
+| **object.indentationSize**     | `number`               | Indentation size for object properties.                |
+| **object.trailingIndentation** | `boolean`              | Indent closing brace on a new line.                    |
+| **object.leadingIndentation**  | `boolean`              | Indent opening brace on a new line.                    |
+| **object.entryIndentation**    | `boolean`              | Indent each object property.                           |
+| **object.trailingComma**       | `boolean`              | Append a trailing comma after the last property.       |
+| **object.commaSpacing**        | `boolean`              | Add space after commas in objects.                     |
+| **object.colonSpacing**        | `boolean`              | Add space after colons in objects.                     |
+
+### Quick recipes
+
+Here are some common formatting styles you can achieve by combining different options.
+
+#### 1) Compact, single-line arrays; pretty multi-line objects
+
+```ts
+node.toString({
+  array: {
+    leadingIndentation: false,   // keep arrays inline when short
+    trailingComma: false,
+    commaSpacing: true,
+  },
+  object: {
+    leadingIndentation: true,    // multi-line objects
+    entryIndentation: true,
+    trailingIndentation: true,
+    indentationSize: 2,
+    trailingComma: true,
+    commaSpacing: true,
+    colonSpacing: true,
+  },
+});
+```
+
+Output style:
+
+```json5
+{
+  "name": "My Project",
+  "keywords": ["json5", "parser"], // array kept inline
+  "deps": {
+    "typescript": "^5.6.0",       // multi-line object
+    "vite": "^5.4.0",
+  }
+}
+```
+
+#### 2) Tabs everywhere, single quotes, unquoted props where valid
+
+```ts
+node.toString({
+  indentationCharacter: 'tab',
+  string: {quote: 'single'},
+  property: {quote: 'single', unquoted: true},
+  object: {
+    leadingIndentation: true,
+    entryIndentation: true,
+    trailingIndentation: true,
+    trailingComma: false,
+    commaSpacing: true,
+    colonSpacing: true,
+  },
+});
+```
+
+Output style:
+
+```json5
+{
+	foo: 'bar',
+	items: [
+		'a',
+		'b'
+	]
+}
+```
+
+#### 3) Strict compact style (no spaces after commas/colons)
+
+```ts
+node.toString({
+  array: {
+    leadingIndentation: false,
+    trailingComma: false,
+    commaSpacing: false,
+  },
+  object: {
+    leadingIndentation: false,
+    trailingComma: false,
+    commaSpacing: false,
+    colonSpacing: false,
+  },
+});
+```
+
+Output style:
+
+```json5
+{"a":1,"b":[1,2,3]}
+```
+
 ## Contributing
 
 Contributions are welcome!