typescript update

Author: khumnath

.gitignore

@@ -1,49 +1,24 @@
-# C++ objects and libs
-*.slo
-*.lo
-*.o
-*.a
-*.la
-*.lai
-*.so
-*.dll
-*.dylib
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
 
-# Qt-es
-object_script.*.Release
-object_script.*.Debug
-*_plugin_import.cpp
-/.qmake.cache
-/.qmake.stash
-*.pro.user
-*.pro.user.*
-*.qbs.user
-*.qbs.user.*
-*.moc
-moc_*.cpp
-moc_*.h
-qrc_*.cpp
-ui_*.h
-*.qmlc
-*.jsc
-Makefile*
-*build*
+node_modules
+dist
+dist-ssr
+*.local
 
-# Qt unit tests
-target_wrapper.*
-
-# QtCreator
-*.autosave
-
-# QtCreator Qml
-*.qmlproject.user
-*.qmlproject.user.*
-
-# QtCreator CMake
-CMakeLists.txt.user*
-
-# QtCreator 4.8< compilation database 
-compile_commands.json
-
-# QtCreator local machine specific files for imported projects
-*creator.user*
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

README.md

@@ -1,56 +1,128 @@
-# Nepdate calendar
-`nepdate-calendar` provides a standalone Nepali calendar and converter for Bikram Sambat and Gregorian calendars.
+# Bikram Sambat Calendar
 
-# Nepdate widget
+A modern React + TypeScript web application for converting and viewing Nepali (Bikram Sambat) and Gregorian dates, with tithi calculation, event/holiday display, and a beautiful calendar UI.
 
-`nepdate-widget` is a desktop floating widget for Linux that displays the Nepali date. It provides the following features:
+## Features
 
