react-timezone-range-picker 0.1.6 → 0.2.0

package/README.md

@@ -25,12 +25,47 @@
 
 The picker opens in basic mode on every mount. It provides a compact date-only range field and day-based quick options. Date and quick-option selections are applied immediately without an Apply button, and both returned times are set to `00:00:00`.
 
-Select **Advanced** to switch modes for the lifetime of the mounted component. Reloading the page or remounting the picker resets it to basic mode.
+Select **Advanced** to open the full picker. In Advanced mode, use the **Basic** button on the left side of the footer to return to Basic mode.
 
 ### Advanced mode
 
 Advanced mode provides the full picker with separate start/end date and time fields, relative time options, around-time selection, and timezone selection. Changes to its form-based panels are submitted with the Apply button.
 
+### Restricting past or future ranges
+
+Set `options.allowedTimeRange` to `"past"`, `"future"`, or `"all"` (the default). This filters quick options, limits date pickers, and validates date/time input against the current time in the selected timezone.
+
+```tsx
+<TimezoneRangePicker
+  {...range}
+  onApply={handleTimeRangeApply}
+  options={{
+    allowedTimeRange: "future",
+    // Adds today as a whole calendar day to Last/Next day ranges
+    includeTodayInQuickRanges: true,
+  }}
+/>
+```
+
+`Today`, `Yesterday`, and `Tomorrow` use complete calendar-day boundaries (for example, Today 00:00 through Tomorrow 00:00). By default, `Last 2 days` and `Next 2 days` select two complete days before or after today. Set `includeTodayInQuickRanges` to `true` to add the complete current day to those ranges.
+
+### Limiting the range length
+
+Set `options.maxRange` to the longest range users may select, as a duration such as `{ months: 1 }`, `{ days: 30 }`, `{ weeks: 2 }` or `{ hours: 36 }`. The limit is measured from the start on the calendar, so `{ months: 1 }` allows Jan 15 → Feb 15.
+
+- Quick options longer than the limit are hidden.
+- In basic mode, once a start date is picked, days beyond the limit are disabled.
+- Start and end times longer than the limit fail validation ("Range must not exceed 1 month").
+- Around-a-time durations whose window exceeds the limit are not offered.
+
+```tsx
+<TimezoneRangePicker
+  {...range}
+  onApply={handleTimeRangeApply}
+  options={{ maxRange: { months: 1 } }}
+/>
+```
+
 ---
 
 ## 📦 Installation
