code-languages 1.42.5 → 1.43.1

package/README.md

@@ -430,6 +430,37 @@ api.related("typescript").langs().get(); // JavaScript
 api.related("sql").langs().get(); // T-SQL, PL/SQL, PL/pgSQL, PRQL
 ```
 
+Filters compose. Every language collection is chainable: call `.category()`, `.paradigm()`, `.runtime()`,
+`.packageManager()`, `.ecosystem()`, `.extension()`, `.status()`, or `.related()` on any
+`langs()`, `languages()`, `search()`, or `detectAll()` result to intersect filters.
+Order does not matter, and `.locale()` can be set at any point in the chain:
+
+```ts
+import { api } from "code-languages/api";
+
+// Backend languages that are also functional
+api.category("backend").langs().paradigm("functional").get(); // Elixir, Erlang, ...
+
+// Active languages that run on Node.js, localized
+api.languages().runtime("node").status("active").locale("es").get();
+
+// Systems languages registering the .h extension
+api.category("systems").langs().extension(".h").get(); // C, C++
+
+// Ranked search narrowed by lifecycle status
+api.search("script").status("active").get();
+```
+
+Collections also offer cheap helpers that skip localization: `.slugs()` returns the
+matching catalog slugs, `.count()` the number of matches, and `.first()` the first
+match localized (or `undefined` when the collection is empty):
+
+```ts
+api.category("backend").langs().paradigm("functional").slugs(); // ["clojure", "elixir", ...]
+api.runtime("node").langs().count(); // number of matching languages
+api.search("golang").first()?.slug; // "go"
+```
+
 ## Supported Languages
 
 The catalog currently includes 313 language entries. Each row can be imported directly
@@ -619,7 +650,7 @@ from its package subpath.
 | <img src="https://upload.wikimedia.org/wikipedia/commons/c/c5/Nginx_logo.svg" alt="nginx logo" width="24" height="24"> | nginx | `nginx` | `nginx.conf`, `.nginx`, `.conf` | `1.30.4` | `code-languages/nginx` |
 | <img src="https://avatars.githubusercontent.com/u/83021462?v=4" alt="Nickel logo" width="24" height="24"> | Nickel | `nickel` | `.ncl` | `1.17.0` | `code-languages/nickel` |
 | <img src="https://cdn.simpleicons.org/nim/FFE953" alt="Nim logo" width="24" height="24"> | Nim | `nim` | `.nim`, `.nims`, `.nimble` | `2.2.10` | `code-languages/nim` |
-| <img src="https://cdn.simpleicons.org/nixos/5277C3" alt="Nix logo" width="24" height="24"> | Nix | `nix` | `.nix` | `2.34.8` | `code-languages/nix` |
+| <img src="https://cdn.simpleicons.org/nixos/5277C3" alt="Nix logo" width="24" height="24"> | Nix | `nix` | `.nix` | `2.35.2` | `code-languages/nix` |
 | <img src="https://avatars.githubusercontent.com/u/72610319?v=4" alt="Noir logo" width="24" height="24"> | Noir | `noir` | `.nr` | `1.0.0-beta` | `code-languages/noir` |
 | <img src="https://cdn.simpleicons.org/nunjucks/1C4A1C" alt="Nunjucks logo" width="24" height="24"> | Nunjucks | `nunjucks` | `.njk`, `.nunjucks` | `3.2.4` | `code-languages/nunjucks` |
 | <img src="https://cdn.simpleicons.org/nushell/3AA675" alt="Nushell logo" width="24" height="24"> | Nushell | `nushell` | `.nu` | `0.114.1` | `code-languages/nushell` |

package/dist/{api-DfKZeygA.d.ts → api-CiSr3n5R.d.ts}

@@ -1,7 +1,13 @@
 import { L as LanguageSlug } from './registry-DftZRMv6.js';
-import { f as Locale, g as LocalizedLanguage, c as LanguageStatus } from './types-BRDmsib7.js';
+import { f as Locale, c as LanguageStatus, g as LocalizedLanguage } from './types-BRDmsib7.js';
 
 type LanguageCategory = 'frontend' | 'backend' | 'fullstack' | 'systems' | 'data-science' | 'scripting' | 'other';
+interface CategoryInfo {
+    slug: LanguageCategory;
+    name: string;
+    description: string;
+    aliases: string[];
+}
 declare function getCategories(): LanguageCategory[];
 
 interface EcosystemInfo {
@@ -79,6 +85,8 @@ interface RuntimeRequest {
     info(): RuntimeInfo | undefined;
     /** Languages that run on or target this platform. */
     langs(): LanguageCollectionRequest;
+    /** Package managers available on this runtime platform. */
+    packageManagers(): PackageManagerInfo[];
 }
 interface PackageManagerRequest {
     /** Metadata about the matched package manager. Returns undefined for unknown values. */
@@ -89,6 +97,8 @@ interface PackageManagerRequest {
     runtimes(): RuntimeInfo[];
 }
 interface CategoryRequest {
+    /** Metadata about the matched category. Returns undefined for unknown values. */
+    info(): CategoryInfo | undefined;
     /** Languages that belong to this category. */
     langs(): LanguageCollectionRequest;
 }
@@ -121,6 +131,28 @@ interface LanguageCollectionRequest {
      * Sets the requested locale for every language returned by this collection lookup.
      */
     locale(locale: Locale): LanguageCollectionRequest;
+    /** Narrows the collection to languages that belong to the given category. */
+    category(value: LanguageCategory): LanguageCollectionRequest;
+    /** Narrows the collection to languages that use the given programming paradigm. */
+    paradigm(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages that run on or target the given platform. */
+    runtime(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages that use the given package manager. */
+    packageManager(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages that belong to the given ecosystem. */
+    ecosystem(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages registering the given extension or exact filename. */
+    extension(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages with the given lifecycle status. */
+    status(value: LanguageStatus): LanguageCollectionRequest;
+    /** Narrows the collection to languages related to the given language through `relations`. */
+    related(slug: RuntimeLanguageSlug): LanguageCollectionRequest;
+    /** Lists the matching catalog slugs without localizing. */
+    slugs(): string[];
+    /** Counts the matching languages without localizing. */
+    count(): number;
+    /** Reads the first matching language from the in-memory catalog and localizes it. */
+    first(): LocalizedLanguage | undefined;
     /**
      * Reads every language from the in-memory catalog and localizes the result.
      */
@@ -135,6 +167,14 @@ interface LanguageCollectionRequest {
  *
  * Use `.get()` for synchronous catalog access or `.load()` to dynamically import only the
  * requested language modules.
+ *
+ * Language collections compose: chain `.category()`, `.paradigm()`, `.runtime()`,
+ * `.packageManager()`, `.ecosystem()`, `.extension()`, `.status()`, or `.related()` on any
+ * collection to intersect filters.
+ *
+ * @example
+ * api.category('backend').langs().paradigm('functional').get();
+ * api.languages().runtime('node').status('active').locale('es').get();
  */
 declare const api: {
     /**
@@ -215,6 +255,7 @@ declare const api: {
      * @example
      * api.runtime('node').langs().locale('es').get();
      * api.runtime('.net').info();
+     * api.runtime('node').packageManagers();
      */
     runtime(value: string): RuntimeRequest;
     /**
@@ -244,6 +285,7 @@ declare const api: {
      *
      * @example
      * api.category('backend').langs().locale('es').get();
+     * api.category('backend').info();
      * await api.category('data-science').langs().load();
      */
     category(value: LanguageCategory): CategoryRequest;
@@ -279,4 +321,4 @@ declare const api: {
 /** Lists every lifecycle status usable with `api.status()`. */
 declare function getStatuses(): LanguageStatus[];
 
-export { type CategoryRequest as C, type EcosystemInfo as E, type LanguageCategory as L, type PackageManagerInfo as P, type RelatedRequest as R, type StatusRequest as S, type EcosystemRequest as a, type ExtensionRequest as b, type ParadigmInfo as c, type ParadigmRequest as d, type ResolvedLanguageRequest as e, type RuntimeInfo as f, api as g, getCategories as h, getEcosystems as i, getPackageManagers as j, getParadigms as k, getRuntimes as l, getStatuses as m, type LanguageCollectionRequest as n, type LanguageRequest as o, type PackageManagerRequest as p, type RuntimeRequest as q };
+export { type CategoryInfo as C, type EcosystemInfo as E, type LanguageCategory as L, type PackageManagerInfo as P, type RelatedRequest as R, type StatusRequest as S, type CategoryRequest as a, type EcosystemRequest as b, type ExtensionRequest as c, type ParadigmInfo as d, type ParadigmRequest as e, type ResolvedLanguageRequest as f, type RuntimeInfo as g, api as h, getCategories as i, getEcosystems as j, getPackageManagers as k, getParadigms as l, getRuntimes as m, getStatuses as n, type LanguageCollectionRequest as o, type LanguageRequest as p, type PackageManagerRequest as q, type RuntimeRequest as r };

package/dist/{api-D10hZgSz.d.cts → api-jHE_4U3C.d.cts}

@@ -1,7 +1,13 @@
 import { L as LanguageSlug } from './registry-DftZRMv6.cjs';
-import { f as Locale, g as LocalizedLanguage, c as LanguageStatus } from './types-BRDmsib7.cjs';
+import { f as Locale, c as LanguageStatus, g as LocalizedLanguage } from './types-BRDmsib7.cjs';
 
 type LanguageCategory = 'frontend' | 'backend' | 'fullstack' | 'systems' | 'data-science' | 'scripting' | 'other';
+interface CategoryInfo {
+    slug: LanguageCategory;
+    name: string;
+    description: string;
+    aliases: string[];
+}
 declare function getCategories(): LanguageCategory[];
 
 interface EcosystemInfo {
@@ -79,6 +85,8 @@ interface RuntimeRequest {
     info(): RuntimeInfo | undefined;
     /** Languages that run on or target this platform. */
     langs(): LanguageCollectionRequest;
+    /** Package managers available on this runtime platform. */
+    packageManagers(): PackageManagerInfo[];
 }
 interface PackageManagerRequest {
     /** Metadata about the matched package manager. Returns undefined for unknown values. */
@@ -89,6 +97,8 @@ interface PackageManagerRequest {
     runtimes(): RuntimeInfo[];
 }
 interface CategoryRequest {
+    /** Metadata about the matched category. Returns undefined for unknown values. */
+    info(): CategoryInfo | undefined;
     /** Languages that belong to this category. */
     langs(): LanguageCollectionRequest;
 }
@@ -121,6 +131,28 @@ interface LanguageCollectionRequest {
      * Sets the requested locale for every language returned by this collection lookup.
      */
     locale(locale: Locale): LanguageCollectionRequest;
+    /** Narrows the collection to languages that belong to the given category. */
+    category(value: LanguageCategory): LanguageCollectionRequest;
+    /** Narrows the collection to languages that use the given programming paradigm. */
+    paradigm(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages that run on or target the given platform. */
+    runtime(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages that use the given package manager. */
+    packageManager(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages that belong to the given ecosystem. */
+    ecosystem(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages registering the given extension or exact filename. */
+    extension(value: string): LanguageCollectionRequest;
+    /** Narrows the collection to languages with the given lifecycle status. */
+    status(value: LanguageStatus): LanguageCollectionRequest;
+    /** Narrows the collection to languages related to the given language through `relations`. */
+    related(slug: RuntimeLanguageSlug): LanguageCollectionRequest;
+    /** Lists the matching catalog slugs without localizing. */
+    slugs(): string[];
+    /** Counts the matching languages without localizing. */
+    count(): number;
+    /** Reads the first matching language from the in-memory catalog and localizes it. */
+    first(): LocalizedLanguage | undefined;
     /**
      * Reads every language from the in-memory catalog and localizes the result.
      */
@@ -135,6 +167,14 @@ interface LanguageCollectionRequest {
  *
  * Use `.get()` for synchronous catalog access or `.load()` to dynamically import only the
  * requested language modules.
+ *
+ * Language collections compose: chain `.category()`, `.paradigm()`, `.runtime()`,
+ * `.packageManager()`, `.ecosystem()`, `.extension()`, `.status()`, or `.related()` on any
+ * collection to intersect filters.
+ *
+ * @example
+ * api.category('backend').langs().paradigm('functional').get();
+ * api.languages().runtime('node').status('active').locale('es').get();
  */
 declare const api: {
     /**
@@ -215,6 +255,7 @@ declare const api: {
      * @example
      * api.runtime('node').langs().locale('es').get();
      * api.runtime('.net').info();
+     * api.runtime('node').packageManagers();
      */
     runtime(value: string): RuntimeRequest;
     /**
@@ -244,6 +285,7 @@ declare const api: {
      *
      * @example
      * api.category('backend').langs().locale('es').get();
+     * api.category('backend').info();
      * await api.category('data-science').langs().load();
      */
     category(value: LanguageCategory): CategoryRequest;
@@ -279,4 +321,4 @@ declare const api: {
 /** Lists every lifecycle status usable with `api.status()`. */
 declare function getStatuses(): LanguageStatus[];
 
-export { type CategoryRequest as C, type EcosystemInfo as E, type LanguageCategory as L, type PackageManagerInfo as P, type RelatedRequest as R, type StatusRequest as S, type EcosystemRequest as a, type ExtensionRequest as b, type ParadigmInfo as c, type ParadigmRequest as d, type ResolvedLanguageRequest as e, type RuntimeInfo as f, api as g, getCategories as h, getEcosystems as i, getPackageManagers as j, getParadigms as k, getRuntimes as l, getStatuses as m, type LanguageCollectionRequest as n, type LanguageRequest as o, type PackageManagerRequest as p, type RuntimeRequest as q };
+export { type CategoryInfo as C, type EcosystemInfo as E, type LanguageCategory as L, type PackageManagerInfo as P, type RelatedRequest as R, type StatusRequest as S, type CategoryRequest as a, type EcosystemRequest as b, type ExtensionRequest as c, type ParadigmInfo as d, type ParadigmRequest as e, type ResolvedLanguageRequest as f, type RuntimeInfo as g, api as h, getCategories as i, getEcosystems as j, getPackageManagers as k, getParadigms as l, getRuntimes as m, getStatuses as n, type LanguageCollectionRequest as o, type LanguageRequest as p, type PackageManagerRequest as q, type RuntimeRequest as r };

package/dist/api.cjs

@@ -10756,7 +10756,7 @@ var init_nix = __esm({
         packageManagers: ["nix", "nix flakes"],
         ecosystems: ["Linux", "macOS", "NixOS", "DevOps"]
       },
-      version: "2.34.8",
+      version: "2.35.2",
       logo: "https://cdn.simpleicons.org/nixos/5277C3",
       color: "#5277C3",
       i18n: {
@@ -18467,6 +18467,50 @@ var init_zsh = __esm({
 });
 
 // src/domain/category/registry.ts
+var CATEGORY_REGISTRY = [
+  {
+    slug: "frontend",
+    name: "Frontend",
+    description: "Languages that target the browser only.",
+    aliases: ["frontend", "front-end"]
+  },
+  {
+    slug: "backend",
+    name: "Backend",
+    description: "Languages that run on a server runtime.",
+    aliases: ["backend", "back-end", "server"]
+  },
+  {
+    slug: "fullstack",
+    name: "Fullstack",
+    description: "Languages that target both the browser and a server runtime.",
+    aliases: ["fullstack", "full-stack"]
+  },
+  {
+    slug: "systems",
+    name: "Systems",
+    description: "Low-level, native, and embedded programming languages.",
+    aliases: ["systems", "systems-programming", "low-level"]
+  },
+  {
+    slug: "data-science",
+    name: "Data Science",
+    description: "Languages for data analysis, machine learning, and scientific computing.",
+    aliases: ["data-science", "datascience", "data"]
+  },
+  {
+    slug: "scripting",
+    name: "Scripting",
+    description: "Shell and scripting languages.",
+    aliases: ["scripting", "shell"]
+  },
+  {
+    slug: "other",
+    name: "Other",
+    description: "Languages that do not match any other category.",
+    aliases: ["other"]
+  }
+];
 var BROWSER_TARGETS = ["Browser"];
 var SERVER_TARGETS = [
   "Node.js",
@@ -18536,6 +18580,18 @@ function matchesCategory(lang, category) {
       return !browser && !server && !poolMatches(pool, SYSTEMS_TARGETS) && !poolMatches(pool, DATA_TARGETS) && !poolMatches(pool, SCRIPT_TARGETS);
   }
 }
+function findCategory(value) {
+  const key = value.trim().toLowerCase();
+  return CATEGORY_REGISTRY.find((c2) => c2.aliases.includes(key));
+}
+function categoryInfoFromDefinition(def) {
+  return {
+    slug: def.slug,
+    name: def.name,
+    description: def.description,
+    aliases: def.aliases
+  };
+}
 
 // src/domain/detection/match.ts
 var pathSegmentPattern = /[/\\]/;
@@ -20411,6 +20467,14 @@ function packageManagerInfoFromDefinition(def) {
     aliases: def.aliases
   };
 }
+function packageManagersForRuntime(names) {
+  const keys = names.map((name) => name.trim().toLowerCase());
+  return PACKAGE_MANAGER_REGISTRY.filter(
+    (pm) => keys.some(
+      (key) => pm.name.toLowerCase() === key || pm.aliases.includes(key) || pm.targets.some((target) => target.toLowerCase() === key)
+    )
+  ).map(packageManagerInfoFromDefinition);
+}
 
 // src/domain/paradigm/registry.ts
 var PARADIGM_REGISTRY = [
@@ -21079,13 +21143,93 @@ var createLanguageRequest = (getLanguage, loadLanguageModule) => {
   };
   return request;
 };
+var getLanguageBySlug = (slug) => languageMap.get(slug);
+var getRelationSlugs = (language) => {
+  const { supersetOf = [], dialectOf = [], compilesTo = [] } = language.relations ?? {};
+  return [...supersetOf, ...dialectOf, ...compilesTo];
+};
+var categoryPredicate = (value) => {
+  const resolvedCategory = findCategory(value)?.slug ?? value;
+  return (language) => matchesCategory(language, resolvedCategory);
+};
+var paradigmPredicate = (value) => {
+  const targets = findParadigm(value)?.targets ?? [value];
+  return (language) => matchesParadigm(language, targets);
+};
+var runtimePredicate = (value) => {
+  const targets = findRuntime(value)?.targets ?? [value];
+  return (language) => matchesRuntime(language, targets);
+};
+var packageManagerPredicate = (value) => {
+  const targets = findPackageManager(value)?.targets ?? [value];
+  return (language) => matchesPackageManager(language, targets);
+};
+var ecosystemPredicate = (value) => {
+  const targets = findEcosystem(value)?.targets ?? [value];
+  return (language) => matchesEcosystem(language, targets);
+};
+var extensionPredicate = (value) => {
+  const normalized = value.trim().toLowerCase();
+  return (language) => language.extensions.some((extension) => {
+    const normalizedExtension = extension.toLowerCase();
+    return normalizedExtension === normalized || normalizedExtension === `.${normalized}`;
+  });
+};
+var statusPredicate = (value) => (language) => (language.status ?? "active") === value;
+var relatedPredicate = (slug) => {
+  const resolvedSlug = resolveLanguageLookup(slug);
+  const source = getLanguageBySlug(resolvedSlug);
+  const outgoing = new Set(source ? getRelationSlugs(source) : []);
+  return (language) => language.slug !== resolvedSlug && (outgoing.has(language.slug) || getRelationSlugs(language).includes(resolvedSlug));
+};
 var createLanguageCollectionRequest = (getLanguageList, loadLanguageList) => {
   let requestedLocale = defaultLocale;
+  const narrow = (predicate) => {
+    const filtered = () => getLanguageList().filter(predicate);
+    const next = createLanguageCollectionRequest(filtered, async () => {
+      const loaded = await Promise.all(filtered().map((language) => loadLanguage(language.slug)));
+      return loaded.filter((language) => Boolean(language));
+    });
+    return next.locale(requestedLocale);
+  };
   const request = {
     locale(locale) {
       requestedLocale = locale;
       return request;
     },
+    category(value) {
+      return narrow(categoryPredicate(value));
+    },
+    paradigm(value) {
+      return narrow(paradigmPredicate(value));
+    },
+    runtime(value) {
+      return narrow(runtimePredicate(value));
+    },
+    packageManager(value) {
+      return narrow(packageManagerPredicate(value));
+    },
+    ecosystem(value) {
+      return narrow(ecosystemPredicate(value));
+    },
+    extension(value) {
+      return narrow(extensionPredicate(value));
+    },
+    status(value) {
+      return narrow(statusPredicate(value));
+    },
+    related(slug) {
+      return narrow(relatedPredicate(slug));
+    },
+    slugs() {
+      return getLanguageList().map((language) => language.slug);
+    },
+    count() {
+      return getLanguageList().length;
+    },
+    first() {
+      return localizeOptionalLanguage(getLanguageList().at(0), requestedLocale);
+    },
     get() {
       return getLanguageList().map((language) => localizeLanguage(language, requestedLocale));
     },
@@ -21103,17 +21247,20 @@ var createFilteredLanguageCollection = (predicate) => {
     return loaded.filter((language) => Boolean(language));
   });
 };
+var createGroupSelection = (definition, toInfo, predicate) => ({
+  info() {
+    return definition ? toInfo(definition) : void 0;
+  },
+  langs() {
+    return createFilteredLanguageCollection(predicate);
+  }
+});
 var loadDetectedLanguages = async (filename) => {
   const detectedLanguages = await Promise.all(
     detectLanguageSlugs(filename).map((slug) => loadLanguage(slug))
   );
   return detectedLanguages.filter((language) => Boolean(language));
 };
-var getLanguageBySlug = (slug) => languageMap.get(slug);
-var getRelationSlugs = (language) => {
-  const { supersetOf = [], dialectOf = [], compilesTo = [] } = language.relations ?? {};
-  return [...supersetOf, ...dialectOf, ...compilesTo];
-};
 var getDetectedLanguages = (filename) => detectLanguageSlugs(filename).map((slug) => getLanguageBySlug(slug)).filter((language) => Boolean(language));
 var api = {
   /**
@@ -21177,15 +21324,9 @@ var api = {
    * api.extension('ts').langs().locale('es').get();
    */
   extension(value) {
-    const normalized = value.trim().toLowerCase();
     return {
       langs() {
-        return createFilteredLanguageCollection(
-          (language) => language.extensions.some((extension) => {
-            const normalizedExtension = extension.toLowerCase();
-            return normalizedExtension === normalized || normalizedExtension === `.${normalized}`;
-          })
-        );
+        return createFilteredLanguageCollection(extensionPredicate(value));
       }
     };
   },
@@ -21241,9 +21382,7 @@ var api = {
   status(value) {
     return {
       langs() {
-        return createFilteredLanguageCollection(
-          (language) => (language.status ?? "active") === value
-        );
+        return createFilteredLanguageCollection(statusPredicate(value));
       }
     };
   },
@@ -21256,14 +21395,9 @@ var api = {
    * api.related('typescript').langs().get(); // JavaScript
    */
   related(slug) {
-    const resolvedSlug = resolveLanguageLookup(slug);
     return {
       langs() {
-        const source = getLanguageBySlug(resolvedSlug);
-        const outgoing = new Set(source ? getRelationSlugs(source) : []);
-        return createFilteredLanguageCollection(
-          (language) => language.slug !== resolvedSlug && (outgoing.has(language.slug) || getRelationSlugs(language).includes(resolvedSlug))
-        );
+        return createFilteredLanguageCollection(relatedPredicate(slug));
       }
     };
   },
@@ -21276,16 +21410,14 @@ var api = {
    * @example
    * api.runtime('node').langs().locale('es').get();
    * api.runtime('.net').info();
+   * api.runtime('node').packageManagers();
    */
   runtime(value) {
     const definition = findRuntime(value);
-    const targets = definition?.targets ?? [value];
     return {
-      info() {
-        return definition ? runtimeInfoFromDefinition(definition) : void 0;
-      },
-      langs() {
-        return createFilteredLanguageCollection((language) => matchesRuntime(language, targets));
+      ...createGroupSelection(definition, runtimeInfoFromDefinition, runtimePredicate(value)),
+      packageManagers() {
+        return definition ? packageManagersForRuntime(definition.packageManagers) : [];
       }
     };
   },
@@ -21303,14 +21435,11 @@ var api = {
     const definition = findPackageManager(value);
     const targets = definition?.targets ?? [value];
     return {
-      info() {
-        return definition ? packageManagerInfoFromDefinition(definition) : void 0;
-      },
-      langs() {
-        return createFilteredLanguageCollection(
-          (language) => matchesPackageManager(language, targets)
-        );
-      },
+      ...createGroupSelection(
+        definition,
+        packageManagerInfoFromDefinition,
+        packageManagerPredicate(value)
+      ),
       runtimes() {
         return runtimesForPackageManager(targets);
       }
@@ -21332,14 +21461,15 @@ var api = {
    *
    * @example
    * api.category('backend').langs().locale('es').get();
+   * api.category('backend').info();
    * await api.category('data-science').langs().load();
    */
   category(value) {
-    return {
-      langs() {
-        return createFilteredLanguageCollection((language) => matchesCategory(language, value));
-      }
-    };
+    return createGroupSelection(
+      findCategory(value),
+      categoryInfoFromDefinition,
+      categoryPredicate(value)
+    );
   },
   /**
    * Selects every language that uses the given programming paradigm.
@@ -21352,16 +21482,11 @@ var api = {
    * api.paradigm('oop').info();
    */
   paradigm(value) {
-    const definition = findParadigm(value);
-    const targets = definition?.targets ?? [value];
-    return {
-      info() {
-        return definition ? paradigmInfoFromDefinition(definition) : void 0;
-      },
-      langs() {
-        return createFilteredLanguageCollection((language) => matchesParadigm(language, targets));
-      }
-    };
+    return createGroupSelection(
+      findParadigm(value),
+      paradigmInfoFromDefinition,
+      paradigmPredicate(value)
+    );
   },
   /**
    * Selects every language that belongs to the given ecosystem.
@@ -21374,16 +21499,11 @@ var api = {
    * api.ecosystem('blockchain').info();
    */
   ecosystem(value) {
-    const definition = findEcosystem(value);
-    const targets = definition?.targets ?? [value];
-    return {
-      info() {
-        return definition ? ecosystemInfoFromDefinition(definition) : void 0;
-      },
-      langs() {
-        return createFilteredLanguageCollection((language) => matchesEcosystem(language, targets));
-      }
-    };
+    return createGroupSelection(
+      findEcosystem(value),
+      ecosystemInfoFromDefinition,
+      ecosystemPredicate(value)
+    );
   },
   /**
    * Detects every matching language for a filename or path.

package/dist/api.d.cts

@@ -1,3 +1,3 @@
-export { C as CategoryRequest, E as EcosystemInfo, a as EcosystemRequest, b as ExtensionRequest, L as LanguageCategory, n as LanguageCollectionRequest, o as LanguageRequest, p as PackageManagerRequest, c as ParadigmInfo, d as ParadigmRequest, R as RelatedRequest, e as ResolvedLanguageRequest, q as RuntimeRequest, S as StatusRequest, g as api, m as getStatuses } from './api-D10hZgSz.cjs';
+export { C as CategoryInfo, a as CategoryRequest, E as EcosystemInfo, b as EcosystemRequest, c as ExtensionRequest, L as LanguageCategory, o as LanguageCollectionRequest, p as LanguageRequest, q as PackageManagerRequest, d as ParadigmInfo, e as ParadigmRequest, R as RelatedRequest, f as ResolvedLanguageRequest, r as RuntimeRequest, S as StatusRequest, h as api, n as getStatuses } from './api-jHE_4U3C.cjs';
 export { L as LanguageSlug } from './registry-DftZRMv6.cjs';
 import './types-BRDmsib7.cjs';

package/dist/api.d.ts

@@ -1,3 +1,3 @@
-export { C as CategoryRequest, E as EcosystemInfo, a as EcosystemRequest, b as ExtensionRequest, L as LanguageCategory, n as LanguageCollectionRequest, o as LanguageRequest, p as PackageManagerRequest, c as ParadigmInfo, d as ParadigmRequest, R as RelatedRequest, e as ResolvedLanguageRequest, q as RuntimeRequest, S as StatusRequest, g as api, m as getStatuses } from './api-DfKZeygA.js';
+export { C as CategoryInfo, a as CategoryRequest, E as EcosystemInfo, b as EcosystemRequest, c as ExtensionRequest, L as LanguageCategory, o as LanguageCollectionRequest, p as LanguageRequest, q as PackageManagerRequest, d as ParadigmInfo, e as ParadigmRequest, R as RelatedRequest, f as ResolvedLanguageRequest, r as RuntimeRequest, S as StatusRequest, h as api, n as getStatuses } from './api-CiSr3n5R.js';
 export { L as LanguageSlug } from './registry-DftZRMv6.js';
 import './types-BRDmsib7.js';