@andsfonseca/palavras-pt-br

中文文档
1.0.8发布于 2022/02/13MITTypeScriptCommonJS近 30 天下载 2323

Uma biblioteca que informa todas as palavras a partir de um json.

原始使用文档
文档目录11 节
  1. O que é?
  2. Instalação
  3. Uso
  4. Importação
  5. Funções
  6. Interfaces
  7. IWordleValidation
  8. Base de Dados
  9. Bases Padrões
  10. Issues
  11. Contribuições

Palavras PT-br

Código criado com o intuito de ajudar a ter uma lista de todas as palavras em português brasileiro

O que é?

Um pacote com uma listagem de palavras em português brasileiro

Instalação

Instale o pacote globalmente através do repositório npmjs.com.

npm i @andsfonseca/palavras-pt-br

Uso

Importação

Para realizar a importação via Javascript

var Word = require('@andsfonseca/palavras-pt-br').Word;

Para realizar a importação via Typescript

import { Word } from '@andsfonseca/palavras-pt-br'

Funções

  • getAllWords (limit: number = 0, removeAccents: boolean = true, includeCompounds: boolean = true, includeSpecialCharacters: boolean = false, includeProperNouns: boolean = false)

Método que retorna um array de palavras da base com a filtragem escolhida pelo usuário.

ArgumentoDescriçãoObrigatório
limitLimite de caracteres da palavra, caso seja menor ou igual a 0 serão considerada todas.Não, padrão 0
removeAccentsInforma se deve remover os acentos nas palavras.Não, padrão false
includeCompoundsInforma se deve incluir palavras compostas.Não, padrão true
includeSpecialCharactersInforma se deve incluir palavras com caracateres especiais.Não, padrão false
includeProperNounsInforma se deve incluir nomes próprios.Não, padrão false
let words: string[] = Word.getAllWords()
  • getRandomWord (limit: number = 0, removeAccents: boolean = true, includeCompounds: boolean = true, includeSpecialCharacters: boolean = false, includeProperNouns: boolean = false)

Método que retorna uma palavra aleatória da base com a filtragem escolhida pelo usuário.

Os argumentos são descritos no método getAllWords

let randomWord: string = Word.getRandomWord()
  • getDailyWord (limit: number = 0, removeAccents: boolean = true, includeCompounds: boolean = true, includeSpecialCharacters: boolean = false, includeProperNouns: boolean = false)

Método que retorna uma palavra aleatória por dia da base com a filtragem escolhida pelo usuário.

Os argumentos são descritos no método getAllWords

let randomWord: string = Word.getDailyWord()
  • checkValid (word: string, limit: number = 0, removeAccents: boolean = true, includeCompounds: boolean = true, includeSpecialCharacters: boolean = false, includeProperNouns: boolean = false)

Método que verifica se uma palavra está na base, com a filtragem escolhida pelo usuário.

ArgumentoDescriçãoObrigatório
wordPalavra a ser verificada.✅ Sim

O restante dos argumentos são descritos no método getAllWords

let valid: boolean = Word.checkValid("teste")
  • wordleValidator(trueWord: string, triedWord: string)

Método que verifica a proximidade entre duas palavras, no estilo Wordle. Retorna informações sobre a validação da palavra

ArgumentoDescriçãoObrigatório
trueWordPalavra verdadeira.✅ Sim
triedWordPalavra a ser verificada.✅ Sim
let validation: IWordleValidation[] = Word.wordleValidator("tesla", "testu")

A interface IWordleValidation é descrita nesta seção

Interfaces

  • IWordleValidation

Representação da Validação do Wordle

interface IWordleValidation {
    word: string,
    contains: boolean,
    exact: boolean
}
PropriedadeDescrição
wordLetra.
containsSe a letra está na palavra.
exactSe a letra está na posição correta.

Base de Dados

Bases Padrões

As bases de dados usados nesta biblioteca são:

| Dicionário | |:--------------------:| | Dicionário br.ispell | | pythonprobr | | @un-versed Termoo v2 |

Podem ser importadas da seguinte maneira

import { BRISPELL, PYTHONPROBR, UNVERSEDV2 } from '@andsfonseca/palavras-pt-br'

Por padrão a biblioteca @un-versed Termoo v2 é usada.

Você pode customizar a biblioteca da seguinte maneira:

Word.library = PYTHONPROBR
//Word.library = ["Outras", "Palavras", "Da", "Sua", "Base"]

Issues

Sinta-se livre para contribuir com o projeto.

Contribuições

  1. Crie uma cópia do projeto (fork)
  2. Crie uma branch com sua modificação (git checkout -b my-new-resource)
  3. Faça um commit commit (git commit -am 'Adding a new resource...')
  4. Push (git push origin my-new-resource)
  5. Crie uma Pull Request

版本与发布记录

@andsfonseca/palavras-pt-br 共发布 9 个版本,首次发布于 2022/02/01;过去 12 个月发布了 0 个版本。

版本发布日期距今
1.0.8latest2022/02/134 年前
1.0.72022/02/094 年前
1.0.62022/02/044 年前
1.0.52022/02/044 年前
1.0.42022/02/044 年前
1.0.32022/02/034 年前

关于 @andsfonseca/palavras-pt-br 的常见问题

@andsfonseca/palavras-pt-br 是什么?

Uma biblioteca que informa todas as palavras a partir de um json.

如何安装 @andsfonseca/palavras-pt-br?

在项目目录运行 npm install @andsfonseca/palavras-pt-br,或使用 pnpm add / yarn add / bun add。

@andsfonseca/palavras-pt-br 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@andsfonseca/palavras-pt-br 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@andsfonseca/palavras-pt-br 可以商用吗?

@andsfonseca/palavras-pt-br 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@andsfonseca/palavras-pt-br 的下载量有多少?

根据 npm 官方下载统计,@andsfonseca/palavras-pt-br 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,323 次,日均约 77 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@andsfonseca/palavras-pt-br 还在维护吗?

最新版本 1.0.8 发布于 2022/02/13(4 年前);至今共发布 9 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/02/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。