@polyglot-bundles/vi-word-lists 0.1.2 → 0.2.9

package/src/index.ts

@@ -1,499 +1,489 @@
-/**
- * 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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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,
-  }, () => import("./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 };
+/**
+ * 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 Frequency Band 1 (1-50)",
+    description: "A1 level Vietnamese frequency vocabulary",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a1/a1-vocabulary-01.json")),
+  jsonDescriptor({
+    id: "a1-vocabulary-02",
+    name: "A1 Frequency Band 2 (51-100)",
+    description: "A1 level Vietnamese frequency vocabulary",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a1/a1-vocabulary-02.json")),
+  jsonDescriptor({
+    id: "a1-vocabulary-03",
+    name: "A1 Frequency Band 3 (101-150)",
+    description: "A1 level Vietnamese frequency vocabulary",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a1/a1-vocabulary-03.json")),
+  jsonDescriptor({
+    id: "a1-vocabulary-04",
+    name: "A1 Frequency Band 4 (151-200)",
+    description: "A1 level Vietnamese frequency vocabulary",
+    examGrade: "A1",
+    category: "general",
+    difficulty: "beginner",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a1/a1-vocabulary-04.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,
+  }, () => import("./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,
+  }, () => import("./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,
+  }, () => import("./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,
+  }, () => import("./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,
+  }, () => import("./json/a1/numbers-1-10.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-01",
+    name: "A2 Frequency Band 1 (1-50)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-01.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-02",
+    name: "A2 Frequency Band 2 (51-100)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-02.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-03",
+    name: "A2 Frequency Band 3 (101-150)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-03.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-04",
+    name: "A2 Frequency Band 4 (151-200)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-04.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-05",
+    name: "A2 Frequency Band 5 (201-250)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-05.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-06",
+    name: "A2 Frequency Band 6 (251-300)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-06.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-07",
+    name: "A2 Frequency Band 7 (301-350)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-07.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-08",
+    name: "A2 Frequency Band 8 (351-400)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-08.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-09",
+    name: "A2 Frequency Band 9 (401-450)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-09.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-10",
+    name: "A2 Frequency Band 10 (451-500)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-10.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-11",
+    name: "A2 Frequency Band 11 (501-550)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-11.json")),
+  jsonDescriptor({
+    id: "a2-vocabulary-12",
+    name: "A2 Frequency Band 12 (551-600)",
+    description: "A2 level Vietnamese frequency vocabulary",
+    examGrade: "A2",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/a2/a2-vocabulary-12.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-01",
+    name: "B1 Frequency Band 1 (1-50)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-01.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-02",
+    name: "B1 Frequency Band 2 (51-100)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-02.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-03",
+    name: "B1 Frequency Band 3 (101-150)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-03.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-04",
+    name: "B1 Frequency Band 4 (151-200)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-04.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-05",
+    name: "B1 Frequency Band 5 (201-250)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-05.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-06",
+    name: "B1 Frequency Band 6 (251-300)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-06.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-07",
+    name: "B1 Frequency Band 7 (301-350)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-07.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-08",
+    name: "B1 Frequency Band 8 (351-400)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-08.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-09",
+    name: "B1 Frequency Band 9 (401-450)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-09.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-10",
+    name: "B1 Frequency Band 10 (451-500)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-10.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-11",
+    name: "B1 Frequency Band 11 (501-550)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-11.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-12",
+    name: "B1 Frequency Band 12 (551-600)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-12.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-13",
+    name: "B1 Frequency Band 13 (601-650)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-13.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-14",
+    name: "B1 Frequency Band 14 (651-700)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-14.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-15",
+    name: "B1 Frequency Band 15 (701-750)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-15.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-16",
+    name: "B1 Frequency Band 16 (751-800)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-16.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-17",
+    name: "B1 Frequency Band 17 (801-850)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-17.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-18",
+    name: "B1 Frequency Band 18 (851-900)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-18.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-19",
+    name: "B1 Frequency Band 19 (901-950)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-19.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-20",
+    name: "B1 Frequency Band 20 (951-1000)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-20.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-21",
+    name: "B1 Frequency Band 21 (1001-1050)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-21.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-22",
+    name: "B1 Frequency Band 22 (1051-1100)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-22.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-23",
+    name: "B1 Frequency Band 23 (1101-1150)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 50,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./json/b1/b1-vocabulary-23.json")),
+  jsonDescriptor({
+    id: "b1-vocabulary-24",
+    name: "B1 Frequency Band 24 (1151-1200)",
+    description: "B1 level Vietnamese frequency vocabulary",
+    examGrade: "B1",
+    category: "general",
+    difficulty: "intermediate",
+    itemCount: 49,
+    source: SUBTITLE_FREQUENCY_LIST,
+  }, () => import("./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 };