add tab-* utilities

Author: RobinMalfait

packages/tailwindcss/src/__snapshots__/intellisense.test.ts.snap

@@ -11489,6 +11489,9 @@ exports[`getClassList 1`] = `
   "stroke-transparent/95",
   "stroke-transparent/100",
   "subpixel-antialiased",
+  "tab-2",
+  "tab-4",
+  "tab-8",
   "table",
   "table-auto",
   "table-caption",

packages/tailwindcss/src/property-order.ts

@@ -354,6 +354,7 @@ export default [
   'text-overflow',
   'hyphens',
   'white-space',
+  'tab-size',
 
   'color',
   'text-transform',

packages/tailwindcss/src/utilities.test.ts

@@ -11807,6 +11807,58 @@ test('whitespace', async () => {
   ).toEqual('')
 })
 
+test('tab', async () => {
+  expect(
+    await compileCss(
+      css`
+        @theme {
+          --tab-size-github: 8;
+        }
+
+        @tailwind utilities;
+      `,
+      ['tab-2', 'tab-8', 'tab-[12px]', 'tab-[3]', 'tab-github'],
+    ),
+  ).toMatchInlineSnapshot(`
+    "
+    :root, :host {
+      --tab-size-github: 8;
+    }
+
+    .tab-2 {
+      tab-size: 2;
+    }
+
+    .tab-8 {
+      tab-size: 8;
+    }
+
+    .tab-\\[3\\] {
+      tab-size: 3;
+    }
+
+    .tab-\\[12px\\] {
+      tab-size: 12px;
+    }
+
+    .tab-github {
+      tab-size: var(--tab-size-github);
+    }
+    "
+  `)
+  expect(
+    await run([
+      'tab',
+      '-tab-2',
+      'tab-2.5',
+      'tab-1/2',
+      'tab-unknown',
+      'tab-2/foo',
+      'tab-[12px]/foo',
+    ]),
+  ).toEqual('')
+})
+
 test('text-wrap', async () => {
   expect(await run(['text-wrap', 'text-nowrap', 'text-balance', 'text-pretty']))
     .toMatchInlineSnapshot(`

packages/tailwindcss/src/utilities.ts

@@ -2275,6 +2275,22 @@ export function createUtilities(theme: Theme) {
   staticUtility('whitespace-pre-wrap', [['white-space', 'pre-wrap']])
   staticUtility('whitespace-break-spaces', [['white-space', 'break-spaces']])
 
+  functionalUtility('tab', {
+    themeKeys: ['--tab-size'],
+    handleBareValue: ({ value }) => {
+      if (!isPositiveInteger(value)) return null
+      return value
+    },
+    handle: (value) => [decl('tab-size', value)],
+  })
+
+  suggest('tab', () => [
+    {
+      values: ['2', '4', '8'],
+      valueThemeKeys: ['--tab-size'],
+    },
+  ])
+
   staticUtility('text-wrap', [['text-wrap', 'wrap']])
   staticUtility('text-nowrap', [['text-wrap', 'nowrap']])
   staticUtility('text-balance', [['text-wrap', 'balance']])