code-languages 1.38.0 → 1.39.0

package/README.md

@@ -199,6 +199,45 @@ Supported package manager aliases include: `npm`, `pnpm`, `yarn`, `pip`, `poetry
 `cargo`, `maven`, `gradle`, `nuget`, `composer`, `hex`, `spm`, `rubygems`, `go-mod`,
 `luarocks`, `opam`, `cpan`, and more. Searches `tooling.packageManagers` on each language.
 
+Use `api.category(value)` to filter languages by their domain of use:
+
+```ts
+import { api, getCategories } from "code-languages";
+
+// frontend  — targets the browser only (CSS, HTML, WGSL…)
+api.category('frontend').langs().get();
+
+// backend   — runs on a server runtime (Python, Go, Ruby, PHP, Java, C#…)
+api.category('backend').langs().locale('es').get();
+
+// fullstack — targets both browser and server (JavaScript, TypeScript…)
+api.category('fullstack').langs().get();
+
+// systems   — low-level / native / embedded (C, C++, Rust, Zig…)
+api.category('systems').langs().get();
+
+// data-science — data, ML, scientific computing (R, Julia, Python…)
+api.category('data-science').langs().locale('pt').get();
+
+// scripting — shell and scripting languages (Bash, Zsh, PowerShell…)
+api.category('scripting').langs().get();
+
+// other     — everything that does not match any of the above
+api.category('other').langs().get();
+
+// async load and locale chaining work the same as other collection methods
+await api.category('backend').langs().locale('pt').load();
+
+// list all available categories
+getCategories();
+// → ['frontend', 'backend', 'fullstack', 'systems', 'data-science', 'scripting', 'other']
+```
+
+Categories are inferred from each language's `tooling.runtimes` and `tooling.ecosystems` —
+no extra data is needed in individual language files.  
+`frontend`, `backend`, and `fullstack` are mutually exclusive; the remaining categories
+can overlap (Python appears in both `backend` and `data-science`).
+
 Use `localizeLanguage` to read localized display content with English fallback:
 
 ```ts

package/dist/{api-CjNcbLKv.d.cts → api-C-SCQpIV.d.cts}

@@ -1,6 +1,9 @@
 import { L as LanguageSlug } from './registry-p4uQJ2gP.cjs';
 import { d as Locale, e as LocalizedLanguage } from './types-B0_wjl_Q.cjs';
 
