code-languages 1.1.0 → 1.3.0

package/README.md

@@ -8,7 +8,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. It currently includes metadata for 12 languages.
+`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. It currently includes metadata for 25 languages.
 
 ## Features
 
@@ -31,8 +31,12 @@ Import only the language metadata you need:
 
 ```ts
 import { typescript } from "code-languages/typescript";
+import { localizeLanguage } from "code-languages/i18n";
 
-console.log(typescript.name);
+const localized = localizeLanguage(typescript, "en");
+
+console.log(localized.name);
+console.log(localized.description);
 console.log(typescript.extensions);
 console.log(typescript.paradigms);
 ```
@@ -40,39 +44,107 @@ console.log(typescript.paradigms);
 Import multiple languages:
 
 ```ts
+import { astro } from "code-languages/astro";
+import { bash } from "code-languages/bash";
 import { c } from "code-languages/c";
+import { cpp } from "code-languages/cpp";
 import { css } from "code-languages/css";
+import { dockerfile } from "code-languages/dockerfile";
+import { groovy } from "code-languages/groovy";
 import { javascript } from "code-languages/javascript";
 import { java } from "code-languages/java";
 import { html } from "code-languages/html";
+import { kotlin } from "code-languages/kotlin";
 import { markdown } from "code-languages/markdown";
+import { php } from "code-languages/php";
 import { python } from "code-languages/python";
+import { scss } from "code-languages/scss";
 import { json } from "code-languages/json";
+import { sql } from "code-languages/sql";
+import { swift } from "code-languages/swift";
+import { vue } from "code-languages/vue";
+import { webassembly } from "code-languages/webassembly";
+import { xml } from "code-languages/xml";
 import { yaml } from "code-languages/yaml";
 
+console.log(astro.version);
+console.log(bash.version);
 console.log(c.extensions);
+console.log(cpp.i18n.en.name);
 console.log(css.paradigms);
+console.log(dockerfile.i18n.en.name);
+console.log(groovy.version);
 console.log(javascript.website);
 console.log(java.version);
 console.log(html.extensions);
+console.log(kotlin.version);
 console.log(markdown.website);
+console.log(php.version);
 console.log(python.publishedDate);
-console.log(json.description);
+console.log(scss.extensions);
+console.log(json.i18n.en.description);
+console.log(sql.i18n.en.name);
+console.log(swift.version);
+console.log(vue.website);
+console.log(webassembly.extensions);
+console.log(xml.extensions);
 console.log(yaml.version);
 ```
 
 Import from the package root when bundle size is not a concern:
 
 ```ts
-import { c, css, go, html, java, json, markdown, rust, typescript, yaml } from "code-languages";
+import {
+  astro,
+  bash,
+  c,
+  cpp,
+  css,
+  detectLanguage,
+  detectLanguages,
+  dockerfile,
+  go,
+  groovy,
+  html,
+  java,
+  json,
+  kotlin,
+  localizeLanguage,
+  markdown,
+  php,
+  rust,
+  scss,
+  sql,
+  swift,
+  typescript,
+  vue,
+  webassembly,
+  xml,
+  yaml,
+} from "code-languages";
 
+console.log(localizeLanguage(astro, "es").description);
+console.log(detectLanguage("src/index.ts")?.slug);
+console.log(detectLanguages("include/config.h").map((language) => language.slug));
+console.log(localizeLanguage(bash, "es").description);
 console.log(c.version);
-console.log(css.name);
-console.log(java.name);
+console.log(cpp.website);
+console.log(localizeLanguage(css).name);
+console.log(dockerfile.website);
+console.log(localizeLanguage(groovy).description);
+console.log(localizeLanguage(java).name);
 console.log(html.website);
+console.log(localizeLanguage(kotlin, "es-PE").description);
 console.log(markdown.extensions);
+console.log(localizeLanguage(php, "es").description);
 console.log(go.logo);
+console.log(localizeLanguage(scss).name);
 console.log(json.website);
+console.log(sql.extensions);
+console.log(swift.i18n.en.description);
+console.log(localizeLanguage(vue, "es").description);
+console.log(localizeLanguage(webassembly).name);
+console.log(localizeLanguage(xml, "es").name);
 console.log(yaml.paradigms);
 ```
 
@@ -81,36 +153,92 @@ console.log(yaml.paradigms);
 Every language object satisfies the `Language` interface:
 
 ```ts
