# A diretiva @source

`@source` fica na sua entrada CSS. Suas formas `inline()` adicionam ou removem candidatos de classe e funcionam em qualquer lugar. Suas formas de caminho indicam os arquivos de modelo a serem analisados em busca de nomes de classes; apenas o analisador [CLI](https://tailwindphp.inline0.dev/pt/docs/cli) analisa arquivos, mas ainda não aplica os caminhos informados (veja [Como os caminhos são usados](#how-paths-are-used)).

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

As diretivas `@source` são lidas durante a compilação e removidas da saída — nunca aparecem no CSS gerado. Os caminhos precisam estar entre aspas; aspas simples e duplas são aceitas.

## Caminhos, padrões glob e negação

O formato de caminho aceita um diretório, um padrão glob ou um caminho negado, e as diretivas são acumulativas:

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

### Como os caminhos são usados

O compilador registra cada diretiva de caminho na lista `sources` do array retornado por `TailwindPHP\compile()`, como `['base' => …, 'pattern' => …, 'negated' => …]`, com `base` definido pela opção de compilação `base`. Ele não lê arquivos por conta própria.

- `tw::generate()`, `tw::compile()` e `TailwindCompiler` compilam apenas o conteúdo fornecido. As diretivas de caminho não têm efeito nesses casos.
- O analisador [CLI](https://tailwindphp.inline0.dev/pt/docs/cli) lê `sources`, mas, na versão atual, analisa recursivamente o diretório do arquivo de entrada em busca de todos os caminhos não negados, independentemente do caminho ou padrão glob informado, e ignora completamente os caminhos `not`, que não excluem nada ([#8](https://github.com/inline0/tailwindphp/issues/8)). [O que o analisador CLI analisa](https://tailwindphp.inline0.dev/pt/docs/cli#what-the-cli-scans) explica os detalhes e apresenta uma estrutura que funciona atualmente.

## Candidatos em linha

`@source inline(...)` força a inclusão de classes na saída mesmo que elas não apareçam nos arquivos analisados — útil para nomes de classes montados dinamicamente em tempo de execução:

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

Os candidatos em linha também aceitam variantes:

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

### Expansão de chaves

Os padrões em linha expandem grupos entre chaves, permitindo enumerar vários 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 em linha ignorados

`@source not inline(...)` faz o contrário de `inline()` — remove os candidatos correspondentes da saída, mesmo que tenham sido encontrados no conteúdo. A expansão de chaves também funciona aqui:

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

## Regras de validação

`@source` é uma instrução, não um bloco. O compilador rejeita:

- Uma diretiva com corpo — `@source cannot have a body.`
- Uma diretiva aninhada (por exemplo, dentro de `@media`) — `@source cannot be nested.`
- Um caminho sem aspas — `@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;
```

Consulte [CLI](https://tailwindphp.inline0.dev/pt/docs/cli) para compilações baseadas em arquivos e [Importações](https://tailwindphp.inline0.dev/pt/docs/usage/imports) para resolver `@import` e módulos virtuais.