@alfadocs/ui-kit 0.57.0 → 0.58.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.57.0",
+  "packageVersion": "0.58.0",
   "components": [
     {
       "kind": "component",

package/dist/hooks/index.d.ts

@@ -19,4 +19,5 @@ export { useIsomorphicLayoutEffect } from './use-isomorphic-layout-effect';
 export { useWebOtp, type UseWebOtpOptions } from './use-web-otp';
 export { useEdgeResize, type UseEdgeResizeOptions, type UseEdgeResizeReturn, type EdgeResizeSeparatorProps, } from './use-edge-resize';
 export { useSigningSession, type SigningField, type SigningFieldBase, type UseSigningSessionReturn, } from './use-signing-session';
+export { useCountdown, type UseCountdownOptions, type UseCountdownReturn, } from './use-countdown';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.js

@@ -1,32 +1,32 @@
-import { u as v } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
-import { u as D } from "../_chunks/use-media-query-CcAx5SMM.js";
-import { u as g, a as _ } from "../_chunks/use-signing-session-CyOZWinp.js";
-import { u as O } from "../_chunks/use-count-up-BLLetaZ8.js";
-import { u as k } from "../_chunks/use-locale-BkCIHujH.js";
-import { A as K, T as H, a as M, r as Y, t as q, u as B } from "../_chunks/use-theme-CAuo6EYT.js";
-import { u as P } from "../_chunks/use-controllable-state-BiY4xTzM.js";
-import { u as V } from "../_chunks/use-copy-to-clipboard-Cyfc_dlv.js";
-import { u as z } from "../_chunks/use-debounced-callback-BisrB-Fq.js";
-import { useState as x, useRef as b, useEffect as E } from "react";
-import { u as W, a as J } from "../_chunks/use-direction-Dp8h70PP.js";
-import { u as X } from "../_chunks/use-persistent-state-i23OWy6G.js";
-import { u as $ } from "../_chunks/use-isomorphic-layout-effect-BGfaCOP1.js";
-import { u as te } from "../_chunks/use-web-otp-D_utzp6S.js";
-import { u as oe } from "../_chunks/use-edge-resize-ZnGG7gyO.js";
-function h(e, o) {
-  const [t, i] = x(e), u = b(null);
-  return E(() => {
-    if (o <= 0) {
-      u.current !== null && (clearTimeout(u.current), u.current = null), i(e);
+import { u as L } from "../_chunks/use-prefers-reduced-motion-BMwIQRjB.js";
+import { u as F } from "../_chunks/use-media-query-CcAx5SMM.js";
+import { u as R, a as _ } from "../_chunks/use-signing-session-CyOZWinp.js";
+import { u as w } from "../_chunks/use-count-up-BLLetaZ8.js";
+import { u as K } from "../_chunks/use-locale-BkCIHujH.js";
+import { A as H, T as Y, a as q, r as B, t as G, u as P } from "../_chunks/use-theme-CAuo6EYT.js";
+import { u as V } from "../_chunks/use-controllable-state-BiY4xTzM.js";
+import { u as z } from "../_chunks/use-copy-to-clipboard-Cyfc_dlv.js";
+import { u as W } from "../_chunks/use-debounced-callback-BisrB-Fq.js";
+import { useState as b, useRef as E, useEffect as m, useCallback as x } from "react";
+import { u as N, a as X } from "../_chunks/use-direction-Dp8h70PP.js";
+import { u as $ } from "../_chunks/use-persistent-state-i23OWy6G.js";
+import { u as te } from "../_chunks/use-isomorphic-layout-effect-BGfaCOP1.js";
+import { u as ne } from "../_chunks/use-web-otp-D_utzp6S.js";
+import { u as ue } from "../_chunks/use-edge-resize-ZnGG7gyO.js";
+function C(e, u) {
+  const [r, i] = b(e), n = E(null);
+  return m(() => {
+    if (u <= 0) {
+      n.current !== null && (clearTimeout(n.current), n.current = null), i(e);
       return;
     }
     const s = setTimeout(() => {
-      i(e), u.current = null;
-    }, o);
-    return u.current = s, () => clearTimeout(s);
-  }, [e, o]), t;
+      i(e), n.current = null;
+    }, u);
+    return n.current = s, () => clearTimeout(s);
+  }, [e, u]), r;
 }
-const T = [
+const S = [
   "a[href]",
   "button:not([disabled])",
   'input:not([disabled]):not([type="hidden"])',
@@ -37,74 +37,96 @@ const T = [
   "audio[controls]",
   "video[controls]"
 ].join(",");
-function p(e) {
+function T(e) {
   return Array.from(
-    e.querySelectorAll(T)
-  ).filter((o) => {
-    if (o.hidden) return !1;
-    let t = o;
-    for (; t; ) {
-      if (t.hasAttribute("inert") || t.getAttribute("aria-hidden") === "true") return !1;
-      t = t.parentElement;
+    e.querySelectorAll(S)
+  ).filter((u) => {
+    if (u.hidden) return !1;
+    let r = u;
+    for (; r; ) {
+      if (r.hasAttribute("inert") || r.getAttribute("aria-hidden") === "true") return !1;
+      r = r.parentElement;
     }
     return !0;
   });
 }
-function C(e, o = {}) {
-  const { enabled: t = !0, autoFocus: i = !0, restoreFocus: u = !0 } = o, s = b(null);
-  E(() => {
-    if (!t) return;
-    const a = e.current;
-    if (!a) return;
+function v(e, u = {}) {
+  const { enabled: r = !0, autoFocus: i = !0, restoreFocus: n = !0 } = u, s = E(null);
+  m(() => {
+    if (!r) return;
+    const o = e.current;
+    if (!o) return;
     if (s.current = typeof document < "u" && document.activeElement instanceof HTMLElement ? document.activeElement : null, i) {
-      const n = p(a)[0] ?? (a.tabIndex >= -1 ? a : null);
-      n == null || n.focus();
+      const a = T(o)[0] ?? (o.tabIndex >= -1 ? o : null);
+      a == null || a.focus();
     }
-    function f(r) {
-      if (r.key !== "Tab") return;
-      const n = e.current;
-      if (!n) return;
-      const c = p(n);
-      if (c.length === 0) {
-        r.preventDefault();
+    function l(t) {
+      if (t.key !== "Tab") return;
+      const a = e.current;
+      if (!a) return;
+      const f = T(a);
+      if (f.length === 0) {
+        t.preventDefault();
         return;
       }
-      const d = c[0], m = c[c.length - 1], l = document.activeElement;
-      r.shiftKey ? (l === d || !n.contains(l)) && (r.preventDefault(), m.focus()) : (l === m || !n.contains(l)) && (r.preventDefault(), d.focus());
+      const c = f[0], d = f[f.length - 1], p = document.activeElement;
+      t.shiftKey ? (p === c || !a.contains(p)) && (t.preventDefault(), d.focus()) : (p === d || !a.contains(p)) && (t.preventDefault(), c.focus());
     }
-    return a.addEventListener("keydown", f), () => {
-      if (a.removeEventListener("keydown", f), u && s.current) {
-        const r = s.current;
+    return o.addEventListener("keydown", l), () => {
+      if (o.removeEventListener("keydown", l), n && s.current) {
+        const t = s.current;
         requestAnimationFrame(() => {
-          r.isConnected && r.focus();
+          t.isConnected && t.focus();
         });
       }
     };
-  }, [t, i, u, e]);
+  }, [r, i, n, e]);
+}
+function g(e, u = {}) {
+  const { autoStart: r = !0, onElapsed: i } = u, [n, s] = b(e), [o, l] = b(r), t = E(i);
+  m(() => {
+    t.current = i;
+  }, [i]);
+  const a = x(() => {
+    s(e), l(!0);
+  }, [e]), f = x(() => {
+    s(e), l(!1);
+  }, [e]);
+  return m(() => {
+    if (!o) return;
+    const c = setInterval(() => {
+      s((d) => Math.max(0, d - 1));
+    }, 1e3);
+    return () => clearInterval(c);
+  }, [o]), m(() => {
+    var c;
+    o && n <= 0 && (l(!1), (c = t.current) == null || c.call(t));
+  }, [o, n]), { remaining: n, isRunning: o, start: a, reset: f };
 }
 export {
-  K as ACCESSIBILITY_STORAGE_KEY,
-  H as THEME_CLASS,
-  M as THEME_STORAGE_KEY,
-  Y as resolveTheme,
-  q as themeClassList,
-  P as useControllableState,
-  V as useCopyToClipboard,
-  O as useCountUp,
-  z as useDebouncedCallback,
-  h as useDebouncedValue,
-  W as useDirection,
-  J as useDocumentDirection,
-  oe as useEdgeResize,
-  C as useFocusTrap,
-  $ as useIsomorphicLayoutEffect,
-  k as useLocale,
-  D as useMediaQuery,
-  X as usePersistentState,
-  v as usePrefersReducedMotion,
-  g as useScrollToFirstError,
+  H as ACCESSIBILITY_STORAGE_KEY,
+  Y as THEME_CLASS,
+  q as THEME_STORAGE_KEY,
+  B as resolveTheme,
+  G as themeClassList,
+  V as useControllableState,
+  z as useCopyToClipboard,
+  w as useCountUp,
+  g as useCountdown,
+  W as useDebouncedCallback,
+  C as useDebouncedValue,
+  N as useDirection,
+  X as useDocumentDirection,
+  ue as useEdgeResize,
+  v as useFocusTrap,
+  te as useIsomorphicLayoutEffect,
+  K as useLocale,
+  F as useMediaQuery,
+  $ as usePersistentState,
+  L as usePrefersReducedMotion,
+  R as useScrollToFirstError,
   _ as useSigningSession,
-  B as useTheme,
-  te as useWebOtp
+  P as useTheme,
+  ne as useWebOtp
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/use-countdown.d.ts

@@ -0,0 +1,34 @@
+export interface UseCountdownOptions {
+    /** Begin counting down on mount. Default `true`. */
+    autoStart?: boolean;
+    /** Called exactly once when the countdown reaches zero. */
+    onElapsed?: () => void;
+}
+export interface UseCountdownReturn {
+    /** Whole seconds remaining; counts down to 0. */
+    remaining: number;
+    /** Whether the countdown is actively ticking. */
+    isRunning: boolean;
+    /** (Re)start from the full duration. */
+    start: () => void;
+    /** Stop and reset to the full duration without firing `onElapsed`. */
+    reset: () => void;
+}
+/**
+ * A pure, render-friendly seconds countdown. It owns no side effects — when
+ * it reaches zero it calls `onElapsed` and the CONSUMER decides what to do
+ * (close the tab, redirect, …). Same "no I/O" contract as `useSigningSession`.
+ *
+ * `onElapsed` is read through a ref, so changing the callback doesn't restart
+ * the timer. SSR-safe: the timer only ticks inside an effect (client-only).
+ *
+ * @example
+ *   const { remaining } = useCountdown(10, {
+ *     onElapsed: () => {
+ *       window.close(); // best-effort — blocked for user-opened tabs
+ *       window.location.assign('https://www.alfadocs.com'); // fallback
+ *     },
+ *   });
+ */
+export declare function useCountdown(seconds: number, options?: UseCountdownOptions): UseCountdownReturn;
+//# sourceMappingURL=use-countdown.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfadocs/ui-kit",
-  "version": "0.57.0",
+  "version": "0.58.0",
   "type": "module",
   "description": "AlfaDocs shared design system — tokens, components, patterns, and translations for platform, booking, and alfascribe.",
   "license": "BUSL-1.1",