@polyglot-bundles/vi-word-lists 0.2.11 → 0.4.0

package/src/json/pre-a1/survival-phrases.json

@@ -1,100 +1,136 @@
 {
   "id": "pre-a1-survival-phrases",
   "name": "Survival Phrases",
-  "desc": "Essential yes/no, greetings, and basic commands",
-  "cat": "survival",
-  "level": "Pre-A1",
+  "description": "Essential yes/no, greetings, and basic commands",
+  "examGrade": "Pre-A1",
   "difficulty": "beginner",
+  "category": "survival",
   "words": [
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:1",
       "word": "vâng",
       "translation": "Yes",
-      "partOfSpeech": "interjection"
+      "partOfSpeech": "interjection",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:2",
       "word": "không",
       "translation": "No",
-      "partOfSpeech": "interjection"
+      "partOfSpeech": "interjection",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:3",
       "word": "được",
       "translation": "Okay / Agreed",
-      "partOfSpeech": "interjection"
+      "partOfSpeech": "interjection",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:4",
       "word": "cảm ơn",
       "translation": "Thank you",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:5",
       "word": "xin lỗi",
       "translation": "Sorry / Excuse me",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:6",
       "word": "xin chào",
       "translation": "Hello",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:7",
       "word": "tạm biệt",
       "translation": "Goodbye",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:8",
       "word": "đi",
       "translation": "Go",
-      "partOfSpeech": "verb"
+      "partOfSpeech": "verb",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:9",
       "word": "đến",
       "translation": "Come",
-      "partOfSpeech": "verb"
+      "partOfSpeech": "verb",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:10",
       "word": "ăn",
       "translation": "Eat",
-      "partOfSpeech": "verb"
+      "partOfSpeech": "verb",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:11",
       "word": "uống",
       "translation": "Drink",
-      "partOfSpeech": "verb"
+      "partOfSpeech": "verb",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:12",
       "word": "ngủ",
       "translation": "Sleep",
-      "partOfSpeech": "verb"
+      "partOfSpeech": "verb",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:13",
       "word": "gì?",
       "translation": "What?",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:14",
       "word": "ai?",
       "translation": "Who?",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:15",
       "word": "đâu?",
       "translation": "Where?",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:16",
       "word": "khi nào?",
       "translation": "When?",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:17",
       "word": "tại sao?",
       "translation": "Why?",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     },
     {
+      "id": "vi:vocab:pre-a1:survival-phrases:18",
       "word": "như thế nào",
       "translation": "How?",
-      "partOfSpeech": "phrase"
+      "partOfSpeech": "phrase",
+      "examGrade": "Pre-A1"
     }
   ]
 }

package/src/levels/a1.ts

