persian-date-kit 0.0.3 → 0.0.4

package/dist/react-hook-form.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k=require("react/jsx-runtime"),b=require("react"),g=require("react-hook-form"),m=require("./PersianDatePicker-CCakBpBo.cjs");function D(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:()=>e[r]})}}return t.default=e,Object.freeze(t)}const j=D(b);function c(e){const{name:t,control:r,rules:n,defaultValue:i,shouldUnregister:s,disabled:a,...l}=e,{field:o,fieldState:u,formState:P}=g.useController({name:t,control:r,rules:n,defaultValue:i??null,shouldUnregister:s,disabled:a}),f=o.value??null,d=j.useCallback(p=>{o.onChange(p)},[o]);return{field:o,fieldState:u,formState:P,pickerProps:{...l,value:f,onChange:d,disabled:a}}}function C(e){const{pickerProps:t}=c(e);return k.jsx(m.PersianDatePicker,{...t})}exports.RHF_PersianDatePicker=C;exports.usePersianDatePickerController=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k=require("react/jsx-runtime"),b=require("react"),g=require("react-hook-form"),m=require("./PersianDatePicker-Bcz6VNVe.cjs");function D(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:()=>e[r]})}}return t.default=e,Object.freeze(t)}const j=D(b);function c(e){const{name:t,control:r,rules:n,defaultValue:i,shouldUnregister:s,disabled:a,...l}=e,{field:o,fieldState:u,formState:P}=g.useController({name:t,control:r,rules:n,defaultValue:i??null,shouldUnregister:s,disabled:a}),f=o.value??null,d=j.useCallback(p=>{o.onChange(p)},[o]);return{field:o,fieldState:u,formState:P,pickerProps:{...l,value:f,onChange:d,disabled:a}}}function C(e){const{pickerProps:t}=c(e);return k.jsx(m.PersianDatePicker,{...t})}exports.RHF_PersianDatePicker=C;exports.usePersianDatePickerController=c;

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

@@ -22,10 +22,11 @@ export declare function usePersianDatePickerController<TFieldValues extends Fiel
         value: RHFDateValue;
         onChange: (date: RHFDateValue) => void;
         disabled: boolean | undefined;
+        open?: boolean | undefined;
+        popover?: import(".").PopoverConfig | 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;
@@ -33,6 +34,8 @@ export declare function usePersianDatePickerController<TFieldValues extends Fiel
         weekdays?: string[] | undefined;
         monthLabels?: string[] | undefined;
         renderMonthLabel?: ((jy: number, jm: number) => React.ReactNode) | undefined;
+        prevIcon?: React.ReactNode;
+        nextIcon?: React.ReactNode;
         className?: string | undefined;
         classes?: import(".").PersianDatePickerClasses | undefined;
     };

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

@@ -1 +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"}
+{"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

@@ -1,7 +1,7 @@
 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";
+import { P as C } from "./PersianDatePicker-DFMNtlIF.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,

package/dist/styles.css

@@ -83,6 +83,11 @@
   z-index: 50;
 }
 