+type LanguageCategory = 'frontend' | 'backend' | 'fullstack' | 'systems' | 'data-science' | 'scripting' | 'other';
+declare function getCategories(): LanguageCategory[];
+
 interface PackageManagerInfo {
     slug: string;
     name: string;
@@ -57,6 +60,10 @@ interface PackageManagerRequest {
     /** Runtime platforms that include this package manager. */
     runtimes(): RuntimeInfo[];
 }
+interface CategoryRequest {
+    /** Languages that belong to this category. */
+    langs(): LanguageCollectionRequest;
+}
 interface LanguageCollectionRequest {
     /**
      * Sets the requested locale for every language returned by this collection lookup.
@@ -123,6 +130,25 @@ declare const api: {
      * api.packageManager('npm').runtimes();
      */
     packageManager(value: string): PackageManagerRequest;
+    /**
+     * Selects every language that belongs to the given category.
+     *
+     * Categories are inferred from each language's `tooling.runtimes` and `tooling.ecosystems`:
+     * - `frontend`    — targets the browser only (CSS, HTML, GLSL…)
+     * - `backend`     — runs on a server runtime (Python, Go, Ruby, PHP…)
+     * - `fullstack`   — targets both browser and server (JavaScript, TypeScript…)
+     * - `systems`     — low-level / native / embedded (C, C++, Rust, Zig…)
+     * - `data-science`— data, ML, scientific computing (R, Julia, MATLAB…)
+     * - `scripting`   — shell and scripting languages (Bash, Zsh, PowerShell…)
+     * - `other`       — everything that does not match any of the above
+     *
+     * Categories are not mutually exclusive: Python appears in both `backend` and `data-science`.
+     *
+     * @example
+     * api.category('backend').langs().locale('es').get();
+     * await api.category('data-science').langs().load();
+     */
+    category(value: LanguageCategory): CategoryRequest;
     /**
      * Detects every matching language for a filename or path.
      *
@@ -131,4 +157,4 @@ declare const api: {
     detectAll(filename: string): LanguageCollectionRequest;
 };
 
-export { type LanguageCollectionRequest as L, type PackageManagerInfo as P, type RuntimeInfo as R, api as a, getRuntimes as b, type LanguageRequest as c, type PackageManagerRequest as d, type RuntimeRequest as e, getPackageManagers as g };
+export { type CategoryRequest as C, type LanguageCategory as L, type PackageManagerInfo as P, type RuntimeInfo as R, api as a, getPackageManagers as b, getRuntimes as c, type LanguageCollectionRequest as d, type LanguageRequest as e, type PackageManagerRequest as f, getCategories as g, type RuntimeRequest as h };

package/dist/{api-u3GKPoGq.d.ts → api-EZK9DmOV.d.ts}

@@ -1,6 +1,9 @@
 import { L as LanguageSlug } from './registry-p4uQJ2gP.js';
 import { d as Locale, e as LocalizedLanguage } from './types-B0_wjl_Q.js';
 
+type LanguageCategory = 'frontend' | 'backend' | 'fullstack' | 'systems' | 'data-science' | 'scripting' | 'other';
+declare function getCategories(): LanguageCategory[];
+
 interface PackageManagerInfo {
     slug: string;
     name: string;
@@ -57,6 +60,10 @@ interface PackageManagerRequest {
     /** Runtime platforms that include this package manager. */
     runtimes(): RuntimeInfo[];
 }
+interface CategoryRequest {
+    /** Languages that belong to this category. */
+    langs(): LanguageCollectionRequest;
+}
 interface LanguageCollectionRequest {
     /**
      * Sets the requested locale for every language returned by this collection lookup.
@@ -123,6 +130,25 @@ declare const api: {
      * api.packageManager('npm').runtimes();
      */
     packageManager(value: string): PackageManagerRequest;
+    /**
+     * Selects every language that belongs to the given category.
+     *
+     * Categories are inferred from each language's `tooling.runtimes` and `tooling.ecosystems`:
+     * - `frontend`    — targets the browser only (CSS, HTML, GLSL…)
+     * - `backend`     — runs on a server runtime (Python, Go, Ruby, PHP…)
+     * - `fullstack`   — targets both browser and server (JavaScript, TypeScript…)
+     * - `systems`     — low-level / native / embedded (C, C++, Rust, Zig…)
+     * - `data-science`— data, ML, scientific computing (R, Julia, MATLAB…)
+     * - `scripting`   — shell and scripting languages (Bash, Zsh, PowerShell…)
+     * - `other`       — everything that does not match any of the above
+     *
+     * Categories are not mutually exclusive: Python appears in both `backend` and `data-science`.
+     *
+     * @example
+     * api.category('backend').langs().locale('es').get();
+     * await api.category('data-science').langs().load();
+     */
+    category(value: LanguageCategory): CategoryRequest;
     /**
      * Detects every matching language for a filename or path.
      *
@@ -131,4 +157,4 @@ declare const api: {
     detectAll(filename: string): LanguageCollectionRequest;
 };
 
-export { type LanguageCollectionRequest as L, type PackageManagerInfo as P, type RuntimeInfo as R, api as a, getRuntimes as b, type LanguageRequest as c, type PackageManagerRequest as d, type RuntimeRequest as e, getPackageManagers as g };
+export { type CategoryRequest as C, type LanguageCategory as L, type PackageManagerInfo as P, type RuntimeInfo as R, api as a, getPackageManagers as b, getRuntimes as c, type LanguageCollectionRequest as d, type LanguageRequest as e, type PackageManagerRequest as f, getCategories as g, type RuntimeRequest as h };

package/dist/api.cjs

@@ -16722,6 +16722,77 @@ var init_zsh = __esm({
   }
 });
 
+// src/domain/category/registry.ts
+var BROWSER_TARGETS = ["Browser"];
+var SERVER_TARGETS = [
+  "Node.js",
+  "Deno",
+  "Bun",
+  "CPython",
+  "PyPy",
+  "JVM",
+  "BEAM",
+  "Erlang/OTP",
+  "Ruby MRI",
+  "JRuby",
+  "TruffleRuby",
+  "Go runtime",
+  "PHP",
+  ".NET",
+  "Mono"
+];
+var SYSTEMS_TARGETS = [
+  "Systems",
+  "Systems Programming",
+  "Embedded",
+  "Native",
+  "LLVM",
+  "Firmware",
+  "Linux Kernel",
+  "Microcontroller"
+];
+var DATA_TARGETS = [
+  "Data Science",
+  "Machine Learning",
+  "Scientific Computing",
+  "Statistics",
+  "Bioinformatics",
+  "HPC",
+  "Numerical Computing"
+];
+var SCRIPT_TARGETS = ["shell", "PowerShell", "Scripting"];
+function poolMatches(pool, targets) {
+  return targets.some((t) => pool.some((s) => s.toLowerCase().includes(t.toLowerCase())));
+}
+function hasBrowser(lang) {
+  return poolMatches(lang.tooling?.runtimes ?? [], BROWSER_TARGETS);
+}
+function hasServer(lang) {
+  const pool = [...lang.tooling?.runtimes ?? [], ...lang.tooling?.ecosystems ?? []];
+  return poolMatches(pool, SERVER_TARGETS);
+}
+function matchesCategory(lang, category) {
+  const browser = hasBrowser(lang);
+  const server = hasServer(lang);
+  const pool = [...lang.tooling?.runtimes ?? [], ...lang.tooling?.ecosystems ?? []];
+  switch (category) {
+    case "frontend":
+      return browser && !server;
+    case "backend":
+      return server && !browser;
+    case "fullstack":
+      return browser && server;
+    case "systems":
+      return poolMatches(pool, SYSTEMS_TARGETS);
+    case "data-science":
+      return poolMatches(pool, DATA_TARGETS);
+    case "scripting":
+      return poolMatches(pool, SCRIPT_TARGETS);
+    case "other":
+      return !browser && !server && !poolMatches(pool, SYSTEMS_TARGETS) && !poolMatches(pool, DATA_TARGETS) && !poolMatches(pool, SCRIPT_TARGETS);
+  }
+}
+
 // src/domain/language/registry.ts
 var languageIndex = [
   { slug: "abap", extensions: [".abap"] },
@@ -17321,7 +17392,10 @@ var loadLanguage = (slug) => languageLoaders[slug]?.();
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
-var getBasename = (filename) => filename.trim().split(pathSegmentPattern).at(-1)?.toLowerCase() ?? "";
+var getBasename = (filename) => {
+  const parts = filename.trim().split(pathSegmentPattern);
+  return parts.at(-1).toLowerCase();
+};
 var matchesExtension = (basename, extension) => {
   const normalizedExtension = extension.toLowerCase();
   if (normalizedExtension.startsWith(".")) {
@@ -18829,6 +18903,35 @@ var api = {
       }
     };
   },
+  /**
+   * Selects every language that belongs to the given category.
+   *
+   * Categories are inferred from each language's `tooling.runtimes` and `tooling.ecosystems`:
+   * - `frontend`    — targets the browser only (CSS, HTML, GLSL…)
+   * - `backend`     — runs on a server runtime (Python, Go, Ruby, PHP…)
+   * - `fullstack`   — targets both browser and server (JavaScript, TypeScript…)
+   * - `systems`     — low-level / native / embedded (C, C++, Rust, Zig…)
+   * - `data-science`— data, ML, scientific computing (R, Julia, MATLAB…)
+   * - `scripting`   — shell and scripting languages (Bash, Zsh, PowerShell…)
+   * - `other`       — everything that does not match any of the above
+   *
+   * Categories are not mutually exclusive: Python appears in both `backend` and `data-science`.
+   *
+   * @example
+   * api.category('backend').langs().locale('es').get();
+   * await api.category('data-science').langs().load();
+   */
+  category(value) {
+    return {
+      langs() {
+        const filtered = () => languages.filter((lang) => matchesCategory(lang, value));
+        return createLanguageCollectionRequest(filtered, async () => {
+          const loaded = await Promise.all(filtered().map((lang) => loadLanguage(lang.slug)));
+          return loaded.filter((lang) => Boolean(lang));
+        });
+      }
+    };
+  },
   /**
    * Detects every matching language for a filename or path.
    *

package/dist/api.d.cts

@@ -1,3 +1,3 @@
+export { C as CategoryRequest, L as LanguageCategory, d as LanguageCollectionRequest, e as LanguageRequest, f as PackageManagerRequest, h as RuntimeRequest, a as api } from './api-C-SCQpIV.cjs';
 export { L as LanguageSlug } from './registry-p4uQJ2gP.cjs';
-export { L as LanguageCollectionRequest, c as LanguageRequest, d as PackageManagerRequest, e as RuntimeRequest, a as api } from './api-CjNcbLKv.cjs';
 import './types-B0_wjl_Q.cjs';

package/dist/api.d.ts

@@ -1,3 +1,3 @@
+export { C as CategoryRequest, L as LanguageCategory, d as LanguageCollectionRequest, e as LanguageRequest, f as PackageManagerRequest, h as RuntimeRequest, a as api } from './api-EZK9DmOV.js';
 export { L as LanguageSlug } from './registry-p4uQJ2gP.js';
-export { L as LanguageCollectionRequest, c as LanguageRequest, d as PackageManagerRequest, e as RuntimeRequest, a as api } from './api-u3GKPoGq.js';
 import './types-B0_wjl_Q.js';

package/dist/api.js

@@ -16720,6 +16720,77 @@ var init_zsh = __esm({
   }
 });
 
+// src/domain/category/registry.ts
+var BROWSER_TARGETS = ["Browser"];
+var SERVER_TARGETS = [
+  "Node.js",
+  "Deno",
+  "Bun",
+  "CPython",
+  "PyPy",
+  "JVM",
+  "BEAM",
+  "Erlang/OTP",
+  "Ruby MRI",
+  "JRuby",
+  "TruffleRuby",
+  "Go runtime",
+  "PHP",
+  ".NET",
+  "Mono"
+];
+var SYSTEMS_TARGETS = [
+  "Systems",
+  "Systems Programming",
+  "Embedded",
+  "Native",
+  "LLVM",
+  "Firmware",
+  "Linux Kernel",
+  "Microcontroller"
+];
+var DATA_TARGETS = [
+  "Data Science",
+  "Machine Learning",
+  "Scientific Computing",
+  "Statistics",
+  "Bioinformatics",
+  "HPC",
+  "Numerical Computing"
+];
+var SCRIPT_TARGETS = ["shell", "PowerShell", "Scripting"];
+function poolMatches(pool, targets) {
+  return targets.some((t) => pool.some((s) => s.toLowerCase().includes(t.toLowerCase())));
+}
+function hasBrowser(lang) {
+  return poolMatches(lang.tooling?.runtimes ?? [], BROWSER_TARGETS);
+}
+function hasServer(lang) {
+  const pool = [...lang.tooling?.runtimes ?? [], ...lang.tooling?.ecosystems ?? []];
+  return poolMatches(pool, SERVER_TARGETS);
+}
+function matchesCategory(lang, category) {
+  const browser = hasBrowser(lang);
+  const server = hasServer(lang);
+  const pool = [...lang.tooling?.runtimes ?? [], ...lang.tooling?.ecosystems ?? []];
+  switch (category) {
+    case "frontend":
+      return browser && !server;
+    case "backend":
+      return server && !browser;
+    case "fullstack":
+      return browser && server;
+    case "systems":
+      return poolMatches(pool, SYSTEMS_TARGETS);
+    case "data-science":
+      return poolMatches(pool, DATA_TARGETS);
+    case "scripting":
+      return poolMatches(pool, SCRIPT_TARGETS);
+    case "other":
+      return !browser && !server && !poolMatches(pool, SYSTEMS_TARGETS) && !poolMatches(pool, DATA_TARGETS) && !poolMatches(pool, SCRIPT_TARGETS);
+  }
+}
+
 // src/domain/language/registry.ts
 var languageIndex = [
   { slug: "abap", extensions: [".abap"] },
@@ -17319,7 +17390,10 @@ var loadLanguage = (slug) => languageLoaders[slug]?.();
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
-var getBasename = (filename) => filename.trim().split(pathSegmentPattern).at(-1)?.toLowerCase() ?? "";
+var getBasename = (filename) => {
+  const parts = filename.trim().split(pathSegmentPattern);
+  return parts.at(-1).toLowerCase();
+};
 var matchesExtension = (basename, extension) => {
   const normalizedExtension = extension.toLowerCase();
   if (normalizedExtension.startsWith(".")) {
@@ -18827,6 +18901,35 @@ var api = {
       }
     };
   },
+  /**
+   * Selects every language that belongs to the given category.
+   *
+   * Categories are inferred from each language's `tooling.runtimes` and `tooling.ecosystems`:
+   * - `frontend`    — targets the browser only (CSS, HTML, GLSL…)
+   * - `backend`     — runs on a server runtime (Python, Go, Ruby, PHP…)
+   * - `fullstack`   — targets both browser and server (JavaScript, TypeScript…)
+   * - `systems`     — low-level / native / embedded (C, C++, Rust, Zig…)
+   * - `data-science`— data, ML, scientific computing (R, Julia, MATLAB…)
+   * - `scripting`   — shell and scripting languages (Bash, Zsh, PowerShell…)
+   * - `other`       — everything that does not match any of the above
+   *
+   * Categories are not mutually exclusive: Python appears in both `backend` and `data-science`.
+   *
+   * @example
+   * api.category('backend').langs().locale('es').get();
+   * await api.category('data-science').langs().load();
+   */
+  category(value) {
+    return {
+      langs() {
+        const filtered = () => languages.filter((lang) => matchesCategory(lang, value));
+        return createLanguageCollectionRequest(filtered, async () => {
+          const loaded = await Promise.all(filtered().map((lang) => loadLanguage(lang.slug)));
+          return loaded.filter((lang) => Boolean(lang));
+        });
+      }
+    };
+  },
   /**
    * Detects every matching language for a filename or path.
    *

package/dist/detect-slugs.cjs

@@ -310,7 +310,10 @@ var languageIndex = [
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
-var getBasename = (filename) => filename.trim().split(pathSegmentPattern).at(-1)?.toLowerCase() ?? "";
+var getBasename = (filename) => {
+  const parts = filename.trim().split(pathSegmentPattern);
+  return parts.at(-1).toLowerCase();
+};
 var matchesExtension = (basename, extension) => {
   const normalizedExtension = extension.toLowerCase();
   if (normalizedExtension.startsWith(".")) {

package/dist/detect-slugs.js

@@ -308,7 +308,10 @@ var languageIndex = [
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
-var getBasename = (filename) => filename.trim().split(pathSegmentPattern).at(-1)?.toLowerCase() ?? "";
+var getBasename = (filename) => {
+  const parts = filename.trim().split(pathSegmentPattern);
+  return parts.at(-1).toLowerCase();
+};
 var matchesExtension = (basename, extension) => {
   const normalizedExtension = extension.toLowerCase();
   if (normalizedExtension.startsWith(".")) {

package/dist/detect.cjs

@@ -14430,7 +14430,10 @@ var languages = [
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
-var getBasename = (filename) => filename.trim().split(pathSegmentPattern).at(-1)?.toLowerCase() ?? "";
+var getBasename = (filename) => {
+  const parts = filename.trim().split(pathSegmentPattern);
+  return parts.at(-1).toLowerCase();
+};
 var matchesExtension = (basename, extension) => {
   const normalizedExtension = extension.toLowerCase();
   if (normalizedExtension.startsWith(".")) {

package/dist/detect.js

@@ -14428,7 +14428,10 @@ var languages = [
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
-var getBasename = (filename) => filename.trim().split(pathSegmentPattern).at(-1)?.toLowerCase() ?? "";
+var getBasename = (filename) => {
+  const parts = filename.trim().split(pathSegmentPattern);
+  return parts.at(-1).toLowerCase();
+};
 var matchesExtension = (basename, extension) => {
   const normalizedExtension = extension.toLowerCase();
   if (normalizedExtension.startsWith(".")) {

package/dist/index.cjs

@@ -16722,6 +16722,80 @@ var init_zsh = __esm({
   }
 });
 
+// src/domain/category/registry.ts
+var BROWSER_TARGETS = ["Browser"];
+var SERVER_TARGETS = [
+  "Node.js",
+  "Deno",
+  "Bun",
+  "CPython",
+  "PyPy",
+  "JVM",
+  "BEAM",
+  "Erlang/OTP",
+  "Ruby MRI",
+  "JRuby",
+  "TruffleRuby",
+  "Go runtime",
+  "PHP",
+  ".NET",
+  "Mono"
+];
+var SYSTEMS_TARGETS = [
+  "Systems",
+  "Systems Programming",
+  "Embedded",
+  "Native",
+  "LLVM",
+  "Firmware",
+  "Linux Kernel",
+  "Microcontroller"
+];
+var DATA_TARGETS = [
+  "Data Science",
+  "Machine Learning",
+  "Scientific Computing",
+  "Statistics",
+  "Bioinformatics",
+  "HPC",
+  "Numerical Computing"
+];
+var SCRIPT_TARGETS = ["shell", "PowerShell", "Scripting"];
+function poolMatches(pool, targets) {
+  return targets.some((t) => pool.some((s) => s.toLowerCase().includes(t.toLowerCase())));
+}
+function hasBrowser(lang) {
+  return poolMatches(lang.tooling?.runtimes ?? [], BROWSER_TARGETS);
+}
+function hasServer(lang) {
+  const pool = [...lang.tooling?.runtimes ?? [], ...lang.tooling?.ecosystems ?? []];
+  return poolMatches(pool, SERVER_TARGETS);
+}
+function matchesCategory(lang, category) {
+  const browser = hasBrowser(lang);
+  const server = hasServer(lang);
+  const pool = [...lang.tooling?.runtimes ?? [], ...lang.tooling?.ecosystems ?? []];
+  switch (category) {
+    case "frontend":
+      return browser && !server;
+    case "backend":
+      return server && !browser;
+    case "fullstack":
+      return browser && server;
+    case "systems":
+      return poolMatches(pool, SYSTEMS_TARGETS);
+    case "data-science":
+      return poolMatches(pool, DATA_TARGETS);
+    case "scripting":
+      return poolMatches(pool, SCRIPT_TARGETS);
+    case "other":
+      return !browser && !server && !poolMatches(pool, SYSTEMS_TARGETS) && !poolMatches(pool, DATA_TARGETS) && !poolMatches(pool, SCRIPT_TARGETS);
+  }
+}
+function getCategories() {
+  return ["frontend", "backend", "fullstack", "systems", "data-science", "scripting", "other"];
+}
+
 // src/domain/language/registry.ts
 var languageIndex = [
   { slug: "abap", extensions: [".abap"] },
@@ -17321,7 +17395,10 @@ var loadLanguage = (slug) => languageLoaders[slug]?.();
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
-var getBasename = (filename) => filename.trim().split(pathSegmentPattern).at(-1)?.toLowerCase() ?? "";
+var getBasename = (filename) => {
+  const parts = filename.trim().split(pathSegmentPattern);
+  return parts.at(-1).toLowerCase();
+};
 var matchesExtension = (basename, extension) => {
   const normalizedExtension = extension.toLowerCase();
   if (normalizedExtension.startsWith(".")) {
@@ -18846,6 +18923,35 @@ var api = {
       }
     };
   },
+  /**
+   * Selects every language that belongs to the given category.
+   *
+   * Categories are inferred from each language's `tooling.runtimes` and `tooling.ecosystems`:
+   * - `frontend`    — targets the browser only (CSS, HTML, GLSL…)
+   * - `backend`     — runs on a server runtime (Python, Go, Ruby, PHP…)
+   * - `fullstack`   — targets both browser and server (JavaScript, TypeScript…)
+   * - `systems`     — low-level / native / embedded (C, C++, Rust, Zig…)
+   * - `data-science`— data, ML, scientific computing (R, Julia, MATLAB…)
+   * - `scripting`   — shell and scripting languages (Bash, Zsh, PowerShell…)
+   * - `other`       — everything that does not match any of the above
+   *
+   * Categories are not mutually exclusive: Python appears in both `backend` and `data-science`.
+   *
+   * @example
+   * api.category('backend').langs().locale('es').get();
+   * await api.category('data-science').langs().load();
+   */
+  category(value) {
+    return {
+      langs() {
+        const filtered = () => languages.filter((lang) => matchesCategory(lang, value));
+        return createLanguageCollectionRequest(filtered, async () => {
+          const loaded = await Promise.all(filtered().map((lang) => loadLanguage(lang.slug)));
+          return loaded.filter((lang) => Boolean(lang));
+        });
+      }
+    };
+  },
   /**
    * Detects every matching language for a filename or path.
    *
@@ -19148,6 +19254,7 @@ exports.detectLanguageSlug = detectLanguageSlug;
 exports.detectLanguageSlugs = detectLanguageSlugs;
 exports.detectLanguages = detectLanguages;
 exports.detectProjectLanguages = detectProjectLanguages;
+exports.getCategories = getCategories;
 exports.getPackageManagers = getPackageManagers;
 exports.getRuntimes = getRuntimes;
 exports.languages = languages;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { P as PackageManagerInfo, R as RuntimeInfo, a as api, g as getPackageManagers, b as getRuntimes } from './api-CjNcbLKv.cjs';
+export { C as CategoryRequest, L as LanguageCategory, P as PackageManagerInfo, R as RuntimeInfo, a as api, g as getCategories, b as getPackageManagers, c as getRuntimes } from './api-C-SCQpIV.cjs';
 export { detectLanguage, detectLanguages } from './detect.cjs';
 export { ProjectLanguageDetection, detectLanguageSlug, detectLanguageSlugs, detectProjectLanguages } from './detect-slugs.cjs';
 export { localizeLanguage } from './i18n.cjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { P as PackageManagerInfo, R as RuntimeInfo, a as api, g as getPackageManagers, b as getRuntimes } from './api-u3GKPoGq.js';
+export { C as CategoryRequest, L as LanguageCategory, P as PackageManagerInfo, R as RuntimeInfo, a as api, g as getCategories, b as getPackageManagers, c as getRuntimes } from './api-EZK9DmOV.js';
 export { detectLanguage, detectLanguages } from './detect.js';
 export { ProjectLanguageDetection, detectLanguageSlug, detectLanguageSlugs, detectProjectLanguages } from './detect-slugs.js';
 export { localizeLanguage } from './i18n.js';

package/dist/index.js

@@ -16720,6 +16720,80 @@ var init_zsh = __esm({
   }
 });
 
+// src/domain/category/registry.ts
+var BROWSER_TARGETS = ["Browser"];
+var SERVER_TARGETS = [
+  "Node.js",
+  "Deno",
+  "Bun",
+  "CPython",
+  "PyPy",
+  "JVM",
+  "BEAM",
+  "Erlang/OTP",
+  "Ruby MRI",
+  "JRuby",
+  "TruffleRuby",
+  "Go runtime",
+  "PHP",
+  ".NET",
+  "Mono"
+];
+var SYSTEMS_TARGETS = [
+  "Systems",
+  "Systems Programming",
+  "Embedded",
+  "Native",
+  "LLVM",
+  "Firmware",
+  "Linux Kernel",
+  "Microcontroller"
+];
+var DATA_TARGETS = [
+  "Data Science",
+  "Machine Learning",
+  "Scientific Computing",
+  "Statistics",
+  "Bioinformatics",
+  "HPC",
+  "Numerical Computing"
+];
+var SCRIPT_TARGETS = ["shell", "PowerShell", "Scripting"];
+function poolMatches(pool, targets) {
+  return targets.some((t) => pool.some((s) => s.toLowerCase().includes(t.toLowerCase())));
+}
+function hasBrowser(lang) {
+  return poolMatches(lang.tooling?.runtimes ?? [], BROWSER_TARGETS);
+}
+function hasServer(lang) {
+  const pool = [...lang.tooling?.runtimes ?? [], ...lang.tooling?.ecosystems ?? []];
+  return poolMatches(pool, SERVER_TARGETS);
+}
+function matchesCategory(lang, category) {
+  const browser = hasBrowser(lang);
+  const server = hasServer(lang);
+  const pool = [...lang.tooling?.runtimes ?? [], ...lang.tooling?.ecosystems ?? []];
+  switch (category) {
+    case "frontend":
+      return browser && !server;
+    case "backend":
+      return server && !browser;
+    case "fullstack":
+      return browser && server;
+    case "systems":
+      return poolMatches(pool, SYSTEMS_TARGETS);
+    case "data-science":
+      return poolMatches(pool, DATA_TARGETS);
+    case "scripting":
+      return poolMatches(pool, SCRIPT_TARGETS);
+    case "other":
+      return !browser && !server && !poolMatches(pool, SYSTEMS_TARGETS) && !poolMatches(pool, DATA_TARGETS) && !poolMatches(pool, SCRIPT_TARGETS);
+  }
+}
+function getCategories() {
+  return ["frontend", "backend", "fullstack", "systems", "data-science", "scripting", "other"];
+}
+
 // src/domain/language/registry.ts
 var languageIndex = [
   { slug: "abap", extensions: [".abap"] },
@@ -17319,7 +17393,10 @@ var loadLanguage = (slug) => languageLoaders[slug]?.();
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
-var getBasename = (filename) => filename.trim().split(pathSegmentPattern).at(-1)?.toLowerCase() ?? "";
+var getBasename = (filename) => {
+  const parts = filename.trim().split(pathSegmentPattern);
+  return parts.at(-1).toLowerCase();
+};
 var matchesExtension = (basename, extension) => {
   const normalizedExtension = extension.toLowerCase();
   if (normalizedExtension.startsWith(".")) {
@@ -18844,6 +18921,35 @@ var api = {
       }
     };
   },
+  /**
+   * Selects every language that belongs to the given category.
+   *
+   * Categories are inferred from each language's `tooling.runtimes` and `tooling.ecosystems`:
+   * - `frontend`    — targets the browser only (CSS, HTML, GLSL…)
+   * - `backend`     — runs on a server runtime (Python, Go, Ruby, PHP…)
+   * - `fullstack`   — targets both browser and server (JavaScript, TypeScript…)
+   * - `systems`     — low-level / native / embedded (C, C++, Rust, Zig…)
+   * - `data-science`— data, ML, scientific computing (R, Julia, MATLAB…)
+   * - `scripting`   — shell and scripting languages (Bash, Zsh, PowerShell…)
+   * - `other`       — everything that does not match any of the above
+   *
+   * Categories are not mutually exclusive: Python appears in both `backend` and `data-science`.
+   *
+   * @example
+   * api.category('backend').langs().locale('es').get();
+   * await api.category('data-science').langs().load();
+   */
+  category(value) {
+    return {
+      langs() {
+        const filtered = () => languages.filter((lang) => matchesCategory(lang, value));
+        return createLanguageCollectionRequest(filtered, async () => {
+          const loaded = await Promise.all(filtered().map((lang) => loadLanguage(lang.slug)));
+          return loaded.filter((lang) => Boolean(lang));
+        });
+      }
+    };
+  },
   /**
    * Detects every matching language for a filename or path.
    *
@@ -19140,4 +19246,4 @@ init_zig();
 init_ziggy();
 init_zsh();
 
-export { abap, actionscript, ada, agda, algol, ampl, ante, antlr, apex, api, apl, applescript, aql, arduino, asciidoc, asp, assembly, assemblyscript, astro, austral, autohotkey, avroIdl, awk, ballerina, bash, basic, batch, bazel, bcpl, bibtex, bicep, blade, bosque, bqn, brainfuck, c, cairo, capnproto, carbon, cel, chapel, circom, clojure, cmake, cobol, coffeescript, coldfusion, coq, cpp, cql, crystal, csharp, css, cuda, cue, curry, cypher, cython, d, dafny, dart, dax, detectLanguage, detectLanguageSlug, detectLanguageSlugs, detectLanguages, detectProjectLanguages, dhall, dita, dockerfile, dot, earthly, editorconfig, eiffel, ejs, elixir, elm, erb, erlang, factor, fe, fennel, fish, flatbuffers, flux, forth, fortran, fql, freemarker, fsharp, fstar, gcode, gdscript, getPackageManagers, getRuntimes, gettext, git, gleam, glsl, go, gradle, grain, graphql, gremlin, groovy, hack, haml, handlebars, hare, haskell, haxe, hcl, hlsl, hocon, html, hy, idris, ini, ink, io, isabelle, janet, java, javascript, jinja, jmespath, json, json5, jsonata, jsonc, jsonnet, julia, jupyterNotebook, just, kcl, kdl, koka, kotlin, kql, languages, lean, less, ligo, linkerscript, liquid, lisp, llvmIr, lobster, localizeLanguage, logo, lua, luau, makefile, mako, markdown, marlowe, mathematica, matlab, maxima, mdx, mercury, mermaid, meson, metal, modula2, mojo, moonbit, move, mumps, mustache, n1ql, nginx, nickel, nim, nix, nunjucks, nushell, oberon, objectiveC, ocaml, odin, openapi, opencl, openscad, org, pascal, perl, php, pineScript, pkl, plI, plantuml, plpgsql, plsql, pod, pony, postscript, powerquery, powershell, processing, prolog, promql, protobuf, pug, puppet, purescript, python, qmake, qml, qsharp, r, racket, raku, razor, reasonml, rebol, red, rego, rescript, restructuredtext, roc, rpg, ruby, rust, sas, scala, scheme, scss, self, simula, smalltalk, smarty, snobol, solidity, soql, spark, sparql, spl, sql, standardMl, starlark, stata, stylus, svelte, svg, svn, swift, tcl, tcsh, tex, textile, thrift, tlaPlus, toml, troff, tsql, twig, typescript, typst, unison, v, vala, vale, vba, velocity, verilog, verse, vhdl, visualBasic, vue, vyper, webassembly, wgsl, wren, xaml, xml, xpath, xquery, xslt, yaml, yara, zeek, zig, ziggy, zsh };
+export { abap, actionscript, ada, agda, algol, ampl, ante, antlr, apex, api, apl, applescript, aql, arduino, asciidoc, asp, assembly, assemblyscript, astro, austral, autohotkey, avroIdl, awk, ballerina, bash, basic, batch, bazel, bcpl, bibtex, bicep, blade, bosque, bqn, brainfuck, c, cairo, capnproto, carbon, cel, chapel, circom, clojure, cmake, cobol, coffeescript, coldfusion, coq, cpp, cql, crystal, csharp, css, cuda, cue, curry, cypher, cython, d, dafny, dart, dax, detectLanguage, detectLanguageSlug, detectLanguageSlugs, detectLanguages, detectProjectLanguages, dhall, dita, dockerfile, dot, earthly, editorconfig, eiffel, ejs, elixir, elm, erb, erlang, factor, fe, fennel, fish, flatbuffers, flux, forth, fortran, fql, freemarker, fsharp, fstar, gcode, gdscript, getCategories, getPackageManagers, getRuntimes, gettext, git, gleam, glsl, go, gradle, grain, graphql, gremlin, groovy, hack, haml, handlebars, hare, haskell, haxe, hcl, hlsl, hocon, html, hy, idris, ini, ink, io, isabelle, janet, java, javascript, jinja, jmespath, json, json5, jsonata, jsonc, jsonnet, julia, jupyterNotebook, just, kcl, kdl, koka, kotlin, kql, languages, lean, less, ligo, linkerscript, liquid, lisp, llvmIr, lobster, localizeLanguage, logo, lua, luau, makefile, mako, markdown, marlowe, mathematica, matlab, maxima, mdx, mercury, mermaid, meson, metal, modula2, mojo, moonbit, move, mumps, mustache, n1ql, nginx, nickel, nim, nix, nunjucks, nushell, oberon, objectiveC, ocaml, odin, openapi, opencl, openscad, org, pascal, perl, php, pineScript, pkl, plI, plantuml, plpgsql, plsql, pod, pony, postscript, powerquery, powershell, processing, prolog, promql, protobuf, pug, puppet, purescript, python, qmake, qml, qsharp, r, racket, raku, razor, reasonml, rebol, red, rego, rescript, restructuredtext, roc, rpg, ruby, rust, sas, scala, scheme, scss, self, simula, smalltalk, smarty, snobol, solidity, soql, spark, sparql, spl, sql, standardMl, starlark, stata, stylus, svelte, svg, svn, swift, tcl, tcsh, tex, textile, thrift, tlaPlus, toml, troff, tsql, twig, typescript, typst, unison, v, vala, vale, vba, velocity, verilog, verse, vhdl, visualBasic, vue, vyper, webassembly, wgsl, wren, xaml, xml, xpath, xquery, xslt, yaml, yara, zeek, zig, ziggy, zsh };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-languages",
-  "version": "1.38.0",
+  "version": "1.39.0",
   "description": "Structured metadata for programming languages.",
   "homepage": "https://github.com/ElJijuna/code-languages#readme",
   "bugs": {
@@ -1504,6 +1504,7 @@
     "prepare": "husky",
     "release": "semantic-release",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "translate:i18n": "node scripts/translate-language-i18n.mjs",
     "typecheck": "tsc --noEmit",
     "website:bench": "node scripts/run-website-benchmarks.mjs",
@@ -1522,6 +1523,7 @@
     "@semantic-release/github": "^12.0.8",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.1",
+    "@vitest/coverage-v8": "^4.1.9",
     "eslint": "^9.39.4",
     "husky": "^9.1.7",
     "semantic-release": "^25.0.3",