@syllst/ko 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared types and utilities for SYLLST content
+ * (Inlined from @syllst/content-shared to make package self-contained)
+ */
+/**
+ * CEFR language proficiency levels
+ */
+declare type CEFRLevel = 'A1' | 'A2' | 'B1' | 'B2' | 'C1' | 'C2';
+
+export declare const config: SyllabusConfig;
+
+/**
+ * Content loader interface
+ */
+declare interface ContentLoader {
+    /** Syllabus configuration */
+    config: SyllabusConfig;
+    /** Load a single lesson by number */
+    loadLesson(lessonNumber: number): Promise<LoadedLesson>;
+    /** Load all lessons */
+    loadAllLessons(): Promise<LoadedLesson[]>;
+    /** Get list of available lesson numbers */
+    getAvailableLessons(): number[];
+}
+
+/**
+ * Difficulty levels
+ */
+declare type Difficulty = 'beginner' | 'intermediate' | 'advanced';
+
+export declare const getAvailableLessons: () => number[];
+
+export declare const loadAllLessons: () => Promise<LoadedLesson[]>;
+
+/**
+ * Result of loading a lesson
+ */
+declare interface LoadedLesson {
+    /** Lesson number (1-indexed) */
+    number: number;
+    /** Raw MDX content */
+    rawContent: string;
+}
+
+export declare const loader: ContentLoader;
+
+export declare const loadLesson: (lessonNumber: number) => Promise<LoadedLesson>;
+
+/**
+ * Configuration for a syllabus content package
+ */
+declare interface SyllabusConfig {
+    /** Unique syllabus ID (e.g., "ko-alphabet") */
+    id: string;
+    /** Display title */
+    title: string;
+    /** Description */
+    description: string;
+    /** Language code (ISO 639-1) */
+    language: string;
+    /** Locale code (e.g., "ko-KR") */
+    locale: string;
+    /** Number of lessons */
+    lessonCount: number;
+    /** Difficulty level */
+    difficulty: Difficulty;
+    /** CEFR level */
+    cefrLevel: CEFRLevel;
+    /** Icon for display */
+    icon?: SyllabusIcon;
+    /** Package version */
+    version: string;
+}
+
+/**
+ * Icon types for syllabi
+ */
+declare type SyllabusIcon = 'alphabet' | 'dialogue' | 'vocabulary' | 'grammar' | 'reading' | 'numbers' | 'food' | 'travel';
+
+export { }

package/dist/index.js

@@ -0,0 +1,30 @@
+import { config as s } from "./syllabi/alphabet/index.js";
+import * as t from "./syllabi/alphabet/index.js";
+import { loader as x } from "./syllabi/alphabet/index.js";
+import { config as e } from "./syllabi/numbers/index.js";
+import * as l from "./syllabi/numbers/index.js";
+import { loader as u } from "./syllabi/numbers/index.js";
+import { config as r } from "./syllabi/essentials/index.js";
+import * as p from "./syllabi/essentials/index.js";
+import { loader as C } from "./syllabi/essentials/index.js";
+const i = [
+  s,
+  e,
+  r
+];
+function d(o) {
+  return i.find((a) => a.id === o);
+}
+export {
+  i as allConfigs,
+  t as alphabet,
+  s as alphabetConfig,
+  x as alphabetLoader,
+  p as essentials,
+  r as essentialsConfig,
+  C as essentialsLoader,
+  d as getConfigById,
+  l as numbers,
+  e as numbersConfig,
+  u as numbersLoader
+};

package/dist/shared.js

@@ -0,0 +1,26 @@
+function s(o, e) {
+  return {
+    config: o,
+    async loadLesson(n) {
+      if (n < 1 || n > o.lessonCount)
+        throw new Error(`Lesson ${n} not found. Valid range: 1-${o.lessonCount}`);
+      const t = await e(n);
+      return {
+        number: n,
+        rawContent: t.default
+      };
+    },
+    async loadAllLessons() {
+      const n = [];
+      for (let t = 1; t <= o.lessonCount; t++)
+        n.push(await this.loadLesson(t));
+      return n;
+    },
+    getAvailableLessons() {
+      return Array.from({ length: o.lessonCount }, (n, t) => t + 1);
+    }
+  };
+}
+export {
+  s as createContentLoader
+};

