🤖 Merge PR DefinitelyTyped#74276 Adds Kotobee Definitions by @Bashamega

Author: Bashamega

types/kotobee/.npmignore

@@ -0,0 +1,5 @@
+*
+!**/*.d.ts
+!**/*.d.cts
+!**/*.d.mts
+!**/*.d.*.ts

types/kotobee/index.d.ts

@@ -0,0 +1,55 @@
+type LanguageCode =
+    | "ar"
+    | "de"
+    | "es"
+    | "hu"
+    | "jp"
+    | "ms"
+    | "no"
+    | "pt"
+    | "ru"
+    | "tr"
+    | "zh-tw"
+    | "cy"
+    | "en"
+    | "fr"
+    | "it"
+    | "ko"
+    | "nl"
+    | "pl"
+    | "ro"
+    | "sw"
+    | "zh-cn"
+    | "zh";
+
+type Directions = "ltr" | "rtl";
+
+interface KotobeeReader {
+    /**
+     * Clears cached local data used by the reader.
+     */
+    clearCache: () => void;
+
+    /**
+     * Clears all event listeners attached by the reader.
+     */
+    clearListeners: () => void;
+
+    /**
+     * Clears remotely fetched data (e.g., cloud sync, remote storage).
+     */
+    clearRemoteData: () => void;
+
+    /**
+     * Sets the active UI language of the reader.
+     */
+    setLanguage: (language: LanguageCode) => void;
+
+    /**
+     * Sets reading direction (left-to-right or right-to-left).
+     */
+    setDirection: (direction: Directions) => void;
+}
+
+// Declare the global variable
+declare const Kotobee: KotobeeReader;

types/kotobee/kotobee-tests.ts

@@ -0,0 +1,68 @@
+// ------------------- Correct usage -------------------
+const validLanguages: LanguageCode[] = [
+    "ar",
+    "de",
+    "es",
+    "hu",
+    "jp",
+    "ms",
+    "no",
+    "pt",
+    "ru",
+    "tr",
+    "zh-tw",
+    "cy",
+    "en",
+    "fr",
+    "it",
+    "ko",
+    "nl",
+    "pl",
+    "ro",
+    "sw",
+    "zh-cn",
+    "zh",
+];
+
+const validDirections: Directions[] = ["ltr", "rtl"];
+
+// Test all valid languages
+validLanguages.forEach(lang => Kotobee.setLanguage(lang));
+
+// Test all valid directions
+validDirections.forEach(dir => Kotobee.setDirection(dir));
+
+// ------------------- Incorrect usage -------------------
+
+// Invalid language
+// @ts-expect-error
+Kotobee.setLanguage("invalid");
+
+// Invalid direction
+// @ts-expect-error
+Kotobee.setDirection("up");
+
+// Calling clearCache with parameters should error
+// @ts-expect-error
+Kotobee.clearCache(123);
+
+// Calling clearListeners with parameters should error
+// @ts-expect-error
+Kotobee.clearListeners("test");
+
+// ------------------- Type assignments -------------------
+
+// Assign valid types
+validLanguages.forEach(lang => {
+    const l: LanguageCode = lang; // $ExpectType LanguageCode
+});
+
+validDirections.forEach(dir => {
+    const d: Directions = dir; // $ExpectType Directions
+});
+
+// Invalid assignments
+// @ts-expect-error
+const fakeLang: LanguageCode = "madeup";
+// @ts-expect-error
+const dirCenter: Directions = "center";

types/kotobee/package.json

@@ -0,0 +1,19 @@
+{
+    "private": true,
+    "name": "@types/kotobee",
+    "nonNpm": true,
+    "nonNpmDescription": "This is an SDK for Kotobee Author application.",
+    "version": "0.0.9999",
+    "projects": [
+        "https://support.kotobee.com/en/support/solutions/folders/8000082574"
+    ],
+    "devDependencies": {
+        "@types/kotobee": "workspace:."
+    },
+    "owners": [
+        {
+            "name": "Bashamega",
+            "githubUsername": "Bashamega"
+        }
+    ]
+}

types/kotobee/tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+        "module": "node16",
+        "lib": [
+            "es6"
+        ],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictFunctionTypes": true,
+        "strictNullChecks": true,
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "kotobee-tests.ts"
+    ]
+}