code-languages 1.39.0 → 1.40.0

package/README.md

@@ -238,6 +238,70 @@ 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 `api.paradigm(value)` to filter languages by programming paradigm:
+
+```ts
+import { api, getParadigms } from "code-languages";
+
+// Get paradigm metadata
+const info = api.paradigm('functional').info();
+// {
+//   slug: 'functional',
+//   name: 'Functional',
+//   description: 'Computation through function evaluation, immutability, and avoiding side effects.',
+//   aliases: ['functional', 'fp', 'pure-functional'],
+// }
+
+// Get languages that belong to this paradigm
+const langs = api.paradigm('functional').langs().get();
+const langsEs = api.paradigm('oop').langs().locale('es').get();
+await api.paradigm('object-oriented').langs().load();
+
+// Returns undefined / [] for unknown values
+api.paradigm('unknown-xyz').info();         // undefined
+api.paradigm('unknown-xyz').langs().get();  // []
+
+// List all available paradigms
+getParadigms();
+```
+
+Supported paradigm aliases include: `functional` / `fp`, `object-oriented` / `oop`,
+`imperative` / `procedural`, `declarative`, `logic`, `concurrent`, `reactive`, `scripting` / `shell`,
+`query`, `markup`, `templating`, `array`, `systems` / `low-level`, `stack-based` / `concatenative`,
+`shader` / `gpu`, and more. Searches `paradigms` on each language.
+
+Use `api.ecosystem(value)` to filter languages by technology ecosystem:
+
+```ts
+import { api, getEcosystems } from "code-languages";
+
+// Get ecosystem metadata
+const info = api.ecosystem('jvm').info();
+// {
+//   slug: 'jvm',
+//   name: 'JVM',
+//   description: 'Languages that run on the Java Virtual Machine.',
+//   aliases: ['jvm', 'java'],
+// }
+
+// Get languages that belong to this ecosystem
+const langs = api.ecosystem('jvm').langs().get();
+const langsEs = api.ecosystem('data-science').langs().locale('es').get();
+await api.ecosystem('web').langs().load();
+
+// Returns undefined / [] for unknown values
+api.ecosystem('unknown-xyz').info();         // undefined
+api.ecosystem('unknown-xyz').langs().get();  // []
+
+// List all available ecosystems
+getEcosystems();
+```
+
+Supported ecosystem aliases include: `web` / `frontend`, `node` / `nodejs`, `jvm` / `java`,
+`dotnet` / `.net`, `data-science` / `ml`, `embedded` / `iot`, `game-dev` / `games`,
+`blockchain` / `web3`, `mobile`, `wasm`, `cloud`, `kubernetes` / `k8s`, `systems`,
+`formal-methods` / `verification`, `gpu` / `graphics`, and more. Searches `tooling.ecosystems` on each language.
+
 Use `localizeLanguage` to read localized display content with English fallback:
 
 ```ts

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

@@ -4,6 +4,14 @@ 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 EcosystemInfo {
+    slug: string;
+    name: string;
+    description: string;
+    aliases: string[];
+}
+declare function getEcosystems(): EcosystemInfo[];
+
 interface PackageManagerInfo {
     slug: string;
     name: string;
@@ -14,6 +22,14 @@ interface PackageManagerInfo {
 }
 declare function getPackageManagers(): PackageManagerInfo[];
 
+interface ParadigmInfo {
+    slug: string;
+    name: string;
+    description: string;
+    aliases: string[];
+}
+declare function getParadigms(): ParadigmInfo[];
+
 interface RuntimeInfo {
     slug: string;
     name: string;
@@ -64,6 +80,18 @@ interface CategoryRequest {
     /** Languages that belong to this category. */
     langs(): LanguageCollectionRequest;
 }
+interface ParadigmRequest {
+    /** Metadata about the matched paradigm. Returns undefined for unknown values. */
+    info(): ParadigmInfo | undefined;
+    /** Languages that use this programming paradigm. */
+    langs(): LanguageCollectionRequest;
+}
+interface EcosystemRequest {
+    /** Metadata about the matched ecosystem. Returns undefined for unknown values. */
+    info(): EcosystemInfo | undefined;
+    /** Languages that belong to this ecosystem. */
+    langs(): LanguageCollectionRequest;
+}
 interface LanguageCollectionRequest {
     /**
      * Sets the requested locale for every language returned by this collection lookup.
@@ -149,6 +177,28 @@ declare const api: {
      * await api.category('data-science').langs().load();
      */
     category(value: LanguageCategory): CategoryRequest;
+    /**
+     * Selects every language that uses the given programming paradigm.
+     *
+     * Accepts common aliases: 'functional', 'fp', 'object-oriented', 'oop', 'declarative', etc.
+     * Searches `language.paradigms`.
+     *
+     * @example
+     * api.paradigm('functional').langs().locale('es').get();
+     * api.paradigm('oop').info();
+     */
+    paradigm(value: string): ParadigmRequest;
+    /**
+     * Selects every language that belongs to the given ecosystem.
+     *
+     * Accepts common aliases: 'web', 'jvm', 'dotnet', 'devops', 'data-science', 'embedded', etc.
+     * Searches `tooling.ecosystems`.
+     *
+     * @example
+     * api.ecosystem('jvm').langs().locale('es').get();
+     * api.ecosystem('blockchain').info();
+     */
+    ecosystem(value: string): EcosystemRequest;
     /**
      * Detects every matching language for a filename or path.
      *
@@ -157,4 +207,4 @@ declare const api: {
     detectAll(filename: string): LanguageCollectionRequest;
 };
 
-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 };
+export { type CategoryRequest as C, type EcosystemInfo as E, type LanguageCategory as L, type PackageManagerInfo as P, type RuntimeInfo as R, type EcosystemRequest as a, type ParadigmInfo as b, type ParadigmRequest as c, api as d, getEcosystems as e, getPackageManagers as f, getCategories as g, getParadigms as h, getRuntimes as i, type LanguageCollectionRequest as j, type LanguageRequest as k, type PackageManagerRequest as l, type RuntimeRequest as m };

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

@@ -4,6 +4,14 @@ 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 EcosystemInfo {
+    slug: string;
+    name: string;
+    description: string;
+    aliases: string[];
+}
+declare function getEcosystems(): EcosystemInfo[];
+
 interface PackageManagerInfo {
     slug: string;
     name: string;
@@ -14,6 +22,14 @@ interface PackageManagerInfo {
 }
 declare function getPackageManagers(): PackageManagerInfo[];
 
+interface ParadigmInfo {
+    slug: string;
+    name: string;
+    description: string;
+    aliases: string[];
+}
+declare function getParadigms(): ParadigmInfo[];
+
 interface RuntimeInfo {
     slug: string;
     name: string;
@@ -64,6 +80,18 @@ interface CategoryRequest {
     /** Languages that belong to this category. */
     langs(): LanguageCollectionRequest;
 }
+interface ParadigmRequest {
+    /** Metadata about the matched paradigm. Returns undefined for unknown values. */
+    info(): ParadigmInfo | undefined;
+    /** Languages that use this programming paradigm. */
+    langs(): LanguageCollectionRequest;
+}
+interface EcosystemRequest {
+    /** Metadata about the matched ecosystem. Returns undefined for unknown values. */
+    info(): EcosystemInfo | undefined;
+    /** Languages that belong to this ecosystem. */
+    langs(): LanguageCollectionRequest;
+}
 interface LanguageCollectionRequest {
     /**
      * Sets the requested locale for every language returned by this collection lookup.
@@ -149,6 +177,28 @@ declare const api: {
      * await api.category('data-science').langs().load();
      */
     category(value: LanguageCategory): CategoryRequest;
+    /**
+     * Selects every language that uses the given programming paradigm.
+     *
+     * Accepts common aliases: 'functional', 'fp', 'object-oriented', 'oop', 'declarative', etc.
+     * Searches `language.paradigms`.
+     *
+     * @example
+     * api.paradigm('functional').langs().locale('es').get();
+     * api.paradigm('oop').info();
+     */
+    paradigm(value: string): ParadigmRequest;
+    /**
+     * Selects every language that belongs to the given ecosystem.
+     *
+     * Accepts common aliases: 'web', 'jvm', 'dotnet', 'devops', 'data-science', 'embedded', etc.
+     * Searches `tooling.ecosystems`.
+     *
+     * @example
+     * api.ecosystem('jvm').langs().locale('es').get();
+     * api.ecosystem('blockchain').info();
+     */
+    ecosystem(value: string): EcosystemRequest;
     /**
      * Detects every matching language for a filename or path.
      *
@@ -157,4 +207,4 @@ declare const api: {
     detectAll(filename: string): LanguageCollectionRequest;
 };
 
-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 };
+export { type CategoryRequest as C, type EcosystemInfo as E, type LanguageCategory as L, type PackageManagerInfo as P, type RuntimeInfo as R, type EcosystemRequest as a, type ParadigmInfo as b, type ParadigmRequest as c, api as d, getEcosystems as e, getPackageManagers as f, getCategories as g, getParadigms as h, getRuntimes as i, type LanguageCollectionRequest as j, type LanguageRequest as k, type PackageManagerRequest as l, type RuntimeRequest as m };