chore: wip

Author: chrisbbreuer

README.md

@@ -48,13 +48,13 @@ bunx headwind init
 This creates a `headwind.config.ts` file:
 
 ```typescript
-import type { HeadwindConfig } from 'headwind'
+import type { HeadwindOptions } from 'headwind'
 
 export default {
   content: ['./src/**/*.{html,js,ts,jsx,tsx}'],
   output: './dist/headwind.css',
   minify: false,
-} satisfies Partial<HeadwindConfig>
+} satisfies HeadwindOptions
 ```
 
 2. **Add utility classes to your HTML**:
@@ -114,7 +114,7 @@ headwind --help           # Show help
 Headwind supports extensive configuration options:
 
 ```typescript
-import type { HeadwindConfig } from 'headwind'
+import type { HeadwindOptions } from 'headwind'
 
 export default {
   // Content sources to scan for utility classes
@@ -173,7 +173,7 @@ export default {
 
   // Presets
   presets: [],
-} satisfies Partial<HeadwindConfig>
+} satisfies HeadwindOptions
 ```
 
 For more configuration options, see the [Configuration Guide](https://headwind.stacksjs.org/config).

docs/advanced/custom-rules.md

@@ -16,7 +16,7 @@ While Headwind includes comprehensive built-in utilities, you can add custom rul
 Define custom rules in your configuration:
 
 ```typescript
-import type { HeadwindConfig } from 'headwind'
+import type { HeadwindOptions } from 'headwind'
 
 const config = {
   rules: [
@@ -36,7 +36,7 @@ const config = {
       }),
     ],
   ],
-} satisfies Partial<HeadwindConfig>
+} satisfies HeadwindOptions
 
 export default config
 ```
@@ -97,6 +97,7 @@ const config = {
 ```
 
 Usage:
+
 ```html
 <div class="glass">Glassmorphism effect</div>
 ```
@@ -117,6 +118,7 @@ const config = {
 ```
 
 Usage:
+
 ```html
 <div class="aspect-16/9">16:9 aspect ratio</div>
 <div class="aspect-4/3">4:3 aspect ratio</div>
@@ -150,6 +152,7 @@ const config = {
 ```
 
 Usage:
+
 ```html
 <span class="brand-primary">Primary brand color</span>
 <span class="brand-secondary">Secondary brand color</span>
@@ -183,6 +186,7 @@ const config = {
 ```
 
 Usage:
+
 ```html
 <div class="grid grid-areas-header">
   <header class="grid-area-[header]">Header</header>
@@ -213,6 +217,7 @@ const config = {
 ```
 
 Usage:
+
 ```html
 <div class="animate-delay-500 animate-duration-1000">
   Delayed animation
@@ -279,7 +284,7 @@ const config = {
 Access theme values in custom rules:
 
 ```typescript
-import type { HeadwindConfig } from 'headwind'
+import type { HeadwindOptions } from 'headwind'
 
 const config = {
   theme: {
@@ -307,7 +312,7 @@ const config = {
       },
     ],
   ],
-} satisfies Partial<HeadwindConfig>
+} satisfies HeadwindOptions
 ```
 
 ### Vendor Prefixes
@@ -420,6 +425,7 @@ const config = {
 ```
 
 Usage:
+
 ```html
 <div class="gradient-blue-to-purple">
   Blue to purple gradient
@@ -459,11 +465,13 @@ const config = {
 ### 1. Use Specific Patterns
 
 ✅ **Good:**
+
 ```typescript
 /^my-utility-(\d+)$/ // Specific pattern
 ```
 
 ❌ **Avoid:**
+
 ```typescript
 /^my-/ // Too broad, might conflict
 ```
@@ -559,6 +567,7 @@ Custom rules have minimal performance impact:
 ### Optimization Tips
 
 1. **Use specific patterns:**
+
    ```typescript
    // ✅ Fast
    /^my-utility-(\d+)$/
@@ -568,6 +577,7 @@ Custom rules have minimal performance impact:
    ```
 
 2. **Avoid complex logic:**
+
    ```typescript
    // ✅ Simple check
    if (value === 'sm')
@@ -579,6 +589,7 @@ Custom rules have minimal performance impact:
    ```
 
 3. **Cache computed values:**
+
    ```typescript
    const computedValues = new Map()
 
@@ -605,18 +616,21 @@ Custom rules have minimal performance impact:
 **Check:**
 
 1. Pattern is correct:
+
    ```typescript
    // Test pattern
    /^my-utility-(\d+)$/.test('my-utility-10') // true
    ```
 
 2. Class name matches exactly:
+
    ```html
    <div class="my-utility-10">✅ Matches</div>
    <div class="my-utility-abc">❌ No match</div>
    ```
 
 3. Handler returns valid object:
+
    ```typescript
    (match) => {
      console.log('Match:', match)

docs/advanced/frameworks.md

@@ -22,13 +22,13 @@ bunx headwind init
 
 ```typescript
 // headwind.config.ts
-import type { HeadwindConfig } from 'headwind'
+import type { HeadwindOptions } from 'headwind'
 
 const config = {
   content: ['./src/**/*.{js,jsx,ts,tsx}'],
   output: './src/headwind.css',
   minify: process.env.NODE_ENV === 'production',
-} satisfies Partial<HeadwindConfig>
+} satisfies HeadwindOptions
 
 export default config
 ```
@@ -871,20 +871,23 @@ Use class directives:
 ### CSS Not Updating
 
 **Solution:** Ensure watch mode is running:
+
 ```bash
 headwind watch
 ```
 
 ### Classes Not Found
 
 **Solution:** Check content paths include all files:
+
 ```typescript
 content: ['./src/**/*.{js,jsx,ts,tsx}']
 ```
 
 ### Build Failing in CI
 
 **Solution:** Run Headwind build before framework build:
+
 ```yaml
 - run: bun run headwind build --minify
 - run: bun run build

docs/advanced/presets.md

@@ -92,14 +92,14 @@ export const minimalPreset: Preset = {
 
 ```typescript
 // headwind.config.ts
-import type { HeadwindConfig } from 'headwind'
+import type { HeadwindOptions } from 'headwind'
 import { minimalPreset } from './presets/minimal'
 
 const config = {
   content: ['./src/**/*.{html,js,ts,jsx,tsx}'],
   output: './dist/headwind.css',
   presets: [minimalPreset],
-} satisfies Partial<HeadwindConfig>
+} satisfies HeadwindOptions
 
 export default config
 ```
@@ -654,18 +654,21 @@ const exampleConfig = {
 **Check:**
 
 1. Preset is imported correctly:
+
    ```typescript
    import { myPreset } from './presets/my-preset'
    ```
 
 2. Preset is added to config:
+
    ```typescript
    const config = {
      presets: [myPreset], // ✅
    }
    ```
 
 3. Preset has correct structure:
+
    ```typescript
    const preset: Preset = {
      name: 'my-preset', // Required