raycast-language-detector

Detect languages through Raycast AI or third-party language detectors


Install

``shell
npm i raycast-language-detector
`

Usages

`typescript
import { detect } from "raycast-language-detector";
import { detect as aiDetect } from "raycast-language-detector/ai";
import { detect as francDetect } from "raycast-language-detector/franc";
import { detect as langDetect } from "raycast-language-detector/languagedetect";
import { detect as tinyDetect } from "raycast-language-detector/tinyld";

await detect("Favourite colour");
//=> {languageCode: 'en_GB', languageName: 'British English'}

await aiDetect("New Level Unlocked");
//=> {languageCode: 'en', languageName: 'English'}

francDetect("여기서요?");
//=> {languageCode: 'ko', languageName: 'Korean'}

langDetect("海纳百川，有容乃大");
//=> {languageCode: 'zh', languageName: 'Chinese'}

tinyDetect("一緒に泣いてくれた人");
//=> {languageCode: 'jp', languageName: 'Japanese'}
`

API

$3

This uses all possible detectors in the Detector.AI, Detector.Franc, Detector.LanguageDetect, Detector.TinyLD order. It there is no result, it will fallback to the next detector.

The fallthrough order of detectors can be customized, you can simply pass in an array of Detector to options.detectors.

You can also specify the format of language code, possible values are LanguageCodeFormat.ISO_639_1, LanguageCodeFormat.ISO_639_2, and LanguageCodeFormat.ISO_639_3.

`typescript
export declare const detect: (
text: string,
options?: {
detectors?: Detector[];
languageCodeFormat?: LanguageCodeFormat;
aiDetectOptions?: {
aiAskOptions?: AI.AskOptions;
languageCodes?: string[];
languageCodeFormat?: LanguageCodeFormat;
};
},
) => Promise;
`

`typescript
import { detect } from "raycast-language-detector";

await detect("Viel Glück");
//=> {languageCode: 'de_DE', languageName: 'German (Germany)'}
`

$3

This uses the Raycast AI for detecting text.

You don't have to check user's permission to Raycast AI before using this. We already handled it for you. It will return a undefined if the user doesn't have access to Raycast AI.

`typescript
export declare const makePrompt: (
text: string,
languageCodes?: string[],
) => string;

export declare const detect: (
text: string,
options?: {
aiAskOptions?: AI.AskOptions;
languageCodes?: string[];
languageCodeFormat?: LanguageCodeFormat;
},
) => Promise;

export declare const customPromptDetect: (
prompt: string,
options?: { aiAskOptions?: AI.AskOptions },
) => Promise;
`

`typescript
import { detect, customPromptDetect } from "raycast-language-detector/ai";

await detect("colour", { languageCodes: ["en_US", "en_GB"] });
//=> {languageCode: 'en_GB', languageName: 'British English'}

// Create a custom prompt which detects en_US and en_GB only
const customPrompt = makePrompt("pieapple pizza", ["en_US", "en_GB"]);

await customPromptDetect(customPrompt);
//=> {languageCode: 'en_US', languageName: 'American English'}
`

$3

This uses the franc for detecting text.

`typescript
export declare const detect: (
text: string,
options?: {
languageCodeFormat?: LanguageCodeFormat;
},
) => Language | undefined;
`

`typescript
import { detect } from "raycast-language-detect/franc";

detect("여기서요?");
//=> {languageCode: 'ko', languageName: 'Korean'}
`

$3

This uses the languagedetect for detecting text.

`typescript
export declare const detect: (
text: string,
options?: {
languageCodeFormat?: LanguageCodeFormat;
},
) => Language | undefined;
`

`typescript
import { detect } from "raycast-language-detector/languagedetector";

detect("海纳百川，有容乃大");
//=> {languageCode: 'zh', languageName: 'Chinese'}
`

$3

This uses the tinyld for detecting text.

`typescript
export declare const detect: (
text: string,
options?: {
languageCodeFormat: LanguageCodeFormat;
},
) => Language | undefined;
`

`typescript
import { detect } from "raycast-language-detector/tinyld";

detect("一緒に泣いてくれた人");
//=> {languageCode: 'jp', languageName: 'Japanese'}
`

$3

It exposes some useful utilities for detecting languages.

#### languageCodeToName(languageCode: string): string

It uses JavaScript built-in
Intl.DisplayNames for converting language code to the name.

The input value can be a languageCode ["-" scriptCode] ["-" regionCode ] \*("-" variant ) subsequence of the unicode_language_id grammar in UTS 35's Unicode Language and Locale Identifiers grammar. languageCode is either a two letters ISO 639-1 language code or a three letters ISO 639-2 language code.

`typescript
import { languageCodeToName } from "raycast-language-detector/utils";

languageCodeToName("en");
//=> 'English'

languageCodeToName("eng");
//=> 'English'

languageCodeToName("en_US");
//=> 'American English'

languageCodeToName("en_GB");
//=> 'British English'
`

Who's using raycast-langauge-detector`?

- Easy OCR - Use Tesseract OCR to extract text from screenshot
- Language Detector - Detect languages through Raycast AI or third-party language detectors

License

MIT