feat: Options#tabSize

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Author: unicornware

README.md

@@ -202,6 +202,9 @@ Options for wrapping a string (`interface`).
   — the size of the string to use for padding the right side of each line (as a number or numeric), or the string to use
 - `stringify?` ([`ToString`](#tostringt) | `null` | `undefined`, optional)
   — convert a value to a string
+- `tabSize?` (`number` | `null` | `undefined`, optional)
+  — the number of spaces a tab is equivalent to
+  - default: `2`
 - `trim?` (`boolean` | `null` | `undefined`, optional)
   — whether to remove whitespace from the end of each line
   > 👉 **note**: lines are trimmed before applying indents or padding.

src/interfaces/__tests__/options.spec-d.mts

@@ -54,6 +54,12 @@ describe('unit-d:interfaces/Options', () => {
       .toEqualTypeOf<Nilable<ToString>>()
   })
 
+  it('should match [tabSize?: number | null | undefined]', () => {
+    expectTypeOf<TestSubject>()
+      .toHaveProperty('tabSize')
+      .toEqualTypeOf<Nilable<number>>()
+  })
+
   it('should match [trim?: boolean | null | undefined]', () => {
     expectTypeOf<TestSubject>()
       .toHaveProperty('trim')

src/interfaces/options.mts

@@ -60,6 +60,13 @@ interface Options {
    */
   stringify?: ToString | null | undefined
 
+  /**
+   * The number of spaces a tab is equivalent to.
+   *
+   * @default 2
+   */
+  tabSize?: number | null | undefined
+
   /**
    * Whether to remove whitespace from the beginning and end of each line.
    *

src/internal/tokenize.mts

@@ -118,7 +118,8 @@ function tokenize(
       [codes.vcr]: eol,
       [codes.vlf]: eol,
       null: [sequence, eoc]
-    })
+    }),
+    tabSize: config.tabSize ?? +chars.digit2
   })
 
   /**