{
  "id": "helper-digitshelper",
  "title": "Helper — DigitsHelper",
  "description": "Normalização de valores para uma sequência de dígitos.",
  "type": "technical-reference",
  "status": "implemented",
  "visibility": "public",
  "tags": [
    "sge/helpers",
    "sge/formatacao"
  ],
  "related": [
    "helper-braziliandocumenthelper",
    "helper-braziliancontacthelper",
    "helper-brazilianaddresshelper",
    "helper-funcoes-globais"
  ],
  "sourceRefs": [
    "https://github.com/sge-suite/sge/blob/master/app/Helpers/DigitsHelper.php",
    "https://github.com/sge-suite/sge/blob/master/tests/Unit/Helpers/FormattingHelpersTest.php"
  ],
  "authors": [],
  "updated": null,
  "diagram": null,
  "body": "## Responsabilidade\n\n`DigitsHelper::only()` remove todo caractere não numérico de um valor. `null` retorna uma string vazia. É a base de normalização compartilhada pelos formatadores de CPF/CNPJ, telefone e CEP; não valida documento nem decide formato de apresentação.\n\n## Checklist\n\n- [x] Implementar extração de dígitos e tratamento de `null`.\n- [x] Reutilizar a regra em helpers brasileiros.\n- [x] Expor `unmask()` como fachada global.\n- [ ] Cobrir entradas vazias, máscaras e caracteres não numéricos em teste unitário direto.\n\n## Relacionamentos\n\n- [Helper — BrazilianDocumentHelper](doc:helper-braziliandocumenthelper)\n- [Helper — BrazilianContactHelper](doc:helper-braziliancontacthelper)\n- [Helper — BrazilianAddressHelper](doc:helper-brazilianaddresshelper)\n- [Funções globais](doc:helper-funcoes-globais)",
  "sections": [
    {
      "id": "responsabilidade",
      "level": 2,
      "title": "Responsabilidade",
      "text": "`DigitsHelper::only()` remove todo caractere não numérico de um valor. `null` retorna uma string vazia. É a base de normalização compartilhada pelos formatadores de CPF/CNPJ, telefone e CEP; não valida documento nem decide formato de apresentação.",
      "line": 1
    },
    {
      "id": "checklist",
      "level": 2,
      "title": "Checklist",
      "text": "- [x] Implementar extração de dígitos e tratamento de `null`. - [x] Reutilizar a regra em helpers brasileiros. - [x] Expor `unmask()` como fachada global. - [ ] Cobrir entradas vazias, máscaras e caracteres não numéricos em teste unitário direto.",
      "line": 5
    },
    {
      "id": "relacionamentos",
      "level": 2,
      "title": "Relacionamentos",
      "text": "- [Helper — BrazilianDocumentHelper](doc:helper-braziliandocumenthelper) - [Helper — BrazilianContactHelper](doc:helper-braziliancontacthelper) - [Helper — BrazilianAddressHelper](doc:helper-brazilianaddresshelper) - [Funções globais](doc:helper-funcoes-globais)",
      "line": 12
    }
  ],
  "sourcePath": "content/helper-digitshelper.md",
  "visuals": [],
  "apiVersion": 1
}