@@ -116,3 +151,16 @@ function App() {
   );
 }
 ```
+
+---
+
+## Releasing
+
+Releases are published by the [Release workflow](https://github.com/GermaVinsmoke/react-timezone-range-picker/blob/main/.github/workflows/release.yml) when a new version reaches `main`:
+
+1. Bump `version` in `packages/ui/package.json` in your pull request.
+2. Merge it to `main`.
+
+The workflow skips versions npm already has. For a new one it runs the tests, publishes the package to npm with provenance, then tags the commit `v<version>` and creates a GitHub Release with generated notes. If a run fails after publishing, re-running it only creates the missing tag and release.
+
+npm authenticates the workflow through [trusted publishing](https://docs.npmjs.com/trusted-publishers), so no npm token is stored in the repository.

package/dist/AroundTimePanel/index.d.ts

@@ -2,6 +2,7 @@ import { FC } from "react";
 import { TzRange } from "../interfaces";
 interface IAroundTimePanel {
     tzRange: TzRange;
+    onBasic: () => void;
 }
 declare const AroundTimePanel: FC<IAroundTimePanel>;
 export { AroundTimePanel };

package/dist/AroundTimePanel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/AroundTimePanel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAM3B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOxC,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,QAAA,MAAM,eAAe,EAAE,EAAE,CAAC,gBAAgB,CAoGzC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/AroundTimePanel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAe3B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOxC,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,QAAA,MAAM,eAAe,EAAE,EAAE,CAAC,gBAAgB,CAiJzC,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/AroundTimePanel/util.d.ts

@@ -1,3 +1,4 @@
+import { RangeDuration } from "../interfaces";
 export declare enum TimeOption {
     ThirtySeconds = "\u00B1 30 seconds",
     OneMinute = "\u00B1 1 minute",
@@ -13,4 +14,5 @@ export declare const getStartEndDateTime: (date: string | null, time: string, ti
     endDate: string | null;
     endTime: string;
 };
+export declare const getAllowedTimeOptions: (maxRange?: RangeDuration) => TimeOption[];
 //# sourceMappingURL=util.d.ts.map

package/dist/AroundTimePanel/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/AroundTimePanel/util.ts"],"names":[],"mappings":"AAEA,oBAAY,UAAU;IACpB,aAAa,sBAAiB;IAC9B,SAAS,oBAAe;IACxB,cAAc,sBAAiB;IAC/B,aAAa,sBAAiB;IAC9B,OAAO,kBAAa;IACpB,MAAM,iBAAY;CACnB;AAED,eAAO,MAAM,YAAY,cAOxB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,MAAM,EAAE,YAAY,UAAU;;;;;CAgE5F,CAAC"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/AroundTimePanel/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,oBAAY,UAAU;IACpB,aAAa,sBAAiB;IAC9B,SAAS,oBAAe;IACxB,cAAc,sBAAiB;IAC/B,aAAa,sBAAiB;IAC9B,OAAO,kBAAa;IACpB,MAAM,iBAAY;CACnB;AAED,eAAO,MAAM,YAAY,cAOxB,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,MAAM,EAAE,YAAY,UAAU;;;;;CAgE5F,CAAC;AAIF,eAAO,MAAM,qBAAqB,GAAI,WAAW,aAAa,iBAQ1D,CAAC"}

package/dist/Footer/index.d.ts

@@ -1,2 +1,6 @@
-export declare const Footer: () => import("react").JSX.Element;
+interface FooterProps {
+    onBasic: () => void;
+}
+export declare const Footer: ({ onBasic }: FooterProps) => import("react").JSX.Element;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/Footer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Footer/index.tsx"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM,mCA4BlB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Footer/index.tsx"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,MAAM,GAAI,aAAa,WAAW,gCAqC9C,CAAC"}

package/dist/RelativeTimePanel/timeOptions.d.ts

@@ -6,6 +6,7 @@ export interface ITimeOptions {
     startTime: string;
     endTime: string;
     unit: QuickRangeUnit;
+    direction: "past" | "future" | "present";
     lineBreak?: boolean;
 }
 export declare const getTimeOptions: (timezoneName: string, options?: TimezoneRangePickerOptions) => ITimeOptions[];

package/dist/RelativeTimePanel/timeOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeOptions.d.ts","sourceRoot":"","sources":["../../src/RelativeTimePanel/timeOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAG3D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAoED,eAAO,MAAM,cAAc,GACzB,cAAc,MAAM,EACpB,UAAU,0BAA0B,KACnC,YAAY,EASd,CAAC"}
+{"version":3,"file":"timeOptions.d.ts","sourceRoot":"","sources":["../../src/RelativeTimePanel/timeOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAG3D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAyGD,eAAO,MAAM,cAAc,GACzB,cAAc,MAAM,EACpB,UAAU,0BAA0B,KACnC,YAAY,EAyBd,CAAC"}

package/dist/StartEndTimePanel/index.d.ts

@@ -2,6 +2,7 @@ import { FC } from "react";
 import { TzRange } from "../interfaces";
 interface IStartEndTimePanel {
     tzRange: TzRange;
+    onBasic: () => void;
 }
 declare const StartEndTimePanel: FC<IStartEndTimePanel>;
 export { StartEndTimePanel };

package/dist/StartEndTimePanel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/StartEndTimePanel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAc3B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOxC,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,QAAA,MAAM,iBAAiB,EAAE,EAAE,CAAC,kBAAkB,CAuI7C,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/StartEndTimePanel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAkB3B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAOxC,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,QAAA,MAAM,iBAAiB,EAAE,EAAE,CAAC,kBAAkB,CA+K7C,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/TimezonePanel/index.d.ts

@@ -2,6 +2,7 @@ import { FC } from "react";
 import { TzRange } from "../interfaces";
 interface ITimezonePanel {
     tzRange: TzRange;
+    onBasic: () => void;
 }
 declare const TimezonePanel: FC<ITimezonePanel>;
 export { TimezonePanel };

package/dist/TimezonePanel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/TimezonePanel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAA2C,MAAM,OAAO,CAAC;AASpE,OAAO,EAAgB,OAAO,EAAE,MAAM,eAAe,CAAC;AAatD,UAAU,cAAc;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,QAAA,MAAM,aAAa,EAAE,EAAE,CAAC,cAAc,CA0HrC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/TimezonePanel/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAA2C,MAAM,OAAO,CAAC;AASpE,OAAO,EAAgB,OAAO,EAAE,MAAM,eAAe,CAAC;AAatD,UAAU,cAAc;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,QAAA,MAAM,aAAa,EAAE,EAAE,CAAC,cAAc,CA0HrC,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/TimezoneRangePicker/AdvancedPickerView.d.ts

@@ -2,6 +2,7 @@ import { FC } from "react";
 import { TzRange } from "../interfaces";
 interface AdvancedPickerViewProps {
     tzRange: TzRange;
+    onBasic: () => void;
 }
 export declare const AdvancedPickerView: FC<AdvancedPickerViewProps>;
 export {};

package/dist/TimezoneRangePicker/AdvancedPickerView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdvancedPickerView.d.ts","sourceRoot":"","sources":["../../src/TimezoneRangePicker/AdvancedPickerView.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAuB,MAAM,OAAO,CAAC;AAKhD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,UAAU,uBAAuB;IAC/B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,kBAAkB,EAAE,EAAE,CAAC,uBAAuB,CAoD1D,CAAC"}
+{"version":3,"file":"AdvancedPickerView.d.ts","sourceRoot":"","sources":["../../src/TimezoneRangePicker/AdvancedPickerView.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAuB,MAAM,OAAO,CAAC;AAKhD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,UAAU,uBAAuB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,EAAE,EAAE,CAAC,uBAAuB,CAoD1D,CAAC"}

package/dist/TimezoneRangePicker/BasicPickerView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BasicPickerView.d.ts","sourceRoot":"","sources":["../../src/TimezoneRangePicker/BasicPickerView.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,EAAE,EAAgC,MAAM,OAAO,CAAC;AAKzD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,UAAU,oBAAoB;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAOD,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,oBAAoB,CA+FpD,CAAC"}
+{"version":3,"file":"BasicPickerView.d.ts","sourceRoot":"","sources":["../../src/TimezoneRangePicker/BasicPickerView.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,EAAE,EAAgC,MAAM,OAAO,CAAC;AAKzD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,UAAU,oBAAoB;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAOD,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,oBAAoB,CAoHpD,CAAC"}