-export interface Language {
+export type Locale = "en" | "es";
+
+export interface LanguageContent {
   name: string;
-  slug: string;
   description: string;
   longDescription: string;
+}
+
+export interface Language {
+  slug: string;
   publishedDate: string;
   extensions: string[];
   author: string;
   website: string;
   paradigms: string[];
+  tooling?: {
+    runtimes?: string[];
+    packageManagers?: string[];
+    ecosystems?: string[];
+  };
   version: string;
   logo: string;
+  i18n: {
+    en: LanguageContent;
+    es?: LanguageContent;
+  };
 }
 ```
 
+Use `localizeLanguage` to read localized display content with English fallback:
+
+```ts
+import { json } from "code-languages/json";
+import { localizeLanguage } from "code-languages/i18n";
+
+const language = localizeLanguage(json, "es-PE");
+
+console.log(language.name);
+console.log(language.longDescription);
+console.log(language.resolvedLocale); // "es"
+```
+
+`localizeLanguage` resolves locales in this order:
+
+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`.
+
+Use `detectLanguage` or `detectLanguages` to infer languages from filenames:
+
+```ts
+import { detectLanguage, detectLanguages } from "code-languages/detect";
+
+console.log(detectLanguage("src/index.ts")?.slug); // "typescript"
+console.log(detectLanguage("Dockerfile")?.slug); // "dockerfile"
+console.log(detectLanguages("include/config.h").map((language) => language.slug)); // ["c", "cpp"]
+```
+
 ## Supported Languages
 
 | Language | Slug | Extensions | Version | Import |
 |---|---|---|---|---|
+| Astro | `astro` | `.astro` | `6.3.1` | `code-languages/astro` |
+| Bash | `bash` | `.sh`, `.bash`, `.bashrc`, `.bash_profile`, `.bash_login`, `.profile` | `5.3` | `code-languages/bash` |
 | C | `c` | `.c`, `.h` | `C23` | `code-languages/c` |
+| C++ | `cpp` | `.cpp`, `.cc`, `.cxx`, `.h`, `.hpp`, `.hh`, `.hxx` | `C++23` | `code-languages/cpp` |
+| Dockerfile | `dockerfile` | `Dockerfile`, `.dockerfile` | `1.10` | `code-languages/dockerfile` |
+| Groovy | `groovy` | `.groovy`, `.gvy`, `.gy`, `.gsh` | `5.0.5` | `code-languages/groovy` |
 | TypeScript | `typescript` | `.ts`, `.tsx`, `.mts`, `.cts` | `6.0` | `code-languages/typescript` |
 | JavaScript | `javascript` | `.js`, `.mjs`, `.cjs`, `.jsx` | `ECMAScript 2025` | `code-languages/javascript` |
 | JSON | `json` | `.json` | `RFC 8259` | `code-languages/json` |
+| SQL | `sql` | `.sql` | `SQL:2023` | `code-languages/sql` |
 | Java | `java` | `.java` | `26` | `code-languages/java` |
+| Swift | `swift` | `.swift` | `6.2.2` | `code-languages/swift` |
+| Kotlin | `kotlin` | `.kt`, `.kts` | `2.3.20` | `code-languages/kotlin` |
+| PHP | `php` | `.php`, `.phtml`, `.php3`, `.php4`, `.php5`, `.phps` | `8.5.6` | `code-languages/php` |
 | HTML | `html` | `.html`, `.htm` | `Living Standard` | `code-languages/html` |
 | CSS | `css` | `.css` | `Living Standard` | `code-languages/css` |
 | Markdown | `markdown` | `.md`, `.markdown`, `.mdown`, `.mkd` | `CommonMark 0.31.2` | `code-languages/markdown` |
+| XML | `xml` | `.xml`, `.xsd`, `.xsl`, `.xslt` | `XML 1.0 Fifth Edition` | `code-languages/xml` |
 | YAML | `yaml` | `.yaml`, `.yml` | `1.2.2` | `code-languages/yaml` |
 | Python | `python` | `.py`, `.pyw` | `3.14.4` | `code-languages/python` |
 | Rust | `rust` | `.rs` | `1.95.0` | `code-languages/rust` |
+| Sass | `scss` | `.scss`, `.sass` | `1.99.0` | `code-languages/scss` |
+| Vue | `vue` | `.vue` | `3.5.34` | `code-languages/vue` |
+| WebAssembly | `webassembly` | `.wasm`, `.wat` | `3.0` | `code-languages/webassembly` |
 | Go | `go` | `.go` | `1.26.3` | `code-languages/go` |
 
 ## Development