package/dist/syllabi/alphabet/index.d.ts

@@ -0,0 +1,7 @@
+import { SyllabusConfig, ContentLoader } from '../../shared.js';
+export declare const config: SyllabusConfig;
+export declare const loader: ContentLoader;
+export declare const loadLesson: (lessonNumber: number) => Promise<import('../../shared.js').LoadedLesson>;
+export declare const loadAllLessons: () => Promise<import('../../shared.js').LoadedLesson[]>;
+export declare const getAvailableLessons: () => number[];
+//# sourceMappingURL=index.d.ts.map

package/dist/syllabi/alphabet/index.js

@@ -0,0 +1,47 @@
+import { createContentLoader as n } from "../../shared.js";
+const s = {
+  id: "ko-alphabet",
+  title: "한글 (Hangul)",
+  description: "Learn the Korean Hangul script — basic vowels, consonants, double consonants, and compound vowels across 10 lessons",
+  language: "ko",
+  locale: "ko-KR",
+  lessonCount: 10,
+  difficulty: "beginner",
+  cefrLevel: "A1",
+  icon: "alphabet",
+  version: "0.1.0"
+};
+async function t(e) {
+  switch (e) {
+    case 1:
+      return import("./lessons/lesson-01.mdx.js");
+    case 2:
+      return import("./lessons/lesson-02.mdx.js");
+    case 3:
+      return import("./lessons/lesson-03.mdx.js");
+    case 4:
+      return import("./lessons/lesson-04.mdx.js");
+    case 5:
+      return import("./lessons/lesson-05.mdx.js");
+    case 6:
+      return import("./lessons/lesson-06.mdx.js");
+    case 7:
+      return import("./lessons/lesson-07.mdx.js");
+    case 8:
+      return import("./lessons/lesson-08.mdx.js");
+    case 9:
+      return import("./lessons/lesson-09.mdx.js");
+    case 10:
+      return import("./lessons/lesson-10.mdx.js");
+    default:
+      throw new Error(`Lesson ${e} not found`);
+  }
+}
+const o = n(s, t), a = o.loadLesson.bind(o), c = o.loadAllLessons.bind(o), i = o.getAvailableLessons.bind(o);
+export {
+  s as config,
+  i as getAvailableLessons,
+  c as loadAllLessons,
+  a as loadLesson,
+  o as loader
+};

package/dist/syllabi/alphabet/lessons/lesson-01.mdx.js