+.dvx-pdp__popover--portal {
+  position: fixed;
+  z-index: 9999;
+}
+
 .dvx-pdp__calendar {
   width: 280px;
   border-radius: 14px;

package/dist/types/shared.d.ts

@@ -0,0 +1,120 @@
+import type * as React from 'react';
+/**
+ * Popover positioning options.
+ */
+export type PopoverConfig = {
+    /**
+     * Render popover in a portal (default: `true`).
+     * Portals help with z-index and overflow issues, but may cause issues in SSR.
+     */
+    portal?: boolean;
+    /**
+     * Gap between anchor and popover (default: `8`).
+     */
+    gutter?: number;
+    /**
+     * Minimum padding from viewport edges (default: `8`).
+     */
+    padding?: number;
+    /**
+     * Positioning strategy: `fixed` (default) or `absolute`.
+     */
+    strategy?: 'fixed' | 'absolute';
+    /**
+     * Preferred placements in order (default: `['bottom', 'top', 'left', 'right']`).
+     */
+    placements?: Array<'bottom' | 'top' | 'left' | 'right'>;
+    /**
+     * Alignment on the cross axis (default: `'end'`).
+     */
+    align?: 'start' | 'center' | 'end';
+};
+/**
+ * Common props shared between date picker components.
+ */
+export type BasePickerProps = {
+    /**
+     * Minimum selectable date (Gregorian).
+     */
+    minDate?: Date;
+    /**
+     * Maximum selectable date (Gregorian).
+     */
+    maxDate?: Date;
+    /**
+     * Disable the picker.
+     */
+    disabled?: boolean;
+    /**
+     * Control the open state of the calendar popover (popover mode only).
+     * If provided, the component becomes controlled for open/close.
+     */
+    open?: boolean;
+    /**
+     * Callback when open state changes (popover mode only).
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Rendering mode:
+     * - `popover`: default input + popover calendar
+     * - `inline`: always-visible calendar, no input
+     */
+    mode?: 'popover' | 'inline';
+    /**
+     * Popover positioning options (popover mode only).
+     */
+    popover?: PopoverConfig;
+    /**
+     * Formats a Date for display in inputs.
+     * Default: numeric Jalali `YYYY/MM/DD` (no locale month/day names).
+     */
+    formatValue?: (date: Date) => string;
+    /**
+     * Parses user text into a Gregorian Date.
+     * Default: parses numeric Jalali `YYYY/MM/DD` (also accepts loose separators).
+     */
+    parseValue?: (text: string) => Date | null;
+    /**
+     * Weekday headers. If omitted, numeric headers are used.
+     * Provide 7 items matching the calendar grid order.
+     */
+    weekdays?: string[];
+    /**
+     * Month labels (index 0 => month 1). If omitted, month numbers are shown.
+     * Provide 12 items.
+     */
+    monthLabels?: string[];
+    /**
+     * Month label renderer (e.g. supply localized month name).
+     * Default: `jy / jm` numeric.
+     */
+    renderMonthLabel?: (jy: number, jm: number) => React.ReactNode;
+    /**
+     * Custom navigation icons for previous/next month (and year panel paging).
+     */
+    prevIcon?: React.ReactNode;
+    nextIcon?: React.ReactNode;
+    /**
+     * Additional CSS class for the root element.
+     */
+    className?: string;
+};
+/**
+ * Base classes structure for styling customization.
+ */
+export type BasePickerClasses = {
+    root?: string;
+    input?: string;
+    button?: string;
+    popover?: string;
+    header?: string;
+    navButton?: string;
+    monthLabel?: string;
+    grid?: string;
+    weekday?: string;
+    day?: string;
+    dayOutside?: string;
+    dayDisabled?: string;
+    dayToday?: string;
+};
+//# sourceMappingURL=shared.d.ts.map

package/dist/types/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/types/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC/B;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IACvD;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;CACnC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAA;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAA;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAA;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IAC1C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAA;IAC9D;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA"}

package/dist/utils/usePopoverPosition.d.ts

@@ -0,0 +1,29 @@
+import * as React from "react";
+export type PopoverPlacement = "bottom" | "top" | "left" | "right";
+export type PopoverAlign = "start" | "center" | "end";
+export type PopoverPositionOptions = {
+    gutter?: number;
+    padding?: number;
+    strategy?: "fixed" | "absolute";
+    /**
+     * Placement preference order. The first placement that fits is chosen; otherwise
+     * the placement with the most available space is used.
+     *
+     * Default: ['bottom', 'top', 'left', 'right']
+     */
+    placements?: PopoverPlacement[];
+    /**
+     * Cross-axis alignment:
+     * - For `top`/`bottom` this aligns horizontally (x-axis).
+     * - For `left`/`right` this aligns vertically (y-axis).
+     *
+     * Default: 'end' (RTL-friendly for top/bottom).
+     */
+    align?: PopoverAlign;
+};
+export declare function usePopoverPosition<TAnchor extends HTMLElement, TPopover extends HTMLElement>(open: boolean, anchorRef: React.RefObject<TAnchor | null>, popoverRef: React.RefObject<TPopover | null>, opts?: PopoverPositionOptions): {
+    style: React.CSSProperties;
+    placement: PopoverPlacement;
+    update: () => void;
+};
+//# sourceMappingURL=usePopoverPosition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverPosition.d.ts","sourceRoot":"","sources":["../../src/utils/usePopoverPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AACnE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAStD,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,CAAC;AASF,wBAAgB,kBAAkB,CAChC,OAAO,SAAS,WAAW,EAC3B,QAAQ,SAAS,WAAW,EAE5B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,EAC1C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,EAC5C,IAAI,GAAE,sBAA2B;;;;EAkIlC"}

package/package.json

@@ -1,7 +1,33 @@
 {
   "name": "persian-date-kit",
-  "version": "0.0.3",
+  "version": "0.0.4",
+  "description": "Production-ready Persian (Jalali) date pickers for React with Gregorian-only values.",
+  "keywords": [
+    "react",
+    "datepicker",
+    "date-picker",
+    "jalali",
+    "persian",
+    "shamsi",
+    "calendar",
+    "rtl",
+    "dayjs",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Darvix",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/darvix/persian-date-kit.git"
+  },
+  "homepage": "https://github.com/darvix/persian-date-kit#readme",
+  "bugs": {
+    "url": "https://github.com/darvix/persian-date-kit/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -19,7 +45,9 @@
     "./styles.css": "./dist/styles.css"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "sideEffects": [
     "**/*.css"
@@ -46,6 +74,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",
+    "@fontsource/vazirmatn": "^5.2.8",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.5",
     "@types/react-dom": "^19.2.3",