code-languages 1.1.0 → 1.2.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 20 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,83 @@ console.log(typescript.paradigms);
 Import multiple languages:
 
 ```ts
+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 { python } from "code-languages/python";
 import { json } from "code-languages/json";
+import { sql } from "code-languages/sql";
+import { swift } from "code-languages/swift";
+import { xml } from "code-languages/xml";
 import { yaml } from "code-languages/yaml";
 
+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(python.publishedDate);
-console.log(json.description);
+console.log(json.i18n.en.description);
+console.log(sql.i18n.en.name);
+console.log(swift.version);
+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 {
+  bash,
+  c,
+  cpp,
+  css,
+  dockerfile,
+  go,
+  groovy,
+  html,
+  java,
+  json,
+  kotlin,
+  localizeLanguage,
+  markdown,
+  rust,
+  sql,
+  swift,
+  typescript,
+  xml,
+  yaml,
+} from "code-languages";
+
+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(go.logo);
 console.log(json.website);
+console.log(sql.extensions);
+console.log(swift.i18n.en.description);
+console.log(localizeLanguage(xml, "es").name);
 console.log(yaml.paradigms);
 ```
 
@@ -81,11 +129,16 @@ 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;
@@ -93,21 +146,52 @@ export interface Language {
   paradigms: 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`.
+
 ## Supported Languages
 
 | Language | Slug | Extensions | Version | Import |
 |---|---|---|---|---|
+| 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` |
+| 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` |
 | 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` |

package/dist/i18n-BXk47f_R.d.cts

@@ -0,0 +1,45 @@
+type BaseLocale = "en" | "es";
+type Locale = BaseLocale | `${BaseLocale}-${string}` | (string & {});
+interface LanguageContent {
+    /** Display name. e.g. "TypeScript" */
+    name: string;
+    /** One-line summary, max 160 characters. */
+    description: string;
+    /** Rich multi-paragraph description in plain text. */
+    longDescription: string;
+}
+type LanguageTranslations = {
+    en: LanguageContent;
+} & Partial<Record<BaseLocale, LanguageContent>>;
+interface Language {
+    /** URL-safe identifier. e.g. "typescript" */
+    slug: string;
+    /** ISO 8601 date of first public release. e.g. "2012-10-01" */
+    publishedDate: string;
+    /** All file extensions associated with the language. e.g. [".ts", ".tsx"] */
+    extensions: string[];
+    /** Original author or organization. e.g. "Anders Hejlsberg / Microsoft" */
+    author: string;
+    /** Official website URL. e.g. "https://www.typescriptlang.org" */
+    website: string;
+    /** Programming paradigms. e.g. ["object-oriented", "functional", "imperative"] */
+    paradigms: string[];
+    /** Latest stable version at time of last data update. e.g. "5.4.5" */
+    version: string;
+    /** URL to the official language logo or icon. */
+    logo: string;
+    /** Localized display content. English is required as the fallback locale. */
+    i18n: LanguageTranslations;
+}
+type LocalizedLanguage = Omit<Language, "i18n"> & LanguageContent & {
+    /** Locale requested by the caller. */
+    locale: Locale;
+    /** Translation locale actually used after exact, base-language, and English fallback resolution. */
+    resolvedLocale: BaseLocale;
+    /** Base locales available for this language. */
+    availableLocales: BaseLocale[];
+};
+
+declare const localizeLanguage: (language: Language, locale?: Locale) => LocalizedLanguage;
+
+export { type Language as L, type LanguageContent as a, type LanguageTranslations as b, type Locale as c, type LocalizedLanguage as d, localizeLanguage as l };

package/dist/i18n-BXk47f_R.d.ts

@@ -0,0 +1,45 @@
+type BaseLocale = "en" | "es";
+type Locale = BaseLocale | `${BaseLocale}-${string}` | (string & {});
+interface LanguageContent {
+    /** Display name. e.g. "TypeScript" */
+    name: string;
+    /** One-line summary, max 160 characters. */
+    description: string;
+    /** Rich multi-paragraph description in plain text. */
+    longDescription: string;
+}
+type LanguageTranslations = {
+    en: LanguageContent;
+} & Partial<Record<BaseLocale, LanguageContent>>;
+interface Language {
+    /** URL-safe identifier. e.g. "typescript" */
+    slug: string;
+    /** ISO 8601 date of first public release. e.g. "2012-10-01" */
+    publishedDate: string;
+    /** All file extensions associated with the language. e.g. [".ts", ".tsx"] */
+    extensions: string[];
+    /** Original author or organization. e.g. "Anders Hejlsberg / Microsoft" */
+    author: string;
+    /** Official website URL. e.g. "https://www.typescriptlang.org" */
+    website: string;
+    /** Programming paradigms. e.g. ["object-oriented", "functional", "imperative"] */
+    paradigms: string[];
+    /** Latest stable version at time of last data update. e.g. "5.4.5" */
+    version: string;
+    /** URL to the official language logo or icon. */
+    logo: string;
+    /** Localized display content. English is required as the fallback locale. */
+    i18n: LanguageTranslations;
+}
+type LocalizedLanguage = Omit<Language, "i18n"> & LanguageContent & {
+    /** Locale requested by the caller. */
+    locale: Locale;
+    /** Translation locale actually used after exact, base-language, and English fallback resolution. */
+    resolvedLocale: BaseLocale;
+    /** Base locales available for this language. */
+    availableLocales: BaseLocale[];
+};
+
+declare const localizeLanguage: (language: Language, locale?: Locale) => LocalizedLanguage;
+
+export { type Language as L, type LanguageContent as a, type LanguageTranslations as b, type Locale as c, type LocalizedLanguage as d, localizeLanguage as l };

package/dist/i18n.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+// src/i18n.ts
+var localizeLanguage = (language, locale = "en") => {
+  const { i18n, ...metadata } = language;
+  const resolvedLocale = resolveLocale(i18n, locale);
+  const content = i18n[resolvedLocale] ?? i18n.en;
+  return {
+    ...metadata,
+    ...content,
+    locale,
+    resolvedLocale,
+    availableLocales: Object.keys(i18n)
+  };
+};
+var resolveLocale = (translations, locale) => {
+  const normalizedLocale = locale.toLowerCase();
+  const exactLocale = normalizedLocale;
+  if (translations[exactLocale]) {
+    return exactLocale;
+  }
+  const baseLocale = normalizedLocale.split("-")[0];
+  if (translations[baseLocale]) {
+    return baseLocale;
+  }
+  return "en";
+};
+
+exports.localizeLanguage = localizeLanguage;
+//# sourceMappingURL=i18n.cjs.map
+//# sourceMappingURL=i18n.cjs.map

package/dist/i18n.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n.ts"],"names":[],"mappings":";;;AAEO,IAAM,gBAAA,GAAmB,CAAC,QAAA,EAAoB,MAAA,GAAiB,IAAA,KAA4B;AAChG,EAAA,MAAM,EAAE,IAAA,EAAM,GAAG,QAAA,EAAS,GAAI,QAAA;AAC9B,EAAA,MAAM,cAAA,GAAiB,aAAA,CAAc,IAAA,EAAM,MAAM,CAAA;AACjD,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,cAAc,CAAA,IAAK,IAAA,CAAK,EAAA;AAE7C,EAAA,OAAO;AAAA,IACL,GAAG,QAAA;AAAA,IACH,GAAG,OAAA;AAAA,IACH,MAAA;AAAA,IACA,cAAA;AAAA,IACA,gBAAA,EAAkB,MAAA,CAAO,IAAA,CAAK,IAAI;AAAA,GACpC;AACF;AAEA,IAAM,aAAA,GAAgB,CAAC,YAAA,EAAgC,MAAA,KAA+B;AACpF,EAAA,MAAM,gBAAA,GAAmB,OAAO,WAAA,EAAY;AAC5C,EAAA,MAAM,WAAA,GAAc,gBAAA;AAEpB,EAAA,IAAI,YAAA,CAAa,WAAW,CAAA,EAAG;AAC7B,IAAA,OAAO,WAAA;AAAA,EACT;AAEA,EAAA,MAAM,UAAA,GAAa,gBAAA,CAAiB,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AAEhD,EAAA,IAAI,YAAA,CAAa,UAAU,CAAA,EAAG;AAC5B,IAAA,OAAO,UAAA;AAAA,EACT;AAEA,EAAA,OAAO,IAAA;AACT,CAAA","file":"i18n.cjs","sourcesContent":["import type { BaseLocale, Language, Locale, LocalizedLanguage } from \"./types\";\n\nexport const localizeLanguage = (language: Language, locale: Locale = \"en\"): LocalizedLanguage => {\n  const { i18n, ...metadata } = language;\n  const resolvedLocale = resolveLocale(i18n, locale);\n  const content = i18n[resolvedLocale] ?? i18n.en;\n\n  return {\n    ...metadata,\n    ...content,\n    locale,\n    resolvedLocale,\n    availableLocales: Object.keys(i18n) as BaseLocale[],\n  };\n};\n\nconst resolveLocale = (translations: Language[\"i18n\"], locale: Locale): BaseLocale => {\n  const normalizedLocale = locale.toLowerCase();\n  const exactLocale = normalizedLocale as BaseLocale;\n\n  if (translations[exactLocale]) {\n    return exactLocale;\n  }\n\n  const baseLocale = normalizedLocale.split(\"-\")[0] as BaseLocale;\n\n  if (translations[baseLocale]) {\n    return baseLocale;\n  }\n\n  return \"en\";\n};\n"]}