@@ -0,0 +1,154 @@
+const n = `---
+type: lesson
+id: korean-hangul-lesson-01
+title: "Lesson 1 — Basic Vowels I (ㅏ, ㅑ, ㅓ, ㅕ)"
+description: "Learn the first four Korean basic vowels: a, ya, eo, yeo"
+order: 1
+parentId: ko-alphabet
+difficulty: beginner
+cefrLevel: A1
+categories:
+  - vowels
+  - basic-characters
+metadata:
+  estimatedTime: 20
+  prerequisites: []
+  learningObjectives:
+    - id: obj-ko-alph-01-recognize
+      description: "Recognize the vowels ㅏ, ㅑ, ㅓ, ㅕ"
+      skill: character-recognition
+      references: [a, ya, eo, yeo]
+    - id: obj-ko-alph-01-sounds
+      description: "Map each vowel to its sound"
+      skill: character-sound-mapping
+      references: [a, ya, eo, yeo]
+---
+
+# Lesson 1 — Basic Vowels I (ㅏ, ㅑ, ㅓ, ㅕ)
+
+## Introduction
+
+Welcome to Hangul, the Korean writing system. Hangul was created in 1443 by King Sejong the Great to promote literacy. Unlike Chinese characters or Japanese kanji, Hangul is a phonemic alphabet — each symbol represents a sound, not a word or idea.
+
+Hangul is made up of two types of letters: **자음 (jaeum)** — consonants — and **모음 (moeum)** — vowels. These letters are combined into syllable blocks to write Korean words.
+
+In this first lesson, you will learn four of the ten basic vowels.
+
+## What Is a Vowel in Hangul?
+
+Korean vowels are written as vertical or horizontal strokes. They cannot stand alone as syllables — they are always combined with a consonant. The silent consonant **ㅇ (ieung)** is used as a placeholder when a vowel starts a syllable.
+
+For example: **아** = ㅇ (silent) + ㅏ (a sound) = "a"
+
+## Characters
+
+:::character-set{id="ko-vowels-1" title="Basic Vowels I"}
+
+::character{id="a" canonicalRef="a" char="ㅏ" name="ㅏ 아 (a)" charType="vowel" data:romanization="a" data:ipa="a"}
+
+::character{id="ya" canonicalRef="ya" char="ㅑ" name="ㅑ 야 (ya)" charType="vowel" data:romanization="ya" data:ipa="ja"}
+
+::character{id="eo" canonicalRef="eo" char="ㅓ" name="ㅓ 어 (eo)" charType="vowel" data:romanization="eo" data:ipa="ʌ"}
+
+::character{id="yeo" canonicalRef="yeo" char="ㅕ" name="ㅕ 여 (yeo)" charType="vowel" data:romanization="yeo" data:ipa="jʌ"}
+
+:::
+
+## Pronunciation Guide
+
+| Character | Romanization | Sound | English Approximation |
+|-----------|-------------|-------|----------------------|
+| ㅏ | a | /a/ | "a" in "father" |
+| ㅑ | ya | /ja/ | "ya" in "yard" |
+| ㅓ | eo | /ʌ/ | "u" in "but" (but lower) |
+| ㅕ | yeo | /jʌ/ | "yuh" — like "ya" but with eo sound |
+
+**Note on ㅓ (eo):** This vowel is often difficult for English speakers. It sounds like the "u" in "but" but with your mouth more open. Try keeping your lips relaxed and slightly open.
+
+## Shape Pattern
+
+Notice the visual pattern:
+
+- **ㅏ** — a vertical line with a short horizontal stroke pointing right
+- **ㅑ** — same as ㅏ but with **two** short strokes (the "y" prefix doubles the stroke)
+- **ㅓ** — a vertical line with a short horizontal stroke pointing **left**
+- **ㅕ** — same as ㅓ but with **two** short strokes (the "y" prefix doubles the stroke)
+
+This pattern continues throughout Hangul: adding an extra stroke creates the "y" version of any vowel.
+
+## Syllable Formation
+
+When these vowels combine with the silent consonant ㅇ:
+
+| Vowel | Syllable | Pronunciation |
+|-------|----------|---------------|
+| ㅏ | 아 | a |
+| ㅑ | 야 | ya |
+| ㅓ | 어 | eo |
+| ㅕ | 여 | yeo |
+
+## Practice Words
+
+| Korean | Romanization | Meaning |
+|--------|-------------|---------|
+| 아이 | a-i | child |
+| 야구 | ya-gu | baseball |
+| 어머니 | eo-meo-ni | mother |
+| 여기 | yeo-gi | here |
+
+## Key Points
+
+1. **Hangul is systematic**: Vowels follow visual patterns (extra stroke = "y" prefix)
+2. **ㅇ is the silent placeholder**: Used when a vowel opens a syllable
+3. **ㅓ is unique**: The sound has no perfect English equivalent; keep lips relaxed
+4. **Vertical vowels** (ㅏ, ㅑ, ㅓ, ㅕ) go to the right of a consonant in a syllable block
+
+## Practice Recognition
+
+:::exercise{id="ko-alph-01-recognition" type="matching" title="Match Vowels to Sounds" skill="character-recognition" tests="a,ya,eo,yeo" objectiveId="obj-ko-alph-01-recognize"}
+
+**Question:** Match each Hangul vowel to its romanization
+
+- ㅏ
+- ㅑ
+- ㅓ
+- ㅕ
+
+**Answer:**
+
+- ㅏ = a
+- ㅑ = ya
+- ㅓ = eo
+- ㅕ = yeo
+
+**Explanation:** The four vowels follow a clear visual pattern. ㅏ and ㅓ are mirror images of each other. ㅑ and ㅕ add an extra stroke to create the "y" variants.
+
+:::
+
+:::exercise{id="ko-alph-01-sounds" type="fill-in-blank" title="Sound Mapping" skill="character-sound-mapping" tests="a,ya,eo,yeo" objectiveId="obj-ko-alph-01-sounds"}
+
+**Question:** What sound does each vowel make?
+
+- ㅏ sounds like ___
+- ㅑ sounds like ___
+- ㅓ sounds like ___
+- ㅕ sounds like ___
+
+**Answer:**
+
+- ㅏ = /a/ as in "father"
+- ㅑ = /ja/ as in "yard"
+- ㅓ = /ʌ/ as in "but" (lips more open)
+- ㅕ = /jʌ/ — "yuh" sound
+
+**Explanation:** These four vowels form two pairs: ㅏ/ㅑ and ㅓ/ㅕ. The "y" variants simply add a "y" sound before the base vowel.
+
+:::
+
+## What's Next
+
+In Lesson 2, you will learn three more basic vowels: ㅗ (o), ㅛ (yo), and ㅜ (u) — the horizontal vowels of Hangul.
+`;
+export {
+  n as default
+};

