lichta 1.0.1 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zeforc Labs
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,251 +1,48 @@
-# 🌙 LichTa
+# lichta (legacy)
 
-**Vietnamese Solar ↔ Lunar Calendar conversion library for JavaScript/TypeScript.**
+[![npm version](https://img.shields.io/npm/v/lichta.svg)](https://www.npmjs.com/package/lichta)
 
-Supports ready-to-use Svelte 5 components, while exporting a pure TypeScript core for React, Vue, Angular, and vanilla JS.
+> ⚠️ **Package này đã deprecated.** Đây là tên npm cũ của thư viện trước khi đổi sang các package có scope `@lichta/*`. Đừng cài package này cho dự án mới — xem bảng bên dưới để chọn đúng package thay thế.
 
-[![npm version](https://img.shields.io/npm/v/lichta)](https://www.npmjs.com/package/lichta)
-[![license](https://img.shields.io/npm/l/lichta)](https://github.com/zeforc/lichta/blob/main/LICENSE)
+## Vì sao package này vẫn tồn tại
 
-🚀 **[Live Demo](https://lich-ta.vercel.app/)**
+Trước đây toàn bộ thư viện được publish dưới 1 package tên `lichta` duy nhất. Từ khi tách thành monorepo với các package scoped (`@lichta/core`, `@lichta/react`, `@lichta/vue`, `@lichta/svelte`, `@lichta/full-calendar`, `@lichta/event-calendar`, `@lichta/react-big-calendar`), package `lichta` được giữ lại làm cầu nối tương thích ngược cho những dự án đang cài `lichta` từ trước, tránh vỡ code đột ngột khi họ chạy `npm update`.
 
-> 🇻🇳 [Phiên bản Tiếng Việt (Vietnamese version)](./README.vi.md)
+## Trạng thái hiện tại
 
----
+**Package này hiện chỉ re-export `@lichta/svelte`:**
 
-## ✨ Features
-
-- 🔄 **Solar ↔ Lunar Conversion** — Ho Ngoc Duc algorithm (range 1800–2199)
-- 🐉 **Sexagenary Cycle (Can Chi)** — Calculate Can Chi for year, month, day, and hour
-- 🔮 **Five Elements (Ngũ Hành)** — Calculate destiny element based on birth year
-- ⏰ **Auspicious Hours (Giờ Hoàng Đạo)** — 6 auspicious hours in a day
-- 📅 **Calendar Component** — Svelte 5 monthly calendar with lunar dates
-- 🎨 **Format** — Display traditional lunar dates (Mùng Một tháng Giêng...)
-- 🌐 **i18n** — Vietnamese–English–Japanese–Korean support (vi, en, ja, ko)
-- 📦 **Multi-framework** — Svelte 5, React, Vue, Angular, vanilla JS
-
----
-
-## 📦 Installation
-
-```bash
-npm install lichta
-```
-
----
-
-## 🚀 Usage
-
-### Core Logic (Any framework)
-
-Import from `lichta/core` to use **pure TypeScript** — no Svelte dependency:
-
-```typescript
-import { LichTa, getYearDetails } from 'lichta/core';
-
-// Solar → Lunar
-const lunar = LichTa.toLunar(10, 2, 2024);
-// → {
-//     day: 1, month: 1, year: 2024,
-//     isLeap: false,
-//     yearCanChi: 'Giáp Thìn',
-//     monthCanChi: 'Bính Dần',
-//     dayCanChi: '...',
-//     jd: 2460350
-//   }
-
-// Lunar → Solar
-const solar = LichTa.toSolar(1, 1, 2024, false);
-// → { day: 10, month: 2, year: 2024 }
-
-// Custom timezone (default is GMT+7)
-const lunarChina = LichTa.toLunar(10, 2, 2024, 8); // GMT+8
-```
-
-### Sexagenary Cycle & Feng Shui (Can Chi & Phong Thủy)
-
-```typescript
-import {
-	getYearDetails,
-	getDayCanChi,
-	getMonthCanChi,
-	getHourCanChi,
-	getAuspiciousHours
-} from 'lichta/core';
-
-// Can Chi + Element for the year
-getYearDetails(2024);
-// → { can: 'Giáp', chi: 'Thìn', menh: 'Hỏa',
-//     fullString: 'Giáp Thìn - Mệnh Hỏa' }
-
-// Day Can Chi (requires Julian Day Number)
-const lunar = LichTa.toLunar(10, 2, 2024);
-getDayCanChi(lunar.jd); // → 'Giáp Tý'
-
-// Month Can Chi
-getMonthCanChi(1, 2024); // → month Giêng year Giáp Thìn
-
-// Hour Can Chi
-getHourCanChi(8, lunar.jd); // → hour Thìn (7h-9h)
-
-// Auspicious Hours
-getAuspiciousHours(lunar.jd);
-// → ['Tý', 'Sửu', 'Mão', 'Ngọ', 'Mùi', 'Dậu']
-```
-
-### Format & Display
-
-```typescript
-import { formatTraditional, formatLunarDate, getMonthName, getDayName } from 'lichta/utils';
-
-const lunar = LichTa.toLunar(10, 2, 2024);
-
-// Traditional format
-formatTraditional(lunar);
-// → 'Mùng Một tháng Giêng năm Giáp Thìn'
-
-// Pattern format
-formatLunarDate(lunar, 'dd/MM/yyyy'); // → '01/01/2024'
-formatLunarDate(lunar, 'CC'); // → 'Giáp Thìn'
-formatLunarDate(lunar, 'Ngày DC'); // → 'Ngày Giáp Tý'
-
-// Traditional names
-getMonthName(1); // → 'Giêng'
-getMonthName(12); // → 'Chạp'
-getDayName(1); // → 'Mùng Một'
-getDayName(15); // → 'Rằm'
-getDayName(30); // → 'Ba Mươi'
-```
-
-**Format tokens:**
-
-| Token  | Description           | Example   |
-| ------ | --------------------- | --------- |
-| `dd`   | 2-digit day           | 01, 15    |
-| `d`    | Day                   | 1, 15     |
-| `MM`   | 2-digit month         | 01, 12    |
-| `M`    | Month                 | 1, 12     |
-| `yyyy` | 4-digit year          | 2024      |
-| `yy`   | Last 2 digits of year | 24        |
-| `CC`   | Year Can Chi          | Giáp Thìn |
-| `DC`   | Day Can Chi           | Giáp Tý   |
-| `MC`   | Month Can Chi         | Bính Dần  |
-| `L`    | "Nhuận" if leap month | Nhuận     |
-
-### Svelte 5 Components
-
-```svelte
-<script>
-	import { Calendar, Formatter } from 'lichta';
-</script>
-
-<!-- Full monthly calendar -->
-<Calendar showLunar={true} locale="vi" onSelect={(date, lunar) => console.log(date, lunar)} />
-
-<!-- Lunar date formatter -->
-<Formatter date={new Date()} />
+```javascript
+// index.js
+console.warn("[lichta] WARNING: The 'lichta' package is deprecated for Svelte components. ...");
+export * from '@lichta/svelte';
 ```
 
-#### Calendar Props
+Nghĩa là:
+- Nếu bạn đang dùng Svelte, `import { ... } from 'lichta'` vẫn hoạt động (thực chất là `@lichta/svelte`), nhưng sẽ in cảnh báo deprecation ra console.
+- Nếu bạn dùng React, Vue, hoặc chỉ cần logic tính toán thuần (vanilla JS/TS) — package này **không có đường dẫn tương thích cho bạn**, vì nó chỉ trỏ tới `@lichta/svelte`. Cài `lichta` trong trường hợp này sẽ kéo theo `svelte` như một dependency dù bạn không dùng Svelte.
 
-| Prop           | Type                                     | Default       | Description                 |
-| -------------- | ---------------------------------------- | ------------- | --------------------------- |
-| `month`        | `number`                                 | Current month | Displayed month (1-12)      |
-| `year`         | `number`                                 | Current year  | Displayed year              |
-| `selectedDate` | `Date \| null`                           | `null`        | Selected date               |
-| `onSelect`     | `(date: Date, lunar: LunarDate) => void` | —             | Callback on date select     |
-| `showLunar`    | `boolean`                                | `true`        | Show lunar dates            |
-| `locale`       | `'vi' \| 'en' \| 'ja' \| 'ko'`           | `'vi'`        | Language                    |
-| `dayCell`      | `Snippet`                                | —             | Custom snippet for day cell |
+## Nên làm gì
 
-#### Theming
+Đừng cài `lichta`. Cài thẳng package phù hợp:
 
-The Calendar supports CSS custom properties:
-
-```css
-:root {
-	--lichta-primary: #d4a373;
-	--lichta-bg: #fffcf7;
-	--lichta-text: #2c1810;
-	--lichta-today-bg: #d4a373;
-	--lichta-selected-bg: #a0522d;
-	--lichta-lunar-text: #b08968;
-	--lichta-radius: 8px;
-	--lichta-font: 'Inter', sans-serif;
-}
-```
+| Bạn dùng | Cài package |
+|---|---|
+| Chỉ cần logic tính toán (vanilla JS/TS, Node.js) | [`@lichta/core`](https://www.npmjs.com/package/@lichta/core) |
+| React | [`@lichta/react`](https://www.npmjs.com/package/@lichta/react) |
+| Vue | [`@lichta/vue`](https://www.npmjs.com/package/@lichta/vue) |
+| Svelte 5 | [`@lichta/svelte`](https://www.npmjs.com/package/@lichta/svelte) |
+| FullCalendar | [`@lichta/full-calendar`](https://www.npmjs.com/package/@lichta/full-calendar) |
+| EventCalendar | [`@lichta/event-calendar`](https://www.npmjs.com/package/@lichta/event-calendar) |
+| React Big Calendar | [`@lichta/react-big-calendar`](https://www.npmjs.com/package/@lichta/react-big-calendar) |
 
-### i18n
+Nếu bạn đang cài `lichta` từ trước và dùng API core (`LichTa.toLunar()`, ...), chuyển sang `@lichta/core` — API không đổi, chỉ đổi tên import:
 
-```typescript
-import { t, getZodiacAnimal } from 'lichta';
-
-// Get dictionary
-const vi = t('vi');
-vi.heavenlyStems; // ['Giáp', 'Ất', ...]
-vi.earthlyBranches; // ['Tý', 'Sửu', ...]
-vi.fiveElements; // ['Kim', 'Mộc', 'Thủy', 'Hỏa', 'Thổ']
-vi.monthNames; // ['Giêng', 'Hai', ..., 'Chạp']
-
-const en = t('en');
-en.fiveElements; // ['Metal', 'Wood', 'Water', 'Fire', 'Earth']
-en.zodiacAnimals; // ['Rat', 'Ox', 'Tiger', ...]
-
-const ja = t('ja');
-ja.weekDays; // ['日', '月', '火', '水', '木', '金', '土']
-
-const ko = t('ko');
-ko.fiveElements; // ['금', '목', '수', '화', '토']
-
-// Zodiac animal by year
-getZodiacAnimal(0, 'vi'); // → 'Chuột'
-getZodiacAnimal(4, 'en'); // → 'Dragon'
-getZodiacAnimal(0, 'ja'); // → '鼠'
+```diff
+- import { LichTa } from 'lichta';
++ import { LichTa } from '@lichta/core';
 ```
 
----
-
-## 📁 Import Paths
-
-| Path           | Content                      | Used for                     |
-| -------------- | ---------------------------- | ---------------------------- |
-| `lichta`       | Full API + Svelte components | Svelte 5 projects            |
-| `lichta/core`  | Pure TypeScript logic        | React, Vue, Angular, vanilla |
-| `lichta/utils` | Format utilities             | Any framework                |
-
-```typescript
-// Svelte 5 — import everything
-import { LichTa, Calendar, Formatter, formatTraditional } from 'lichta';
-
-// React / Vue / Angular — import core logic only
-import { LichTa, getYearDetails } from 'lichta/core';
-import { formatTraditional, getDayName } from 'lichta/utils';
-```
-
----
-
-## 📐 Algorithm
-
-LichTa uses the lunar conversion algorithm by **Ho Ngoc Duc** (Leipzig University), based on:
-
-- **Julian Day Number** — Continuous day coordinate system for astronomical calculations
-- **New Moon** — Determines the 1st day of the lunar month
-- **Solar Terms** — Determines months and leap months
-- **Jean Meeus, "Astronomical Algorithms"** — Precise astronomical formulas
-
-**Range**: 1800 – 2199 | **Default timezone**: GMT+7 (Vietnam)
-
-See details in [docs/ALGORITHM.md](./docs/ALGORITHM.md).
-
----
-
-## 📄 License
+## License
 
 [MIT](./LICENSE)
-
----
-
-## 🙏 Credits
-
-- **Ho Ngoc Duc** — Original algorithm ([informatik.uni-leipzig.de](http://www.informatik.uni-leipzig.de/~duc/amlich/))
-- **Jean Meeus** — _Astronomical Algorithms_ (1998)

package/index.d.ts

@@ -0,0 +1 @@
+export * from '@lichta/svelte';

package/index.js

@@ -0,0 +1,3 @@
+console.warn("[lichta] WARNING: The 'lichta' package is deprecated for Svelte components. It will become a pure Vanilla JS core in v3.0.0. Please migrate to '@lichta/svelte' if you are using Svelte.");
+
+export * from '@lichta/svelte';

package/package.json

@@ -1,105 +1,25 @@
 {
-	"name": "lichta",
-	"version": "1.0.1",
-	"description": "Thư viện chuyển đổi Dương lịch ↔ Âm lịch Việt Nam. Vietnamese lunar calendar conversion library with Svelte 5 components.",
-	"author": "Zeforc | Stridev",
-	"license": "MIT",
-	"scripts": {
-		"dev": "vite dev",
-		"build": "vite build && npm run prepack",
-		"preview": "vite preview",
-		"prepare": "svelte-kit sync || echo ''",
-		"prepack": "svelte-kit sync && svelte-package && publint",
-		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
-		"lint": "prettier --check . && eslint .",
-		"format": "prettier --write .",
-		"test": "vitest run",
-		"test:watch": "vitest"
-	},
-	"files": [
-		"dist",
-		"!dist/**/*.test.*",
-		"!dist/**/*.spec.*"
-	],
-	"sideEffects": [
-		"**/*.css"
-	],
-	"svelte": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"type": "module",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"svelte": "./dist/index.js",
-			"default": "./dist/index.js"
-		},
-		"./core": {
-			"types": "./dist/core/index.d.ts",
-			"default": "./dist/core/index.js"
-		},
-		"./utils": {
-			"types": "./dist/utils/index.d.ts",
-			"default": "./dist/utils/index.js"
-		}
-	},
-	"peerDependencies": {
-		"svelte": "^5.0.0"
-	},
-	"peerDependenciesMeta": {
-		"svelte": {
-			"optional": true
-		}
-	},
-	"devDependencies": {
-		"@eslint/js": "^10.0.1",
-		"@sveltejs/adapter-auto": "^7.0.1",
-		"@sveltejs/kit": "^2.63.0",
-		"@sveltejs/package": "^2.5.8",
-		"@sveltejs/vite-plugin-svelte": "^7.1.2",
-		"@types/node": "^22",
-		"@event-calendar/core": "^5.7.1",
-		"@event-calendar/day-grid": "^3.12.0",
-		"@fullcalendar/core": "^6.1.20",
-		"@fullcalendar/daygrid": "^6.1.20",
-		"moment": "^2.30.1",
-		"eslint": "^10.4.1",
-		"eslint-config-prettier": "^10.1.8",
-		"eslint-plugin-svelte": "^3.19.0",
-		"globals": "^17.6.0",
-		"lichta-event-calendar": "^1.0.0",
-		"lichta-full-calendar": "^1.0.0",
-		"lichta-react-big-calendar": "^1.0.0",
-		"prettier": "^3.8.3",
-		"prettier-plugin-svelte": "^4.1.0",
-		"publint": "^0.3.21",
-		"react": "^19.2.7",
-		"react-big-calendar": "^1.20.0",
-		"react-dom": "^19.2.7",
-		"svelte": "^5.56.1",
-		"svelte-check": "^4.6.0",
-		"typescript": "^6.0.3",
-		"typescript-eslint": "^8.60.1",
-		"vite": "^8.0.16",
-		"vitest": "^3.2.6"
-	},
-	"keywords": [
-		"svelte",
-		"lunar-calendar",
-		"vietnamese",
-		"am-lich",
-		"duong-lich",
-		"can-chi",
-		"feng-shui",
-		"calendar",
-		"date-conversion"
-	],
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/zeforc/lichta.git"
-	},
-	"bugs": {
-		"url": "https://github.com/zeforc/lichta/issues"
-	},
-	"homepage": "https://github.com/zeforc/lichta#readme"
-}
+  "name": "lichta",
+  "version": "2.0.0",
+  "description": "LichTa - Thư viện lịch Âm Dương Việt Nam (Tương thích ngược)",
+  "author": "Zeforc Labs | Stridev",
+  "license": "MIT",
+  "type": "module",
+  "svelte": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "svelte": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@lichta/svelte": "2.0.0"
+  }
+}