# Font Weight

**File**: `/src/plugins/theme/fontWeight.js`

> **Deprecated.** `.font-regular` will be removed in v8. Replace it with Tailwind's
> `.font-normal`, which is identical (400) and available today. The examples below
> still show `.font-regular` for reference, but new code should not use it.

## Overview
Extends Tailwind's default font weights with `.font-regular` as an alias for normal (400) weight, maintaining compatibility with Decanter v6 users.

## Generated CSS Classes

- **Regular weight**: `.font-regular` _(deprecated — use `.font-normal`)_ (400 - alias for `.font-normal`)
- **Standard Tailwind weights**: `.font-thin`, `.font-light`, `.font-normal`, `.font-medium`, `.font-semibold`, `.font-bold`, `.font-extrabold`, `.font-black`

## Usage

```html
<!-- Using Decanter's regular alias -->
<p class="font-regular">Regular weight text (400)</p>
<p class="font-normal">Same as font-regular</p>

<!-- Standard font weight scale -->
<h1 class="font-bold">Bold heading</h1>
<h2 class="font-semibold">Semibold subheading</h2>
<p class="font-regular">Regular body text</p>
<small class="font-light">Light helper text</small>

<!-- Typography hierarchy -->
<div class="font-serif">
  <h1 class="font-black text-3xl">Stanford University</h1>
  <h2 class="font-bold text-xl">School of Engineering</h2>
  <p class="font-regular">Regular content text</p>
</div>
```

## Customization

```javascript
// In your tailwind.config.js
module.exports = {
  theme: {
    extend: {
      fontWeight: {
        // Add custom weights
        'hairline': 100,
        'extra-light': 200,
        'book': 350,
        'heavy': 850,
        // Add semantic weights
        'heading': 700,
        'subheading': 600,
        'body': 400,
      },
    },
  },
}

**Purpose**: Provides the `font-regular` class as an alternative to Tailwind's `font-normal`.

**Usage Guidelines:**
- **Legacy compatibility**: Use in projects migrating from Decanter v6
- **Team preference**: When teams prefer "regular" terminology over "normal"
- **Consistency**: Maintains existing code patterns during transitions

## Complete Font Weight System

When combined with Tailwind's default weights, Stanford projects have access to:

### Tailwind Default Weights
```css
font-thin        /* 100 */
font-extralight  /* 200 */
font-light       /* 300 */
font-normal      /* 400 */
font-medium      /* 500 */
font-semibold    /* 600 */
font-bold        /* 700 */
font-extrabold   /* 800 */
font-black       /* 900 */
```

### Stanford Extension
```css
font-regular     /* 400 - Same as font-normal */
```

## Usage Examples

### Legacy Compatibility
```html
<!-- Decanter v6 style (still supported) -->
<p class="font-regular">
  Body text using legacy font-regular class
</p>

<!-- Modern Tailwind style (recommended) -->
<p class="font-normal">
  Body text using standard font-normal class
</p>
```

### Stanford Typography Hierarchy
```html
<!-- Complete weight hierarchy using both systems -->
<article>
  <!-- Hero heading -->
  <h1 class="type-6 font-bold">
    Major Heading - Bold (700)
  </h1>

  <!-- Section headings -->
  <h2 class="type-4 font-semibold">
    Section Heading - Semibold (600)
  </h2>

  <!-- Subheadings -->
  <h3 class="type-3 font-medium">
    Subheading - Medium (500)
  </h3>

  <!-- Body text with both options -->
  <p class="type-0 font-regular leading-normal">
    Body text using legacy font-regular class (400 weight)
  </p>

  <p class="type-0 font-normal leading-normal">
    Body text using standard font-normal class (400 weight)
  </p>

  <!-- Light emphasis -->
  <p class="type-0 font-light text-black-70">
    Supporting text with light weight (300)
  </p>
</article>
```

This simple but important extension ensures Stanford teams can transition smoothly to the modern Tailwind-based system while maintaining familiar conventions and existing codebases.