code-languages 1.22.0 → 1.24.0

package/README.md

@@ -9,7 +9,7 @@
 
 Structured metadata for programming languages, packaged as a typed, tree-shakeable TypeScript library.
 
-`code-languages` is useful when you need a small source of truth for language names, slugs, file extensions, release metadata, websites, paradigms, and logos in developer tools, docs sites, learning platforms, or editor-like interfaces.
+`code-languages` is useful when you need a small source of truth for language names, slugs, file extensions, release metadata, websites, paradigms, logos, and reference colors in developer tools, docs sites, learning platforms, or editor-like interfaces.
 
 ## Features
 
@@ -18,6 +18,7 @@ Structured metadata for programming languages, packaged as a typed, tree-shakeab
 - ESM and CommonJS builds
 - Subpath imports for per-language usage
 - Tree-shakeable exports
+- Localized content in English, Spanish, Italian, and French
 - Works in Node.js and modern bundlers
 
 ## Installation
@@ -706,7 +707,8 @@ console.log(zsh.version);
 Every language object satisfies the `Language` interface:
 
 ```ts
-export type Locale = "en" | "es" | `en-${string}` | `es-${string}` | string;
+export type BaseLocale = "en" | "es" | "it" | "fr";
+export type Locale = BaseLocale | `${BaseLocale}-${string}` | string;
 
 export interface LanguageContent {
   name: string;
@@ -728,9 +730,12 @@ export interface Language {
   };
   version: string;
   logo: string;
+  color: `#${string}`;
   i18n: {
     en: LanguageContent;
     es?: LanguageContent;
+    it?: LanguageContent;
+    fr?: LanguageContent;
   };
 }
 ```
@@ -752,6 +757,10 @@ console.log(detected?.name); // "Vue"
 console.log(ambiguous.map((language) => language.slug)); // ["c", "cpp"]
 ```
 
+`api.language(...)` normalizes lookup values to the package slug format, so inputs
+such as `"Visual Basic"` and `"Jupyter Notebook!"` resolve to `visual-basic` and
+`jupyter-notebook`.
+
 `get()` reads from the bundled in-memory catalog. `load()` uses explicit dynamic
 imports so bundlers can lazy-load individual language modules when the consumer
 build supports code splitting.
@@ -773,7 +782,11 @@ console.log(language.resolvedLocale); // "es"
 
 1. Exact locale, for example `es`.
 2. Base language from a regional locale, for example `es-PE` -> `es`.
-3. English fallback, for example `fr-FR` -> `en`.
+3. English fallback, for example `de-DE` -> `en`.
+
+English, Spanish, Italian, and French are supported base locales. The current Italian
+and French translations were initially generated with `translategemma:4b`; translation
+reviews and corrections are welcome.
 
 Use `detectLanguage` or `detectLanguages` to infer languages from filenames:
 
@@ -787,6 +800,9 @@ console.log(detectLanguages("include/config.h").map((language) => language.slug)
 
 ## Supported Languages
 
+The catalog currently includes 172 language entries. Each row can be imported directly
+from its package subpath.
+
 | Logo | Language | Slug | Extensions | Version | Import |
 |---|---|---|---|---|---|
 | <img src="https://upload.wikimedia.org/wikipedia/commons/5/59/SAP_2011_logo.svg" alt="ABAP logo" width="24" height="24"> | ABAP | `abap` | `.abap` | `ABAP Platform 2025 FPS01` | `code-languages/abap` |