persian-date-kit 0.0.1

package/dist/react-hook-form.d.ts

@@ -0,0 +1,47 @@
+import * as React from 'react';
+import type { Control, FieldValues, Path, RegisterOptions } from 'react-hook-form';
+import { type PersianDatePickerProps } from './components/PersianDatePicker';
+export type RHFDateValue = Date | null;
+export type UsePersianDatePickerControllerParams<TFieldValues extends FieldValues> = {
+    name: Path<TFieldValues>;
+    control: Control<TFieldValues>;
+    rules?: RegisterOptions<TFieldValues, Path<TFieldValues>>;
+    defaultValue?: RHFDateValue;
+    shouldUnregister?: boolean;
+} & Omit<PersianDatePickerProps, 'value' | 'onChange'>;
+/**
+ * RHF adapter hook for `PersianDatePicker`.
+ *
+ * Assumes field value is `Date | null`.
+ */
+export declare function usePersianDatePickerController<TFieldValues extends FieldValues>(params: UsePersianDatePickerControllerParams<TFieldValues>): {
+    field: import("react-hook-form").ControllerRenderProps<TFieldValues, Path<TFieldValues>>;
+    fieldState: import("react-hook-form").ControllerFieldState;
+    formState: import("react-hook-form").UseFormStateReturn<TFieldValues>;
+    pickerProps: {
+        value: RHFDateValue;
+        onChange: (date: RHFDateValue) => void;
+        disabled: boolean | undefined;
+        minDate?: Date | undefined;
+        maxDate?: Date | undefined;
+        placeholder?: string | undefined;
+        open?: boolean | undefined;
+        onOpenChange?: ((open: boolean) => void) | undefined;
+        mode?: "popover" | "inline" | undefined;
+        formatValue?: ((date: Date) => string) | undefined;
+        parseValue?: ((text: string) => Date | null) | undefined;
+        weekdays?: string[] | undefined;
+        monthLabels?: string[] | undefined;
+        renderMonthLabel?: ((jy: number, jm: number) => React.ReactNode) | undefined;
+        className?: string | undefined;
+        classes?: import(".").PersianDatePickerClasses | undefined;
+    };
+};
+export type RHF_PersianDatePickerProps<TFieldValues extends FieldValues> = UsePersianDatePickerControllerParams<TFieldValues>;
+/**
+ * RHF adapter component for `PersianDatePicker`.
+ *
+ * Assumes field value is `Date | null`.
+ */
+export declare function RHF_PersianDatePicker<TFieldValues extends FieldValues>(props: RHF_PersianDatePickerProps<TFieldValues>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=react-hook-form.d.ts.map

package/dist/react-hook-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-hook-form.d.ts","sourceRoot":"","sources":["../src/react-hook-form.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElF,OAAO,EAAqB,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAE/F,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAA;AAEtC,MAAM,MAAM,oCAAoC,CAAC,YAAY,SAAS,WAAW,IAAI;IACnF,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IACxB,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;IACzD,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,GAAG,IAAI,CAAC,sBAAsB,EAAE,OAAO,GAAG,UAAU,CAAC,CAAA;AAEtD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,SAAS,WAAW,EAC7E,MAAM,EAAE,oCAAoC,CAAC,YAAY,CAAC;;;;;;yBAgBjD,YAAY;;;;;;;;;;;;;;;;EAiBtB;AAED,MAAM,MAAM,0BAA0B,CAAC,YAAY,SAAS,WAAW,IAAI,oCAAoC,CAAC,YAAY,CAAC,CAAA;AAE7H;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,SAAS,WAAW,EAAE,KAAK,EAAE,0BAA0B,CAAC,YAAY,CAAC,2CAGtH"}

package/dist/react-hook-form.mjs

@@ -0,0 +1,38 @@
+import { jsx as P } from "react/jsx-runtime";
+import * as d from "react";
+import { useController as k } from "react-hook-form";
+import { P as C } from "./PersianDatePicker-BicyzfQH.js";
+function g(r) {
+  const { name: o, control: n, rules: a, defaultValue: l, shouldUnregister: s, disabled: t, ...i } = r, { field: e, fieldState: u, formState: c } = k({
+    name: o,
+    control: n,
+    rules: a,
+    defaultValue: l ?? null,
+    shouldUnregister: s,
+    disabled: t
+  }), f = e.value ?? null, p = d.useCallback(
+    (m) => {
+      e.onChange(m);
+    },
+    [e]
+  );
+  return {
+    field: e,
+    fieldState: u,
+    formState: c,
+    pickerProps: {
+      ...i,
+      value: f,
+      onChange: p,
+      disabled: t
+    }
+  };
+}
+function v(r) {
+  const { pickerProps: o } = g(r);
+  return /* @__PURE__ */ P(C, { ...o });
+}
+export {
+  v as RHF_PersianDatePicker,
+  g as usePersianDatePickerController
+};

package/dist/styles.css

@@ -0,0 +1,234 @@
+:root {
+  --dvx-pdp-bg: #ffffff;
+  --dvx-pdp-fg: #111827;
+  --dvx-pdp-muted: #6b7280;
+  --dvx-pdp-border: #e5e7eb;
+  --dvx-pdp-shadow: 0 10px 20px rgba(0, 0, 0, 0.08);
+  --dvx-pdp-accent: #2563eb;
+  --dvx-pdp-accentFg: #ffffff;
+  --dvx-pdp-ring: rgba(37, 99, 235, 0.3);
+  --dvx-pdp-dayHover: rgba(37, 99, 235, 0.08);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --dvx-pdp-bg: #0b1220;
+    --dvx-pdp-fg: #e5e7eb;
+    --dvx-pdp-muted: #9ca3af;
+    --dvx-pdp-border: #243045;
+    --dvx-pdp-shadow: 0 10px 20px rgba(0, 0, 0, 0.35);
+    --dvx-pdp-accent: #60a5fa;
+    --dvx-pdp-accentFg: #0b1220;
+    --dvx-pdp-ring: rgba(96, 165, 250, 0.35);
+    --dvx-pdp-dayHover: rgba(96, 165, 250, 0.12);
+  }
+}
+
+.dvx-pdp {
+  position: relative;
+  display: inline-block;
+  direction: rtl;
+  color: var(--dvx-pdp-fg);
+  font: inherit;
+}
+
+.dvx-pdp--inline {
+  display: block;
+}
+
+.dvx-pdp__control {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+
+.dvx-pdp__input {
+  width: 160px;
+  padding: 8px 10px;
+  border-radius: 10px;
+  border: 1px solid var(--dvx-pdp-border);
+  background: var(--dvx-pdp-bg);
+  color: var(--dvx-pdp-fg);
+  outline: none;
+}
+
+.dvx-pdp__input:focus {
+  box-shadow: 0 0 0 4px var(--dvx-pdp-ring);
+  border-color: var(--dvx-pdp-accent);
+}
+
+.dvx-pdp__button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 36px;
+  height: 36px;
+  border-radius: 10px;
+  border: 1px solid var(--dvx-pdp-border);
+  background: var(--dvx-pdp-bg);
+  color: var(--dvx-pdp-fg);
+  cursor: pointer;
+}
+
+.dvx-pdp__button:disabled,
+.dvx-pdp__input:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+}
+
+.dvx-pdp__popover {
+  position: absolute;
+  top: calc(100% + 8px);
+  right: 0;
+  z-index: 50;
+}
+
+.dvx-pdp__calendar {
+  width: 280px;
+  border-radius: 14px;
+  border: 1px solid var(--dvx-pdp-border);
+  background: var(--dvx-pdp-bg);
+  box-shadow: var(--dvx-pdp-shadow);
+  padding: 10px;
+  outline: none;
+}
+
+.dvx-pdp__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 10px;
+  margin-bottom: 10px;
+}
+
+.dvx-pdp__monthLabel {
+  font-weight: 600;
+  font-size: 14px;
+  border: 1px solid transparent;
+  background: transparent;
+  color: var(--dvx-pdp-fg);
+  padding: 6px 10px;
+  border-radius: 10px;
+  cursor: pointer;
+}
+
+.dvx-pdp__nav {
+  width: 34px;
+  height: 34px;
+  border-radius: 10px;
+  border: 1px solid var(--dvx-pdp-border);
+  background: var(--dvx-pdp-bg);
+  color: var(--dvx-pdp-fg);
+  cursor: pointer;
+}
+
+.dvx-pdp__grid {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.dvx-pdp__weekdays {
+  display: grid;
+  grid-template-columns: repeat(7, 1fr);
+  gap: 6px;
+}
+
+.dvx-pdp__weekday {
+  text-align: center;
+  font-size: 12px;
+  color: var(--dvx-pdp-muted);
+  user-select: none;
+}
+
+.dvx-pdp__days {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.dvx-pdp__row {
+  display: grid;
+  grid-template-columns: repeat(7, 1fr);
+  gap: 6px;
+}
+
+.dvx-pdp__day {
+  height: 34px;
+  border-radius: 10px;
+  border: 1px solid transparent;
+  background: transparent;
+  color: var(--dvx-pdp-fg);
+  cursor: pointer;
+}
+
+.dvx-pdp__day:hover {
+  background: var(--dvx-pdp-dayHover);
+}
+
+.dvx-pdp__day--outside {
+  color: var(--dvx-pdp-muted);
+}
+
+.dvx-pdp__day--today {
+  border-color: var(--dvx-pdp-border);
+}
+
+.dvx-pdp__day--selected {
+  background: var(--dvx-pdp-accent);
+  color: var(--dvx-pdp-accentFg);
+}
+
+.dvx-pdp__day--inRange {
+  background: var(--dvx-pdp-dayHover);
+}
+
+.dvx-pdp__day--rangeStart,
+.dvx-pdp__day--rangeEnd {
+  background: var(--dvx-pdp-accent);
+  color: var(--dvx-pdp-accentFg);
+}
+
+.dvx-pdp__day--disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.dvx-pdp__day--focused {
+  box-shadow: 0 0 0 4px var(--dvx-pdp-ring);
+}
+
+.dvx-pdp__panel {
+  padding: 2px 0 0;
+}
+
+.dvx-pdp__panelGrid {
+  display: grid;
+  grid-template-columns: repeat(3, 1fr);
+  gap: 8px;
+}
+
+.dvx-pdp__cell {
+  height: 38px;
+  border-radius: 12px;
+  border: 1px solid var(--dvx-pdp-border);
+  background: var(--dvx-pdp-bg);
+  color: var(--dvx-pdp-fg);
+  cursor: pointer;
+}
+
+.dvx-pdp__cell:hover {
+  background: var(--dvx-pdp-dayHover);
+}
+
+.dvx-pdp__cell:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+
+.dvx-pdp__cell--active {
+  border-color: var(--dvx-pdp-accent);
+  box-shadow: 0 0 0 4px var(--dvx-pdp-ring);
+}
+
+

package/dist/utils/calendarGrid.d.ts

@@ -0,0 +1,23 @@
+import { type JalaliParts } from '../adapters/dayjsAdapter';
+export declare function compareDays(a: Date, b: Date): number;
+export declare function isSameDay(a: Date, b: Date): boolean;
+export declare function addDays(date: Date, deltaDays: number): Date;
+export declare function isWithinRange(date: Date, minDate?: Date, maxDate?: Date): boolean;
+export declare function clampToRange(date: Date, minDate?: Date, maxDate?: Date): Date;
+export type CalendarDayCell = {
+    gregorian: Date;
+    jalali: JalaliParts;
+    inCurrentMonth: boolean;
+};
+export type BuildJalaliMonthGridOptions = {
+    jy: number;
+    jm: number;
+    /**
+     * 0=Sunday ... 6=Saturday. Defaults to 6 (Saturday), common in Iran.
+     */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+};
+export declare function getJalaliMonthLength(jy: number, jm: number): number;
+export declare function addJalaliMonths(date: Date, deltaMonths: number): Date;
+export declare function buildJalaliMonthGrid(opts: BuildJalaliMonthGridOptions): CalendarDayCell[][];
+//# sourceMappingURL=calendarGrid.d.ts.map

package/dist/utils/calendarGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendarGrid.d.ts","sourceRoot":"","sources":["../../src/utils/calendarGrid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAQ3F,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAIpD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAEnD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,CAIjF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAI7E;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,IAAI,CAAA;IACf,MAAM,EAAE,WAAW,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CACzC,CAAA;AAaD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAMrE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,2BAA2B,GAAG,eAAe,EAAE,EAAE,CAyB3F"}

package/dist/utils/toGregorian.d.ts

@@ -0,0 +1,10 @@
+import { type JalaliParts } from '../adapters/dayjsAdapter';
+export type ParseJalaliTextOptions = {
+    /**
+     * Accept `YYYY/MM/DD` or `YYYY-MM-DD` (any non-digit separator).
+     */
+    allowLooseSeparators?: boolean;
+};
+export declare function toGregorian(parts: JalaliParts): Date;
+export declare function parseJalaliText(text: string, opts?: ParseJalaliTextOptions): Date | null;
+//# sourceMappingURL=toGregorian.d.ts.map

package/dist/utils/toGregorian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toGregorian.d.ts","sourceRoot":"","sources":["../../src/utils/toGregorian.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE5E,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAA;AAMD,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAEpD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,IAAI,GAAG,IAAI,CAiB5F"}

package/dist/utils/toJalali.d.ts

@@ -0,0 +1,6 @@
+import { type JalaliParts } from '../adapters/dayjsAdapter';
+export type ToJalaliResult = JalaliParts & {
+    formatted: string;
+};
+export declare function toJalali(gregorian: Date): ToJalaliResult;
+//# sourceMappingURL=toJalali.d.ts.map

package/dist/utils/toJalali.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toJalali.d.ts","sourceRoot":"","sources":["../../src/utils/toJalali.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAExF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhE,wBAAgB,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,cAAc,CAGxD"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "persian-date-kit",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./react-hook-form": {
+      "types": "./dist/react-hook-form.d.ts",
+      "import": "./dist/react-hook-form.mjs",
+      "require": "./dist/react-hook-form.cjs"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc -p tsconfig.build.json && node scripts/copyStyles.mjs",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "dayjs": "^1.11.13",
+    "jalaliday": "^3.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18",
+    "react-hook-form": ">=7"
+  },
+  "peerDependenciesMeta": {
+    "react-hook-form": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react-swc": "^4.2.2",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-hook-form": "^7.62.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4"
+  }
+}