@thyrith/momentkh 3.0.0 → 3.0.2

package/README.md

@@ -2,7 +2,9 @@
 
 **MomentKH** is a lightweight, zero-dependency JavaScript/TypeScript library for accurate Khmer (Cambodian) Lunar Calendar conversions. It provides a modern, standalone implementation with full TypeScript support.
 
-[![Version](https://img.shields.io/badge/version-3.0.0-blue.svg)](https://github.com/ThyrithSor/momentkh)
+[🎮 **Live Demo Playground**](https://thyrithsor.github.io/momentkh/)
+
+[![Version](https://img.shields.io/badge/version-3.0.2-blue.svg)](https://github.com/ThyrithSor/momentkh)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![No Dependencies](https://img.shields.io/badge/dependencies-none-success.svg)](https://github.com/ThyrithSor/momentkh)
 
@@ -17,11 +19,11 @@ const momentkh = require("@thyrith/momentkh");
 // Convert date to Khmer format (default)
 const khmer = momentkh.fromDate(new Date());
 console.log(momentkh.format(khmer));
-// Output: ថ្ងៃចន្ទ ១៦រោច ខែមិគសិរ ឆ្នាំរោង ឆស័ក ពុទ្ធសករាជ ២៥៦៨
+// Output: ថ្ងៃពុធ ១២រោច ខែមិគសិរ ឆ្នាំម្សាញ់ សប្តស័ក ពុទ្ធសករាជ ២៥៦៩
 
 // Convert date to Khmer format (custom)
 console.log(momentkh.format(khmer, "dN ខែm ឆ្នាំa"));
-// Output: ១៦រោច ខែមិគសិរ ឆ្នាំរោង
+// Output: ១២រោច ខែមិគសិរ ឆ្នាំម្សាញ់
 
 // Convert Khmer date to Gregorian
 const gregorian = momentkh.fromKhmer(15, 0, 5, 2568); // 15កើត ខែពិសាខ ព.ស.២៥៦៨
@@ -31,7 +33,7 @@ console.log(gregorian);
 // Get Khmer New Year
 const newYear = momentkh.getNewYear(2025);
 console.log(newYear);
-// Output: { year: 2025, month: 4, day: 13, hour: 20, minute: 9 }
+// Output: { year: 2025, month: 4, day: 14, hour: 4, minute: 48 }
 ```
 
 ---
@@ -52,7 +54,7 @@ console.log(newYear);
 - [Understanding Khmer Calendar](#-understanding-khmer-calendar)
   - [Buddhist Era (BE) Year](#buddhist-era-be-year)
   - [Animal Year](#animal-year)
-  - [Era Year (Sak)](#era-year-sak)
+  - [Sak](#sak-year-sak)
   - [When Each Year Type Increases](#when-each-year-type-increases)
 - [Format Codes](#-format-codes)
 - [Constants](#-constants)
@@ -66,7 +68,7 @@ console.log(newYear);
 
 - ✅ **Zero Dependencies** - Pure JavaScript, no external libraries required
 - ✅ **TypeScript Support** - Full type definitions included for excellent IDE experience
-- ✅ **Type-Safe Enums** - NEW in v3.0! Use enums for moonPhase, monthIndex, animalYear, eraYear, and dayOfWeek
+- ✅ **Type-Safe Enums** - NEW in v3.0! Use enums for moonPhase, monthIndex, animalYear, sak, and dayOfWeek
 - ✅ **Bidirectional Conversion** - Convert between Gregorian ↔ Khmer Lunar dates
 - ✅ **Accurate Calculations** - Based on traditional Khmer astronomical algorithms
 - ✅ **Khmer New Year** - Precise calculation of Moha Songkran timing
@@ -85,14 +87,6 @@ console.log(newYear);
 npm install @thyrith/momentkh
 ```
 
-### Direct Download
-
-Download `momentkh.js` from the repository and include it in your project.
-
-```bash
-cp momentkh.js /path/to/your/project/
-```
-
 ### TypeScript
 
 Type definitions are included automatically when you install via NPM. For direct downloads, you can also use `momentkh.ts` or the compiled `.d.ts` files from the `dist/` folder.
@@ -104,19 +98,23 @@ Type definitions are included automatically when you install via NPM. For direct
 ### Browser (HTML)
 
 ```html
-<script src="momentkh.js"></script>
+<!-- Include the browser-compatible UMD bundle -->
+<script src="https://cdn.jsdelivr.net/gh/ThyrithSor/momentkh@3.0.2/momentkh.js"></script>
 <script>
   // Convert today to Khmer
   const today = new Date();
   const khmer = momentkh.fromDate(today);
   console.log(momentkh.format(khmer));
-  // Output: ថ្ងៃចន្ទ ១០កើត ខែចេត្រ ឆ្នាំរោង ឆស័ក ពុទ្ធសករាជ ២៥៦៧
+  // Output: ថ្ងៃពុធ ១២រោច ខែមិគសិរ ឆ្នាំម្សាញ់ សប្តស័ក ពុទ្ធសករាជ ២៥៦៩
 </script>
 ```
 
+> **Note:** Use `momentkh.js` (UMD bundle) for browsers. The `dist/momentkh.js` is CommonJS format for Node.js.
+
 ### Node.js (CommonJS)
 
 ```javascript
+// Use the CommonJS module from dist/
 const momentkh = require("@thyrith/momentkh");
 
 // Convert specific date
@@ -125,7 +123,7 @@ console.log(momentkh.format(khmer));
 
 // Get Khmer New Year
 const newYear = momentkh.getNewYear(2024);
-console.log(newYear); // { year: 2024, month: 4, day: 13, hour: 22, minute: 24 }
+console.log(newYear); // { year: 2024, month: 4, day: 13, hour: 22, minute: 17 }
 ```
 
 ### ES Modules
@@ -149,7 +147,7 @@ import momentkh, {
   MoonPhase,
   MonthIndex,
   AnimalYear,
-  EraYear,
+  Sak,
   DayOfWeek,
 } from "@thyrith/momentkh";
 
@@ -165,14 +163,14 @@ console.log(momentkh.format(khmer));
 
 // Access enum values (NEW in v3.0!)
 console.log(khmer.khmer.moonPhase === MoonPhase.Waxing); // Type-safe comparison
-console.log(khmer.khmer.monthIndex === MonthIndex.Chetr); // Enum comparison
+console.log(khmer.khmer.monthIndex === MonthIndex.Cheit); // Enum comparison
 console.log(khmer.khmer.dayOfWeek === DayOfWeek.Sunday); // Autocomplete support!
 
 // Reverse conversion with enums (type-safe!)
 const gregorianDate: GregorianDate = momentkh.fromKhmer(
   15,
   MoonPhase.Waxing, // Use enum instead of 0
-  MonthIndex.Visakh, // Use enum instead of 5
+  MonthIndex.Pisakh, // Use enum instead of 5
   2568
 );
 console.log(
@@ -205,7 +203,7 @@ const monthName = momentkh.constants.LunarMonthNames[4]; // "ចេត្រ"
 - 🌙 `MoonPhase` - Waxing (កើត) and Waning (រោច)
 - 📅 `MonthIndex` - All 14 Khmer lunar months
 - 🐉 `AnimalYear` - All 12 animal years
-- ⭐ `EraYear` - All 10 era years
+- ⭐ `Sak` - All 10 Saks
 - 📆 `DayOfWeek` - Sunday through Saturday
 
 ---
@@ -249,8 +247,8 @@ Converts a Gregorian (Western) date to a Khmer Lunar date.
     jsYear: 1386,                // Number: Jolak Sakaraj (Chula Sakaraj) year
     animalYear: 4,               // AnimalYear enum: 0-11 (NEW in v3.0)
     animalYearName: 'រោង',       // String: Animal year name
-    eraYear: 6,                  // EraYear enum: 0-9 (NEW in v3.0)
-    eraYearName: 'ឆស័ក',         // String: Era/Sak name
+    sak: 6,                  // Sak enum: 0-9 (NEW in v3.0)
+    sakName: 'ឆស័ក',         // String: Sak name
     dayOfWeek: 0,                // DayOfWeek enum: 0=Sunday, 6=Saturday (NEW in v3.0)
     dayOfWeekName: 'អាទិត្យ'     // String: Khmer weekday name
   },
@@ -267,9 +265,9 @@ Converts a Gregorian (Western) date to a Khmer Lunar date.
 
 ```javascript
 const result = momentkh.fromGregorian(2024, 4, 14);
-console.log(result.khmer.beYear); // 2568
+console.log(result.khmer.beYear); // 2567
 console.log(result.khmer.monthName); // 'ចេត្រ'
-console.log(result.khmer.animalYear); // 'រោង'
+console.log(result.khmer.animalYear); // 4 (រោង)
 ```
 
 ---
@@ -319,14 +317,14 @@ Converts a Khmer Lunar date to a Gregorian date.
 ```javascript
 // Using numbers (backward compatible)
 const gregorian1 = momentkh.fromKhmer(6, 0, 4, 2568);
-console.log(gregorian1); // { year: 2024, month: 4, day: 14 }
+console.log(gregorian1); // { year: 2025, month: 4, day: 3 }
 
 // Using enums (NEW in v3.0 - type-safe!)
 const { MoonPhase, MonthIndex } = momentkh;
 const gregorian2 = momentkh.fromKhmer(
   6,
   MoonPhase.Waxing,
-  MonthIndex.Chetr,
+  MonthIndex.Cheit,
   2568
 );
 console.log(gregorian2); // { year: 2024, month: 4, day: 14 }
@@ -415,7 +413,7 @@ console.log(
     ny2024.hour
   }:${String(ny2024.minute).padStart(2, "0")}`
 );
-// Output: Khmer New Year 2024: 13/4/2024 at 22:24
+// Output: Khmer New Year 2024: 13/4/2024 at 22:17
 
 // Loop through multiple years
 for (let year = 2020; year <= 2025; year++) {
@@ -444,9 +442,14 @@ Formats a Khmer date object into a string with optional custom formatting.
 **Default Format:**
 
 ```
-ថ្ងៃ{weekday} {day}{moonPhase} ខែ{month} ឆ្នាំ{animalYear} {eraYear} ពុទ្ធសករាជ {beYear}
+ថ្ងៃ{weekday} {day}{moonPhase} ខែ{month} ឆ្នាំ{animalYear} {sak} ពុទ្ធសករាជ {beYear}
 ```
 
+**Escaping Characters:**
+To escape characters in the format string (so they are not interpreted as format codes), wrap them in square brackets `[]`.
+
+Example: `[Week] w` -> "Week អា"
+
 **Returns:** String (formatted Khmer date)
 
 **Example:**
@@ -467,6 +470,10 @@ console.log(momentkh.format(khmer, "c/M/D"));
 
 console.log(momentkh.format(khmer, "ថ្ងៃw dN m ឆ្នាំa e ព.ស.b"));
 // ថ្ងៃអា ៦កើត ចេត្រ ឆ្នាំរោង ឆស័ក ព.ស.២៥៦៨
+
+// Escaping characters (use brackets [])
+console.log(momentkh.format(khmer, "[Day:] d [Month:] m"));
+// Day: ៦ Month: ចេត្រ
 ```
 
 ---
@@ -495,20 +502,20 @@ All 14 Khmer lunar months (including leap months).
 ```javascript
 const { MonthIndex } = momentkh;
 
-MonthIndex.Mikasar; // 0  - មិគសិរ
+MonthIndex.Migasir; // 0  - មិគសិរ
 MonthIndex.Bos; // 1  - បុស្ស
 MonthIndex.Meak; // 2  - មាឃ
-MonthIndex.Phalgun; // 3  - ផល្គុន
-MonthIndex.Chetr; // 4  - ចេត្រ
-MonthIndex.Visakh; // 5  - ពិសាខ
+MonthIndex.Phalkun; // 3  - ផល្គុន
+MonthIndex.Cheit; // 4  - ចេត្រ
+MonthIndex.Pisakh; // 5  - ពិសាខ
 MonthIndex.Jesth; // 6  - ជេស្ឋ
-MonthIndex.Asath; // 7  - អាសាឍ
+MonthIndex.Asadh; // 7  - អាសាឍ
 MonthIndex.Srap; // 8  - ស្រាពណ៍
-MonthIndex.Photrobot; // 9  - ភទ្របទ
+MonthIndex.Phatrabot; // 9  - ភទ្របទ
 MonthIndex.Assoch; // 10 - អស្សុជ
-MonthIndex.Kadek; // 11 - កត្ដិក
-MonthIndex.BothmakAsath; // 12 - បឋមាសាឍ (leap month only)
-MonthIndex.TutiyakAsath; // 13 - ទុតិយាសាឍ (leap month only)
+MonthIndex.Kadeuk; // 11 - កត្ដិក
+MonthIndex.Pathamasadh; // 12 - បឋមាសាឍ (leap month only)
+MonthIndex.Tutiyasadh; // 13 - ទុតិយាសាឍ (leap month only)
 ```
 
 #### 🐉 AnimalYear
@@ -532,23 +539,23 @@ AnimalYear.Cho; // 10 - 🐕 ច (Dog)
 AnimalYear.Kor; // 11 - 🐖 កុរ (Pig)
 ```
 
-#### ⭐ EraYear
+#### ⭐ Sak
 
-The 10 era years (ស័ក) cycle.
+The 10 Saks (ស័ក) cycle.
 
 ```javascript
-const { EraYear } = momentkh;
-
-EraYear.Samridhisak; // 0 - 🔟 សំរឹទ្ធិស័ក
-EraYear.Ekasak; // 1 - 1️⃣ ឯកស័ក
-EraYear.Tosak; // 2 - 2️⃣ ទោស័ក
-EraYear.Tresak; // 3 - 3️⃣ ត្រីស័ក
-EraYear.Chatvasak; // 4 - 4️⃣ ចត្វាស័ក
-EraYear.Panchasak; // 5 - 5️⃣ បញ្ចស័ក
-EraYear.Chhasak; // 6 - 6️⃣ ឆស័ក
-EraYear.Saptasak; // 7 - 7️⃣ សប្តស័ក
-EraYear.Atthasak; // 8 - 8️⃣ អដ្ឋស័ក
-EraYear.Novvasak; // 9 - 9️⃣ នព្វស័ក
+const { Sak } = momentkh;
+
+Sak.SamridhiSak; // 0 - 🔟 សំរឹទ្ធិស័ក
+Sak.AekSak; // 1 - 1️⃣ ឯកស័ក
+Sak.ToSak; // 2 - 2️⃣ ទោស័ក
+Sak.TreiSak; // 3 - 3️⃣ ត្រីស័ក
+Sak.ChattvaSak; // 4 - 4️⃣ ចត្វាស័ក
+Sak.PanchaSak; // 5 - 5️⃣ បញ្ចស័ក
+Sak.ChhaSak; // 6 - 6️⃣ ឆស័ក
+Sak.SappaSak; // 7 - 7️⃣ សប្តស័ក
+Sak.AtthaSak; // 8 - 8️⃣ អដ្ឋស័ក
+Sak.NappaSak; // 9 - 9️⃣ នព្វស័ក
 ```
 
 #### 📆 DayOfWeek
@@ -583,8 +590,8 @@ if (khmer.khmer.moonPhase === MoonPhase.Waxing) {
 }
 
 // Check specific month
-if (khmer.khmer.monthIndex === MonthIndex.Mikasar) {
-  console.log("It is Mikasar month!");
+if (khmer.khmer.monthIndex === MonthIndex.Migasir) {
+  console.log("It is Migasir month!");
 }
 
 // Check day of week
@@ -602,7 +609,7 @@ const { MoonPhase, MonthIndex } = momentkh;
 const date1 = momentkh.fromKhmer(
   15, // day
   MoonPhase.Waxing, // instead of 0
-  MonthIndex.Visakh, // instead of 5
+  MonthIndex.Pisakh, // instead of 5
   2568
 );
 
@@ -622,14 +629,14 @@ const khmer = momentkh.fromGregorian(2024, 12, 16);
 
 // Switch on month
 switch (khmer.khmer.monthIndex) {
-  case MonthIndex.Mikasar:
+  case MonthIndex.Migasir:
   case MonthIndex.Bos:
   case MonthIndex.Meak:
     console.log("Winter months");
     break;
-  case MonthIndex.Phalgun:
-  case MonthIndex.Chetr:
-  case MonthIndex.Visakh:
+  case MonthIndex.Phalkun:
+  case MonthIndex.Cheit:
+  case MonthIndex.Pisakh:
     console.log("Spring months");
     break;
   // ... more cases
@@ -666,14 +673,14 @@ const month: MonthIndex = result.khmer.monthIndex;
 const date = momentkh.fromKhmer(
   15,
   MoonPhase.  // ← IDE shows: Waxing, Waning
-  MonthIndex. // ← IDE shows: Mikasar, Bos, Meak, etc.
+  MonthIndex. // ← IDE shows: Migasir, Bos, Meak, etc.
   2568
 );
 ```
 
 ### Benefits of Using Enums
 
-1. 📖 **Readability**: `MonthIndex.Visakh` is clearer than `5`
+1. 📖 **Readability**: `MonthIndex.Pisakh` is clearer than `5`
 2. 🛡️ **Type Safety**: TypeScript catches invalid values at compile time
 3. ⚡ **Autocomplete**: IDEs show all available options
 4. 🔧 **Maintainability**: Easier to understand code months later
@@ -686,8 +693,8 @@ const date = momentkh.fromKhmer(
 
 ```javascript
 // All of these work:
-momentkh.fromKhmer(15, MoonPhase.Waxing, MonthIndex.Visakh, 2568); // ✨ New enum way
-momentkh.fromKhmer(15, 0, MonthIndex.Visakh, 2568); // 🔀 Mixed
+momentkh.fromKhmer(15, MoonPhase.Waxing, MonthIndex.Pisakh, 2568); // ✨ New enum way
+momentkh.fromKhmer(15, 0, MonthIndex.Pisakh, 2568); // 🔀 Mixed
 momentkh.fromKhmer(15, MoonPhase.Waxing, 5, 2568); // 🔀 Mixed
 momentkh.fromKhmer(15, 0, 5, 2568); // 👍 Old way still works!
 ```
@@ -704,15 +711,15 @@ The Khmer calendar is a **lunisolar calendar** that tracks both the moon phases
 
 **Full Name:** ពុទ្ធសករាជ (Putthsak, Buddhist Era)
 **Offset from Gregorian:** +543 or +544
-**When it increases:** At midnight (00:00) on the **15th waxing day of Pisakh month** (១៥កើត ខែពិសាខ)
+**When it increases:** At midnight (00:00) on the **1st waning day of Pisakh month** (១រោច ខែពិសាខ)
 
 **Example Timeline:**
 
 ```
-2024-05-22 23:59 → 14កើត Pisakh, BE 2567
-2024-05-23 00:00 → 15កើត Pisakh, BE 2568 (NEW year starts!)
-2024-05-23 23:59 → 15កើត Pisakh, BE 2568
-2024-05-24 00:00 → 1រោច Pisakh, BE 2568
+2024-05-22 23:59 → 15កើត Pisakh, BE 2567
+2024-05-23 00:00 → 1រោច Pisakh, BE 2568 (NEW year starts!)
+2024-05-23 23:59 → 1រោច Pisakh, BE 2568
+2024-05-24 00:00 → 2រោច Pisakh, BE 2568
 ```
 
 **Important:**
@@ -781,13 +788,13 @@ console.log(at.khmer.animalYear); // 'រកា' (Rooster) - Changed!
 
 ---
 
-### Era Year (Sak)
+### Sak
 
 **Full Name:** ស័ក (Sak, Era)
 **Cycle:** 10 years
 **When it increases:** At **midnight (00:00) of the last day** of Khmer New Year celebration (Lerng Sak - ថ្ងៃឡើងស័ក)
 
-**The 10 Eras (in order):**
+**The 10 Saks (in order):**
 | Index | Khmer | Romanization |
 |-------|-------|--------------|
 | 0 | សំរឹទ្ធិស័ក | Samridhi Sak |
@@ -805,19 +812,19 @@ console.log(at.khmer.animalYear); // 'រកា' (Rooster) - Changed!
 
 - 🎉 **Day 1:** Moha Songkran (មហាសង្រ្កាន្ត) - New Year's Day
 - 🎊 **Day 2:** Virak Wanabat (វីរៈវ័នបត) - Second day
-- ⭐ **Day 3 or 4:** Lerng Sak (ថ្ងៃឡើងស័ក) - Last day & Era change day
+- ⭐ **Day 3 or 4:** Lerng Sak (ថ្ងៃឡើងស័ក) - Last day & Sak change day
 
 **Example:**
 
 ```javascript
 // 2024 New Year is on April 13, 22:24
-// Lerng Sak (Era change) is typically 3-4 days later at midnight
+// Lerng Sak (Sak change) is typically 3-4 days later at midnight
 
 const newYearDay = momentkh.fromGregorian(2024, 4, 13, 23, 0);
-console.log(newYearDay.khmer.eraYear); // 'ឆស័ក' (still old era)
+console.log(newYearDay.khmer.sak); // 'ឆស័ក' (still old sak)
 
 const lerngSakDay = momentkh.fromGregorian(2024, 4, 17, 0, 0); // Midnight of Lerng Sak
-console.log(lerngSakDay.khmer.eraYear); // 'សប្តស័ក' (new era!)
+console.log(lerngSakDay.khmer.sak); // 'សប្តស័ក' (new sak!)
 ```
 
 ---
@@ -826,20 +833,20 @@ console.log(lerngSakDay.khmer.eraYear); // 'សប្តស័ក' (new era!)
 
 **Summary Table:**
 
-| Year Type       | Changes At             | Example Date/Time    |
-| --------------- | ---------------------- | -------------------- |
-| **BE Year**     | 00:00 on ១៥កើត ខែពិសាខ | May 23, 2024 00:00   |
-| **Animal Year** | ម៉ោង និង នាទីទេវតាចុះ  | April 13, 2024 22:17 |
-| **Era Year**    | 00:00 នៅថ្ងៃឡើងស័ក     | April 16, 2024 00:00 |
+| Year Type       | Changes At               | Example Date/Time    |
+| --------------- | ------------------------ | -------------------- |
+| **BE Year**     | 00:00 នៅថ្ងៃ១រោច ខែពិសាខ | May 23, 2024 00:00   |
+| **Animal Year** | ម៉ោង និង នាទីទេវតាចុះ    | April 13, 2024 22:17 |
+| **Sak**         | 00:00 នៅថ្ងៃឡើងស័ក       | April 16, 2024 00:00 |
 
 **Visual Timeline for 2024:**
 
 ```
-April 13, 22:23 → BE 2567, Monkey (វក), Old Era (ឆស័ក)
-April 13, 22:24 → BE 2567, Rooster (រកា), Old Era (ឆស័ក) ← Animal Year changes
-April 17, 00:00 → BE 2567, Rooster (រកា), New Era (សប្តស័ក) ← Era changes
-May 22, 23:59   → BE 2567, Rooster (រកា), New Era (សប្តស័ក)
-May 23, 00:00   → BE 2568, Rooster (រកា), New Era (សប្តស័ក) ← BE Year changes
+April 13, 22:23 → BE 2567, Monkey (វក), Old Sak (ឆស័ក)
+April 13, 22:24 → BE 2567, Rooster (រកា), Old Sak (ឆស័ក) ← Animal Year changes
+April 17, 00:00 → BE 2567, Rooster (រកា), New Sak (សប្តស័ក) ← Sak changes
+May 22, 23:59   → BE 2567, Rooster (រកា), New Sak (សប្តស័ក)
+May 23, 00:00   → BE 2568, Rooster (រកា), New Sak (សប្តស័ក) ← BE Year changes
 ```
 
 ---
@@ -848,26 +855,39 @@ May 23, 00:00   → BE 2568, Rooster (រកា), New Era (សប្តស័ក
 
 Complete list of format tokens for the `format()` function:
 
-| Token                  | Output            | Description                 | Example               |
-| ---------------------- | ----------------- | --------------------------- | --------------------- |
+| Token                  | Output            | Description                    | Example               |
+| ---------------------- | ----------------- | ------------------------------ | --------------------- |
 | **📅 Date Components** |
-| `W`                    | ថ្ងៃនៃសប្តាហ៍ពេញ  | Weekday name (full)         | អាទិត្យ, ចន្ទ, អង្គារ |
-| `w`                    | ថ្ងៃនៃសប្តាហ៍ខ្លី | Weekday name (short)        | អា, ច, អ              |
-| `d`                    | ថ្ងៃទី            | Lunar day number            | ១, ៥, ១៥              |
-| `D`                    | ថ្ងៃទី (២ខ្ទង់)   | Lunar day (zero-padded)     | ០១, ០៥, ១៥            |
+| `W`                    | ថ្ងៃនៃសប្តាហ៍ពេញ  | Weekday name (full)            | អាទិត្យ, ចន្ទ, អង្គារ |
+| `w`                    | ថ្ងៃនៃសប្តាហ៍ខ្លី | Weekday name (short)           | អា, ច, អ              |
+| `d`                    | ថ្ងៃទី            | Lunar day number               | ១, ៥, ១៥              |
+| `D`                    | ថ្ងៃទី (២ខ្ទង់)   | Lunar day (zero-padded)        | ០១, ០៥, ១៥            |
 | **🌙 Moon Phase**      |
-| `n`                    | កើត/រោច (ខ្លី)    | Moon phase (short)          | ក, រ                  |
-| `N`                    | កើត/រោច (ពេញ)     | Moon phase (full)           | កើត, រោច              |
-| `o`                    | និមិត្តសញ្ញា      | Moon day symbol             | ᧡, ᧢, ᧣ ... ᧿         |
+| `n`                    | កើត/រោច (ខ្លី)    | Moon phase (short)             | ក, រ                  |
+| `N`                    | កើត/រោច (ពេញ)     | Moon phase (full)              | កើត, រោច              |
+| `o`                    | និមិត្តសញ្ញា      | Moon day symbol                | ᧡, ᧢, ᧣ ... ᧿         |
 | **📆 Month Names**     |
-| `m`                    | ខែចន្ទគតិ         | Lunar month name            | មិគសិរ, បុស្ស, ចេត្រ  |
-| `M`                    | ខែសុរិយគតិ        | Solar month name            | មករា, កុម្ភៈ, មេសា    |
+| `m`                    | ខែចន្ទគតិ         | Lunar month name               | មិគសិរ, បុស្ស, ចេត្រ  |
+| `ms`                   | ខែ (សង្ខេប)       | Lunar month name (abbreviated) | មិ, បុ                |
+| `Ms`                   | ខែ (សង្ខេប)       | Solar month name (abbreviated) | មក, កម                |
+| `M`                    | ខែសុរិយគតិ        | Solar month name               | មករា, កុម្ភៈ, មេសា    |
 | **⏰ Year Components** |
-| `a`                    | ឆ្នាំសត្វ         | Animal year                 | ជូត, ឆ្លូវ, រោង       |
-| `e`                    | ស័ក               | Era year                    | ឯកស័ក, ទោស័ក          |
-| `b`                    | ព.ស.              | Buddhist Era year           | ២៥៦៨                  |
-| `c`                    | គ.ស.              | Common Era (Gregorian) year | ២០២៤                  |
-| `j`                    | ច.ស.              | Jolak Sakaraj year          | ១៣៨៦                  |
+| `a`                    | ឆ្នាំសត្វ         | Animal year                    | ជូត, ឆ្លូវ, រោង       |
+| `as`                   | ឆ្នាំ (រូប)       | Animal year emoji              | 🐀, 🐂, 🐉            |
+| `e`                    | ស័ក               | Sak                            | ឯកស័ក, ទោស័ក          |
+| `b`                    | ព.ស.              | Buddhist Era year              | ២៥៦៨                  |
+| `br`                   | BE                | Buddhist Era year (Latin)      | 2568                  |
+| `c`                    | គ.ស.              | Common Era (Gregorian) year    | ២០២៤                  |
+| `cr`                   | CE                | Common Era year (Latin)        | 2024                  |
+| `j`                    | ច.ស.              | Jolak Sakaraj year             | ១៣៨៦                  |
+| `jr`                   | JS                | Jolak Sakaraj year (Latin)     | 1386                  |
+| **📅 Day Components**  |
+| `d`                    | ថ្ងៃទី            | Day of month                   | ១, ២, ១៤              |
+| `dr`                   | Day               | Day of month (Latin)           | 1, 2, 14              |
+| `D`                    | ថ្ងៃទី (មាន០)     | Day of month (padded)          | ០១, ០២, ១៤            |
+| `Dr`                   | Day (0)           | Day of month (padded Latin)    | 01, 02, 14            |
+| `W`                    | ថ្ងៃនៃសប្តាហ៍     | Day of week (full)             | អាទិត្យ, ចន្ទ         |
+| `w`                    | ថ្ងៃ (សង្ខេប)     | Day of week (short)            | អា, ច, អ              |
 
 **Format Examples:**
 
@@ -911,8 +931,13 @@ momentkh.constants.AnimalYearNames;
 // ['ជូត', 'ឆ្លូវ', 'ខាល', 'ថោះ', 'រោង', 'ម្សាញ់',
 //  'មមី', 'មមែ', 'វក', 'រកា', 'ច', 'កុរ']
 
-// Era year names array (indices 0-9)
-momentkh.constants.EraYearNames;
+// Animal year emojis array (indices 0-11)
+momentkh.constants.AnimalYearEmojis;
+// ['🐀', '🐂', '🐅', '🐇', '🐉', '🐍',
+//  '🐎', '🐐', '🐒', '🐓', '🐕', '🐖']
+
+// Sak names array (indices 0-9)
+momentkh.constants.SakNames;
 // ['សំរឹទ្ធិស័ក', 'ឯកស័ក', 'ទោស័ក', 'ត្រីស័ក', 'ចត្វាស័ក',
 //  'បញ្ចស័ក', 'ឆស័ក', 'សប្តស័ក', 'អដ្ឋស័ក', 'នព្វស័ក']
 
@@ -921,7 +946,7 @@ momentkh.constants.WeekdayNames;
 // ['អាទិត្យ', 'ចន្ទ', 'អង្គារ', 'ពុធ', 'ព្រហស្បតិ៍', 'សុក្រ', 'សៅរ៍']
 
 // Moon phase names array (indices 0-1)
-momentkh.constants.MoonStatusNames;
+momentkh.constants.MoonPhaseNames;
 // ['កើត', 'រោច']
 ```
 
@@ -1122,7 +1147,7 @@ console.log(
 );
 console.log("BE Year:", khmer.khmer.beYear);
 console.log("Animal Year:", khmer.khmer.animalYear);
-console.log("Era:", khmer.khmer.eraYear);
+console.log("Sak:", khmer.khmer.sak);
 console.log("Month:", khmer.khmer.monthName);
 console.log(
   "Day:",
@@ -1133,7 +1158,7 @@ console.log(
 // Gregorian: 14/4/2024
 // BE Year: 2568
 // Animal Year: រោង
-// Era: ឆស័ក
+// Sak: ឆស័ក
 // Month: ចេត្រ
 // Day: 6កើត
 ```
@@ -1270,7 +1295,7 @@ for (let day = 20; day <= 25; day++) {
 
 MIT License - Same as original momentkh
 
-Copyright (c) 2024
+Copyright (c) 2025
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
@@ -1283,10 +1308,6 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 ## 🙏 Credits & References
 
 - **Original momentkh library** by [Thyrith Sor](https://github.com/ThyrithSor)
-- **Algorithm based on:**
-  - Traditional Khmer astronomical calculations
-  - "Pratitin Soryakkatik-Chankatik 1900-1999" by Mr. Roath Kim Soeun
-  - Khmer calendar C++ reference implementation
 - **Resources:**
   - [CAM-CC: Khmer Calendar](http://www.cam-cc.org)
   - [Dahlina: Khmer New Year Calculation](http://www.dahlina.com/education/khmer_new_year_time.html)
@@ -1322,12 +1343,11 @@ node test_specific_dates.js
 
 ## 📞 Support
 
-- **Documentation:** See examples folder (`newYearMoment.js`, `index.html`)
 - **Issues:** [GitHub Issues](https://github.com/ThyrithSor/momentkh/issues)
 - **Comparison:** Check behavior against original momentkh for compatibility
+- **Contact** [E-mail](me@thyrith.com)
 
 ---
 
-**Version:** 3.0.0
-**Last Updated:** December 2024
-**Status:** Production Ready ✅
+**Version:** 3.0.2
+**Last Updated:** December 2025