-- Displays the Nepali date on your desktop.
-- Can be moved anywhere on the screen.
-- with automatic text color adjustment based on the background color.
+- Convert between Bikram Sambat (BS) and Gregorian (AD) dates
+- View Nepali and English months, days, and years
+- Calculate lunar tithi for any date
+- See major Nepali festivals and holidays
+- Responsive, accessible, and print-friendly calendar UI
+- Toggle between Nepali and English language
+- "Show in Calendar" and event modal support
+- Built with [Vite](https://vitejs.dev/), [React](https://react.dev/), [Tailwind CSS](https://tailwindcss.com/), and [shadcn/ui](https://ui.shadcn.com/)
 
-##To-Do List
+## Getting Started
 
-1. Create an installable DEB file for Debian-based distributions. (released appimages for wider linux distributions but gcc version is high now in release build. I will build with lower gcc version in future release.)
-2. Make the calendar responsive to window resizing.(Done)
-3. Implement tithi and other panchanga calculations in the calendar app.( Tithi implemented. in future i will check other components like nakshatra karan and yoga too.)
-4. make cross plateform application. now nepdate-calendar and widget builds and runs perfectly in windows.
-using qtcreator and mingw compiler. not tested cmake.(Done)
+### Prerequisites
 
-## Dependencies
+- [Node.js](https://nodejs.org/) (v18+ recommended)
+- [Yarn](https://yarnpkg.com/) or [npm](https://www.npmjs.com/)
 
-Nepdate and calendar relies on the following Qt libraries:
+### Installation
 
-- Qt Core
-- Qt Widgets
-- Qt GUI
+```sh
+git clone https://github.com/yourusername/nepdate.git
+cd nepdate
+yarn install
+# or
+npm install
+```
 
-## Usage
+### Development
 
-1. Clone this repository to your local machine.
-2. Create a build folder in the project directory.
-3. Build the project using `cmake ..` and then run `make all`.
-4. You can also compile the project using Qt Creator or Qmake.
-5. Run the Nepdate executables:
-    `nepdate-widget` for the desktop widget
-    `nepdate-calendar` for the calendar
-6. The floating Nepali date widget will appear on your desktop, with automatic text color adjustment based on the background color.
+Start the local development server:
 
-## Screenshots
-nepdate in action ![nepdate](https://github.com/khumnath/nepdate/assets/50103558/8f17f73b-3dfd-4679-a2f9-2461d9b34cf9)
+```sh
+yarn dev
+# or
+npm run dev
+```
 
+Open [http://localhost:8080](http://localhost:8080) in your browser.
 
-## License
+> **Note:** If you encounter a "too many open files" error, you may need to increase your system's file watch limit. See [this StackOverflow answer](https://stackoverflow.com/questions/53930305/nodemon-error-system-limit-for-number-of-file-watchers-reached) for help.
+
+### Local Production Build
+
+Build and preview locally:
+
+```sh
+yarn build
+yarn preview
+# or
+npm run build
+npm run preview
+```
+
+This will output the production build to the `dist/` directory, which is **not pushed to GitHub**.
+
+### Build for GitHub Pages
+
+To build for GitHub Pages (output to `docs/` and set correct base path):
+
+```sh
+yarn build-gh
+# or
+npm run build-gh
+```
+
+Preview the GitHub Pages build locally:
 
-This project is licensed under the **GNU General Public License (GPL) version 3**. See the LICENSE file for details.
+```sh
+yarn preview-gh
+# or
+npm run preview-gh
+```
 
-## contribution
+This will output the production build to the `docs/` directory, which **should be committed and pushed** to your repository for GitHub Pages deployment.
 
-first of all any suggestion and bug reports can be filed on github issue here https://github.com/khumnath/nepdate/issues
+### Deploy to GitHub Pages
+
+1. Commit and push the `docs` folder to your repository.
+2. In your repository settings, set GitHub Pages to serve from the `docs` folder on the `main` branch.
+3. Your site will be available at `https://<username>.github.io/nepdate/`.
+
+## Project Structure
+
+```
+├── bikram-calendar/      # Bikram Sambat calendar calculation library 
+├── src/                  # React app source code
+│   ├── components/       # React components
+│   ├── data/             # Event and holiday data
+│   ├── hooks/            # Custom React hooks
+│   ├── utils/            # Utility functions
+│   └── index.css         # Main CSS (Tailwind)
+├── docs/                 # Production build output for GitHub Pages (should be pushed)
+├── dist/                 # Production build output for local preview (not pushed)
+├── index.html            # Main HTML entry
+├── package.json
+├── postcss.config.js
+├── tailwind.config.ts
+└── vite.config.ts
+```
+
+## Scripts
+
+| Command         | Description                                 |
+|-----------------|---------------------------------------------|
+| `dev`           | Start local dev server                      |
+| `build`         | Build for local production (`dist/`)        |
+| `preview`       | Preview local production build              |
+| `build-gh`      | Build for GitHub Pages (`docs/`)            |
+| `preview-gh`    | Preview GitHub Pages build                  |
+| `lint`          | Run ESLint                                  |
+
+## Notes on Build Outputs
+
+- The `dist/` directory is for local production builds and **should not be pushed to Git**.
+- The `docs/` directory is for GitHub Pages deployment and **should be committed and pushed**.
+
+## License
 
-# for contribution 
-1. Clone repository
- 2. make changes
-  3. make a pull request with proper description of changes.
+This project is licensed under the [GPL v3 or later](https://www.gnu.org/licenses/gpl-3.0.en.html).
 
+---
 
+**Made with love by Khumnath.**

bikram-calendar/.npmignore

@@ -0,0 +1,16 @@
+
+# source
+src
+
+# builds
+*.tgz
+
+# tests
+__tests__
+coverage
+jest.config.js
+
+# Development files
+.eslintrc.js
+.prettierrc
+tsconfig.json

bikram-calendar/LICENSE

@@ -0,0 +1,10 @@
+GNU GENERAL PUBLIC LICENSE  
+Version 3, 29 June 2007
+
+Copyright (C) 2024
+
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

bikram-calendar/README.md

@@ -0,0 +1,87 @@
+# bikram-calendar
+
+A comprehensive JavaScript/TypeScript library for working with the Bikram Sambat (BS) calendar system used in Nepal.  
+Provides utilities for date conversion between Bikram Sambat and Gregorian calendars, tithi (lunar day) calculation, Nepali/English digit conversion, and more.
+
+---
+
+## Features
+
+- Convert between Bikram Sambat (BS) and Gregorian (AD) dates
+- Get information about Bikram months (days, start day of week)
+- Calculate Tithi (Lunar day)
+- Convert between Nepali and English digits
+- Access month and day names in both Nepali and English
+
+---
+
+## Usage
+
+> **Note:**  
+> This package is **not published to npm**.  
+> If you want to use it, **download or clone this repository** and copy or import the `bikram-calendar` folder into your own project.  
+> You can then import from it using a relative path, for example:
+
+```typescript
+import {
+  getToday,
+  convertToBikram,
+  convertToEnglish,
+  calculateTithi,
+  getNepaliDigits,
+  getEnglishDigits,
+  nepaliMonthsNp,
+  nepaliMonthsEn
+} from './bikram-calendar'; // Adjust the path as needed
+```
+
+---
+
+## API Documentation
+
+### Date Conversion
+
+#### `getToday(): BikramDateObj`
+Returns today's date in Bikram Sambat.
+
+#### `convertToBikram(date: Date): BikramDateObj`
+Converts a JavaScript Date to Bikram Sambat.
+
+#### `convertToEnglish(bsDate: BikramDateObj): Date`
+Converts a Bikram Sambat date to JavaScript Date.
+
+### Tithi Calculation
+
+#### `calculateTithi(date: Date): TithiResult`
+Calculates the tithi (lunar day) for a given date.
+
+### Month Information
+
+#### `getBikramMonth(year: number, month: number): BikramMonth`
+Gets information about a Bikram month including days and start day of week.
+
+### Utilities
+
+#### `getNepaliDigits(num: number): string`
+Converts English digits to Nepali digits.
+
+#### `getEnglishDigits(nepaliStr: string): string`
+Converts Nepali digits to English digits.
+
+#### `nepaliMonthsNp`, `nepaliMonthsEn`
+Arrays of Nepali and English month names.
+
+#### `nepaliDaysNp`, `nepaliDaysEn`
+Arrays of Nepali and English day names.
+
+---
+
+## License
+GNU General Public License v3.0 or later
+
+This software is licensed under the GNU General Public License, which allows for free use, modification, and distribution. The GPL ensures that the software and any derivative works remain open and free. For full details, please visit [GNU GPL v3.0](https://www.gnu.org/licenses/gpl-3.0.en.html).
+
+
+---
+
+**Made with love by Khumnath.**