@reykjavik/hanna-react 0.10.162 → 0.10.163

package/Alert.d.ts

@@ -11,8 +11,11 @@ type AlertType = 'info' | 'success' | 'warning' | 'error' | 'critical';
 export declare const alertTypes: Record<string, 1>;
 export type AlertProps = {
     type: AlertType;
+    /** Defaults to `true` if an `onClose` handler or a `closeUrl` is passaed */
     closable?: boolean;
+    /** The alert content */
     children?: ReactNode;
+    /** UNSAFE raw HTML content for the Alert, e.g. one emitted by a CMS. */
     childrenHTML?: string;
     /** server-side anchor href */
     closeUrl?: string;
@@ -21,8 +24,8 @@ export type AlertProps = {
     /** Set to true to opt out of the opening transition */
     instantShow?: boolean;
 } & SSRSupportProps & EitherObj<{
-    /** Seconds until the Alert auto-closes.
-     *
+    /**
+     * Seconds until the Alert auto-closes.
      * Mosueover and keyboard focus resets the timer.
      */
     autoClose: number;
@@ -31,7 +34,8 @@ export type AlertProps = {
     /** Callback that fires when the alert has closed/transitoned out */
     onClosed: () => void;
 }, {
-    /** @deprecated This signature with the `event` argument will be removed in hanna-react v0.11
+    /**
+     * NOTE: The signature with the `event` argument will be removed in hanna-react v0.11
      *
      * Return `false` to prevent the alert from closing
      */

package/Alert.js

@@ -48,8 +48,7 @@ exports.alertTypes = {
     critical: 1,
 };
 const Alert = (props) => {
-    const { type, childrenHTML, children, onClose, // eslint-disable-line deprecation/deprecation
-    closeUrl, closable = !!(onClose || closeUrl != null), ssr, onClosed, instantShow, wrapperProps, } = props;
+    const { type, childrenHTML, children, onClose, closeUrl, closable = !!(onClose || closeUrl != null), ssr, onClosed, instantShow, wrapperProps, } = props;
     const autoClose = Math.max(props.autoClose || 0, 0);
     const closing = (0, react_1.useRef)();
     const isBrowser = (0, utils_js_1.useIsBrowserSide)(ssr);
@@ -62,7 +61,7 @@ const Alert = (props) => {
     const closeAlert = (0, react_1.useCallback)((event) => {
         const ret = onClose &&
             // @ts-expect-error  (@deprecated `event` parameter will be removed in v0.11)
-            onClose(event); // eslint-disable-line deprecation/deprecation
+            onClose(event);
         if (ret !== false) {
             setOpen(false);
             if (closing.current) {

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 - ... <!-- Add new lines here. -->
 
+## 0.10.163
+
+_2026-01-20_
+
+- feat: Add `useLaggedState` to `utils` for advanced delayed state updates
+
 ## 0.10.162
 
 _2026-01-16_

package/esm/Alert.d.ts

@@ -11,8 +11,11 @@ type AlertType = 'info' | 'success' | 'warning' | 'error' | 'critical';
 export declare const alertTypes: Record<string, 1>;
 export type AlertProps = {
     type: AlertType;
+    /** Defaults to `true` if an `onClose` handler or a `closeUrl` is passaed */
     closable?: boolean;
+    /** The alert content */
     children?: ReactNode;
+    /** UNSAFE raw HTML content for the Alert, e.g. one emitted by a CMS. */
     childrenHTML?: string;
     /** server-side anchor href */
     closeUrl?: string;
@@ -21,8 +24,8 @@ export type AlertProps = {
     /** Set to true to opt out of the opening transition */
     instantShow?: boolean;
 } & SSRSupportProps & EitherObj<{
-    /** Seconds until the Alert auto-closes.
-     *
+    /**
+     * Seconds until the Alert auto-closes.
      * Mosueover and keyboard focus resets the timer.
      */
     autoClose: number;
@@ -31,7 +34,8 @@ export type AlertProps = {
     /** Callback that fires when the alert has closed/transitoned out */
     onClosed: () => void;
 }, {
-    /** @deprecated This signature with the `event` argument will be removed in hanna-react v0.11
+    /**
+     * NOTE: The signature with the `event` argument will be removed in hanna-react v0.11
      *
      * Return `false` to prevent the alert from closing
      */

package/esm/Alert.js

@@ -44,8 +44,7 @@ export const alertTypes = {
     critical: 1,
 };
 export const Alert = (props) => {
-    const { type, childrenHTML, children, onClose, // eslint-disable-line deprecation/deprecation
-    closeUrl, closable = !!(onClose || closeUrl != null), ssr, onClosed, instantShow, wrapperProps, } = props;
+    const { type, childrenHTML, children, onClose, closeUrl, closable = !!(onClose || closeUrl != null), ssr, onClosed, instantShow, wrapperProps, } = props;
     const autoClose = Math.max(props.autoClose || 0, 0);
     const closing = useRef();
     const isBrowser = useIsBrowserSide(ssr);
@@ -58,7 +57,7 @@ export const Alert = (props) => {
     const closeAlert = useCallback((event) => {
         const ret = onClose &&
             // @ts-expect-error  (@deprecated `event` parameter will be removed in v0.11)
-            onClose(event); // eslint-disable-line deprecation/deprecation
+            onClose(event);
         if (ret !== false) {
             setOpen(false);
             if (closing.current) {

package/esm/utils/useLaggedState.d.ts

@@ -1,5 +1,6 @@
 /**
- * A `useState` alternative with in-built support for delayed (debounced) effect.
+ * An advanced `useState` alternative with in-built support for delayed
+ * (debounced) effect.
  *
  * This is especially useful when emulating "focusin"/"focusout" events,
  * and a less jittery 'onMouseEnter'/'onMouseLeave' behavior.

package/esm/utils/useLaggedState.js

@@ -1,7 +1,8 @@
 import { useEffect, useMemo, useRef, useState } from 'react';
 // ---------------------------------------------------------------------------
 /**
- * A `useState` alternative with in-built support for delayed (debounced) effect.
+ * An advanced `useState` alternative with in-built support for delayed
+ * (debounced) effect.
  *
  * This is especially useful when emulating "focusin"/"focusout" events,
  * and a less jittery 'onMouseEnter'/'onMouseLeave' behavior.

package/esm/utils.d.ts

@@ -5,6 +5,7 @@ export * from './utils/useDidChange.js';
 export * from './utils/useDomid.js';
 export * from './utils/useFormatMonitor.js';
 export * from './utils/useGetSVGtext.js';
+export * from './utils/useLaggedState.js';
 export * from './utils/useMixedControlState.js';
 export * from './utils/useScrollbarWidthCSSVar.js';
 /**

package/esm/utils.js

@@ -4,6 +4,7 @@ export * from './utils/useDidChange.js';
 export * from './utils/useDomid.js';
 export * from './utils/useFormatMonitor.js';
 export * from './utils/useGetSVGtext.js';
+export * from './utils/useLaggedState.js';
 export * from './utils/useMixedControlState.js';
 export * from './utils/useScrollbarWidthCSSVar.js';
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@reykjavik/hanna-react",
-	"version": "0.10.162",
+	"version": "0.10.163",
 	"author": "Reykjavík (http://www.reykjavik.is)",
 	"contributors": [
 		"Hugsmiðjan ehf (http://www.hugsmidjan.is)",

package/utils/useLaggedState.d.ts

@@ -1,5 +1,6 @@
 /**
- * A `useState` alternative with in-built support for delayed (debounced) effect.
+ * An advanced `useState` alternative with in-built support for delayed
+ * (debounced) effect.
  *
  * This is especially useful when emulating "focusin"/"focusout" events,
  * and a less jittery 'onMouseEnter'/'onMouseLeave' behavior.

package/utils/useLaggedState.js

@@ -4,7 +4,8 @@ exports.useLaggedState = void 0;
 const react_1 = require("react");
 // ---------------------------------------------------------------------------
 /**
- * A `useState` alternative with in-built support for delayed (debounced) effect.
+ * An advanced `useState` alternative with in-built support for delayed
+ * (debounced) effect.
  *
  * This is especially useful when emulating "focusin"/"focusout" events,
  * and a less jittery 'onMouseEnter'/'onMouseLeave' behavior.

package/utils.d.ts

@@ -5,6 +5,7 @@ export * from './utils/useDidChange.js';
 export * from './utils/useDomid.js';
 export * from './utils/useFormatMonitor.js';
 export * from './utils/useGetSVGtext.js';
+export * from './utils/useLaggedState.js';
 export * from './utils/useMixedControlState.js';
 export * from './utils/useScrollbarWidthCSSVar.js';
 /**

package/utils.js

@@ -8,6 +8,7 @@ tslib_1.__exportStar(require("./utils/useDidChange.js"), exports);
 tslib_1.__exportStar(require("./utils/useDomid.js"), exports);
 tslib_1.__exportStar(require("./utils/useFormatMonitor.js"), exports);
 tslib_1.__exportStar(require("./utils/useGetSVGtext.js"), exports);
+tslib_1.__exportStar(require("./utils/useLaggedState.js"), exports);
 tslib_1.__exportStar(require("./utils/useMixedControlState.js"), exports);
 tslib_1.__exportStar(require("./utils/useScrollbarWidthCSSVar.js"), exports);
 // ---------------------------------------------------------------------------