@@ -18,6 +18,6 @@ export {
 export type {
   ExamGrade,
   WordListDifficulty,
-  WordListItem,
-  WordListSet,
+  PolyglotWordListItem,
+  PolyglotWordListSet,
 } from "../index.js";

package/src/levels/a2.ts

@@ -0,0 +1,16 @@
+import { vietnameseWordListCatalog } from "../index.js";
+
+export const a2Descriptors = vietnameseWordListCatalog.getDescriptorsByExamGrade("A2");
+
+export {
+  getDescriptorById,
+  getDescriptorsByCategory,
+  getDescriptorsByDifficulty,
+} from "../index.js";
+
+export type {
+  ExamGrade,
+  WordListDifficulty,
+  PolyglotWordListItem,
+  PolyglotWordListSet,
+} from "../index.js";

package/src/levels/b1.ts

@@ -0,0 +1,16 @@
+import { vietnameseWordListCatalog } from "../index.js";
+
+export const b1Descriptors = vietnameseWordListCatalog.getDescriptorsByExamGrade("B1");
+
+export {
+  getDescriptorById,
+  getDescriptorsByCategory,
+  getDescriptorsByDifficulty,
+} from "../index.js";
+
+export type {
+  ExamGrade,
+  WordListDifficulty,
+  PolyglotWordListItem,
+  PolyglotWordListSet,
+} from "../index.js";

package/src/levels/b2.ts

@@ -0,0 +1,16 @@
+import { vietnameseWordListCatalog } from "../index.js";
+
+export const b2Descriptors = vietnameseWordListCatalog.getDescriptorsByExamGrade("B2");
+
+export {
+  getDescriptorById,
+  getDescriptorsByCategory,
+  getDescriptorsByDifficulty,
+} from "../index.js";
+
+export type {
+  ExamGrade,
+  WordListDifficulty,
+  PolyglotWordListItem,
+  PolyglotWordListSet,
+} from "../index.js";

package/src/levels/pre-a1.ts

@@ -0,0 +1,16 @@
+import { vietnameseWordListCatalog } from "../index.js";
+
+export const preA1Descriptors = vietnameseWordListCatalog.getDescriptorsByExamGrade("Pre-A1");
+
+export {
+  getDescriptorById,
+  getDescriptorsByCategory,
+  getDescriptorsByDifficulty,
+} from "../index.js";
+
+export type {
+  ExamGrade,
+  WordListDifficulty,
+  PolyglotWordListItem,
+  PolyglotWordListSet,
+} from "../index.js";

package/src/vocab.ts

@@ -0,0 +1,28 @@
+import { vietnameseWordListCatalog } from "./index.js";
+import type { WordListItem } from "@syllst/word-lists";
+
+export type VocabEntry = WordListItem & { id: string };
+
+export async function getVocabById(id: string): Promise<VocabEntry | undefined> {
+  for (const descriptor of vietnameseWordListCatalog.descriptors) {
+    const set = await descriptor.load();
+    const word = set.words.find((w) => w.id === id);
+    if (word?.id) return word as VocabEntry;
+  }
+  return undefined;
+}
+
+export async function getAllVocabEntries(): Promise<VocabEntry[]> {
+  const seen = new Set<string>();
+  const entries: VocabEntry[] = [];
+  for (const descriptor of vietnameseWordListCatalog.descriptors) {
+    const set = await descriptor.load();
+    for (const word of set.words) {
+      if (word.id && !seen.has(word.id)) {
+        seen.add(word.id);
+        entries.push(word as VocabEntry);
+      }
+    }
+  }
+  return entries;
+}

package/src/json/a1/basic-greetings.json

@@ -1,60 +0,0 @@
-{
-  "id": "a1-basic-greetings",
-  "name": "Basic Greetings",
-  "desc": "Basic greeting phrases in Vietnamese",
-  "cat": "greetings",
-  "level": "A1",
-  "difficulty": "beginner",
-  "words": [
-    {
-      "word": "xin chào",
-      "translation": "hello",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "chào buổi sáng",
-      "translation": "good morning",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "chào buổi tối",
-      "translation": "good evening",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "chúc ngủ ngon",
-      "translation": "good night",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "tạm biệt",
-      "translation": "goodbye",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "hẹn gặp lại",
-      "translation": "see you again",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "cảm ơn",
-      "translation": "thank you",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "làm ơn",
-      "translation": "please",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "xin lỗi",
-      "translation": "sorry",
-      "partOfSpeech": "phrase"
-    },
-    {
-      "word": "vâng",
-      "translation": "yes",
-      "partOfSpeech": "interjection"
-    }
-  ]
-}

package/src/json/a1/colors.json

@@ -1,60 +0,0 @@
-{
-  "id": "a1-colors",
-  "name": "Colors",
-  "desc": "Basic color words in Vietnamese",
-  "cat": "colors",
-  "level": "A1",
-  "difficulty": "beginner",
-  "words": [
-    {
-      "word": "đỏ",
-      "translation": "red",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "xanh dương",
-      "translation": "blue",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "xanh lá",
-      "translation": "green",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "vàng",
-      "translation": "yellow",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "đen",
-      "translation": "black",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "trắng",
-      "translation": "white",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "cam",
-      "translation": "orange",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "tím",
-      "translation": "purple",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "hồng",
-      "translation": "pink",
-      "partOfSpeech": "adjective"
-    },
-    {
-      "word": "nâu",
-      "translation": "brown",
-      "partOfSpeech": "adjective"
-    }
-  ]
-}

package/src/json/a1/family-members.json

@@ -1,50 +0,0 @@
-{
-  "id": "a1-family-members",
-  "name": "Family Members",
-  "desc": "Family member words in Vietnamese",
-  "cat": "family",
-  "level": "A1",
-  "difficulty": "beginner",
-  "words": [
-    {
-      "word": "mẹ",
-      "translation": "mother",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "bố",
-      "translation": "father",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "chị gái",
-      "translation": "older sister",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "anh trai",
-      "translation": "older brother",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "con gái",
-      "translation": "daughter",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "con trai",
-      "translation": "son",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "bà",
-      "translation": "grandmother",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "ông",
-      "translation": "grandfather",
-      "partOfSpeech": "noun"
-    }
-  ]
-}

package/src/json/a1/food-basics.json

@@ -1,60 +0,0 @@
-{
-  "id": "a1-food-basics",
-  "name": "Food Basics",
-  "desc": "Basic food vocabulary in Vietnamese",
-  "cat": "food",
-  "level": "A1",
-  "difficulty": "beginner",
-  "words": [
-    {
-      "word": "nước",
-      "translation": "water",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "bánh mì",
-      "translation": "bread",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "sữa",
-      "translation": "milk",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "táo",
-      "translation": "apple",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "cà phê",
-      "translation": "coffee",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "trà",
-      "translation": "tea",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "cơm",
-      "translation": "rice",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "thịt",
-      "translation": "meat",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "cá",
-      "translation": "fish",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "rau",
-      "translation": "vegetables",
-      "partOfSpeech": "noun"
-    }
-  ]
-}

package/src/json/a1/numbers-1-10.json

@@ -1,60 +0,0 @@
-{
-  "id": "a1-numbers-1-10",
-  "name": "Numbers 1-10",
-  "desc": "Numbers one through ten in Vietnamese",
-  "cat": "numbers",
-  "level": "A1",
-  "difficulty": "beginner",
-  "words": [
-    {
-      "word": "một",
-      "translation": "one",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "hai",
-      "translation": "two",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "ba",
-      "translation": "three",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "bốn",
-      "translation": "four",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "năm",
-      "translation": "five",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "sáu",
-      "translation": "six",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "bảy",
-      "translation": "seven",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "tám",
-      "translation": "eight",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "chín",
-      "translation": "nine",
-      "partOfSpeech": "number"
-    },
-    {
-      "word": "mười",
-      "translation": "ten",
-      "partOfSpeech": "number"
-    }
-  ]
-}

package/src/json/a2/body-parts.json

@@ -1,110 +0,0 @@
-{
-  "id": "a2-body-parts",
-  "name": "Body Parts",
-  "desc": "Human body parts and anatomy",
-  "cat": "anatomy",
-  "level": "A2",
-  "difficulty": "intermediate",
-  "words": [
-    {
-      "word": "đầu",
-      "translation": "head",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "tóc",
-      "translation": "hair",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "mắt",
-      "translation": "eye",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "mũi",
-      "translation": "nose",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "miệng",
-      "translation": "mouth",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "răng",
-      "translation": "tooth",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "lưỡi",
-      "translation": "tongue",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "tai",
-      "translation": "ear",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "cổ",
-      "translation": "neck",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "vai",
-      "translation": "shoulder",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "tay",
-      "translation": "arm / hand",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "khuỷu tay",
-      "translation": "elbow",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "ngón tay",
-      "translation": "finger",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "bụng",
-      "translation": "stomach / belly",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "chân",
-      "translation": "leg / foot",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "đầu gối",
-      "translation": "knee",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "bàn chân",
-      "translation": "foot",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "ngón chân",
-      "translation": "toe",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "da",
-      "translation": "skin",
-      "partOfSpeech": "noun"
-    },
-    {
-      "word": "xương",
-      "translation": "bone",
-      "partOfSpeech": "noun"
-    }
-  ]
-}