jalaali-date-time-picker 1.0.1 → 2.0.0

package/README.md

@@ -2,14 +2,6 @@
 
 Production-ready Jalali (Persian) date + time picker for **React / Next.js**.
 
-[![npm version](https://img.shields.io/npm/v/jalaali-date-time-picker.svg)](https://www.npmjs.com/package/jalaali-date-time-picker)
-[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![TailwindCSS](https://img.shields.io/badge/TailwindCSS-%5E3.0-38b2ac?logo=tailwindcss&logoColor=white)](https://tailwindcss.com)
-[![ShadCN](https://img.shields.io/badge/ShadCN-UI-purple?logo=react)](https://ui.shadcn.dev)
-[![TypeScript](https://img.shields.io/badge/TypeScript-%5E5.0-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-[![Checked with Biome](https://img.shields.io/badge/Checked_with-Biome-60a5fa?style=flat&logo=biome)](https://biomejs.dev)
----
-
 - Fully typed
 - Tree-shakable ESM build
 - Built on Tailwind + ShadCN
@@ -83,6 +75,35 @@ export default function Page() {
 
 See the full interactive demo [here](https://alijeyrad.github.io/jalaali-date-time-picker/).
 
+---
+
+## Props
+
+| Prop             | Type                                              | Default            | Description |
+|------------------|---------------------------------------------------|--------------------|-------------|
+| `className`      | `string`                                          | `""`               | Optional Tailwind class |
+| `defaultValue`   | `Date`                                            | `new Date()`       | Default initial date |
+| `value`          | `Date`                                            | `undefined`        | Controlled value |
+| `minDate`        | `Date`                                            | `1970-01-01`       | Minimum date allowed |
+| `maxDate`        | `Date`                                            | `2100-12-31`       | Maximum date allowed |
+| `disablePast`    | `boolean`                                         | `false`            | Disallow past dates |
+| `disableFuture`  | `boolean`                                         | `false`            | Disallow future dates |
+| `minuteStep`     | `number`                                          | `1`                | Step for minute selection |
+| `disabled`       | `boolean`                                         | `false`            | Disable the picker |
+| `showTime`       | `boolean`                                         | `true`             | Show time picker |
+| `format`         | `"jalali" \| "gregorian"`                        | `"jalali"`         | Date format to display |
+| `clearable`      | `boolean`                                         | `false`            | Show "clear" button |
+| `inline`         | `boolean`                                         | `false`            | Render in-place instead of a modal |
+| `trigger`        | `ReactNode`                                       | `undefined`        | Custom trigger component |
+| `formatLabel`    | `(date: Date) => string`                          | `undefined`        | Custom display label formatter |
+| `onChange`       | `(date: Date) => void`                            | `undefined`        | Callback when value changes |
+| `onOpenChange`   | `(open: boolean) => void`                         | `undefined`        | Callback when modal opens/closes |
+| `onClear`        | `(prev: Date \| null) => void`                   | `undefined`        | Callback when cleared |
+| `inputRef`       | `React.RefObject<HTMLInputElement>`              | `undefined`        | Ref to hidden input |
+| `placeholderLabel` | `string`                                        | `"انتخاب تاریخ و زمان"` | Placeholder |
+| `inputFieldProps` | `InputFieldProps`                                | `undefined`        | Pass props from RHF, Formik, etc. |
+
+
 ---
 
 ## Goal

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "jalaali-date-time-picker",
-	"version": "1.0.1",
+	"version": "2.0.0",
 	"license": "MIT",
 	"keywords": [
 		"jalaali",
@@ -17,8 +17,7 @@
 		"react",
 		"shamsi",
 		"tailwind",
-		"shadcn",
-		"lucide"
+		"shadcn"
 	],
 	"repository": {
 		"type": "git",
@@ -37,7 +36,9 @@
 	"main": "dist/index.cjs",
 	"types": "dist/index.d.ts",
 	"sideEffects": false,
-	"files": ["dist"],
+	"files": [
+		"dist"
+	],
 	"scripts": {
 		"dev": "next dev --turbopack",
 		"build:site": "next build",
@@ -53,17 +54,7 @@
 		"@radix-ui/react-select": "^2.2.5",
 		"@radix-ui/react-separator": "^1.1.7",
 		"@radix-ui/react-slot": "^1.2.3",
-		"class-variance-authority": "^0.7.1",
-		"clsx": "^2.1.1",
-		"jalaali-js": "^1.2.8",
-		"lucide-react": ">=0.513",
-		"next": ">=14",
-		"next-themes": "^0.4.6",
-		"react": ">=18",
-		"react-dom": ">=18",
-		"react-hook-form": "^7.57.0",
-		"react-markdown": "^10.1.0",
-		"tailwind-merge": "^3.3.0"
+		"jalaali-js": "^1.2.8"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "1.9.4",
@@ -72,14 +63,20 @@
 		"@types/node": "^20",
 		"@types/react": "^19",
 		"@types/react-dom": "^19",
+		"class-variance-authority": "^0.7.1",
+		"lucide-react": "^0.468.0",
+		"next": ">=14",
+		"next-themes": "^0.4.6",
+		"react": ">=18",
+		"react-dom": ">=18",
+		"react-hook-form": "^7.57.0",
+		"react-markdown": "^10.1.0",
 		"tailwindcss": "^4",
 		"tsup": "^8.5.0",
 		"tw-animate-css": "^1.3.4",
 		"typescript": "^5"
 	},
 	"peerDependencies": {
-		"lucide-react": ">=0.513",
-		"next": ">=14",
 		"react": ">=18",
 		"react-dom": ">=18",
 		"tailwindcss": ">=3"