@polyglot-bundles/vi-word-lists 0.1.1

package/src/index.ts

@@ -0,0 +1,499 @@
+/**
+ * Vietnamese Word Lists
+ *
+ * CEFR-aligned vocabulary collections for Vietnamese language learning.
+ * Uses descriptor-based lazy loading: metadata is eager, each set's
+ * JSON is loaded on demand via `descriptor.load()`.
+ */
+
+import {
+  createWordListCatalog,
+  jsonDescriptor,
+  type ExamGrade,
+  type WordListDifficulty,
+  type WordListItem,
+  type WordListSet,
+} from "@syllst/word-lists";
+
+// ─── Sources ───────────────────────────────────────────────────────────────
+
+const SUBTITLE_FREQUENCY_LIST = { name: "Subtitle frequency list", url: "https://github.com/hermitdave/FrequencyWords" };
+const UNKNOWN_SOURCE = { name: "Unknown source" };
+
+// ─── Descriptors ───────────────────────────────────────────────────────────
+
+const descriptors = [
+  jsonDescriptor({
+    id: "a1-vocabulary-01",
+    name: "A1 Vocabulary 01",
+    description: "A1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a1/a1-vocabulary-01.json"),
+  jsonDescriptor({
+    id: "a1-vocabulary-02",
+    name: "A1 Vocabulary 02",
+    description: "A1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a1/a1-vocabulary-02.json"),
+  jsonDescriptor({
+    id: "a1-vocabulary-03",
+    name: "A1 Vocabulary 03",
+    description: "A1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a1/a1-vocabulary-03.json"),
+  jsonDescriptor({
+    id: "a1-vocabulary-04",
+    name: "A1 Vocabulary 04",
+    description: "A1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a1/a1-vocabulary-04.json"),
+  jsonDescriptor({
+    id: "a1-vocabulary-05",
+    name: "A1 Vocabulary 05",
+    description: "A1 level Vietnamese frequency vocabulary (1 words)",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 1,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a1/a1-vocabulary-05.json"),
+  jsonDescriptor({
+    id: "a1-basic-greetings",
+    name: "Basic Greetings",
+    description: "Basic Greetings vocabulary list",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 10,
+    source: UNKNOWN_SOURCE,
+  }, "./json/a1/basic-greetings.json"),
+  jsonDescriptor({
+    id: "a1-colors",
+    name: "Colors",
+    description: "Colors vocabulary list",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 10,
+    source: UNKNOWN_SOURCE,
+  }, "./json/a1/colors.json"),
+  jsonDescriptor({
+    id: "a1-family-members",
+    name: "Family Members",
+    description: "Family Members vocabulary list",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 8,
+    source: UNKNOWN_SOURCE,
+  }, "./json/a1/family-members.json"),
+  jsonDescriptor({
+    id: "a1-food-basics",
+    name: "Food Basics",
+    description: "Food Basics vocabulary list",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 10,
+    source: UNKNOWN_SOURCE,
+  }, "./json/a1/food-basics.json"),
+  jsonDescriptor({
+    id: "a1-numbers-1-10",
+    name: "Numbers 1-10",
+    description: "Numbers 1-10 vocabulary list",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 10,
+    source: UNKNOWN_SOURCE,
+  }, "./json/a1/numbers-1-10.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-01",
+    name: "A2 Vocabulary 01",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-01.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-02",
+    name: "A2 Vocabulary 02",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-02.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-03",
+    name: "A2 Vocabulary 03",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-03.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-04",
+    name: "A2 Vocabulary 04",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-04.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-05",
+    name: "A2 Vocabulary 05",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-05.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-06",
+    name: "A2 Vocabulary 06",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-06.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-07",
+    name: "A2 Vocabulary 07",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-07.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-08",
+    name: "A2 Vocabulary 08",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-08.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-09",
+    name: "A2 Vocabulary 09",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-09.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-10",
+    name: "A2 Vocabulary 10",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-10.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-11",
+    name: "A2 Vocabulary 11",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-11.json"),
+  jsonDescriptor({
+    id: "a2-vocabulary-12",
+    name: "A2 Vocabulary 12",
+    description: "A2 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/a2/a2-vocabulary-12.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-01",
+    name: "B1 Vocabulary 01",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-01.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-02",
+    name: "B1 Vocabulary 02",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-02.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-03",
+    name: "B1 Vocabulary 03",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-03.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-04",
+    name: "B1 Vocabulary 04",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-04.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-05",
+    name: "B1 Vocabulary 05",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-05.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-06",
+    name: "B1 Vocabulary 06",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-06.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-07",
+    name: "B1 Vocabulary 07",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-07.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-08",
+    name: "B1 Vocabulary 08",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-08.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-09",
+    name: "B1 Vocabulary 09",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-09.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-10",
+    name: "B1 Vocabulary 10",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-10.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-11",
+    name: "B1 Vocabulary 11",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-11.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-12",
+    name: "B1 Vocabulary 12",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-12.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-13",
+    name: "B1 Vocabulary 13",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-13.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-14",
+    name: "B1 Vocabulary 14",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-14.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-15",
+    name: "B1 Vocabulary 15",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-15.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-16",
+    name: "B1 Vocabulary 16",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-16.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-17",
+    name: "B1 Vocabulary 17",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-17.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-18",
+    name: "B1 Vocabulary 18",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-18.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-19",
+    name: "B1 Vocabulary 19",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-19.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-20",
+    name: "B1 Vocabulary 20",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-20.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-21",
+    name: "B1 Vocabulary 21",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-21.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-22",
+    name: "B1 Vocabulary 22",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-22.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-23",
+    name: "B1 Vocabulary 23",
+    description: "B1 level Vietnamese frequency vocabulary (50 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-23.json"),
+  jsonDescriptor({
+    id: "b1-vocabulary-24",
+    name: "B1 Vocabulary 24",
+    description: "B1 level Vietnamese frequency vocabulary (49 words)",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 49,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, "./json/b1/b1-vocabulary-24.json"),
+] as const;
+
+export const vietnameseWordListCatalog = createWordListCatalog([...descriptors]);
+
+// Backward-compatible re-exports (deprecated — prefer catalog API)
+export const {
+  getDescriptorById,
+  getDescriptorsByExamGrade,
+  getDescriptorsByCategory,
+  getDescriptorsByDifficulty,
+  getCategories,
+} = vietnameseWordListCatalog;
+
+export type { ExamGrade, WordListDifficulty, WordListItem, WordListSet };