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

package/src/index.ts

@@ -1,569 +1,569 @@
-/**
- * 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: "pre-a1-survival-phrases",
-    name: "Survival Phrases",
-    description: "Essential yes/no, greetings, and basic commands",
-    examGrade: "Pre-A1",
-    category: "survival",
-    difficulty: "beginner",
-    itemCount: 18,
-    source: { name: "Vietnamese essential phrases" },
-  }, () => import("./json/pre-a1/survival-phrases.json")),
-  jsonDescriptor({
-    id: "a2-body-parts",
-    name: "Body Parts",
-    description: "Human body parts and anatomy",
-    examGrade: "A2",
-    category: "anatomy",
-    difficulty: "intermediate",
-    itemCount: 20,
-    source: { name: "Vietnamese frequency and thematic vocabulary" },
-  }, () => import("./json/a2/body-parts.json")),
-  jsonDescriptor({
-    id: "a2-clothing",
-    name: "Clothing",
-    description: "Clothing and accessories",
-    examGrade: "A2",
-    category: "clothing",
-    difficulty: "intermediate",
-    itemCount: 15,
-    source: { name: "Vietnamese frequency and thematic vocabulary" },
-  }, () => import("./json/a2/clothing.json")),
-  jsonDescriptor({
-    id: "a2-places",
-    name: "Places",
-    description: "Common places and buildings",
-    examGrade: "A2",
-    category: "places",
-    difficulty: "intermediate",
-    itemCount: 15,
-    source: { name: "Vietnamese frequency and thematic vocabulary" },
-  }, () => import("./json/a2/places.json")),
-  jsonDescriptor({
-    id: "b1-emotions",
-    name: "Emotions",
-    description: "Emotions and feelings",
-    examGrade: "B1",
-    category: "emotions",
-    difficulty: "intermediate",
-    itemCount: 15,
-    source: { name: "Vietnamese frequency and thematic vocabulary" },
-  }, () => import("./json/b1/emotions.json")),
-  jsonDescriptor({
-    id: "b1-professions",
-    name: "Professions",
-    description: "Jobs and professions",
-    examGrade: "B1",
-    category: "work",
-    difficulty: "intermediate",
-    itemCount: 15,
-    source: { name: "Vietnamese frequency and thematic vocabulary" },
-  }, () => import("./json/b1/professions.json")),
-  jsonDescriptor({
-    id: "b1-weather",
-    name: "Weather",
-    description: "Weather and climate terms",
-    examGrade: "B1",
-    category: "nature",
-    difficulty: "intermediate",
-    itemCount: 15,
-    source: { name: "Vietnamese frequency and thematic vocabulary" },
-  }, () => import("./json/b1/weather.json")),
-  jsonDescriptor({
-    id: "b2-abstract-concepts",
-    name: "Abstract Concepts",
-    description: "Abstract philosophical and social concepts",
-    examGrade: "B2",
-    category: "abstract",
-    difficulty: "advanced",
-    itemCount: 15,
-    source: { name: "Vietnamese frequency and thematic vocabulary" },
-  }, () => import("./json/b2/abstract-concepts.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 };
+/**
+ * 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-greetings",
+    name: "Basic Greetings",
+    description: "Basic greeting phrases in Vietnamese",
+    examGrade: "A1",
+    category: "greetings",
+    difficulty: "beginner",
+    itemCount: 10,
+    source: UNKNOWN_SOURCE,
+  }, () => import("./json/a1/a1-greetings.json")),
+  jsonDescriptor({
+    id: "a1-colors",
+    name: "Colors",
+    description: "Common colors in Vietnamese",
+    examGrade: "A1",
+    category: "colors",
+    difficulty: "beginner",
+    itemCount: 10,
+    source: UNKNOWN_SOURCE,
+  }, () => import("./json/a1/a1-colors.json")),
+  jsonDescriptor({
+    id: "a1-family",
+    name: "Family Members",
+    description: "Family member vocabulary in Vietnamese",
+    examGrade: "A1",
+    category: "family",
+    difficulty: "beginner",
+    itemCount: 8,
+    source: UNKNOWN_SOURCE,
+  }, () => import("./json/a1/a1-family.json")),
+  jsonDescriptor({
+    id: "a1-food",
+    name: "Food Basics",
+    description: "Basic food vocabulary in Vietnamese",
+    examGrade: "A1",
+    category: "food",
+    difficulty: "beginner",
+    itemCount: 10,
+    source: UNKNOWN_SOURCE,
+  }, () => import("./json/a1/a1-food.json")),
+  jsonDescriptor({
+    id: "a1-numbers",
+    name: "Numbers 1-10",
+    description: "Numbers 1-10 in Vietnamese",
+    examGrade: "A1",
+    category: "numbers",
+    difficulty: "beginner",
+    itemCount: 10,
+    source: UNKNOWN_SOURCE,
+  }, () => import("./json/a1/a1-numbers.json")),
+  jsonDescriptor({
+    id: "pre-a1-survival-phrases",
+    name: "Survival Phrases",
+    description: "Essential yes/no, greetings, and basic commands",
+    examGrade: "Pre-A1",
+    category: "survival",
+    difficulty: "beginner",
+    itemCount: 18,
+    source: { name: "Vietnamese essential phrases" },
+  }, () => import("./json/pre-a1/survival-phrases.json")),
+  jsonDescriptor({
+    id: "a2-body-parts",
+    name: "Body Parts",
+    description: "Human body parts and anatomy",
+    examGrade: "A2",
+    category: "anatomy",
+    difficulty: "intermediate",
+    itemCount: 20,
+    source: { name: "Vietnamese frequency and thematic vocabulary" },
+  }, () => import("./json/a2/a2-body-parts.json")),
+  jsonDescriptor({
+    id: "a2-clothing",
+    name: "Clothing",
+    description: "Clothing and accessories",
+    examGrade: "A2",
+    category: "clothing",
+    difficulty: "intermediate",
+    itemCount: 15,
+    source: { name: "Vietnamese frequency and thematic vocabulary" },
+  }, () => import("./json/a2/a2-clothing.json")),
+  jsonDescriptor({
+    id: "a2-places",
+    name: "Places",
+    description: "Common places and buildings",
+    examGrade: "A2",
+    category: "places",
+    difficulty: "intermediate",
+    itemCount: 15,
+    source: { name: "Vietnamese frequency and thematic vocabulary" },
+  }, () => import("./json/a2/a2-places.json")),
+  jsonDescriptor({
+    id: "b1-emotions",
+    name: "Emotions",
+    description: "Emotions and feelings",
+    examGrade: "B1",
+    category: "emotions",
+    difficulty: "intermediate",
+    itemCount: 15,
+    source: { name: "Vietnamese frequency and thematic vocabulary" },
+  }, () => import("./json/b1/b1-emotions.json")),
+  jsonDescriptor({
+    id: "b1-professions",
+    name: "Professions",
+    description: "Jobs and professions",
+    examGrade: "B1",
+    category: "work",
+    difficulty: "intermediate",
+    itemCount: 15,
+    source: { name: "Vietnamese frequency and thematic vocabulary" },
+  }, () => import("./json/b1/b1-professions.json")),
+  jsonDescriptor({
+    id: "b1-weather",
+    name: "Weather",
+    description: "Weather and climate terms",
+    examGrade: "B1",
+    category: "nature",
+    difficulty: "intermediate",
+    itemCount: 15,
+    source: { name: "Vietnamese frequency and thematic vocabulary" },
+  }, () => import("./json/b1/b1-weather.json")),
+  jsonDescriptor({
+    id: "b2-abstract-concepts",
+    name: "Abstract Concepts",
+    description: "Abstract philosophical and social concepts",
+    examGrade: "B2",
+    category: "abstract",
+    difficulty: "advanced",
+    itemCount: 15,
+    source: { name: "Vietnamese frequency and thematic vocabulary" },
+  }, () => import("./json/b2/abstract-concepts.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 };