@papia/cspell-kea

CSpell-compatible Cape Verdean Kriolu (Kabuverdianu, ISO 639-3 kea) dictionary, generated from the @papia/text-core ALUPEC wordlist (3267 entries).

Pairs cleanly with vscode-papia (sideload .vsix from GitHub Releases) — when you're using both ALUPEC linting (for orthography) and CSpell (for spell-checking), this dictionary stops CSpell from flagging valid Kriolu words as misspelled.

Install

npm install -D @papia/cspell-kea
# or
pnpm add -D @papia/cspell-kea

The package ships just kea.txt + cspell-ext.json — no build step, no runtime dependencies.

Usage

In your .cspell.json (or cspell.config.yaml):

{
  "import": ["@papia/cspell-kea/cspell-ext.json"],
  "overrides": [
    {
      "filename": "**/{*.kea,kea}.{md,mdx}",
      "dictionaries": ["kea"]
    }
  ]
}

The overrides block scopes the dictionary to files that follow the same naming convention vscode-papia uses for Kriolu detection (*.kea.{md,mdx} or kea.{md,mdx}). For frontmatter-tagged files (language: kea in plain .md/.mdx), CSpell can't auto-detect from frontmatter — list those globs explicitly or set the override to apply repo-wide.

To apply Kriolu spelling rules everywhere:

{
  "import": ["@papia/cspell-kea/cspell-ext.json"],
  "dictionaries": ["kea"]
}

Limitations

The dictionary is a phonetic/orthographic baseline. It does not include:

• Proper nouns (place names, personal names, organizations).
• Recent neologisms that aren't in the source wordlist.
• Loanwords from English/Portuguese still in flux.
• Technical jargon (programming terms, scientific vocabulary).
• Words containing Portuguese-influenced characters (ç, ã, õ, ñ) — these are explicitly forbidden by ALUPEC and excluded from the dictionary.

Add project-specific words to your cspell.json words list as you encounter them, or contribute back upstream to @papia/text-core/alupec-wordlist.json.

Regeneration

The dictionary is committed to the repo so consumers don't need to build text-core. To refresh it after a wordlist update:

pnpm -C packages/text-core build:cspell-dict

This reads packages/text-core/src/alupec/alupec-wordlist.json and rewrites kea.txt. Determine the new entry count from the script's stdout, bump this package's version field if entries changed materially, then commit both.