@commercelayer/app-elements 0.0.21 → 0.0.23

package/dist/{Select-5f2d8bcf.js → Select-d21cd3a7.js}

@@ -1,8 +1,8 @@
 import * as r from "react";
 import a, { forwardRef as s } from "react";
-import { u as m, S as c, d as p, s as i } from "./overrides-a8601925.js";
+import { u as m, S as c, d as p, s as i } from "./overrides-7ddc4b65.js";
 import "react-dom";
-import "./main-efbde4bf.js";
+import "./main-017487f0.js";
 import "@commercelayer/sdk";
 var l = /* @__PURE__ */ s(function(e, t) {
   var o = m(e);

package/dist/helpers/date.d.ts

@@ -1,5 +1,5 @@
-type Format = 'full' | 'noTime' | 'noYear';
-type FormatDateOptions = {
+type Format = 'date' | 'time' | 'timeWithSeconds' | 'full' | 'fullWithSeconds' | 'distanceToNow';
+interface FormatDateOptions {
     /**
      * JavaScript ISO date string. Example '2022-10-06T11:59:30.371Z'
      */
@@ -8,32 +8,57 @@ type FormatDateOptions = {
      * Set a specific timezone, when not passed default value is 'UTC'
      */
     timezone?: string;
-} & ({
     /**
      * How to format the date:
-     * - full `Feb 28, 2023 · 5:30 PM`
-     * - noTime `Feb 28, 2023`
-     * - noYear `Feb 28`
-     * @default noTime
+     * - `date` – can be `Today` when today, `Feb 28` when current year or `Feb 28, 2022` when previous year
+     * - `time` – `04:34` `18:54`
+     * - `timeWithSeconds` – `04:34:23` `18:54:12`
+     * - `full` – `Feb 28, 2023 · 15:30` the date in this string behaves like the `date` format
+     * - `fullWithSeconds` – `Feb 28, 2023 · 15:30:43` the date in this string behaves like the `date` format
+     * - `distanceToNow` – `about 1 hour ago` `10 months ago` `less than a minute ago`
+     * @default date
      */
     format?: Format;
-} | {
-    /**
-     * When set as `custom` a `customTemplate` is required
-     */
-    format: 'custom';
-    /**
-     * Custom template to override the default one ('LLL dd, yyyy').
-     * @link https://date-fns.org/v2.29.3/docs/format
-     */
-    customTemplate: string;
-});
+}
 /**
  * Format the date as nice string also specifying a custom timezone
  * @param opts a set of `FormatDateOptions`
  * @returns a nice string representation. Example: 'Jul 21, 2022' or 'Jul 21, 2022 · 1:16 PM' if includeTime
  */
 export declare function formatDate({ isoDate, timezone, ...opts }: FormatDateOptions): string;
-export declare function isCurrentYear(isoDate: string): boolean;
-export declare function isToday(isoDate: string): boolean;
+export declare const timeSeparator = "\u00B7";
+type DateISOString = string;
+/**
+ * Calculate the time-zoned start or end of the day from an ISO date string.
+ * Useful when getting date from a date range picker.
+ * @param isoString a JavaScript ISO date string. Example '2022-10-06T11:59:30.371Z'
+ * @param edge 'startOfTheDay' or 'endOfTheDay'
+ * @param timezone Set a specific timezone, when not passed default value is 'UTC'
+ * @returns a JavaScript ISO date string that reflect the start or end of the day
+ * based on the user timezone. Example '2022-10-06T22:00:00.000Z' when timezone is 'Europe/Rome'
+ */
+export declare function getIsoDateAtDayEdge({ isoString, edge, timezone }: {
+    isoString: DateISOString;
+    edge: 'startOfTheDay' | 'endOfTheDay';
+    timezone?: string;
+}): string | undefined;
+/**
+ * Subtract n days from an ISO date string
+ * to always return the correspondent time-zoned start of the day
+ *
+ * Example: if date-now is the 8th of March at 16:00 Italian time
+ * and I want to get the date at -7, the result will be
+ * '2022-03-01T23:00:00.000Z' as UTC string since my timezone is 'Europe/Rome'
+ * and on the 8th of March I was at +1 from UTC
+ *
+ * @param isoString JavaScript ISO date (eg: '2022-03-01T23:00:00.000Z')
+ * @param days positive number of days to subtract
+ * @param timezone (optional) in case of working with a specific timezone different from UTC
+ * @returns a new iso string
+ */
+export declare function getIsoDateAtDaysBefore({ isoString, days, timezone }: {
+    isoString: DateISOString;
+    days: number;
+    timezone?: string;
+}): string | undefined;
 export {};

package/dist/hooks/useIsChanged.d.ts

@@ -0,0 +1,11 @@
+/**
+ * This hook is used to detect when a value has changed during new rendering.
+ * It is useful to trigger an action when a value has changed.
+ * @param value - the value to watch
+ * @param onChange - the action to trigger when the value has changed
+ * @returns - a boolean that is true when the value has changed
+ */
+export declare function useIsChanged<T>({ value, onChange }: {
+    value: T;
+    onChange?: () => void;
+}): boolean;