package/dist/syllabi/alphabet/lessons/lesson-02.mdx.js

@@ -0,0 +1,169 @@
+const n = `---
+type: lesson
+id: korean-hangul-lesson-02
+title: "Lesson 2 — Basic Vowels II (ㅗ, ㅛ, ㅜ, ㅠ, ㅡ, ㅣ)"
+description: "Learn the remaining six Korean basic vowels: o, yo, u, yu, eu, i"
+order: 2
+parentId: ko-alphabet
+difficulty: beginner
+cefrLevel: A1
+categories:
+  - vowels
+  - basic-characters
+metadata:
+  estimatedTime: 25
+  prerequisites: [korean-hangul-lesson-01]
+  learningObjectives:
+    - id: obj-ko-alph-02-recognize
+      description: "Recognize the vowels ㅗ, ㅛ, ㅜ, ㅠ, ㅡ, ㅣ"
+      skill: character-recognition
+      references: [o, yo, u, yu, eu, i]
+    - id: obj-ko-alph-02-sounds
+      description: "Map each vowel to its sound"
+      skill: character-sound-mapping
+      references: [o, yo, u, yu, eu, i]
+---
+
+# Lesson 2 — Basic Vowels II (ㅗ, ㅛ, ㅜ, ㅠ, ㅡ, ㅣ)
+
+## Introduction
+
+In Lesson 1, you learned the four vertical vowels with strokes pointing left or right. In this lesson, you will complete the ten basic Korean vowels. The next set includes **horizontal vowels** — vowels whose base line is horizontal — plus the final two: ㅡ and ㅣ.
+
+## Characters
+
+:::character-set{id="ko-vowels-2" title="Basic Vowels II"}
+
+::character{id="o" canonicalRef="o" char="ㅗ" name="ㅗ 오 (o)" charType="vowel" data:romanization="o" data:ipa="o"}
+
+::character{id="yo" canonicalRef="yo" char="ㅛ" name="ㅛ 요 (yo)" charType="vowel" data:romanization="yo" data:ipa="jo"}
+
+::character{id="u" canonicalRef="u" char="ㅜ" name="ㅜ 우 (u)" charType="vowel" data:romanization="u" data:ipa="u"}
+
+::character{id="yu" canonicalRef="yu" char="ㅠ" name="ㅠ 유 (yu)" charType="vowel" data:romanization="yu" data:ipa="ju"}
+
+::character{id="eu" canonicalRef="eu" char="ㅡ" name="ㅡ 으 (eu)" charType="vowel" data:romanization="eu" data:ipa="ɯ"}
+
+::character{id="i" canonicalRef="i" char="ㅣ" name="ㅣ 이 (i)" charType="vowel" data:romanization="i" data:ipa="i"}
+
+:::
+
+## Pronunciation Guide
+
+| Character | Romanization | Sound | English Approximation |
+|-----------|-------------|-------|----------------------|
+| ㅗ | o | /o/ | "o" in "go" |
+| ㅛ | yo | /jo/ | "yo" in "yoke" |
+| ㅜ | u | /u/ | "oo" in "moon" |
+| ㅠ | yu | /ju/ | "you" |
+| ㅡ | eu | /ɯ/ | No English equivalent — "uh" with lips spread flat |
+| ㅣ | i | /i/ | "ee" in "see" |
+
+**Note on ㅡ (eu):** This is the most difficult vowel for English speakers. Keep your lips spread flat (like you are smiling) and say "uh." It is the same sound as the Russian ы.
+
+## Shape Pattern
+
+The horizontal vowels follow the same rule as vertical vowels:
+
+- **ㅗ** — horizontal line with a short vertical stroke pointing **up**
+- **ㅛ** — same as ㅗ but with **two** vertical strokes (the "y" prefix)
+- **ㅜ** — horizontal line with a short vertical stroke pointing **down**
+- **ㅠ** — same as ㅜ but with **two** vertical strokes (the "y" prefix)
+- **ㅡ** — just a horizontal line — the "flat" vowel
+- **ㅣ** — just a vertical line — the simplest vowel
+
+## Syllable Formation
+
+When combined with the silent consonant ㅇ:
+
+| Vowel | Syllable | Pronunciation |
+|-------|----------|---------------|
+| ㅗ | 오 | o |
+| ㅛ | 요 | yo |
+| ㅜ | 우 | u |
+| ㅠ | 유 | yu |
+| ㅡ | 으 | eu |
+| ㅣ | 이 | i |
+
+## Placement in Syllable Blocks
+
+Korean consonants and vowels are assembled into syllable blocks. The vowel's orientation determines where it goes:
+
+- **Vertical vowels** (ㅏ, ㅑ, ㅓ, ㅕ, ㅣ): consonant goes **to the left**
+- **Horizontal vowels** (ㅗ, ㅛ, ㅜ, ㅠ, ㅡ): consonant goes **above**
+
+| Vowel | Example syllable | Description |
+|-------|-----------------|-------------|
+| ㅏ | 가 (ga) | ㄱ left, ㅏ right |
+| ㅗ | 고 (go) | ㄱ above, ㅗ below |
+
+## Practice Words
+
+| Korean | Romanization | Meaning |
+|--------|-------------|---------|
+| 오이 | o-i | cucumber |
+| 유리 | yu-ri | glass (material) |
+| 으로 | eu-ro | toward / with |
+| 이유 | i-yu | reason |
+| 우유 | u-yu | milk |
+
+## Key Points
+
+1. **All 10 basic vowels**: You now know all 10 (ㅏ, ㅑ, ㅓ, ㅕ, ㅗ, ㅛ, ㅜ, ㅠ, ㅡ, ㅣ)
+2. **Horizontal vowels go below consonants**: ㅗ, ㅛ, ㅜ, ㅠ, ㅡ position the consonant above
+3. **ㅡ is unique**: No close English equivalent — spread lips flat for "uh"
+4. **ㅣ is the simplest**: Just a vertical line, sounds like "ee"
+
+## Practice Recognition
+
+:::exercise{id="ko-alph-02-recognition" type="matching" title="Match Vowels to Sounds" skill="character-recognition" tests="o,yo,u,yu,eu,i" objectiveId="obj-ko-alph-02-recognize"}
+
+**Question:** Match each Hangul vowel to its romanization
+
+- ㅗ
+- ㅛ
+- ㅜ
+- ㅠ
+- ㅡ
+- ㅣ
+
+**Answer:**
+
+- ㅗ = o
+- ㅛ = yo
+- ㅜ = u
+- ㅠ = yu
+- ㅡ = eu
+- ㅣ = i
+
+**Explanation:** Horizontal vowels pair with their "y" versions just like the vertical vowels did in Lesson 1. ㅡ and ㅣ stand alone as the base horizontal and vertical lines.
+
+:::
+
+:::exercise{id="ko-alph-02-sounds" type="fill-in-blank" title="Sound Mapping" skill="character-sound-mapping" tests="o,yo,u,yu,eu,i" objectiveId="obj-ko-alph-02-sounds"}
+
+**Question:** What sound does each vowel make?
+
+- ㅗ sounds like ___
+- ㅜ sounds like ___
+- ㅡ sounds like ___
+- ㅣ sounds like ___
+
+**Answer:**
+
+- ㅗ = /o/ as in "go"
+- ㅜ = /u/ as in "moon"
+- ㅡ = /ɯ/ — spread lips flat and say "uh"
+- ㅣ = /i/ as in "see"
+
+**Explanation:** ㅗ and ㅜ are the most common horizontal vowels. ㅡ is the only vowel with no close English equivalent. ㅣ is the simplest — just a straight line making the "ee" sound.
+
+:::
+
+## What's Next
+
+In Lesson 3, you will learn your first consonants: ㄱ, ㄴ, and ㄷ. Combined with the vowels you already know, you can begin reading real Korean syllables.
+`;
+export {
+  n as default
+};

