# La directiva @source

`@source` reside en su CSS de entrada. Sus formas `inline()` añaden o eliminan candidatos de clase y funcionan en todas partes. Sus formas de ruta nombran los archivos de plantilla que se deben analizar en busca de nombres de clase; solo [CLI](https://tailwindphp.inline0.dev/es/docs/cli) analiza archivos, y todavía no aplica las rutas que le proporcione (consulte [Cómo se usan las rutas](#how-paths-are-used)).

```css
@import "tailwindcss";
@source "./templates";
```

Las directivas `@source` se leen durante la compilación y se eliminan de la salida: nunca aparecen en el CSS generado. Las rutas deben ir entre comillas; se aceptan comillas simples y dobles.

## Rutas, patrones glob y negación

La forma de ruta acepta un directorio, un patrón glob o una ruta negada, y las directivas se acumulan:

```css
@source "./templates";              /* a directory */
@source "./components/**/*.php";    /* a glob */
@source not "./templates/legacy";   /* an exclusion */
```

### Cómo se usan las rutas

El compilador registra cada directiva de ruta en la lista `sources` de la matriz que devuelve `TailwindPHP\compile()`, como `['base' => …, 'pattern' => …, 'negated' => …]` con `base` tomado de la opción de compilación `base`. Nunca lee archivos por sí mismo.

- `tw::generate()`, `tw::compile()` y `TailwindCompiler` compilan solo el contenido que les pasas. Las directivas de ruta no tienen efecto en ellos.
- El [CLI](https://tailwindphp.inline0.dev/es/docs/cli) lee `sources`, pero en la versión actual analiza recursivamente el directorio del archivo de entrada en busca de todas las rutas no negadas, sin importar qué indiquen la ruta o el patrón glob, y omite por completo las rutas `not`, por lo que no excluyen nada ([#8](https://github.com/inline0/tailwindphp/issues/8)). [Qué analiza CLI](https://tailwindphp.inline0.dev/es/docs/cli#what-the-cli-scans) explica los detalles y muestra una estructura que funciona actualmente.

## Candidatos en línea

`@source inline(...)` fuerza la inclusión de clases en la salida, aunque no aparezcan en los archivos analizados; resulta útil para nombres de clase que se construyen dinámicamente en tiempo de ejecución:

```css
@source inline("flex p-4 m-2");
```

Los candidatos en línea también admiten variantes:

```css
@source inline("hover:bg-blue-500 focus:ring-2");
```

### Expansión de llaves

Los patrones en línea expanden grupos entre llaves, lo que permite enumerar muchos candidatos de forma compacta:

```css
@source inline("p-{1,2,4}");
/* Generates p-1, p-2, and p-4 */

@source inline("text-{red,blue}-500");
/* Generates text-red-500 and text-blue-500 */
```

## Candidatos en línea ignorados

`@source not inline(...)` hace lo contrario de `inline()`: elimina de la salida los candidatos coincidentes, aunque se hayan encontrado en el contenido. Aquí también funciona la expansión de llaves:

```css
@source not inline("legacy");
@source not inline("p-{1,2}");
```

## Reglas de validación

`@source` es una declaración, no un bloque. El compilador rechaza:

- Una directiva con cuerpo — `@source cannot have a body.`
- Una directiva anidada (por ejemplo, dentro de `@media`) — `@source cannot be nested.`
- Una ruta sin comillas — `@source paths must be quoted.`

```css
/* Invalid — throws "`@source` cannot have a body." */
@source "./src" {
    .some-style { color: red; }
}

/* Invalid — throws "`@source` paths must be quoted." */
@source ./src;
```

Consulta [CLI](https://tailwindphp.inline0.dev/es/docs/cli) para compilaciones basadas en archivos e [Imports](https://tailwindphp.inline0.dev/es/docs/usage/imports) para resolver `@import` y módulos virtuales.