CSpell Dictionaries

npm install @cspell/dict-cspell-bundle

// Automatic loading via CSpell configuration
// Add to cspell.json:
{
  "import": ["@cspell/dict-cspell-bundle"]
}

// Each package exports CSpell configuration
import pythonDict from "@cspell/dict-python";
import typescriptDict from "@cspell/dict-typescript";
import awsDict from "@cspell/dict-aws";

// Standard exports for all packages:
// - Default: "./cspell-ext.json"
// - Named: "./cspell" -> "./cspell-ext.json"  
// - Direct: "./cspell-ext.json"

const pythonDict = require("@cspell/dict-python");
const typescriptDict = require("@cspell/dict-typescript");

{
  "import": ["@cspell/dict-cspell-bundle"],
  "dictionaries": ["typescript", "python", "aws", "docker"]
}

{
  "import": [
    "@cspell/dict-typescript",
    "@cspell/dict-python", 
    "@cspell/dict-aws"
  ]
}

{
  "cSpell.import": ["@cspell/dict-cspell-bundle"],
  "cSpell.dictionaries": ["typescript", "python", "aws"]
}

import { readFileSync } from 'fs';

// Load any dictionary package configuration
const dictPath = require.resolve("@cspell/dict-typescript");
const dictConfig = JSON.parse(
  readFileSync(dictPath, 'utf8')
    .replace(/\/\/.*$/gm, '')    // Remove comments
    .replace(/,\s*}/g, '}')      // Clean trailing commas
);

console.log(dictConfig.id);                    // "typescript"
console.log(dictConfig.dictionaryDefinitions); // Dictionary files
console.log(dictConfig.languageSettings);      // Language-specific rules

@cspell/dict-{name}/
├── package.json        # Package metadata
├── cspell-ext.json     # Main CSpell configuration
├── dict/              # Dictionary word files (.gz)
└── README.md          # Package documentation

/**
 * Main bundle package containing 63 essential dictionaries
 * Covers programming languages, web technologies, and development tools
 */
interface CSpellBundle {
  id: "cspell-bundle";
  import: string[];  // 63 dictionary package imports
  dictionaries: string[];  // Available dictionary names
}

/**
 * Natural language dictionary packages
 * Pattern: @cspell/dict-{language-code}
 */
interface NaturalLanguageDict {
  /** English variants: en_us, en-gb, en-au, en-ca */
  english: string[];
  /** European: fr-fr, de-de, es-es, it-it, pt-pt, nl-nl, etc. */
  european: string[];
  /** Slavic: ru_ru, pl_pl, cs-cz, hr-hr, bg-bg, etc. */
  slavic: string[];
  /** Asian: ar, he, bn, vi-vn, id-id, etc. */
  asian: string[];
  /** Other: ca, eu, eo, la, grc */
  specialized: string[];
}

/**
 * Programming language dictionary packages  
 * Pattern: @cspell/dict-{language}
 */
interface ProgrammingLanguageDict {
  /** Web: typescript, html, css, vue, svelte */
  web: string[];
  /** Systems: rust, golang, cpp, csharp, fsharp */
  systems: string[];
  /** General: python, java, scala, kotlin, swift, ruby, php */
  general: string[];
  /** Functional: haskell, elixir, clojure, elisp */
  functional: string[];
  /** Scripting: bash, shell, powershell */
  scripting: string[];
}

/**
 * Technology and framework dictionary packages
 * Pattern: @cspell/dict-{technology}
 */
interface TechnologyDict {
  /** Cloud: aws, google, docker, k8s, terraform */
  cloud: string[];
  /** Frameworks: dotnet, django, flutter, node, npm */
  frameworks: string[];
  /** Tools: git, vim, latex, markdown, makefile, sql */
  tools: string[];
}

/**
 * Specialized domain dictionary packages
 * Pattern: @cspell/dict-{domain}
 */
interface SpecializedDict {
  /** Scientific: scientific-terms-us, medicalterms, data-science */
  scientific: string[];
  /** Business: companies, public-licenses */
  business: string[];
  /** Technical: software-terms, fullstack, cryptocurrencies, filetypes */
  technical: string[];
  /** Geographic: city-names-finland, people-names */
  geographic: string[];
}

/**
 * Standard dictionary package export structure
 */
interface CSpellDictionaryConfig {
  /** Dictionary identifier */
  id: string;
  /** Configuration version */
  version: string;
  /** Display name */
  name: string;
  /** Package description */
  description: string;
  /** Dictionary definitions */
  dictionaryDefinitions: DictionaryDefinition[];
  /** Language-specific settings */
  languageSettings?: LanguageSettings[];
  /** File pattern overrides */
  overrides?: Override[];
  /** External dependencies */
  import?: string[];
}

interface DictionaryDefinition {
  /** Dictionary name */
  name: string;
  /** Path to dictionary file */
  path: string;
  /** Dictionary description */
  description: string;
}

interface LanguageSettings {
  /** Target language ID */
  languageId: string;
  /** Dictionaries to use */
  dictionaries: string[];
  /** Patterns to ignore */
  ignoreRegExpList?: string[];
  /** Syntax patterns */
  patterns?: Pattern[];
}

interface Pattern {
  /** Pattern name */
  name: string;
  /** Pattern description */
  description?: string;
  /** Regex pattern */
  pattern: string | string[];
}

interface Override {
  /** File pattern to match */
  filename: string;
  /** Dictionaries for matched files */
  dictionaries: string[];
}

npm install @cspell/dict-cspell-bundle

# Programming languages
npm install @cspell/dict-typescript @cspell/dict-python @cspell/dict-rust

# Natural languages  
npm install @cspell/dict-en_us @cspell/dict-fr-fr @cspell/dict-de-de

# Cloud & DevOps
npm install @cspell/dict-aws @cspell/dict-docker @cspell/dict-k8s

npm install @cspell/dict-typescript @cspell/dict-node @cspell/dict-html @cspell/dict-css @cspell/dict-git @cspell/dict-docker

/**
 * Type definitions for the cspell-dicts monorepo
 */
interface CSpellDictsMonorepo {
  /** Individual dictionary packages (110+) */
  packages: Record<string, CSpellDictionaryConfig>;
  /** Main bundle package */
  bundle: CSpellBundle;
  /** Package categories */
  categories: {
    naturalLanguages: string[];
    programmingLanguages: string[];
    technologies: string[];
    specialized: string[];
  };
}

/**
 * Package naming pattern: @cspell/dict-{name}
 * Configuration export: cspell-ext.json
 * Word files: dict/*.gz
 */
type DictionaryPackageName = `@cspell/dict-${string}`;
type ConfigurationFile = "cspell-ext.json";