code-languages 1.40.11 → 1.42.0

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

@@ -1,5 +1,5 @@
-import { L as LanguageSlug } from './registry-p4uQJ2gP.cjs';
-import { d as Locale, e as LocalizedLanguage } from './types-B0_wjl_Q.cjs';
+import { L as LanguageSlug } from './registry-DftZRMv6.cjs';
+import { f as Locale, g as LocalizedLanguage, c as LanguageStatus } from './types-BRDmsib7.cjs';
 
 type LanguageCategory = 'frontend' | 'backend' | 'fullstack' | 'systems' | 'data-science' | 'scripting' | 'other';
 declare function getCategories(): LanguageCategory[];
@@ -62,6 +62,18 @@ interface LanguageRequest {
      */
     load(): Promise<LocalizedLanguage | undefined>;
 }
+/**
+ * A `LanguageRequest` for a slug that is statically known to exist in the catalog,
+ * so `get()` and `load()` never return `undefined`.
+ */
+interface ResolvedLanguageRequest {
+    /** Sets the requested locale for this language lookup. */
+    locale(locale: Locale): ResolvedLanguageRequest;
+    /** Reads the language from the in-memory catalog and localizes it. */
+    get(): LocalizedLanguage;
+    /** Dynamically imports the language module and localizes it. */
+    load(): Promise<LocalizedLanguage>;
+}
 interface RuntimeRequest {
     /** Metadata about the matched runtime platform. Returns undefined for unknown values. */
     info(): RuntimeInfo | undefined;
@@ -92,6 +104,18 @@ interface EcosystemRequest {
     /** Languages that belong to this ecosystem. */
     langs(): LanguageCollectionRequest;
 }
+interface ExtensionRequest {
+    /** Languages whose extensions include this extension or exact filename. */
+    langs(): LanguageCollectionRequest;
+}
+interface StatusRequest {
+    /** Languages with this lifecycle status. Languages without a status count as `active`. */
+    langs(): LanguageCollectionRequest;
+}
+interface RelatedRequest {
+    /** Languages linked to the given language through `relations`, in either direction. */
+    langs(): LanguageCollectionRequest;
+}
 interface LanguageCollectionRequest {
     /**
      * Sets the requested locale for every language returned by this collection lookup.
@@ -114,14 +138,18 @@ interface LanguageCollectionRequest {
  */
 declare const api: {
     /**
-     * Selects a language by slug.
+     * Selects a language by slug or alias.
      *
-     * Input is normalized to the package slug format before lookup.
+     * Input is normalized to the package slug format before lookup, and language
+     * aliases such as `golang`, `C#`, or `wasm` resolve to their catalog slug.
+     * When the slug is a known literal, `get()` and `load()` are typed as
+     * always returning a language.
      *
      * @example
      * api.language("astro").locale("es-PE").get();
+     * api.language("golang").get()?.slug; // "go"
      */
-    language(slug: RuntimeLanguageSlug): LanguageRequest;
+    language<Slug extends string>(slug: Slug): Slug extends LanguageSlug ? ResolvedLanguageRequest : LanguageRequest;
     /**
      * Selects every language in the catalog.
      *
@@ -136,6 +164,48 @@ declare const api: {
      * api.detect("src/App.vue").locale("es").get();
      */
     detect(filename: string): LanguageRequest;
+    /**
+     * Selects every language that registers the given file extension or exact filename.
+     *
+     * Accepts values with or without the leading dot: `.ts`, `ts`, or `Dockerfile`.
+     * Unlike `detect`, this matches the extension entry exactly instead of ranking
+     * suffix matches, so `api.extension('.h')` returns both C and C++.
+     *
+     * @example
+     * api.extension('.h').langs().get().map((language) => language.slug); // ["c", "cpp"]
+     * api.extension('ts').langs().locale('es').get();
+     */
+    extension(value: string): ExtensionRequest;
+    /**
+     * Searches languages by name, slug, or alias with ranked results.
+     *
+     * Ranking: exact slug/alias/name match, then name or slug prefix, then name
+     * substring, then slug or alias substring. Empty queries return no results.
+     *
+     * @example
+     * api.search('type').get().map((language) => language.slug); // ["typescript", "typst", ...]
+     * api.search('golang').get().at(0)?.slug; // "go"
+     */
+    search(query: string): LanguageCollectionRequest;
+    /**
+     * Selects every language with the given lifecycle status.
+     *
+     * Languages without a `status` field count as `active`.
+     *
+     * @example
+     * api.status('legacy').langs().get();
+     * api.status('experimental').langs().locale('es').get();
+     */
+    status(value: LanguageStatus): StatusRequest;
+    /**
+     * Selects every language related to the given language through `relations`,
+     * in either direction.
+     *
+     * @example
+     * api.related('javascript').langs().get(); // TypeScript, CoffeeScript, Elm, ...
+     * api.related('typescript').langs().get(); // JavaScript
+     */
+    related(slug: RuntimeLanguageSlug): RelatedRequest;
     /**
      * Selects every language that runs on or targets the given platform or runtime.
      *
@@ -206,5 +276,7 @@ declare const api: {
      */
     detectAll(filename: string): LanguageCollectionRequest;
 };
+/** 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 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 };
+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 };

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

@@ -1,5 +1,5 @@
-import { L as LanguageSlug } from './registry-p4uQJ2gP.js';
-import { d as Locale, e as LocalizedLanguage } from './types-B0_wjl_Q.js';
+import { L as LanguageSlug } from './registry-DftZRMv6.js';
+import { f as Locale, g as LocalizedLanguage, c as LanguageStatus } from './types-BRDmsib7.js';
 
 type LanguageCategory = 'frontend' | 'backend' | 'fullstack' | 'systems' | 'data-science' | 'scripting' | 'other';
 declare function getCategories(): LanguageCategory[];
@@ -62,6 +62,18 @@ interface LanguageRequest {
      */
     load(): Promise<LocalizedLanguage | undefined>;
 }
+/**
+ * A `LanguageRequest` for a slug that is statically known to exist in the catalog,
+ * so `get()` and `load()` never return `undefined`.
+ */
+interface ResolvedLanguageRequest {
+    /** Sets the requested locale for this language lookup. */
+    locale(locale: Locale): ResolvedLanguageRequest;
+    /** Reads the language from the in-memory catalog and localizes it. */
+    get(): LocalizedLanguage;
+    /** Dynamically imports the language module and localizes it. */
+    load(): Promise<LocalizedLanguage>;
+}
 interface RuntimeRequest {
     /** Metadata about the matched runtime platform. Returns undefined for unknown values. */
     info(): RuntimeInfo | undefined;
@@ -92,6 +104,18 @@ interface EcosystemRequest {
     /** Languages that belong to this ecosystem. */
     langs(): LanguageCollectionRequest;
 }
+interface ExtensionRequest {
+    /** Languages whose extensions include this extension or exact filename. */
+    langs(): LanguageCollectionRequest;
+}
+interface StatusRequest {
+    /** Languages with this lifecycle status. Languages without a status count as `active`. */
+    langs(): LanguageCollectionRequest;
+}
+interface RelatedRequest {
+    /** Languages linked to the given language through `relations`, in either direction. */
+    langs(): LanguageCollectionRequest;
+}
 interface LanguageCollectionRequest {
     /**
      * Sets the requested locale for every language returned by this collection lookup.
@@ -114,14 +138,18 @@ interface LanguageCollectionRequest {
  */
 declare const api: {
     /**
-     * Selects a language by slug.
+     * Selects a language by slug or alias.
      *
-     * Input is normalized to the package slug format before lookup.
+     * Input is normalized to the package slug format before lookup, and language
+     * aliases such as `golang`, `C#`, or `wasm` resolve to their catalog slug.
+     * When the slug is a known literal, `get()` and `load()` are typed as
+     * always returning a language.
      *
      * @example
      * api.language("astro").locale("es-PE").get();
+     * api.language("golang").get()?.slug; // "go"
      */
-    language(slug: RuntimeLanguageSlug): LanguageRequest;
+    language<Slug extends string>(slug: Slug): Slug extends LanguageSlug ? ResolvedLanguageRequest : LanguageRequest;
     /**
      * Selects every language in the catalog.
      *
@@ -136,6 +164,48 @@ declare const api: {
      * api.detect("src/App.vue").locale("es").get();
      */
     detect(filename: string): LanguageRequest;
+    /**
+     * Selects every language that registers the given file extension or exact filename.
+     *
+     * Accepts values with or without the leading dot: `.ts`, `ts`, or `Dockerfile`.
+     * Unlike `detect`, this matches the extension entry exactly instead of ranking
+     * suffix matches, so `api.extension('.h')` returns both C and C++.
+     *
+     * @example
+     * api.extension('.h').langs().get().map((language) => language.slug); // ["c", "cpp"]
+     * api.extension('ts').langs().locale('es').get();
+     */
+    extension(value: string): ExtensionRequest;
+    /**
+     * Searches languages by name, slug, or alias with ranked results.
+     *
+     * Ranking: exact slug/alias/name match, then name or slug prefix, then name
+     * substring, then slug or alias substring. Empty queries return no results.
+     *
+     * @example
+     * api.search('type').get().map((language) => language.slug); // ["typescript", "typst", ...]
+     * api.search('golang').get().at(0)?.slug; // "go"
+     */
+    search(query: string): LanguageCollectionRequest;
+    /**
+     * Selects every language with the given lifecycle status.
+     *
+     * Languages without a `status` field count as `active`.
+     *
+     * @example
+     * api.status('legacy').langs().get();
+     * api.status('experimental').langs().locale('es').get();
+     */
+    status(value: LanguageStatus): StatusRequest;
+    /**
+     * Selects every language related to the given language through `relations`,
+     * in either direction.
+     *
+     * @example
+     * api.related('javascript').langs().get(); // TypeScript, CoffeeScript, Elm, ...
+     * api.related('typescript').langs().get(); // JavaScript
+     */
+    related(slug: RuntimeLanguageSlug): RelatedRequest;
     /**
      * Selects every language that runs on or targets the given platform or runtime.
      *
@@ -206,5 +276,7 @@ declare const api: {
      */
     detectAll(filename: string): LanguageCollectionRequest;
 };
+/** 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 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 };
+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 };