// Your Chinese project so far:
import { SVO, TopicComment } from "grammar/runtime";    // Module 1
import { MeasureWords } from "grammar/types";            // Module 2
import { Particles } from "grammar/memory";              // Module 3
import { Negation, Questions } from "grammar/errors";    // Module 4

// But you still need the actual data:
import * as stdlib from "vocab/core";   // ← THIS MODULE
// ~300 words. ~80% of daily conversation. Your HSK 1-2 starter pack.

// greetings — the handshake protocol
greetings.hello()       // → 你好
greetings.thanks()      // → 谢谢     → response: 不客气
greetings.sorry()       // → 对不起   → response: 没关系
greetings.goodbye()     // → 再见

// English pronouns: a messy polymorphic interface
interface EnglishPronoun {
    subject: "I" | "he" | "she" | "we" | "they";
    object:  "me" | "him" | "her" | "us" | "them";
    possAdj: "my" | "his" | "her" | "our" | "their";
    possNoun: "mine" | "his" | "hers" | "ours" | "theirs";
    reflexive: "myself" | "himself" | "herself" | "ourselves" | "themselves";
}

// Chinese pronouns: one form, one operator
interface ChinesePronoun {
    base: "我" | "你" | "他" | "她" | "它";       // That's it.
    plural: base + "们";                           // Add 们 for plural.
    possessive: base + "的";                       // Add 的 for possessive.
}
// I/me/my/mine/myself = 我 / 我 / 我的 / 我的 / 我自己. Done.

// Chinese number construction: it's literally math
function toChineseNumber(n: number): string {
    // 11 = 十一     → shí yī       → "ten-one"
    // 23 = 二十三   → èr shí sān   → "two-ten-three"
    // 99 = 九十九   → jiǔ shí jiǔ  → "nine-ten-nine"
    // 105 = 一百零五 → yì bǎi líng wǔ → "one-hundred-zero-five"

    // English: eleven, twelve, thirteen, fourteen... (why?!)
    // Chinese: 十一, 十二, 十三, 十四... (ten+1, ten+2, ten+3, ten+4)
    // Guess which one a programmer's brain prefers.
}

// Note: 零 (líng) = zero, used as a placeholder when a middle digit is missing.
// 105 = 一百零五, not 一百五 (that means 150 in shorthand).

// Date format: YEAR年 MONTH月 DAY日 — literally ISO 8601
// 2026年4月7日 = April 7, 2026
// èr líng èr liù nián sì yuè qī rì

// American English: April 7, 2026   (month-day-year... why?)
// Chinese:          2026年4月7日      (year-month-day ✓)
// ISO 8601:         2026-04-07       (year-month-day ✓)
// Chinese got it right from the start.

// Days of the week: 星期 + number
// 星期一 = Monday    (week-one)
// 星期二 = Tuesday   (week-two)
// 星期三 = Wednesday (week-three)
// ...
// 星期六 = Saturday  (week-six)
// 星期天 or 星期日 = Sunday (week-sky/day)

// Time: AM/PM marker BEFORE the hour (big → small)
// 下午三点十五分 = 3:15 PM
// "afternoon three o'clock fifteen minutes"
// Not "three fifteen PM" — the period-of-day comes first.

// Notice how some nouns double as verbs:
// 工作 (gōngzuò) = "work" (noun) AND "to work" (verb)
// 学习 (xuéxí)   = "study" (noun) AND "to study" (verb)
//
// No conversion needed. No nominalization. No "-tion" suffix.
// It's duck typing: if it fits in the verb slot, it's a verb.
// If it fits in the noun slot, it's a noun. Same word. Zero ceremony.

// English: Subject + "is" + adjective
// "She is tall."    → 3 words, requires a linking verb

// Chinese: Subject + 很 + adjective (adjective IS the predicate)
// 她很高。           → "She very tall."  (complete sentence, no verb needed)
// tā hěn gāo

// ⚠ The 很 (hěn, "very") is often just a grammatical filler — it doesn't
// always mean "very." Without it, 她高 sounds comparative ("she's tallER").
// Think of 很 as a default parameter:
//   adjective(subject, degree = 很)

// To actually emphasize "very," use 很 with stress, or upgrade to:
// 非常 (fēicháng) = extremely / 特别 (tèbié) = especially
// 她非常高。= She is extremely tall.

// Chinese connectors often come in pairs (like matching braces):

// 因为...所以... = because...therefore...
因为下雨，所以我不去。
// yīnwèi xià yǔ, suǒyǐ wǒ bú qù
// "Because raining, therefore I not-go."
// if (raining) { stay_home(); }

// 虽然...但是... = although...but...
虽然很难，但是很有意思。
// suīrán hěn nán, dànshì hěn yǒu yìsi
// "Although very hard, but very interesting."
// try { hard(); } catch { interesting(); }

// 如果...就... = if...then...
如果你来，我就很高兴。
// rúguǒ nǐ lái, wǒ jiù hěn gāoxìng
// "If you come, I then very happy."
// if (you.come()) { me.happy = true; }

// Note: 还是 for questions, 或者 for statements
// 你喝茶还是咖啡？ = Tea or coffee? (asking you to pick)
// 我喝茶或者咖啡。  = I'll drink tea or coffee. (either is fine)

// The wrong way to learn vocabulary:
for (const word of allWords) {
    brain.memorize(word.hanzi, word.meaning);    // rote memorization
}
// Result: words stored in short-term cache, evicted within hours.

// The right way:
for (const word of allWords) {
    brain.encounter(word, context);              // see it in a sentence
    brain.use(word, ownSentence);                // produce it yourself
    await brain.sleep();                         // consolidation happens offline
    brain.review(word, spacedInterval);          // SRS — review right before you forget
}
// Result: words promoted to long-term storage.

/**
 * stdlib/core — Vocabulary Quick Reference
 *
 * PACKAGES INSTALLED:
 *   greetings    →  6 words   (hello, thanks, sorry, goodbye...)
 *   pronouns     →  8 words   (I, you, he, she, it, we, you-all, they)
 *   numbers      → 13 words   (1-10, 100, 1000, 10000)
 *   time         → 14 words   (today, tomorrow, days, months, hours...)
 *   verbs.core   → 20 words   (be, have, go, come, do, see, say, eat...)
 *   nouns.core   → 20 words   (person, friend, home, book, water, money...)
 *   adjectives   → 17 words   (good, big, small, fast, slow, new, old...)
 *   connectors   →  8 words   (and, but, because, so, if, although, or...)
 *
 * TOTAL: ~106 core words (covers ~60% of basic conversation)
 *
 * KEY INSIGHTS:
 *   - Pronouns never change form (no case system)
 *   - Numbers compose mathematically (十一 = 10+1 = 11)
 *   - Time follows ISO 8601 order (big → small)
 *   - Adjectives ARE verbs (no linking "is" needed)
 *   - Connectors often come in pairs (因为...所以...)
 *   - Many words are both noun and verb (duck typing)
 *
 * LEARNING METHOD:
 *   SRS flashcards + context sentences + daily review
 *   You don't memorize an API by reading docs.
 *   You learn it by shipping code.
 *
 * NEXT MODULE: Control Flow (if/then, because/so, although/but)
 * → How to connect sentences into complex logic.
 */