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

package/src/json/b1/b1-weather.json

@@ -0,0 +1,115 @@
+{
+  "id": "b1-weather",
+  "name": "Weather",
+  "description": "Weather and climate terms",
+  "examGrade": "B1",
+  "difficulty": "intermediate",
+  "category": "nature",
+  "words": [
+    {
+      "id": "vi:vocab:b1:weather:1",
+      "word": "thời tiết",
+      "translation": "weather",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:2",
+      "word": "nắng",
+      "translation": "sunny",
+      "partOfSpeech": "adjective",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:3",
+      "word": "mưa",
+      "translation": "rain / rainy",
+      "partOfSpeech": "noun / verb",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:4",
+      "word": "gió",
+      "translation": "wind / windy",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:5",
+      "word": "lạnh",
+      "translation": "cold",
+      "partOfSpeech": "adjective",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:6",
+      "word": "nóng",
+      "translation": "hot",
+      "partOfSpeech": "adjective",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:7",
+      "word": "ấm",
+      "translation": "warm",
+      "partOfSpeech": "adjective",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:8",
+      "word": "mát",
+      "translation": "cool",
+      "partOfSpeech": "adjective",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:9",
+      "word": "bão",
+      "translation": "storm / typhoon",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:10",
+      "word": "tuyết",
+      "translation": "snow",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:11",
+      "word": "sương mù",
+      "translation": "fog / foggy",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:12",
+      "word": "mây",
+      "translation": "cloud / cloudy",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:13",
+      "word": "sấm",
+      "translation": "thunder",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:14",
+      "word": "sét",
+      "translation": "lightning",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    },
+    {
+      "id": "vi:vocab:b1:weather:15",
+      "word": "lũ lụt",
+      "translation": "flood",
+      "partOfSpeech": "noun",
+      "examGrade": "B1"
+    }
+  ]
+}

package/src/json/b2/abstract-concepts.json

@@ -1,85 +1,115 @@
 {
   "id": "b2-abstract-concepts",
   "name": "Abstract Concepts",
-  "desc": "Abstract philosophical and social concepts",
-  "cat": "abstract",
-  "level": "B2",
+  "description": "Abstract philosophical and social concepts",
+  "examGrade": "B2",
   "difficulty": "advanced",
+  "category": "abstract",
   "words": [
     {
+      "id": "vi:vocab:b2:abstract-concepts:1",
       "word": "tự do",
       "translation": "freedom / liberty",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:2",
       "word": "hòa bình",
       "translation": "peace",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:3",
       "word": "công bằng",
       "translation": "justice / fairness",
-      "partOfSpeech": "noun / adjective"
+      "partOfSpeech": "noun / adjective",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:4",
       "word": "sự thật",
       "translation": "truth",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:5",
       "word": "niềm tin",
       "translation": "belief / faith",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:6",
       "word": "hy vọng",
       "translation": "hope",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:7",
       "word": "ước mơ",
       "translation": "dream / aspiration",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:8",
       "word": "trách nhiệm",
       "translation": "responsibility",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:9",
       "word": "nghĩa vụ",
       "translation": "duty / obligation",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:10",
       "word": "quyền lợi",
       "translation": "right / benefit",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:11",
       "word": "dân chủ",
       "translation": "democracy",
-      "partOfSpeech": "noun"
+      "partOfSpeech": "noun",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:12",
       "word": "độc lập",
       "translation": "independence",
-      "partOfSpeech": "noun / adjective"
+      "partOfSpeech": "noun / adjective",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:13",
       "word": "phát triển",
       "translation": "development",
-      "partOfSpeech": "noun / verb"
+      "partOfSpeech": "noun / verb",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:14",
       "word": "tiến bộ",
       "translation": "progress",
-      "partOfSpeech": "noun / adjective"
+      "partOfSpeech": "noun / adjective",
+      "examGrade": "B2"
     },
     {
+      "id": "vi:vocab:b2:abstract-concepts:15",
       "word": "thành công",
       "translation": "success",
-      "partOfSpeech": "noun / adjective"
+      "partOfSpeech": "noun / adjective",
+      "examGrade": "B2"
     }
   ]
 }

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/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,
+  WordListItem,
+  WordListSet,
+} 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,
+  WordListItem,
+  WordListSet,
+} 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,
+  WordListItem,
+  WordListSet,
+} 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,
+  WordListItem,
+  WordListSet,
+} 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"
-    }
-  ]
-}