> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# helpers

> Conjunto de utilitários globais para formatação, navegação, URLs, imagens e manipulação de strings. Disponíveis em todos os componentes via mixin.

Mixin global que injeta métodos e filtros utilitários em todos os componentes. Além do mixin em si, o módulo exporta funções standalone que podem ser importadas diretamente.

## Uso

```js theme={"system"}
// Como mixin (já aplicado globalmente)
this.$formatMoney(1990.5);        // "R$ 1.990,50"
this.$thumborize(src, { width: 300 });
this.$redirectTo('/checkout');

// Como função standalone
import { formatMoney, thumborize, redirectTo } from '@/mixins/helpers';
```

## Computed injetados

| Computed   |   Tipo   | Descrição                                       |
| :--------- | :------: | :---------------------------------------------- |
| `$baseUrl` | `String` | Origem da URL atual (`window.location.origin`). |

## Filtros injetados

| Filtro        | Descrição                                  |
| :------------ | :----------------------------------------- |
| `formatMoney` | Formata número como moeda BRL (`R$ 0,00`). |

## Métodos injetados

| Método                  | Parâmetros                              | Descrição                                                                                      |
| :---------------------- | :-------------------------------------- | :--------------------------------------------------------------------------------------------- |
| `$get`                  | `object, path, default?`                | Acesso seguro a propriedades aninhadas (lodash `_get`).                                        |
| `$randomString`         | —                                       | Gera uma string aleatória de 7 caracteres.                                                     |
| `$queryParamsToString`  | `query: Object`                         | Serializa objeto em query string (formato RFC1738).                                            |
| `$mapWithKeys`          | `obj: Object, fn: Function`             | Transforma objeto mapeando chaves e valores.                                                   |
| `$formatMoney`          | `value: Number, withCurrency?: Boolean` | Formata valor como moeda BRL. `withCurrency: false` retorna apenas o número formatado.         |
| `$checkoutUrl`          | `url: String, withExtras?: Boolean`     | Retorna URL do checkout. Com `withExtras: true` inclui UTMs e tokens.                          |
| `$shopperUrl`           | `url: String, withExtras?: Boolean`     | Retorna URL do shopper. Com `withExtras: true` inclui UTMs e store token.                      |
| `$awaitTicks`           | `ticks?: Number, cb?: Function`         | Aguarda N ciclos de `Vue.nextTick`.                                                            |
| `$applyQueriesToUrl`    | `url: String, queries: Object`          | Adiciona query params a uma URL.                                                               |
| `$thumborize`           | `src: String, thumbor?: Object`         | Gera URL de imagem otimizada via Thumbor.                                                      |
| `$redirectTo`           | `url: String, allowIframe?: Boolean`    | Redireciona o usuário. Bloqueado dentro do iframe do editor (a menos que `allowIframe: true`). |
| `$safeCleanLink`        | `link: String`                          | Sanitiza e normaliza uma URL, adicionando protocolo se necessário.                             |
| `$forceHttp`            | `url: String, useHttps?: Boolean`       | Garante que a URL tenha protocolo HTTP/HTTPS.                                                  |
| `$cleanString`          | `str: String`                           | Remove caracteres nulos de uma string.                                                         |
| `$getCreditCardIconUrl` | `paymentsData: Array, alias: String`    | Retorna a URL do ícone do cartão de crédito pelo alias.                                        |