code-languages 1.2.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 20 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
 
@@ -44,6 +44,7 @@ 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";
@@ -55,13 +56,18 @@ 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);
@@ -73,10 +79,14 @@ 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(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);
 ```
@@ -85,10 +95,13 @@ Import from the package root when bundle size is not a concern:
 
 ```ts
 import {
+  astro,
   bash,
   c,
   cpp,
   css,
+  detectLanguage,
+  detectLanguages,
   dockerfile,
   go,
   groovy,
@@ -98,14 +111,21 @@ import {
   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(cpp.website);
@@ -116,10 +136,14 @@ 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);
 ```
@@ -144,6 +168,11 @@ export interface Language {
   author: string;
   website: string;
   paradigms: string[];
+  tooling?: {
+    runtimes?: string[];
+    packageManagers?: string[];
+    ecosystems?: string[];
+  };
   version: string;
   logo: string;
   i18n: {
@@ -172,13 +201,24 @@ console.log(language.resolvedLocale); // "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`, `.hpp`, `.hh`, `.hxx` | `C++23` | `code-languages/cpp` |
+| 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` |
@@ -188,6 +228,7 @@ console.log(language.resolvedLocale); // "es"
 | 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` |
@@ -195,6 +236,9 @@ console.log(language.resolvedLocale); // "es"
 | 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