package/dist/syllabi/alphabet/lessons/lesson-03.mdx.js

@@ -0,0 +1,164 @@
+const n = `---
+type: lesson
+id: korean-hangul-lesson-03
+title: "Lesson 3 — Basic Vowels Review & Syllable Blocks"
+description: "Review all 10 basic vowels and learn how syllable blocks are assembled"
+order: 3
+parentId: ko-alphabet
+difficulty: beginner
+cefrLevel: A1
+categories:
+  - vowels
+  - syllable-structure
+metadata:
+  estimatedTime: 25
+  prerequisites: [korean-hangul-lesson-01, korean-hangul-lesson-02]
+  learningObjectives:
+    - id: obj-ko-alph-03-review
+      description: "Recall all 10 basic vowels and their sounds"
+      skill: character-recognition
+      references: [a, ya, eo, yeo, o, yo, u, yu, eu, i]
+    - id: obj-ko-alph-03-syllables
+      description: "Understand how vowels and consonants combine into syllable blocks"
+      skill: syllable-analysis
+      references: [a, eo, o, u, eu, i]
+---
+
+# Lesson 3 — Basic Vowels Review & Syllable Blocks
+
+## Introduction
+
+You have now learned all 10 basic Korean vowels. Before moving on to consonants, it is important to understand **how Korean syllable blocks work**. This knowledge will let you read and write any Korean syllable correctly.
+
+## All 10 Basic Vowels at a Glance
+
+:::character-set{id="ko-vowels-all" title="All 10 Basic Vowels"}
+
+::character{id="a" canonicalRef="a" char="ㅏ" name="ㅏ 아 (a)" charType="vowel" data:romanization="a" data:ipa="a"}
+
+::character{id="ya" canonicalRef="ya" char="ㅑ" name="ㅑ 야 (ya)" charType="vowel" data:romanization="ya" data:ipa="ja"}
+
+::character{id="eo" canonicalRef="eo" char="ㅓ" name="ㅓ 어 (eo)" charType="vowel" data:romanization="eo" data:ipa="ʌ"}
+
+::character{id="yeo" canonicalRef="yeo" char="ㅕ" name="ㅕ 여 (yeo)" charType="vowel" data:romanization="yeo" data:ipa="jʌ"}
+
+::character{id="o" canonicalRef="o" char="ㅗ" name="ㅗ 오 (o)" charType="vowel" data:romanization="o" data:ipa="o"}
+
+::character{id="yo" canonicalRef="yo" char="ㅛ" name="ㅛ 요 (yo)" charType="vowel" data:romanization="yo" data:ipa="jo"}
+
+::character{id="u" canonicalRef="u" char="ㅜ" name="ㅜ 우 (u)" charType="vowel" data:romanization="u" data:ipa="u"}
+
+::character{id="yu" canonicalRef="yu" char="ㅠ" name="ㅠ 유 (yu)" charType="vowel" data:romanization="yu" data:ipa="ju"}
+
+::character{id="eu" canonicalRef="eu" char="ㅡ" name="ㅡ 으 (eu)" charType="vowel" data:romanization="eu" data:ipa="ɯ"}
+
+::character{id="i" canonicalRef="i" char="ㅣ" name="ㅣ 이 (i)" charType="vowel" data:romanization="i" data:ipa="i"}
+
+:::
+
+## The Vowel Chart
+
+| Group | Characters | Base Sound |
+|-------|-----------|------------|
+| Vertical (right) | ㅏ, ㅑ | a, ya |
+| Vertical (left) | ㅓ, ㅕ | eo, yeo |
+| Horizontal (up) | ㅗ, ㅛ | o, yo |
+| Horizontal (down) | ㅜ, ㅠ | u, yu |
+| Solo | ㅡ, ㅣ | eu, i |
+
+## How Syllable Blocks Work
+
+Korean words are written in **syllable blocks**, not as individual letters in a row. Each block contains exactly one vowel, at least one consonant, and sometimes a final consonant (called a **받침, batchim**).
+
+### Block Structure
+
+There are four possible block shapes:
+
+1. **CV** — consonant + vertical vowel: **가** (ga = ㄱ+ㅏ)
+2. **CV** — consonant above horizontal vowel: **고** (go = ㄱ+ㅗ)
+3. **CVC** — consonant + vertical vowel + final consonant: **강** (gang = ㄱ+ㅏ+ㅇ)
+4. **CVC** — consonant above horizontal vowel + final consonant: **공** (gong = ㄱ+ㅗ+ㅇ)
+
+### The Silent Consonant ㅇ
+
+When a syllable starts with a vowel sound, the silent consonant **ㅇ (ieung)** is used as a placeholder:
+
+| Vowel | Syllable | Pronunciation |
+|-------|----------|---------------|
+| ㅏ | 아 | a |
+| ㅓ | 어 | eo |
+| ㅗ | 오 | o |
+| ㅜ | 우 | u |
+| ㅡ | 으 | eu |
+| ㅣ | 이 | i |
+
+## Reading Practice
+
+Now that you know all vowels, you can read these simple words:
+
+| Korean | Parts | Pronunciation | Meaning |
+|--------|-------|---------------|---------|
+| 아이 | 아+이 | a-i | child |
+| 오이 | 오+이 | o-i | cucumber |
+| 유이 | 유+이 | yu-i | (a name) |
+| 이유 | 이+유 | i-yu | reason |
+| 으이 | 으+이 | eu-i | (exclamation of disgust) |
+
+## Key Points
+
+1. **10 basic vowels**: ㅏ ㅑ ㅓ ㅕ ㅗ ㅛ ㅜ ㅠ ㅡ ㅣ — memorize them in order
+2. **Syllable blocks, not linear**: Korean is written in blocks, not letter by letter
+3. **ㅇ is silent at the start**: When a syllable begins with a vowel, ㅇ fills the consonant slot
+4. **Vowel position determines layout**: Vertical vowels → consonant left; horizontal → consonant above
+
+## Practice Recognition
+
+:::exercise{id="ko-alph-03-review" type="matching" title="Vowel Review — All 10" skill="character-recognition" tests="a,ya,eo,yeo,o,yo,u,yu,eu,i" objectiveId="obj-ko-alph-03-review"}
+
+**Question:** Match each Hangul vowel to its romanization
+
+- ㅏ, ㅑ, ㅓ, ㅕ
+- ㅗ, ㅛ, ㅜ, ㅠ
+- ㅡ, ㅣ
+
+**Answer:**
+
+- ㅏ = a, ㅑ = ya, ㅓ = eo, ㅕ = yeo
+- ㅗ = o, ㅛ = yo, ㅜ = u, ㅠ = yu
+- ㅡ = eu, ㅣ = i
+
+**Explanation:** The ten basic vowels divide into five pairs. Each base vowel (ㅏ, ㅓ, ㅗ, ㅜ) has a "y" variant formed by adding an extra stroke. ㅡ and ㅣ are the two "singleton" vowels.
+
+:::
+
+:::exercise{id="ko-alph-03-syllables" type="fill-in-blank" title="Syllable Block Reading" skill="syllable-analysis" tests="a,eo,o,u,eu,i" objectiveId="obj-ko-alph-03-syllables"}
+
+**Question:** Read these syllables written with the silent consonant ㅇ:
+
+- 아 = ___
+- 어 = ___
+- 오 = ___
+- 우 = ___
+- 으 = ___
+- 이 = ___
+
+**Answer:**
+
+- 아 = a
+- 어 = eo
+- 오 = o
+- 우 = u
+- 으 = eu
+- 이 = i
+
+**Explanation:** Each syllable uses ㅇ (silent) + vowel. The ㅇ at the start of a syllable has no sound — it is purely a structural placeholder. When ㅇ appears at the **end** of a syllable (as batchim), it makes an "ng" sound.
+
+:::
+
+## What's Next
+
+In Lesson 4, you will learn your first group of consonants: ㄱ (giyeok), ㄴ (nieun), and ㄷ (digeut). With consonants added to the vowels you know, you can start reading real Korean words.
+`;
+export {
+  n as default
+};