package/dist/i18n.d.cts

@@ -0,0 +1 @@
+export { l as localizeLanguage } from './i18n-BXk47f_R.cjs';

package/dist/i18n.d.ts

@@ -0,0 +1 @@
+export { l as localizeLanguage } from './i18n-BXk47f_R.js';

package/dist/i18n.js

@@ -0,0 +1,29 @@
+// src/i18n.ts
+var localizeLanguage = (language, locale = "en") => {
+  const { i18n, ...metadata } = language;
+  const resolvedLocale = resolveLocale(i18n, locale);
+  const content = i18n[resolvedLocale] ?? i18n.en;
+  return {
+    ...metadata,
+    ...content,
+    locale,
+    resolvedLocale,
+    availableLocales: Object.keys(i18n)
+  };
+};
+var resolveLocale = (translations, locale) => {
+  const normalizedLocale = locale.toLowerCase();
+  const exactLocale = normalizedLocale;
+  if (translations[exactLocale]) {
+    return exactLocale;
+  }
+  const baseLocale = normalizedLocale.split("-")[0];
+  if (translations[baseLocale]) {
+    return baseLocale;
+  }
+  return "en";
+};
+
+export { localizeLanguage };
+//# sourceMappingURL=i18n.js.map
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n.ts"],"names":[],"mappings":";AAEO,IAAM,gBAAA,GAAmB,CAAC,QAAA,EAAoB,MAAA,GAAiB,IAAA,KAA4B;AAChG,EAAA,MAAM,EAAE,IAAA,EAAM,GAAG,QAAA,EAAS,GAAI,QAAA;AAC9B,EAAA,MAAM,cAAA,GAAiB,aAAA,CAAc,IAAA,EAAM,MAAM,CAAA;AACjD,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,cAAc,CAAA,IAAK,IAAA,CAAK,EAAA;AAE7C,EAAA,OAAO;AAAA,IACL,GAAG,QAAA;AAAA,IACH,GAAG,OAAA;AAAA,IACH,MAAA;AAAA,IACA,cAAA;AAAA,IACA,gBAAA,EAAkB,MAAA,CAAO,IAAA,CAAK,IAAI;AAAA,GACpC;AACF;AAEA,IAAM,aAAA,GAAgB,CAAC,YAAA,EAAgC,MAAA,KAA+B;AACpF,EAAA,MAAM,gBAAA,GAAmB,OAAO,WAAA,EAAY;AAC5C,EAAA,MAAM,WAAA,GAAc,gBAAA;AAEpB,EAAA,IAAI,YAAA,CAAa,WAAW,CAAA,EAAG;AAC7B,IAAA,OAAO,WAAA;AAAA,EACT;AAEA,EAAA,MAAM,UAAA,GAAa,gBAAA,CAAiB,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AAEhD,EAAA,IAAI,YAAA,CAAa,UAAU,CAAA,EAAG;AAC5B,IAAA,OAAO,UAAA;AAAA,EACT;AAEA,EAAA,OAAO,IAAA;AACT,CAAA","file":"i18n.js","sourcesContent":["import type { BaseLocale, Language, Locale, LocalizedLanguage } from \"./types\";\n\nexport const localizeLanguage = (language: Language, locale: Locale = \"en\"): LocalizedLanguage => {\n  const { i18n, ...metadata } = language;\n  const resolvedLocale = resolveLocale(i18n, locale);\n  const content = i18n[resolvedLocale] ?? i18n.en;\n\n  return {\n    ...metadata,\n    ...content,\n    locale,\n    resolvedLocale,\n    availableLocales: Object.keys(i18n) as BaseLocale[],\n  };\n};\n\nconst resolveLocale = (translations: Language[\"i18n\"], locale: Locale): BaseLocale => {\n  const normalizedLocale = locale.toLowerCase();\n  const exactLocale = normalizedLocale as BaseLocale;\n\n  if (translations[exactLocale]) {\n    return exactLocale;\n  }\n\n  const baseLocale = normalizedLocale.split(\"-\")[0] as BaseLocale;\n\n  if (translations[baseLocale]) {\n    return baseLocale;\n  }\n\n  return \"en\";\n};\n"]}