@epam/ai-dial-ui-kit 0.15.0-dev.3 → 0.15.0-dev.4

package/dist/components/New/Calendar/Calendar.js

@@ -1,232 +1,244 @@
-import { jsx as t, jsxs as o, Fragment as O } from "react/jsx-runtime";
-import { useFloating as ne, autoUpdate as re, offset as se, flip as ie, shift as oe, useClick as ce, useDismiss as de, useRole as me, useInteractions as fe, FloatingPortal as pe, FloatingFocusManager as ue } from "@floating-ui/react";
-import { IconChevronDown as he } from "@tabler/icons-react";
-import { useId as ge, useState as E, useMemo as S, useEffect as be } from "react";
-import { Label as xe } from "../Label/Label.js";
-import { StaticIconButton as $ } from "../IconButton/IconButtonWrappers.js";
-import { DIAL_KIT_ICON_STROKE as ye } from "../constants/icon.js";
-import { DIAL_ICON_SIZE as ve } from "../../../constants/icon.js";
-import { CalendarMode as v } from "../../../types/calendar.js";
-import { ElementSize as j } from "../../../types/size.js";
-import { useThemeScope as De } from "../ThemeScope/ThemeScope.js";
-import { mergeClasses as c } from "../../../utils/merge-classes.js";
-import { DEFAULT_CALENDAR_LOCALE as Ne, calendarModeDefaultPlaceholder as Ce, calendarFieldIconClassName as Ie, calendarNavIcons as V, calendarDaySelectedClassName as Le, calendarDayTodayClassName as Te, calendarDayOutsideClassName as Fe, calendarDayButtonBaseClassName as Se, calendarIcon as Me, calendarFieldDisabledClassName as Z, calendarFieldInvalidClassName as q, calendarFieldBaseClassName as H, calendarPopoverClassName as Oe } from "./constants.js";
-import { getWeekdayShortLabels as we, getWeekdayOptions as ke, getMonthGrid as Be, formatTimeLabel as M, formatMonthLabel as Ee, isSameDay as P, isDateOutOfRange as W, formatDayAriaLabel as Ae, sanitizeTimeInput as _e, isCompleteTimeString as Re, setTimeOnDate as K, formatDateLabel as U } from "./utils.js";
-const Y = ({
+import { jsx as e, jsxs as c, Fragment as O } from "react/jsx-runtime";
+import { useFloating as se, autoUpdate as ie, offset as oe, flip as ce, shift as de, useClick as me, useDismiss as pe, useRole as ue, useInteractions as fe, FloatingPortal as he, FloatingFocusManager as ge } from "@floating-ui/react";
+import { IconChevronDown as be } from "@tabler/icons-react";
+import { useId as xe, useState as E, useMemo as F, useEffect as ye } from "react";
+import { Label as ve } from "../Label/Label.js";
+import { StaticIconButton as j } from "../IconButton/IconButtonWrappers.js";
+import { DIAL_KIT_ICON_STROKE as Ne } from "../constants/icon.js";
+import { DIAL_ICON_SIZE as De } from "../../../constants/icon.js";
+import { CalendarMode as N } from "../../../types/calendar.js";
+import { ElementSize as V } from "../../../types/size.js";
+import { useThemeScope as Ce } from "../ThemeScope/ThemeScope.js";
+import { mergeClasses as d } from "../../../utils/merge-classes.js";
+import { getTimezoneLabel as Ie } from "../../../utils/timezone.js";
+import { DEFAULT_CALENDAR_LOCALE as Le, calendarModeDefaultPlaceholder as Te, calendarFieldIconClassName as Fe, calendarNavIcons as P, calendarDaySelectedClassName as Se, calendarDayTodayClassName as Me, calendarDayOutsideClassName as Oe, calendarDayButtonBaseClassName as we, calendarIcon as ke, calendarFieldDisabledClassName as q, calendarFieldInvalidClassName as H, calendarFieldBaseClassName as J, calendarPopoverClassName as Be } from "./constants.js";
+import { getWeekdayShortLabels as Ee, getWeekdayOptions as Ae, getMonthGrid as _e, formatTimeLabel as M, formatMonthLabel as Re, isSameDay as W, isDateOutOfRange as K, formatDayAriaLabel as ze, sanitizeTimeInput as $e, isCompleteTimeString as je, setTimeOnDate as U, formatDateLabel as Y } from "./utils.js";
+const G = ({
   id: s,
-  disabled: l,
-  invalid: m,
+  disabled: a,
+  invalid: u,
   trigger: i,
-  panelClassName: N,
-  fieldClassName: h,
-  panel: g,
-  labelledBy: C,
-  panelLabel: b
+  panelClassName: C,
+  fieldClassName: x,
+  panel: y,
+  labelledBy: I,
+  panelLabel: f
 }) => {
-  const x = De(), [f, n] = E(!1), { refs: D, floatingStyles: p, context: a } = ne({
-    open: f,
-    onOpenChange: (F) => n(l ? !1 : F),
+  const D = Ce(), [m, l] = E(!1), { refs: h, floatingStyles: g, context: o } = se({
+    open: m,
+    onOpenChange: (L) => l(a ? !1 : L),
     placement: "bottom-start",
-    whileElementsMounted: re,
-    middleware: [se(8), ie({ padding: 8 }), oe({ padding: 8 })]
-  }), w = ce(a, { enabled: !l }), u = de(a), T = me(a, { role: "dialog" }), { getReferenceProps: k, getFloatingProps: I } = fe([
+    whileElementsMounted: ie,
+    middleware: [oe(8), ce({ padding: 8 }), de({ padding: 8 })]
+  }), n = me(o, { enabled: !a }), w = pe(o), b = ue(o, { role: "dialog" }), { getReferenceProps: S, getFloatingProps: k } = fe([
+    n,
     w,
-    u,
-    T
+    b
   ]);
-  return /* @__PURE__ */ o(O, { children: [
-    /* @__PURE__ */ t(
+  return /* @__PURE__ */ c(O, { children: [
+    /* @__PURE__ */ e(
       "div",
       {
         id: s,
-        ref: D.setReference,
+        ref: h.setReference,
         role: "button",
         "aria-haspopup": "dialog",
-        "aria-expanded": f,
-        "aria-disabled": l,
-        "aria-labelledby": C,
-        tabIndex: l ? -1 : 0,
-        className: c(
-          H,
+        "aria-expanded": m,
+        "aria-disabled": a,
+        "aria-labelledby": I,
+        tabIndex: a ? -1 : 0,
+        className: d(
+          J,
           "focus-visible:outline focus-visible:outline-focus",
-          m && q,
-          l && Z,
-          h
+          u && H,
+          a && q,
+          x
         ),
-        ...k(),
+        ...S(),
         children: i
       }
     ),
-    f && /* @__PURE__ */ t(pe, { children: /* @__PURE__ */ t(
-      ue,
+    m && /* @__PURE__ */ e(he, { children: /* @__PURE__ */ e(
+      ge,
       {
-        context: a,
+        context: o,
         modal: !1,
         initialFocus: -1,
         returnFocus: !0,
-        children: /* @__PURE__ */ t(
+        children: /* @__PURE__ */ e(
           "div",
           {
-            ref: D.setFloating,
-            style: p,
-            "aria-label": b,
-            className: c(
-              Oe,
-              x,
-              N
+            ref: h.setFloating,
+            style: g,
+            "aria-label": f,
+            className: d(
+              Be,
+              D,
+              C
             ),
-            ...I(),
-            children: g(() => n(!1))
+            ...k(),
+            children: y(() => l(!1))
           }
         )
       }
     ) })
   ] });
-}, G = ({
+}, Z = ({
   id: s,
-  value: l,
-  onChange: m,
+  value: a,
+  onChange: u,
   disabled: i,
-  invalid: N,
-  className: h,
-  ariaLabel: g,
-  placeholder: C = "--:--"
+  invalid: C,
+  className: x,
+  ariaLabel: y,
+  placeholder: I = "--:--",
+  timezoneLabel: f
 }) => {
-  const [b, x] = E(l);
-  return be(() => {
-    x(l);
-  }, [l]), /* @__PURE__ */ t(
+  const [D, m] = E(a);
+  ye(() => {
+    m(a);
+  }, [a]);
+  const l = /* @__PURE__ */ e(
     "input",
     {
       id: s,
       type: "text",
       inputMode: "numeric",
       autoComplete: "off",
-      "aria-label": g,
-      placeholder: C,
+      "aria-label": y,
+      placeholder: I,
       disabled: i,
-      value: b,
-      onChange: (f) => {
-        const n = _e(f.target.value);
-        x(n), Re(n) && m(n);
+      value: D,
+      onChange: (h) => {
+        const g = $e(h.target.value);
+        m(g), je(g) && u(g);
       },
-      className: c(
-        H,
-        N && q,
-        i && Z,
-        h
+      className: d(
+        J,
+        C && H,
+        i && q,
+        x
       )
     }
   );
-}, Qe = ({
-  mode: s = v.Date,
-  value: l,
-  onChange: m,
+  return f ? /* @__PURE__ */ c("div", { className: "relative w-full", children: [
+    l,
+    /* @__PURE__ */ e("span", { className: "dial-small-paragraph-text pointer-events-none absolute end-4 top-1/2 -translate-y-1/2 truncate text-secondary", children: f })
+  ] }) : l;
+}, at = ({
+  mode: s = N.Date,
+  value: a,
+  onChange: u,
   labelProps: i,
-  placeholder: N,
-  disabled: h = !1,
-  invalid: g = !1,
-  id: C,
-  className: b,
-  minDate: x,
-  maxDate: f,
-  locale: n = Ne,
-  fieldClassName: D
+  placeholder: C,
+  disabled: x = !1,
+  invalid: y = !1,
+  id: I,
+  className: f,
+  minDate: D,
+  maxDate: m,
+  locale: l = Le,
+  fieldClassName: h,
+  showTimezone: g = !1
 }) => {
-  const p = N ?? Ce[s], a = l instanceof Date ? l : null, w = ge(), u = C ?? w, T = i?.id ?? `${u}-label`, k = !!i?.label, I = typeof i?.label == "string" ? i.label : void 0, F = k ? `${T} ${u}` : void 0, B = i ? /* @__PURE__ */ t(xe, { ...i, id: T, htmlFor: u }) : null, [L, J] = E(
-    () => a ?? /* @__PURE__ */ new Date()
-  ), Q = S(() => /* @__PURE__ */ new Date(), []), X = S(
-    () => we(n),
-    [n]
-  ), A = S(() => ke(n), [n]), ee = S(
-    () => Be(L.getFullYear(), L.getMonth()),
-    [L]
-  ), _ = (r) => {
-    J(
-      (e) => new Date(e.getFullYear(), e.getMonth() + r, 1)
+  const o = C ?? Te[s], n = a instanceof Date ? a : null, w = xe(), b = I ?? w, S = i?.id ?? `${b}-label`, k = !!i?.label, L = typeof i?.label == "string" ? i.label : void 0, A = k ? `${S} ${b}` : void 0, B = i ? /* @__PURE__ */ e(ve, { ...i, id: S, htmlFor: b }) : null, [T, Q] = E(
+    () => n ?? /* @__PURE__ */ new Date()
+  ), X = F(() => /* @__PURE__ */ new Date(), []), ee = F(
+    () => g ? Ie({ locale: l }) : null,
+    [g, l]
+  ), te = F(
+    () => Ee(l),
+    [l]
+  ), _ = F(() => Ae(l), [l]), ae = F(
+    () => _e(T.getFullYear(), T.getMonth()),
+    [T]
+  ), R = (r) => {
+    Q(
+      (t) => new Date(t.getFullYear(), t.getMonth() + r, 1)
     );
-  }, te = (r, e) => {
-    if (W(r, x, f)) return;
-    const y = s === v.DateTime && a ? K(r, M(a)) : r;
-    m?.(y), s === v.Date && e();
-  }, ae = (r) => {
-    m?.(K(a ?? /* @__PURE__ */ new Date(), r));
-  }, le = () => a ? s === v.DateTime ? `${U(a, n)}, ${M(a)}` : U(a, n) : p;
-  if (s === v.Time) {
-    const r = typeof l == "string" ? l : a ? M(a) : "";
-    return /* @__PURE__ */ o("div", { className: c("flex flex-col gap-y-3", b), children: [
+  }, le = (r, t) => {
+    if (K(r, D, m)) return;
+    const v = s === N.DateTime && n ? U(r, M(n)) : r;
+    u?.(v), s === N.Date && t();
+  }, ne = (r) => {
+    u?.(U(n ?? /* @__PURE__ */ new Date(), r));
+  }, re = () => n ? s === N.DateTime ? `${Y(n, l)}, ${M(n)}` : Y(n, l) : o;
+  if (s === N.Time) {
+    const r = typeof a == "string" ? a : n ? M(n) : "";
+    return /* @__PURE__ */ c("div", { className: d("flex flex-col gap-y-3", f), children: [
       B,
-      /* @__PURE__ */ t(
-        G,
+      /* @__PURE__ */ e(
+        Z,
         {
-          id: u,
+          id: b,
           value: r,
-          onChange: (e) => m?.(e),
-          disabled: h,
-          invalid: g,
-          placeholder: p,
-          className: D
+          onChange: (t) => u?.(t),
+          disabled: x,
+          invalid: y,
+          placeholder: o,
+          className: h,
+          timezoneLabel: ee
         }
       )
     ] });
   }
-  if (s === v.Weekday) {
-    const r = typeof l == "string" ? l : void 0, e = A.find((y) => y.value === r);
-    return /* @__PURE__ */ o("div", { className: c("flex flex-col gap-y-3", b), children: [
+  if (s === N.Weekday) {
+    const r = typeof a == "string" ? a : void 0, t = _.find((v) => v.value === r);
+    return /* @__PURE__ */ c("div", { className: d("flex flex-col gap-y-3", f), children: [
       B,
-      /* @__PURE__ */ t(
-        Y,
+      /* @__PURE__ */ e(
+        G,
         {
-          id: u,
-          disabled: h,
-          invalid: g,
-          labelledBy: F,
-          panelLabel: I ?? p,
-          fieldClassName: D,
-          trigger: /* @__PURE__ */ o(O, { children: [
-            /* @__PURE__ */ t(
+          id: b,
+          disabled: x,
+          invalid: y,
+          labelledBy: A,
+          panelLabel: L ?? o,
+          fieldClassName: h,
+          trigger: /* @__PURE__ */ c(O, { children: [
+            /* @__PURE__ */ e(
               "span",
               {
-                className: c(
+                className: d(
                   "truncate",
-                  !e && "text-secondary"
+                  !t && "text-secondary"
                 ),
-                children: e?.label ?? p
+                children: t?.label ?? o
               }
             ),
-            /* @__PURE__ */ t(
-              he,
+            /* @__PURE__ */ e(
+              be,
               {
-                size: ve.MD,
-                stroke: ye,
+                size: De.MD,
+                stroke: Ne,
                 "aria-hidden": "true",
-                className: Ie
+                className: Fe
               }
             )
           ] }),
-          panel: (y) => /* @__PURE__ */ t(
+          panel: (v) => /* @__PURE__ */ e(
             "div",
             {
               role: "listbox",
-              "aria-label": I ?? p,
+              "aria-label": L ?? o,
               className: "flex flex-col gap-0.5",
-              children: A.map((d) => /* @__PURE__ */ t(
+              children: _.map((p) => /* @__PURE__ */ e(
                 "button",
                 {
                   type: "button",
                   role: "option",
-                  "aria-selected": d.value === r,
-                  className: c(
+                  "aria-selected": p.value === r,
+                  className: d(
                     "flex w-full items-center rounded-lg px-3 py-2 text-left dial-small-text text-primary hover:bg-control-accent-alpha-hover",
                     "focus-visible:outline focus-visible:outline-focus",
-                    d.value === r && "bg-control-accent-alpha-hover"
+                    p.value === r && "bg-control-accent-alpha-hover"
                   ),
                   onClick: () => {
-                    m?.(d.value), y();
+                    u?.(p.value), v();
                   },
-                  children: d.label
+                  children: p.label
                 },
-                d.value
+                p.value
               ))
             }
           )
@@ -234,101 +246,101 @@ const Y = ({
       )
     ] });
   }
-  return /* @__PURE__ */ o("div", { className: c("flex flex-col gap-y-3", b), children: [
+  return /* @__PURE__ */ c("div", { className: d("flex flex-col gap-y-3", f), children: [
     B,
-    /* @__PURE__ */ t(
-      Y,
+    /* @__PURE__ */ e(
+      G,
       {
-        id: u,
-        disabled: h,
-        invalid: g,
-        labelledBy: F,
-        panelLabel: I ?? p,
-        fieldClassName: D,
-        trigger: /* @__PURE__ */ o(O, { children: [
-          /* @__PURE__ */ t(
+        id: b,
+        disabled: x,
+        invalid: y,
+        labelledBy: A,
+        panelLabel: L ?? o,
+        fieldClassName: h,
+        trigger: /* @__PURE__ */ c(O, { children: [
+          /* @__PURE__ */ e(
             "span",
             {
-              className: c(
+              className: d(
                 "truncate",
-                !a && "text-secondary"
+                !n && "text-secondary"
               ),
-              children: le()
+              children: re()
             }
           ),
-          Me
+          ke
         ] }),
-        panel: (r) => /* @__PURE__ */ o(O, { children: [
-          /* @__PURE__ */ o("div", { className: "flex items-center justify-between", children: [
-            /* @__PURE__ */ t(
-              $,
+        panel: (r) => /* @__PURE__ */ c(O, { children: [
+          /* @__PURE__ */ c("div", { className: "flex items-center justify-between", children: [
+            /* @__PURE__ */ e(
+              j,
               {
                 "aria-label": "Previous month",
-                icon: V.prev,
-                size: j.Small,
-                onClick: () => _(-1)
+                icon: P.prev,
+                size: V.Small,
+                onClick: () => R(-1)
               }
             ),
-            /* @__PURE__ */ t(
+            /* @__PURE__ */ e(
               "div",
               {
                 className: "dial-small-semi-text text-primary",
                 "aria-live": "polite",
-                children: Ee(L, n)
+                children: Re(T, l)
               }
             ),
-            /* @__PURE__ */ t(
-              $,
+            /* @__PURE__ */ e(
+              j,
               {
                 "aria-label": "Next month",
-                icon: V.next,
-                size: j.Small,
-                onClick: () => _(1)
+                icon: P.next,
+                size: V.Small,
+                onClick: () => R(1)
               }
             )
           ] }),
-          /* @__PURE__ */ o("div", { className: "grid grid-cols-7 gap-y-1 text-center", children: [
-            X.map((e) => /* @__PURE__ */ t(
+          /* @__PURE__ */ c("div", { className: "grid grid-cols-7 gap-y-1 text-center", children: [
+            te.map((t) => /* @__PURE__ */ e(
               "div",
               {
                 "aria-hidden": "true",
                 className: "dial-tiny-text py-1 text-secondary",
-                children: e
+                children: t
               },
-              e
+              t
             )),
-            ee.map((e) => {
-              const y = e.getMonth() !== L.getMonth(), d = P(e, a), R = P(e, Q), z = W(e, x, f);
-              return /* @__PURE__ */ t(
+            ae.map((t) => {
+              const v = t.getMonth() !== T.getMonth(), p = W(t, n), z = W(t, X), $ = K(t, D, m);
+              return /* @__PURE__ */ e(
                 "button",
                 {
                   type: "button",
-                  disabled: z,
-                  "aria-label": Ae(e, n),
-                  "aria-pressed": d,
-                  "aria-current": R ? "date" : void 0,
-                  className: c(
-                    Se,
-                    y && Fe,
-                    R && !d && Te,
-                    d && Le,
-                    z && "cursor-not-allowed opacity-40 hover:bg-transparent"
+                  disabled: $,
+                  "aria-label": ze(t, l),
+                  "aria-pressed": p,
+                  "aria-current": z ? "date" : void 0,
+                  className: d(
+                    we,
+                    v && Oe,
+                    z && !p && Me,
+                    p && Se,
+                    $ && "cursor-not-allowed opacity-40 hover:bg-transparent"
                   ),
-                  onClick: () => te(e, r),
-                  children: e.getDate()
+                  onClick: () => le(t, r),
+                  children: t.getDate()
                 },
-                e.toISOString()
+                t.toISOString()
               );
             })
           ] }),
-          s === v.DateTime && /* @__PURE__ */ o("div", { className: "flex items-center justify-between gap-3 border-t border-secondary pt-3", children: [
-            /* @__PURE__ */ t("span", { className: "dial-small-text text-primary", children: "Time" }),
-            /* @__PURE__ */ t(
-              G,
+          s === N.DateTime && /* @__PURE__ */ c("div", { className: "flex items-center justify-between gap-3 border-t border-secondary pt-3", children: [
+            /* @__PURE__ */ e("span", { className: "dial-small-text text-primary", children: "Time" }),
+            /* @__PURE__ */ e(
+              Z,
               {
                 ariaLabel: "Time",
-                value: a ? M(a) : "",
-                onChange: ae,
+                value: n ? M(n) : "",
+                onChange: ne,
                 className: "w-[120px] px-3 py-1.5"
               }
             )
@@ -339,5 +351,5 @@ const Y = ({
   ] });
 };
 export {
-  Qe as Calendar
+  at as Calendar
 };

package/dist/components-manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.15.0-dev.3",
-  "generatedAt": "2026-09-14T19:58:04.346Z",
+  "version": "0.15.0-dev.4",
+  "generatedAt": "2026-09-16T07:40:41.827Z",
   "kit": {
     "name": "@epam/ai-dial-ui-kit",
     "description": "A modern UI kit for building AI DIAL interfaces with React",
@@ -491,6 +491,13 @@
           "type": "string",
           "required": false,
           "description": "Additional classes merged onto the trigger field, overriding conflicting defaults"
+        },
+        {
+          "name": "showTimezone",
+          "type": "boolean",
+          "required": false,
+          "defaultValue": "false",
+          "description": "Shows the viewer's timezone (e.g. `(GMT+01:00) Europe/Berlin`) at the trailing edge of the `time` field"
         }
       ],
       "examples": [
@@ -10686,6 +10693,16 @@
       "sourceFile": "utils/flat-to-hierarchy-convertor.ts",
       "description": "Helper to create a root folder wrapping flat items.\nUseful when you want the entire tree to be nested under a single root.",
       "signature": "function wrapInRootFolder(flatItems: FlatFileItem[], rootName = 'Prompts', rootPath = 'prompts/public/', rootFolderId = 'root'): DialFile[]"
+    },
+    {
+      "name": "getTimezoneLabel",
+      "sourceFile": "utils/timezone.ts",
+      "description": "Returns a timezone as a hint label for time-of-day fields, e.g.\n`(GMT+01:00) Europe/Berlin`: the UTC offset in effect at `options.date`\nrendered by `Intl` (`timeZoneName: 'longOffset'`), followed by the IANA\ntimezone name.",
+      "signature": "({\n  locale,\n  timeZone,\n  date = new Date(),\n}: TimezoneLabelOptions = {}) => string"
+    },
+    {
+      "name": "TimezoneLabelOptions",
+      "sourceFile": "utils/timezone.ts"
     }
   ],
   "constants": [