@alma-oss/spirit-web-react 4.4.2 → 4.5.0

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/constants/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./classes.cjs"),n=require("./colors.cjs"),e=require("./dictionaries.cjs"),o=require("./direction.cjs"),s=require("./inputs.cjs"),l=require("./media.cjs"),d=require("./position.cjs"),t=require("./style.cjs"),i=require("./text.cjs");exports.CLASS_NAME_OPEN=r.CLASS_NAME_OPEN;exports.ColorPrefixes=n.ColorPrefixes;exports.AlignmentX=e.AlignmentX;exports.AlignmentXExtended=e.AlignmentXExtended;exports.AlignmentY=e.AlignmentY;exports.AlignmentYExtended=e.AlignmentYExtended;exports.BackgroundColors=e.BackgroundColors;exports.BackgroundGradients=e.BackgroundGradients;exports.BorderColors=e.BorderColors;exports.BorderRadii=e.BorderRadii;exports.BorderStyles=e.BorderStyles;exports.BorderWidths=e.BorderWidths;exports.ComponentButtonColors=e.ComponentButtonColors;exports.ContainerTokenSizes=e.ContainerTokenSizes;exports.EmotionColors=e.EmotionColors;exports.Emphasis=e.Emphasis;exports.FillVariants=e.FillVariants;exports.Intensity=e.Intensity;exports.LinkColors=e.LinkColors;exports.Placements=e.Placements;exports.ShapeVariants=e.ShapeVariants;exports.Sizes=e.Sizes;exports.SizesExtended=e.SizesExtended;exports.TextAlignments=e.TextAlignments;exports.TextColors=e.TextColors;exports.ValidationStates=e.ValidationStates;exports.Direction=o.Direction;exports.DirectionAxis=o.DirectionAxis;exports.DirectionExtended=o.DirectionExtended;exports.isDirectionHorizontal=o.isDirectionHorizontal;exports.InputPositions=s.InputPositions;exports.ObjectFit=l.ObjectFit;exports.Position=d.Position;exports.BackgroundStyleProps=t.BackgroundStyleProps;exports.BorderRadiusStyleProps=t.BorderRadiusStyleProps;exports.DisplayStyleProps=t.DisplayStyleProps;exports.HeadingStyleProps=t.HeadingStyleProps;exports.PaddingStyleProps=t.PaddingStyleProps;exports.SpacingStyleProp=t.SpacingStyleProp;exports.TextStyleProps=t.TextStyleProps;exports.ThemeStyleProps=t.ThemeStyleProps;exports.TextHyphens=i.TextHyphens;exports.TextWordBreaks=i.TextWordBreaks;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./classes.cjs"),s=require("./colors.cjs"),e=require("./dictionaries.cjs"),o=require("./direction.cjs"),l=require("./inputs.cjs"),d=require("./media.cjs"),a=require("./position.cjs"),i=require("./selection.cjs"),t=require("./style.cjs"),r=require("./text.cjs");exports.CLASS_NAME_OPEN=n.CLASS_NAME_OPEN;exports.ColorPrefixes=s.ColorPrefixes;exports.AlignmentX=e.AlignmentX;exports.AlignmentXExtended=e.AlignmentXExtended;exports.AlignmentY=e.AlignmentY;exports.AlignmentYExtended=e.AlignmentYExtended;exports.BackgroundColors=e.BackgroundColors;exports.BackgroundGradients=e.BackgroundGradients;exports.BorderColors=e.BorderColors;exports.BorderRadii=e.BorderRadii;exports.BorderStyles=e.BorderStyles;exports.BorderWidths=e.BorderWidths;exports.ComponentButtonColors=e.ComponentButtonColors;exports.ContainerTokenSizes=e.ContainerTokenSizes;exports.EmotionColors=e.EmotionColors;exports.Emphasis=e.Emphasis;exports.FillVariants=e.FillVariants;exports.Intensity=e.Intensity;exports.LinkColors=e.LinkColors;exports.Placements=e.Placements;exports.ShapeVariants=e.ShapeVariants;exports.Sizes=e.Sizes;exports.SizesExtended=e.SizesExtended;exports.TextAlignments=e.TextAlignments;exports.TextColors=e.TextColors;exports.ValidationStates=e.ValidationStates;exports.Direction=o.Direction;exports.DirectionAxis=o.DirectionAxis;exports.DirectionExtended=o.DirectionExtended;exports.isDirectionHorizontal=o.isDirectionHorizontal;exports.InputPositions=l.InputPositions;exports.ObjectFit=d.ObjectFit;exports.Position=a.Position;exports.MULTIPLE_SELECTION_MODE=i.MULTIPLE_SELECTION_MODE;exports.SINGLE_SELECTION_MODE=i.SINGLE_SELECTION_MODE;exports.BackgroundStyleProps=t.BackgroundStyleProps;exports.BorderRadiusStyleProps=t.BorderRadiusStyleProps;exports.DisplayStyleProps=t.DisplayStyleProps;exports.HeadingStyleProps=t.HeadingStyleProps;exports.PaddingStyleProps=t.PaddingStyleProps;exports.SpacingStyleProp=t.SpacingStyleProp;exports.TextStyleProps=t.TextStyleProps;exports.ThemeStyleProps=t.ThemeStyleProps;exports.TextHyphens=r.TextHyphens;exports.TextWordBreaks=r.TextWordBreaks;
 //# sourceMappingURL=index.cjs.map

package/dist/constants/index.d.ts

@@ -5,5 +5,6 @@ export * from './direction';
 export * from './inputs';
 export * from './media';
 export * from './position';
+export * from './selection';
 export * from './style';
 export * from './text';

package/dist/constants/index.js

@@ -1,12 +1,13 @@
 import { CLASS_NAME_OPEN as r } from "./classes.js";
 import { ColorPrefixes as i } from "./colors.js";
-import { AlignmentX as s, AlignmentXExtended as l, AlignmentY as d, AlignmentYExtended as p, BackgroundColors as a, BackgroundGradients as x, BorderColors as m, BorderRadii as S, BorderStyles as P, BorderWidths as y, ComponentButtonColors as c, ContainerTokenSizes as g, EmotionColors as f, Emphasis as B, FillVariants as C, Intensity as A, LinkColors as E, Placements as u, ShapeVariants as T, Sizes as k, SizesExtended as h, TextAlignments as D, TextColors as z, ValidationStates as H } from "./dictionaries.js";
-import { Direction as F, DirectionAxis as I, DirectionExtended as L, isDirectionHorizontal as N } from "./direction.js";
-import { InputPositions as R } from "./inputs.js";
-import { ObjectFit as X } from "./media.js";
-import { Position as _ } from "./position.js";
-import { BackgroundStyleProps as j, BorderRadiusStyleProps as G, DisplayStyleProps as M, HeadingStyleProps as q, PaddingStyleProps as v, SpacingStyleProp as w, TextStyleProps as J, ThemeStyleProps as K } from "./style.js";
-import { TextHyphens as U, TextWordBreaks as Z } from "./text.js";
+import { AlignmentX as s, AlignmentXExtended as l, AlignmentY as d, AlignmentYExtended as p, BackgroundColors as a, BackgroundGradients as x, BorderColors as m, BorderRadii as S, BorderStyles as E, BorderWidths as P, ComponentButtonColors as y, ContainerTokenSizes as C, EmotionColors as c, Emphasis as f, FillVariants as g, Intensity as B, LinkColors as T, Placements as A, ShapeVariants as u, Sizes as D, SizesExtended as L, TextAlignments as k, TextColors as I, ValidationStates as O } from "./dictionaries.js";
+import { Direction as h, DirectionAxis as N, DirectionExtended as z, isDirectionHorizontal as M } from "./direction.js";
+import { InputPositions as V } from "./inputs.js";
+import { ObjectFit as G } from "./media.js";
+import { Position as W } from "./position.js";
+import { MULTIPLE_SELECTION_MODE as Y, SINGLE_SELECTION_MODE as b } from "./selection.js";
+import { BackgroundStyleProps as U, BorderRadiusStyleProps as q, DisplayStyleProps as v, HeadingStyleProps as w, PaddingStyleProps as J, SpacingStyleProp as K, TextStyleProps as Q, ThemeStyleProps as Z } from "./style.js";
+import { TextHyphens as oo, TextWordBreaks as eo } from "./text.js";
 export {
   s as AlignmentX,
   l as AlignmentXExtended,
@@ -14,42 +15,44 @@ export {
   p as AlignmentYExtended,
   a as BackgroundColors,
   x as BackgroundGradients,
-  j as BackgroundStyleProps,
+  U as BackgroundStyleProps,
   m as BorderColors,
   S as BorderRadii,
-  G as BorderRadiusStyleProps,
-  P as BorderStyles,
-  y as BorderWidths,
+  q as BorderRadiusStyleProps,
+  E as BorderStyles,
+  P as BorderWidths,
   r as CLASS_NAME_OPEN,
   i as ColorPrefixes,
-  c as ComponentButtonColors,
-  g as ContainerTokenSizes,
-  F as Direction,
-  I as DirectionAxis,
-  L as DirectionExtended,
-  M as DisplayStyleProps,
-  f as EmotionColors,
-  B as Emphasis,
-  C as FillVariants,
-  q as HeadingStyleProps,
-  R as InputPositions,
-  A as Intensity,
-  E as LinkColors,
-  X as ObjectFit,
-  v as PaddingStyleProps,
-  u as Placements,
-  _ as Position,
-  T as ShapeVariants,
-  k as Sizes,
-  h as SizesExtended,
-  w as SpacingStyleProp,
-  D as TextAlignments,
-  z as TextColors,
-  U as TextHyphens,
-  J as TextStyleProps,
-  Z as TextWordBreaks,
-  K as ThemeStyleProps,
-  H as ValidationStates,
-  N as isDirectionHorizontal
+  y as ComponentButtonColors,
+  C as ContainerTokenSizes,
+  h as Direction,
+  N as DirectionAxis,
+  z as DirectionExtended,
+  v as DisplayStyleProps,
+  c as EmotionColors,
+  f as Emphasis,
+  g as FillVariants,
+  w as HeadingStyleProps,
+  V as InputPositions,
+  B as Intensity,
+  T as LinkColors,
+  Y as MULTIPLE_SELECTION_MODE,
+  G as ObjectFit,
+  J as PaddingStyleProps,
+  A as Placements,
+  W as Position,
+  b as SINGLE_SELECTION_MODE,
+  u as ShapeVariants,
+  D as Sizes,
+  L as SizesExtended,
+  K as SpacingStyleProp,
+  k as TextAlignments,
+  I as TextColors,
+  oo as TextHyphens,
+  Q as TextStyleProps,
+  eo as TextWordBreaks,
+  Z as ThemeStyleProps,
+  O as ValidationStates,
+  M as isDirectionHorizontal
 };
 //# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/dist/constants/selection.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E="multiple",t="single";exports.MULTIPLE_SELECTION_MODE=E;exports.SINGLE_SELECTION_MODE=t;
+//# sourceMappingURL=selection.cjs.map

package/dist/constants/selection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.cjs","sources":["../../src/constants/selection.ts"],"sourcesContent":["export const MULTIPLE_SELECTION_MODE = 'multiple' as const;\nexport const SINGLE_SELECTION_MODE = 'single' as const;\n"],"names":["MULTIPLE_SELECTION_MODE","SINGLE_SELECTION_MODE"],"mappings":"gFAAO,MAAMA,EAA0B,WAC1BC,EAAwB"}

package/dist/constants/selection.d.ts

@@ -0,0 +1,2 @@
+export declare const MULTIPLE_SELECTION_MODE: "multiple";
+export declare const SINGLE_SELECTION_MODE: "single";

package/dist/constants/selection.js

@@ -0,0 +1,6 @@
+const E = "multiple", t = "single";
+export {
+  E as MULTIPLE_SELECTION_MODE,
+  t as SINGLE_SELECTION_MODE
+};
+//# sourceMappingURL=selection.js.map

package/dist/constants/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sources":["../../src/constants/selection.ts"],"sourcesContent":["export const MULTIPLE_SELECTION_MODE = 'multiple' as const;\nexport const SINGLE_SELECTION_MODE = 'single' as const;\n"],"names":["MULTIPLE_SELECTION_MODE","SINGLE_SELECTION_MODE"],"mappings":"AAAO,MAAMA,IAA0B,YAC1BC,IAAwB;"}

package/dist/context/RouterContext.cjs

@@ -0,0 +1,2 @@
+"use strict";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),s=null,t=e.createContext(s),c=t.Consumer,i=r=>{const{navigate:o,children:u}=r,n=e.useMemo(()=>({navigate:o}),[o]);return e.createElement(t.Provider,{value:n},u)},l=()=>e.useContext(t);exports.RouterConsumer=c;exports.RouterProvider=i;exports.useRouter=l;
+//# sourceMappingURL=RouterContext.cjs.map

package/dist/context/RouterContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterContext.cjs","sources":["../../src/context/RouterContext.ts"],"sourcesContent":["'use client';\n\nimport { type ReactNode, createContext, createElement, useContext, useMemo } from 'react';\n\n/** Return value is ignored by Spirit; typed as `unknown` so framework navigators (e.g. Next.js `push` → `Promise<boolean>`) stay assignable without wrappers. */\ntype RouterNavigate = (path: string, routerOptions?: Record<string, unknown>) => unknown;\n\ntype RouterContextType = {\n  navigate: RouterNavigate;\n} | null;\n\ntype RouterProviderProps = {\n  navigate: RouterNavigate;\n  children: ReactNode;\n};\n\nconst defaultContext: RouterContextType = null;\n\nconst RouterContext = createContext<RouterContextType>(defaultContext);\nconst RouterConsumer = RouterContext.Consumer;\n\n/**\n * Wraps part of the app so Spirit link-like components (`Link`, `ButtonLink`, …) can call\n * `navigate` on internal clicks instead of a full page load.\n *\n * Pass your app’s navigation function as `navigate` (path plus optional options as a second argument;\n * e.g. Next.js App Router `router.push`; Pages Router often needs a thin wrapper—see package README).\n *\n * @param props Provider props.\n * @param props.navigate Invoked from link components on qualifying internal navigations (after `preventDefault` when intercepting).\n * @param props.children Subtree that should be wrapped; descendants may call {@link useRouter}.\n */\nconst RouterProvider = (props: RouterProviderProps): JSX.Element => {\n  const { navigate, children } = props;\n  const value = useMemo(() => ({ navigate }), [navigate]);\n\n  return createElement(RouterContext.Provider, { value }, children);\n};\n\n/** Returns the router value from the nearest `RouterProvider`, or `null` when missing. */\nconst useRouter = (): RouterContextType => useContext(RouterContext);\n\nexport default RouterContext;\nexport { RouterConsumer, RouterProvider, useRouter };\nexport type { RouterContextType, RouterNavigate, RouterProviderProps };\n"],"names":["defaultContext","RouterContext","createContext","RouterConsumer","RouterProvider","props","navigate","children","value","useMemo","createElement","useRouter","useContext"],"mappings":"sHAgBMA,EAAoC,KAEpCC,EAAgBC,EAAAA,cAAiCF,CAAc,EAC/DG,EAAiBF,EAAc,SAa/BG,EAAkBC,GAA4C,CAClE,KAAM,CAAE,SAAAC,EAAU,SAAAC,CAAA,EAAaF,EACzBG,EAAQC,EAAAA,QAAQ,KAAO,CAAE,SAAAH,IAAa,CAACA,CAAQ,CAAC,EAEtD,OAAOI,EAAAA,cAAcT,EAAc,SAAU,CAAE,MAAAO,CAAA,EAASD,CAAQ,CAClE,EAGMI,EAAY,IAAyBC,EAAAA,WAAWX,CAAa"}

package/dist/context/RouterContext.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+type RouterNavigate = (path: string, routerOptions?: Record<string, unknown>) => unknown;
+type RouterContextType = {
+    navigate: RouterNavigate;
+} | null;
+type RouterProviderProps = {
+    navigate: RouterNavigate;
+    children: ReactNode;
+};
+declare const RouterContext: React.Context<RouterContextType>;
+declare const RouterConsumer: React.Consumer<RouterContextType>;
+declare const RouterProvider: (props: RouterProviderProps) => JSX.Element;
+declare const useRouter: () => RouterContextType;
+export default RouterContext;
+export { RouterConsumer, RouterProvider, useRouter };
+export type { RouterContextType, RouterNavigate, RouterProviderProps };

package/dist/context/RouterContext.js

@@ -0,0 +1,12 @@
+"use client";
+import { createContext as s, useMemo as u, createElement as c, useContext as i } from "react";
+const l = null, e = s(l), m = e.Consumer, C = (o) => {
+  const { navigate: t, children: n } = o, r = u(() => ({ navigate: t }), [t]);
+  return c(e.Provider, { value: r }, n);
+}, x = () => i(e);
+export {
+  m as RouterConsumer,
+  C as RouterProvider,
+  x as useRouter
+};
+//# sourceMappingURL=RouterContext.js.map

package/dist/context/RouterContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterContext.js","sources":["../../src/context/RouterContext.ts"],"sourcesContent":["'use client';\n\nimport { type ReactNode, createContext, createElement, useContext, useMemo } from 'react';\n\n/** Return value is ignored by Spirit; typed as `unknown` so framework navigators (e.g. Next.js `push` → `Promise<boolean>`) stay assignable without wrappers. */\ntype RouterNavigate = (path: string, routerOptions?: Record<string, unknown>) => unknown;\n\ntype RouterContextType = {\n  navigate: RouterNavigate;\n} | null;\n\ntype RouterProviderProps = {\n  navigate: RouterNavigate;\n  children: ReactNode;\n};\n\nconst defaultContext: RouterContextType = null;\n\nconst RouterContext = createContext<RouterContextType>(defaultContext);\nconst RouterConsumer = RouterContext.Consumer;\n\n/**\n * Wraps part of the app so Spirit link-like components (`Link`, `ButtonLink`, …) can call\n * `navigate` on internal clicks instead of a full page load.\n *\n * Pass your app’s navigation function as `navigate` (path plus optional options as a second argument;\n * e.g. Next.js App Router `router.push`; Pages Router often needs a thin wrapper—see package README).\n *\n * @param props Provider props.\n * @param props.navigate Invoked from link components on qualifying internal navigations (after `preventDefault` when intercepting).\n * @param props.children Subtree that should be wrapped; descendants may call {@link useRouter}.\n */\nconst RouterProvider = (props: RouterProviderProps): JSX.Element => {\n  const { navigate, children } = props;\n  const value = useMemo(() => ({ navigate }), [navigate]);\n\n  return createElement(RouterContext.Provider, { value }, children);\n};\n\n/** Returns the router value from the nearest `RouterProvider`, or `null` when missing. */\nconst useRouter = (): RouterContextType => useContext(RouterContext);\n\nexport default RouterContext;\nexport { RouterConsumer, RouterProvider, useRouter };\nexport type { RouterContextType, RouterNavigate, RouterProviderProps };\n"],"names":["defaultContext","RouterContext","createContext","RouterConsumer","RouterProvider","props","navigate","children","value","useMemo","createElement","useRouter","useContext"],"mappings":";;AAgBA,MAAMA,IAAoC,MAEpCC,IAAgBC,EAAiCF,CAAc,GAC/DG,IAAiBF,EAAc,UAa/BG,IAAiB,CAACC,MAA4C;AAClE,QAAM,EAAE,UAAAC,GAAU,UAAAC,EAAA,IAAaF,GACzBG,IAAQC,EAAQ,OAAO,EAAE,UAAAH,MAAa,CAACA,CAAQ,CAAC;AAEtD,SAAOI,EAAcT,EAAc,UAAU,EAAE,OAAAO,EAAA,GAASD,CAAQ;AAClE,GAGMI,IAAY,MAAyBC,EAAWX,CAAa;"}

package/dist/context/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./ClassNamePrefixContext.cjs"),s=require("./IconsContext.cjs"),e=require("./PropsContext.cjs");exports.ClassNamePrefixConsumer=r.ClassNamePrefixConsumer;exports.ClassNamePrefixProvider=r.ClassNamePrefixProvider;exports.IconsConsumer=s.IconsConsumer;exports.IconsProvider=s.IconsProvider;exports.PropsConsumer=e.PropsConsumer;exports.PropsProvider=e.PropsProvider;exports.useContextProps=e.useContextProps;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./ClassNamePrefixContext.cjs"),s=require("./IconsContext.cjs"),e=require("./PropsContext.cjs"),r=require("./RouterContext.cjs");exports.ClassNamePrefixConsumer=o.ClassNamePrefixConsumer;exports.ClassNamePrefixProvider=o.ClassNamePrefixProvider;exports.IconsConsumer=s.IconsConsumer;exports.IconsProvider=s.IconsProvider;exports.PropsConsumer=e.PropsConsumer;exports.PropsProvider=e.PropsProvider;exports.useContextProps=e.useContextProps;exports.RouterConsumer=r.RouterConsumer;exports.RouterProvider=r.RouterProvider;exports.useRouter=r.useRouter;
 //# sourceMappingURL=index.cjs.map

package/dist/context/index.d.ts

@@ -1,3 +1,4 @@
 export * from './ClassNamePrefixContext';
 export * from './IconsContext';
 export * from './PropsContext';
+export * from './RouterContext';

package/dist/context/index.js

@@ -1,13 +1,17 @@
 import { ClassNamePrefixConsumer as e, ClassNamePrefixProvider as s } from "./ClassNamePrefixContext.js";
-import { IconsConsumer as P, IconsProvider as t } from "./IconsContext.js";
-import { PropsConsumer as n, PropsProvider as p, useContextProps as x } from "./PropsContext.js";
+import { IconsConsumer as m, IconsProvider as u } from "./IconsContext.js";
+import { PropsConsumer as i, PropsProvider as n, useContextProps as p } from "./PropsContext.js";
+import { RouterConsumer as C, RouterProvider as f, useRouter as a } from "./RouterContext.js";
 export {
   e as ClassNamePrefixConsumer,
   s as ClassNamePrefixProvider,
-  P as IconsConsumer,
-  t as IconsProvider,
-  n as PropsConsumer,
-  p as PropsProvider,
-  x as useContextProps
+  m as IconsConsumer,
+  u as IconsProvider,
+  i as PropsConsumer,
+  n as PropsProvider,
+  C as RouterConsumer,
+  f as RouterProvider,
+  p as useContextProps,
+  a as useRouter
 };
 //# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/hooks/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./styleProps.cjs"),s=require("./useAlignmentClass.cjs"),u=require("./useAriaDescribedBy.cjs"),r=require("./useCancelEvent.cjs"),t=require("./useClassNamePrefix.cjs"),i=require("./useClick.cjs"),o=require("./useClickOutside.cjs"),n=require("./useDeprecationMessage.cjs"),c=require("./useDimensionStyle.cjs"),l=require("./useDragAndDrop.cjs"),a=require("./useI18n.cjs"),C=require("./useIcon.cjs"),y=require("./useIconName.cjs"),m=require("./useInputPositionClass.cjs"),p=require("./useIsomorphicLayoutEffect.cjs"),q=require("./useLastActiveFocus.cjs"),g=require("./useResizeObserver.cjs"),S=require("./useScrollControl.cjs"),D=require("./useSpacingStyle.cjs"),I=require("./useSymmetry.cjs"),A=require("./useToggle.cjs"),d=require("./useWrapClass.cjs");exports.useStyleProps=e.useStyleProps;exports.useAlignmentClass=s.useAlignmentClass;exports.useAriaDescribedBy=u.useAriaDescribedBy;exports.useCancelEvent=r.useCancelEvent;exports.useClassNamePrefix=t.useClassNamePrefix;exports.useClick=i.useClick;exports.useClickOutside=o.useClickOutside;exports.useDeprecationMessage=n.useDeprecationMessage;exports.useDimensionStyle=c.useDimensionStyle;exports.useDragAndDrop=l.useDragAndDrop;exports.useI18n=a.useI18n;exports.useIcon=C.useIcon;exports.useIconName=y.useIconName;exports.useInputPositionClass=m.useInputPositionClass;exports.useIsomorphicLayoutEffect=p.useIsomorphicLayoutEffect;exports.useLastActiveFocus=q.useLastActiveFocus;exports.useResizeObserver=g.useResizeObserver;exports.useScrollControl=S.useScrollControl;exports.useSpacingStyle=D.useSpacingStyle;exports.useSymmetry=I.useSymmetry;exports.useToggle=A.useToggle;exports.useWrapClass=d.useWrapClass;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("./styleProps.cjs"),r=require("./useAlignmentClass.cjs"),s=require("./useAriaIdRefs.cjs"),t=require("./useCancelEvent.cjs"),i=require("./useClassNamePrefix.cjs"),o=require("./useClick.cjs"),n=require("./useClickOutside.cjs"),c=require("./useControlledModeGuard.cjs"),l=require("./useDebouncedValue.cjs"),a=require("./useDeprecationMessage.cjs"),d=require("./useDimensionStyle.cjs"),S=require("./useDragAndDrop.cjs"),g=require("./useI18n.cjs"),C=require("./useIcon.cjs"),y=require("./useIconName.cjs"),q=require("./useInputPositionClass.cjs"),m=require("./useIsomorphicLayoutEffect.cjs"),p=require("./useLastActiveFocus.cjs"),D=require("./useLinkClick.cjs"),I=require("./useResizeObserver.cjs"),A=require("./useScrollControl.cjs"),e=require("./useSelectionState.cjs"),f=require("./useSpacingStyle.cjs"),k=require("./useSymmetry.cjs"),b=require("./useToggle.cjs"),v=require("./useWrapClass.cjs");exports.useStyleProps=u.useStyleProps;exports.useAlignmentClass=r.useAlignmentClass;exports.useAriaDescribedBy=s.useAriaDescribedBy;exports.useAriaDetails=s.useAriaDetails;exports.useAriaIdRefs=s.useAriaIdRefs;exports.useCancelEvent=t.useCancelEvent;exports.useClassNamePrefix=i.useClassNamePrefix;exports.useClick=o.useClick;exports.useClickOutside=n.useClickOutside;exports.useControlledModeGuard=c.useControlledModeGuard;exports.useDebouncedValue=l.useDebouncedValue;exports.useDeprecationMessage=a.useDeprecationMessage;exports.useDimensionStyle=d.useDimensionStyle;exports.useDragAndDrop=S.useDragAndDrop;exports.useI18n=g.useI18n;exports.useIcon=C.useIcon;exports.useIconName=y.useIconName;exports.useInputPositionClass=q.useInputPositionClass;exports.useIsomorphicLayoutEffect=m.useIsomorphicLayoutEffect;exports.useLastActiveFocus=p.useLastActiveFocus;exports.useLinkClick=D.useLinkClick;exports.useResizeObserver=I.useResizeObserver;exports.useScrollControl=A.useScrollControl;exports.getSelectedKeys=e.getSelectedKeys;exports.getToggledSelectedKeys=e.getToggledSelectedKeys;exports.isKeySelected=e.isKeySelected;exports.isSingleSelectionMode=e.isSingleSelectionMode;exports.useSelectionState=e.useSelectionState;exports.useSpacingStyle=f.useSpacingStyle;exports.useSymmetry=k.useSymmetry;exports.useToggle=b.useToggle;exports.useWrapClass=v.useWrapClass;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/index.d.ts

@@ -1,10 +1,12 @@
 export * from './styleProps';
 export * from './useAlignmentClass';
-export * from './useAriaDescribedBy';
+export * from './useAriaIdRefs';
 export * from './useCancelEvent';
 export * from './useClassNamePrefix';
 export * from './useClick';
 export * from './useClickOutside';
+export * from './useControlledModeGuard';
+export * from './useDebouncedValue';
 export * from './useDeprecationMessage';
 export * from './useDimensionStyle';
 export * from './useDragAndDrop';
@@ -14,8 +16,10 @@ export * from './useIconName';
 export * from './useInputPositionClass';
 export * from './useIsomorphicLayoutEffect';
 export * from './useLastActiveFocus';
+export * from './useLinkClick';
 export * from './useResizeObserver';
 export * from './useScrollControl';
+export * from './useSelectionState';
 export * from './useSpacingStyle';
 export * from './useSymmetry';
 export * from './useToggle';

package/dist/hooks/index.js

@@ -1,47 +1,61 @@
 import { useStyleProps as r } from "./styleProps.js";
 import { useAlignmentClass as t } from "./useAlignmentClass.js";
-import { useAriaDescribedBy as p } from "./useAriaDescribedBy.js";
-import { useCancelEvent as f } from "./useCancelEvent.js";
-import { useClassNamePrefix as i } from "./useClassNamePrefix.js";
-import { useClick as l } from "./useClick.js";
-import { useClickOutside as c } from "./useClickOutside.js";
-import { useDeprecationMessage as y } from "./useDeprecationMessage.js";
-import { useDimensionStyle as S } from "./useDimensionStyle.js";
-import { useDragAndDrop as I } from "./useDragAndDrop.js";
-import { useI18n as d } from "./useI18n.js";
-import { useIcon as P } from "./useIcon.js";
-import { useIconName as k } from "./useIconName.js";
-import { useInputPositionClass as L } from "./useInputPositionClass.js";
-import { useIsomorphicLayoutEffect as O } from "./useIsomorphicLayoutEffect.js";
-import { useLastActiveFocus as z } from "./useLastActiveFocus.js";
-import { useResizeObserver as F } from "./useResizeObserver.js";
-import { useScrollControl as R } from "./useScrollControl.js";
-import { useSpacingStyle as W } from "./useSpacingStyle.js";
-import { useSymmetry as q } from "./useSymmetry.js";
-import { useToggle as G } from "./useToggle.js";
-import { useWrapClass as J } from "./useWrapClass.js";
+import { useAriaDescribedBy as m, useAriaDetails as p, useAriaIdRefs as f } from "./useAriaIdRefs.js";
+import { useCancelEvent as l } from "./useCancelEvent.js";
+import { useClassNamePrefix as a } from "./useClassNamePrefix.js";
+import { useClick as n } from "./useClick.js";
+import { useClickOutside as S } from "./useClickOutside.js";
+import { useControlledModeGuard as y } from "./useControlledModeGuard.js";
+import { useDebouncedValue as D } from "./useDebouncedValue.js";
+import { useDeprecationMessage as I } from "./useDeprecationMessage.js";
+import { useDimensionStyle as b } from "./useDimensionStyle.js";
+import { useDragAndDrop as K } from "./useDragAndDrop.js";
+import { useI18n as M } from "./useI18n.js";
+import { useIcon as E } from "./useIcon.js";
+import { useIconName as O } from "./useIconName.js";
+import { useInputPositionClass as T } from "./useInputPositionClass.js";
+import { useIsomorphicLayoutEffect as z } from "./useIsomorphicLayoutEffect.js";
+import { useLastActiveFocus as F } from "./useLastActiveFocus.js";
+import { useLinkClick as V } from "./useLinkClick.js";
+import { useResizeObserver as j } from "./useResizeObserver.js";
+import { useScrollControl as w } from "./useScrollControl.js";
+import { getSelectedKeys as J, getToggledSelectedKeys as Q, isKeySelected as U, isSingleSelectionMode as X, useSelectionState as Y } from "./useSelectionState.js";
+import { useSpacingStyle as _ } from "./useSpacingStyle.js";
+import { useSymmetry as ee } from "./useSymmetry.js";
+import { useToggle as re } from "./useToggle.js";
+import { useWrapClass as te } from "./useWrapClass.js";
 export {
+  J as getSelectedKeys,
+  Q as getToggledSelectedKeys,
+  U as isKeySelected,
+  X as isSingleSelectionMode,
   t as useAlignmentClass,
-  p as useAriaDescribedBy,
-  f as useCancelEvent,
-  i as useClassNamePrefix,
-  l as useClick,
-  c as useClickOutside,
-  y as useDeprecationMessage,
-  S as useDimensionStyle,
-  I as useDragAndDrop,
-  d as useI18n,
-  P as useIcon,
-  k as useIconName,
-  L as useInputPositionClass,
-  O as useIsomorphicLayoutEffect,
-  z as useLastActiveFocus,
-  F as useResizeObserver,
-  R as useScrollControl,
-  W as useSpacingStyle,
+  m as useAriaDescribedBy,
+  p as useAriaDetails,
+  f as useAriaIdRefs,
+  l as useCancelEvent,
+  a as useClassNamePrefix,
+  n as useClick,
+  S as useClickOutside,
+  y as useControlledModeGuard,
+  D as useDebouncedValue,
+  I as useDeprecationMessage,
+  b as useDimensionStyle,
+  K as useDragAndDrop,
+  M as useI18n,
+  E as useIcon,
+  O as useIconName,
+  T as useInputPositionClass,
+  z as useIsomorphicLayoutEffect,
+  F as useLastActiveFocus,
+  V as useLinkClick,
+  j as useResizeObserver,
+  w as useScrollControl,
+  Y as useSelectionState,
+  _ as useSpacingStyle,
   r as useStyleProps,
-  q as useSymmetry,
-  G as useToggle,
-  J as useWrapClass
+  ee as useSymmetry,
+  re as useToggle,
+  te as useWrapClass
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/hooks/useAriaIdRefs.cjs

@@ -0,0 +1,2 @@
+"use strict";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("react");function a(e,n){const[t,u]=i.useState(()=>{if(!n)return[];const r=n.trim().split(/\s+/).filter(Boolean);return Array.from(new Set(r))}),l=i.useCallback(({add:r,remove:o})=>{u(c=>{const s=new Set(c),d=s.size;return o&&s.delete(o),r&&s.add(r),s.size!==d?Array.from(s):c})},[]);return[i.useMemo(()=>t.length>0?{[e]:t.join(" ")}:{},[t,e]),l]}const f=e=>a("aria-describedby",e),y=e=>a("aria-details",e);exports.useAriaDescribedBy=f;exports.useAriaDetails=y;exports.useAriaIdRefs=a;
+//# sourceMappingURL=useAriaIdRefs.cjs.map

package/dist/hooks/useAriaIdRefs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAriaIdRefs.cjs","sources":["../../src/hooks/useAriaIdRefs.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useMemo, useState } from 'react';\n\ntype AriaIdRefAttribute = 'aria-describedby' | 'aria-details';\n\nexport type RegisterParams = { add?: string; remove?: string };\nexport type RegisterType = (params: RegisterParams) => void;\nexport type AriaIdRefsReturn = [Partial<Record<AriaIdRefAttribute, string>>, RegisterType];\n\nexport function useAriaIdRefs(ariaAttribute: AriaIdRefAttribute, initialIds?: string): AriaIdRefsReturn {\n  const [ids, setIds] = useState<string[]>(() => {\n    if (!initialIds) {\n      return [];\n    }\n\n    const parsed = initialIds.trim().split(/\\s+/).filter(Boolean);\n\n    return Array.from(new Set(parsed));\n  });\n\n  const register = useCallback(({ add, remove }: RegisterParams) => {\n    setIds((prevIds) => {\n      const idsSet = new Set(prevIds);\n      const initialSize = idsSet.size;\n\n      if (remove) {\n        idsSet.delete(remove);\n      }\n\n      if (add) {\n        idsSet.add(add);\n      }\n\n      return idsSet.size !== initialSize ? Array.from(idsSet) : prevIds;\n    });\n  }, []);\n\n  const ariaProps = useMemo(() => (ids.length > 0 ? { [ariaAttribute]: ids.join(' ') } : {}), [ids, ariaAttribute]);\n\n  return [ariaProps, register];\n}\n\nexport const useAriaDescribedBy = (initialIds?: string): AriaIdRefsReturn =>\n  useAriaIdRefs('aria-describedby', initialIds);\n\nexport const useAriaDetails = (initialIds?: string): AriaIdRefsReturn => useAriaIdRefs('aria-details', initialIds);\n\nexport default useAriaIdRefs;\n"],"names":["useAriaIdRefs","ariaAttribute","initialIds","ids","setIds","useState","parsed","register","useCallback","add","remove","prevIds","idsSet","initialSize","useMemo","useAriaDescribedBy","useAriaDetails"],"mappings":"sHAUO,SAASA,EAAcC,EAAmCC,EAAuC,CACtG,KAAM,CAACC,EAAKC,CAAM,EAAIC,EAAAA,SAAmB,IAAM,CAC7C,GAAI,CAACH,EACH,MAAO,CAAA,EAGT,MAAMI,EAASJ,EAAW,KAAA,EAAO,MAAM,KAAK,EAAE,OAAO,OAAO,EAE5D,OAAO,MAAM,KAAK,IAAI,IAAII,CAAM,CAAC,CACnC,CAAC,EAEKC,EAAWC,EAAAA,YAAY,CAAC,CAAE,IAAAC,EAAK,OAAAC,KAA6B,CAChEN,EAAQO,GAAY,CAClB,MAAMC,EAAS,IAAI,IAAID,CAAO,EACxBE,EAAcD,EAAO,KAE3B,OAAIF,GACFE,EAAO,OAAOF,CAAM,EAGlBD,GACFG,EAAO,IAAIH,CAAG,EAGTG,EAAO,OAASC,EAAc,MAAM,KAAKD,CAAM,EAAID,CAC5D,CAAC,CACH,EAAG,CAAA,CAAE,EAIL,MAAO,CAFWG,EAAAA,QAAQ,IAAOX,EAAI,OAAS,EAAI,CAAE,CAACF,CAAa,EAAGE,EAAI,KAAK,GAAG,GAAM,CAAA,EAAK,CAACA,EAAKF,CAAa,CAAC,EAE7FM,CAAQ,CAC7B,CAEO,MAAMQ,EAAsBb,GACjCF,EAAc,mBAAoBE,CAAU,EAEjCc,EAAkBd,GAA0CF,EAAc,eAAgBE,CAAU"}

package/dist/hooks/useAriaIdRefs.d.ts

@@ -0,0 +1,11 @@
+type AriaIdRefAttribute = 'aria-describedby' | 'aria-details';
+export type RegisterParams = {
+    add?: string;
+    remove?: string;
+};
+export type RegisterType = (params: RegisterParams) => void;
+export type AriaIdRefsReturn = [Partial<Record<AriaIdRefAttribute, string>>, RegisterType];
+export declare function useAriaIdRefs(ariaAttribute: AriaIdRefAttribute, initialIds?: string): AriaIdRefsReturn;
+export declare const useAriaDescribedBy: (initialIds?: string) => AriaIdRefsReturn;
+export declare const useAriaDetails: (initialIds?: string) => AriaIdRefsReturn;
+export default useAriaIdRefs;

package/dist/hooks/useAriaIdRefs.js

@@ -0,0 +1,23 @@
+"use client";
+import { useState as f, useCallback as d, useMemo as m } from "react";
+function a(e, i) {
+  const [t, c] = f(() => {
+    if (!i)
+      return [];
+    const r = i.trim().split(/\s+/).filter(Boolean);
+    return Array.from(new Set(r));
+  }), u = d(({ add: r, remove: n }) => {
+    c((o) => {
+      const s = new Set(o), l = s.size;
+      return n && s.delete(n), r && s.add(r), s.size !== l ? Array.from(s) : o;
+    });
+  }, []);
+  return [m(() => t.length > 0 ? { [e]: t.join(" ") } : {}, [t, e]), u];
+}
+const y = (e) => a("aria-describedby", e), A = (e) => a("aria-details", e);
+export {
+  y as useAriaDescribedBy,
+  A as useAriaDetails,
+  a as useAriaIdRefs
+};
+//# sourceMappingURL=useAriaIdRefs.js.map

package/dist/hooks/useAriaIdRefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAriaIdRefs.js","sources":["../../src/hooks/useAriaIdRefs.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useMemo, useState } from 'react';\n\ntype AriaIdRefAttribute = 'aria-describedby' | 'aria-details';\n\nexport type RegisterParams = { add?: string; remove?: string };\nexport type RegisterType = (params: RegisterParams) => void;\nexport type AriaIdRefsReturn = [Partial<Record<AriaIdRefAttribute, string>>, RegisterType];\n\nexport function useAriaIdRefs(ariaAttribute: AriaIdRefAttribute, initialIds?: string): AriaIdRefsReturn {\n  const [ids, setIds] = useState<string[]>(() => {\n    if (!initialIds) {\n      return [];\n    }\n\n    const parsed = initialIds.trim().split(/\\s+/).filter(Boolean);\n\n    return Array.from(new Set(parsed));\n  });\n\n  const register = useCallback(({ add, remove }: RegisterParams) => {\n    setIds((prevIds) => {\n      const idsSet = new Set(prevIds);\n      const initialSize = idsSet.size;\n\n      if (remove) {\n        idsSet.delete(remove);\n      }\n\n      if (add) {\n        idsSet.add(add);\n      }\n\n      return idsSet.size !== initialSize ? Array.from(idsSet) : prevIds;\n    });\n  }, []);\n\n  const ariaProps = useMemo(() => (ids.length > 0 ? { [ariaAttribute]: ids.join(' ') } : {}), [ids, ariaAttribute]);\n\n  return [ariaProps, register];\n}\n\nexport const useAriaDescribedBy = (initialIds?: string): AriaIdRefsReturn =>\n  useAriaIdRefs('aria-describedby', initialIds);\n\nexport const useAriaDetails = (initialIds?: string): AriaIdRefsReturn => useAriaIdRefs('aria-details', initialIds);\n\nexport default useAriaIdRefs;\n"],"names":["useAriaIdRefs","ariaAttribute","initialIds","ids","setIds","useState","parsed","register","useCallback","add","remove","prevIds","idsSet","initialSize","useMemo","useAriaDescribedBy","useAriaDetails"],"mappings":";;AAUO,SAASA,EAAcC,GAAmCC,GAAuC;AACtG,QAAM,CAACC,GAAKC,CAAM,IAAIC,EAAmB,MAAM;AAC7C,QAAI,CAACH;AACH,aAAO,CAAA;AAGT,UAAMI,IAASJ,EAAW,KAAA,EAAO,MAAM,KAAK,EAAE,OAAO,OAAO;AAE5D,WAAO,MAAM,KAAK,IAAI,IAAII,CAAM,CAAC;AAAA,EACnC,CAAC,GAEKC,IAAWC,EAAY,CAAC,EAAE,KAAAC,GAAK,QAAAC,QAA6B;AAChE,IAAAN,EAAO,CAACO,MAAY;AAClB,YAAMC,IAAS,IAAI,IAAID,CAAO,GACxBE,IAAcD,EAAO;AAE3B,aAAIF,KACFE,EAAO,OAAOF,CAAM,GAGlBD,KACFG,EAAO,IAAIH,CAAG,GAGTG,EAAO,SAASC,IAAc,MAAM,KAAKD,CAAM,IAAID;AAAA,IAC5D,CAAC;AAAA,EACH,GAAG,CAAA,CAAE;AAIL,SAAO,CAFWG,EAAQ,MAAOX,EAAI,SAAS,IAAI,EAAE,CAACF,CAAa,GAAGE,EAAI,KAAK,GAAG,MAAM,CAAA,GAAK,CAACA,GAAKF,CAAa,CAAC,GAE7FM,CAAQ;AAC7B;AAEO,MAAMQ,IAAqB,CAACb,MACjCF,EAAc,oBAAoBE,CAAU,GAEjCc,IAAiB,CAACd,MAA0CF,EAAc,gBAAgBE,CAAU;"}

package/dist/hooks/useControlledModeGuard.cjs

@@ -0,0 +1,2 @@
+"use strict";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react"),i=require("../common/utilities/warning.cjs"),v=f=>{const{value:u,defaultValue:l,componentName:t,valuePropName:e="value",defaultValuePropName:d="defaultValue",bothDefinedMessage:s,modeSwitchMessage:a}=f,o=u!==void 0,n=r.useRef(void 0),c=r.useRef(!1);r.useEffect(()=>{u!==void 0&&l!==void 0&&!c.current&&(c.current=!0,i.default(!1,s??`${t}: \`${e}\` and \`${d}\` cannot both be set. Use either controlled (\`${e}\`) or uncontrolled (\`${d}\`) mode.`))},[s,t,l,d,u,e]),r.useEffect(()=>{if(n.current===void 0){n.current=o;return}n.current!==o&&i.default(!1,a??`${t}: Do not switch between controlled (\`${e}\` defined) and uncontrolled (\`${e}\` undefined) modes across renders.`),n.current=o},[t,o,a,e])};exports.useControlledModeGuard=v;
+//# sourceMappingURL=useControlledModeGuard.cjs.map

package/dist/hooks/useControlledModeGuard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControlledModeGuard.cjs","sources":["../../src/hooks/useControlledModeGuard.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef } from 'react';\nimport { warning } from '../common/utilities';\n\nexport interface UseControlledModeGuardProps<T> {\n  value?: T;\n  defaultValue?: T;\n  componentName: string;\n  valuePropName?: string;\n  defaultValuePropName?: string;\n  bothDefinedMessage?: string;\n  modeSwitchMessage?: string;\n}\n\n/**\n * Dev-only guard for controlled/uncontrolled APIs (`value` + `defaultValue`).\n * Warns when both props are set and when mode switches across renders.\n *\n * @param props - Guard configuration for controlled/uncontrolled checks.\n * @param props.value - Controlled value.\n * @param props.defaultValue - Uncontrolled initial value.\n * @param props.componentName - Name used in warning messages.\n * @param props.valuePropName - Optional controlled prop label for warning text.\n * @param props.defaultValuePropName - Optional uncontrolled prop label for warning text.\n * @param props.bothDefinedMessage - Optional custom warning when both value and defaultValue are set.\n * @param props.modeSwitchMessage - Optional custom warning when controlled mode changes across renders.\n */\nexport const useControlledModeGuard = <T>(props: UseControlledModeGuardProps<T>): void => {\n  const {\n    value,\n    defaultValue,\n    componentName,\n    valuePropName = 'value',\n    defaultValuePropName = 'defaultValue',\n    bothDefinedMessage,\n    modeSwitchMessage,\n  } = props;\n  const isControlled = value !== undefined;\n  const isControlledRef = useRef<boolean | undefined>(undefined);\n  const didWarnBothValueAndDefaultRef = useRef(false);\n\n  useEffect(() => {\n    if (value !== undefined && defaultValue !== undefined && !didWarnBothValueAndDefaultRef.current) {\n      didWarnBothValueAndDefaultRef.current = true;\n\n      warning(\n        false,\n        bothDefinedMessage ??\n          `${componentName}: \\`${valuePropName}\\` and \\`${defaultValuePropName}\\` cannot both be set. Use either controlled (\\`${valuePropName}\\`) or uncontrolled (\\`${defaultValuePropName}\\`) mode.`,\n      );\n    }\n  }, [bothDefinedMessage, componentName, defaultValue, defaultValuePropName, value, valuePropName]);\n\n  useEffect(() => {\n    if (isControlledRef.current === undefined) {\n      isControlledRef.current = isControlled;\n\n      return;\n    }\n\n    if (isControlledRef.current !== isControlled) {\n      warning(\n        false,\n        modeSwitchMessage ??\n          `${componentName}: Do not switch between controlled (\\`${valuePropName}\\` defined) and uncontrolled (\\`${valuePropName}\\` undefined) modes across renders.`,\n      );\n    }\n\n    isControlledRef.current = isControlled;\n  }, [componentName, isControlled, modeSwitchMessage, valuePropName]);\n};\n"],"names":["useControlledModeGuard","props","value","defaultValue","componentName","valuePropName","defaultValuePropName","bothDefinedMessage","modeSwitchMessage","isControlled","isControlledRef","useRef","didWarnBothValueAndDefaultRef","useEffect","warning"],"mappings":"mKA4BaA,EAA6BC,GAAgD,CACxF,KAAM,CACJ,MAAAC,EACA,aAAAC,EACA,cAAAC,EACA,cAAAC,EAAgB,QAChB,qBAAAC,EAAuB,eACvB,mBAAAC,EACA,kBAAAC,CAAA,EACEP,EACEQ,EAAeP,IAAU,OACzBQ,EAAkBC,EAAAA,OAA4B,MAAS,EACvDC,EAAgCD,EAAAA,OAAO,EAAK,EAElDE,EAAAA,UAAU,IAAM,CACVX,IAAU,QAAaC,IAAiB,QAAa,CAACS,EAA8B,UACtFA,EAA8B,QAAU,GAExCE,EAAAA,QACE,GACAP,GACE,GAAGH,CAAa,OAAOC,CAAa,YAAYC,CAAoB,mDAAmDD,CAAa,0BAA0BC,CAAoB,WAAA,EAG1L,EAAG,CAACC,EAAoBH,EAAeD,EAAcG,EAAsBJ,EAAOG,CAAa,CAAC,EAEhGQ,EAAAA,UAAU,IAAM,CACd,GAAIH,EAAgB,UAAY,OAAW,CACzCA,EAAgB,QAAUD,EAE1B,MACF,CAEIC,EAAgB,UAAYD,GAC9BK,EAAAA,QACE,GACAN,GACE,GAAGJ,CAAa,yCAAyCC,CAAa,mCAAmCA,CAAa,qCAAA,EAI5HK,EAAgB,QAAUD,CAC5B,EAAG,CAACL,EAAeK,EAAcD,EAAmBH,CAAa,CAAC,CACpE"}

package/dist/hooks/useControlledModeGuard.d.ts

@@ -0,0 +1,10 @@
+export interface UseControlledModeGuardProps<T> {
+    value?: T;
+    defaultValue?: T;
+    componentName: string;
+    valuePropName?: string;
+    defaultValuePropName?: string;
+    bothDefinedMessage?: string;
+    modeSwitchMessage?: string;
+}
+export declare const useControlledModeGuard: <T>(props: UseControlledModeGuardProps<T>) => void;

package/dist/hooks/useControlledModeGuard.js

@@ -0,0 +1,33 @@
+"use client";
+import { useRef as c, useEffect as i } from "react";
+import f from "../common/utilities/warning.js";
+const h = (m) => {
+  const {
+    value: r,
+    defaultValue: l,
+    componentName: o,
+    valuePropName: e = "value",
+    defaultValuePropName: d = "defaultValue",
+    bothDefinedMessage: u,
+    modeSwitchMessage: s
+  } = m, t = r !== void 0, n = c(void 0), a = c(!1);
+  i(() => {
+    r !== void 0 && l !== void 0 && !a.current && (a.current = !0, f(
+      !1,
+      u ?? `${o}: \`${e}\` and \`${d}\` cannot both be set. Use either controlled (\`${e}\`) or uncontrolled (\`${d}\`) mode.`
+    ));
+  }, [u, o, l, d, r, e]), i(() => {
+    if (n.current === void 0) {
+      n.current = t;
+      return;
+    }
+    n.current !== t && f(
+      !1,
+      s ?? `${o}: Do not switch between controlled (\`${e}\` defined) and uncontrolled (\`${e}\` undefined) modes across renders.`
+    ), n.current = t;
+  }, [o, t, s, e]);
+};
+export {
+  h as useControlledModeGuard
+};
+//# sourceMappingURL=useControlledModeGuard.js.map

package/dist/hooks/useControlledModeGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControlledModeGuard.js","sources":["../../src/hooks/useControlledModeGuard.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef } from 'react';\nimport { warning } from '../common/utilities';\n\nexport interface UseControlledModeGuardProps<T> {\n  value?: T;\n  defaultValue?: T;\n  componentName: string;\n  valuePropName?: string;\n  defaultValuePropName?: string;\n  bothDefinedMessage?: string;\n  modeSwitchMessage?: string;\n}\n\n/**\n * Dev-only guard for controlled/uncontrolled APIs (`value` + `defaultValue`).\n * Warns when both props are set and when mode switches across renders.\n *\n * @param props - Guard configuration for controlled/uncontrolled checks.\n * @param props.value - Controlled value.\n * @param props.defaultValue - Uncontrolled initial value.\n * @param props.componentName - Name used in warning messages.\n * @param props.valuePropName - Optional controlled prop label for warning text.\n * @param props.defaultValuePropName - Optional uncontrolled prop label for warning text.\n * @param props.bothDefinedMessage - Optional custom warning when both value and defaultValue are set.\n * @param props.modeSwitchMessage - Optional custom warning when controlled mode changes across renders.\n */\nexport const useControlledModeGuard = <T>(props: UseControlledModeGuardProps<T>): void => {\n  const {\n    value,\n    defaultValue,\n    componentName,\n    valuePropName = 'value',\n    defaultValuePropName = 'defaultValue',\n    bothDefinedMessage,\n    modeSwitchMessage,\n  } = props;\n  const isControlled = value !== undefined;\n  const isControlledRef = useRef<boolean | undefined>(undefined);\n  const didWarnBothValueAndDefaultRef = useRef(false);\n\n  useEffect(() => {\n    if (value !== undefined && defaultValue !== undefined && !didWarnBothValueAndDefaultRef.current) {\n      didWarnBothValueAndDefaultRef.current = true;\n\n      warning(\n        false,\n        bothDefinedMessage ??\n          `${componentName}: \\`${valuePropName}\\` and \\`${defaultValuePropName}\\` cannot both be set. Use either controlled (\\`${valuePropName}\\`) or uncontrolled (\\`${defaultValuePropName}\\`) mode.`,\n      );\n    }\n  }, [bothDefinedMessage, componentName, defaultValue, defaultValuePropName, value, valuePropName]);\n\n  useEffect(() => {\n    if (isControlledRef.current === undefined) {\n      isControlledRef.current = isControlled;\n\n      return;\n    }\n\n    if (isControlledRef.current !== isControlled) {\n      warning(\n        false,\n        modeSwitchMessage ??\n          `${componentName}: Do not switch between controlled (\\`${valuePropName}\\` defined) and uncontrolled (\\`${valuePropName}\\` undefined) modes across renders.`,\n      );\n    }\n\n    isControlledRef.current = isControlled;\n  }, [componentName, isControlled, modeSwitchMessage, valuePropName]);\n};\n"],"names":["useControlledModeGuard","props","value","defaultValue","componentName","valuePropName","defaultValuePropName","bothDefinedMessage","modeSwitchMessage","isControlled","isControlledRef","useRef","didWarnBothValueAndDefaultRef","useEffect","warning"],"mappings":";;;AA4BO,MAAMA,IAAyB,CAAIC,MAAgD;AACxF,QAAM;AAAA,IACJ,OAAAC;AAAA,IACA,cAAAC;AAAA,IACA,eAAAC;AAAA,IACA,eAAAC,IAAgB;AAAA,IAChB,sBAAAC,IAAuB;AAAA,IACvB,oBAAAC;AAAA,IACA,mBAAAC;AAAA,EAAA,IACEP,GACEQ,IAAeP,MAAU,QACzBQ,IAAkBC,EAA4B,MAAS,GACvDC,IAAgCD,EAAO,EAAK;AAElD,EAAAE,EAAU,MAAM;AACd,IAAIX,MAAU,UAAaC,MAAiB,UAAa,CAACS,EAA8B,YACtFA,EAA8B,UAAU,IAExCE;AAAA,MACE;AAAA,MACAP,KACE,GAAGH,CAAa,OAAOC,CAAa,YAAYC,CAAoB,mDAAmDD,CAAa,0BAA0BC,CAAoB;AAAA,IAAA;AAAA,EAG1L,GAAG,CAACC,GAAoBH,GAAeD,GAAcG,GAAsBJ,GAAOG,CAAa,CAAC,GAEhGQ,EAAU,MAAM;AACd,QAAIH,EAAgB,YAAY,QAAW;AACzC,MAAAA,EAAgB,UAAUD;AAE1B;AAAA,IACF;AAEA,IAAIC,EAAgB,YAAYD,KAC9BK;AAAA,MACE;AAAA,MACAN,KACE,GAAGJ,CAAa,yCAAyCC,CAAa,mCAAmCA,CAAa;AAAA,IAAA,GAI5HK,EAAgB,UAAUD;AAAA,EAC5B,GAAG,CAACL,GAAeK,GAAcD,GAAmBH,CAAa,CAAC;AACpE;"}

package/dist/hooks/useDebouncedValue.cjs

@@ -0,0 +1,2 @@
+"use strict";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),d=require("../utils/debounce.cjs"),i=(u,c)=>{const[o,r]=e.useState(u),n=e.useRef(!0),t=e.useMemo(()=>d.debounce(s=>r(s),c),[c]);return e.useEffect(()=>{if(n.current){n.current=!1;return}return t(u),()=>t.cancel()},[u,t]),o};exports.useDebouncedValue=i;
+//# sourceMappingURL=useDebouncedValue.cjs.map

package/dist/hooks/useDebouncedValue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.cjs","sources":["../../src/hooks/useDebouncedValue.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useMemo, useRef, useState } from 'react';\nimport { debounce } from '../utils';\n\n/**\n * Returns a debounced version of the provided value.\n * The returned value updates only after the specified delay has passed\n * without the input value changing.\n *\n * On the initial call the value is returned immediately (no delay).\n *\n * @param {T} inputValue - The value to debounce.\n * @param {number} delay - Debounce delay in milliseconds.\n * @returns {T} The debounced value.\n */\nexport const useDebouncedValue = <T>(inputValue: T, delay: number): T => {\n  const [debouncedValue, setDebouncedValue] = useState(inputValue);\n  const isInitialMount = useRef(true);\n\n  const debouncedSetValue = useMemo(() => debounce((value: T) => setDebouncedValue(value), delay), [delay]);\n\n  useEffect(() => {\n    if (isInitialMount.current) {\n      isInitialMount.current = false;\n\n      return undefined;\n    }\n\n    debouncedSetValue(inputValue);\n\n    return () => debouncedSetValue.cancel();\n  }, [inputValue, debouncedSetValue]);\n\n  return debouncedValue;\n};\n"],"names":["useDebouncedValue","inputValue","delay","debouncedValue","setDebouncedValue","useState","isInitialMount","useRef","debouncedSetValue","useMemo","debounce","value","useEffect"],"mappings":"yJAgBaA,EAAoB,CAAIC,EAAeC,IAAqB,CACvE,KAAM,CAACC,EAAgBC,CAAiB,EAAIC,EAAAA,SAASJ,CAAU,EACzDK,EAAiBC,EAAAA,OAAO,EAAI,EAE5BC,EAAoBC,EAAAA,QAAQ,IAAMC,EAAAA,SAAUC,GAAaP,EAAkBO,CAAK,EAAGT,CAAK,EAAG,CAACA,CAAK,CAAC,EAExGU,OAAAA,EAAAA,UAAU,IAAM,CACd,GAAIN,EAAe,QAAS,CAC1BA,EAAe,QAAU,GAEzB,MACF,CAEA,OAAAE,EAAkBP,CAAU,EAErB,IAAMO,EAAkB,OAAA,CACjC,EAAG,CAACP,EAAYO,CAAiB,CAAC,EAE3BL,CACT"}

package/dist/hooks/useDebouncedValue.d.ts

@@ -0,0 +1 @@
+export declare const useDebouncedValue: <T>(inputValue: T, delay: number) => T;

package/dist/hooks/useDebouncedValue.js

@@ -0,0 +1,17 @@
+"use client";
+import { useState as s, useRef as d, useMemo as f, useEffect as i } from "react";
+import { debounce as a } from "../utils/debounce.js";
+const m = (e, u) => {
+  const [r, c] = s(e), o = d(!0), t = f(() => a((n) => c(n), u), [u]);
+  return i(() => {
+    if (o.current) {
+      o.current = !1;
+      return;
+    }
+    return t(e), () => t.cancel();
+  }, [e, t]), r;
+};
+export {
+  m as useDebouncedValue
+};
+//# sourceMappingURL=useDebouncedValue.js.map

package/dist/hooks/useDebouncedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.js","sources":["../../src/hooks/useDebouncedValue.ts"],"sourcesContent":["'use client';\n\nimport { useEffect, useMemo, useRef, useState } from 'react';\nimport { debounce } from '../utils';\n\n/**\n * Returns a debounced version of the provided value.\n * The returned value updates only after the specified delay has passed\n * without the input value changing.\n *\n * On the initial call the value is returned immediately (no delay).\n *\n * @param {T} inputValue - The value to debounce.\n * @param {number} delay - Debounce delay in milliseconds.\n * @returns {T} The debounced value.\n */\nexport const useDebouncedValue = <T>(inputValue: T, delay: number): T => {\n  const [debouncedValue, setDebouncedValue] = useState(inputValue);\n  const isInitialMount = useRef(true);\n\n  const debouncedSetValue = useMemo(() => debounce((value: T) => setDebouncedValue(value), delay), [delay]);\n\n  useEffect(() => {\n    if (isInitialMount.current) {\n      isInitialMount.current = false;\n\n      return undefined;\n    }\n\n    debouncedSetValue(inputValue);\n\n    return () => debouncedSetValue.cancel();\n  }, [inputValue, debouncedSetValue]);\n\n  return debouncedValue;\n};\n"],"names":["useDebouncedValue","inputValue","delay","debouncedValue","setDebouncedValue","useState","isInitialMount","useRef","debouncedSetValue","useMemo","debounce","value","useEffect"],"mappings":";;;AAgBO,MAAMA,IAAoB,CAAIC,GAAeC,MAAqB;AACvE,QAAM,CAACC,GAAgBC,CAAiB,IAAIC,EAASJ,CAAU,GACzDK,IAAiBC,EAAO,EAAI,GAE5BC,IAAoBC,EAAQ,MAAMC,EAAS,CAACC,MAAaP,EAAkBO,CAAK,GAAGT,CAAK,GAAG,CAACA,CAAK,CAAC;AAExG,SAAAU,EAAU,MAAM;AACd,QAAIN,EAAe,SAAS;AAC1B,MAAAA,EAAe,UAAU;AAEzB;AAAA,IACF;AAEA,WAAAE,EAAkBP,CAAU,GAErB,MAAMO,EAAkB,OAAA;AAAA,EACjC,GAAG,CAACP,GAAYO,CAAiB,CAAC,GAE3BL;AACT;"}

package/dist/hooks/useLinkClick.cjs

@@ -0,0 +1,2 @@
+"use strict";"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react"),l=require("../context/RouterContext.cjs"),a=require("../utils/router.cjs"),k=s=>{const e=l.useRouter(),{routerOptions:t,href:r,target:o,download:u,onClick:i,isDisabled:n}=s;return c.useMemo(()=>a.handleLinkClick({router:e,routerOptions:t,href:r,target:o,download:u,onClick:i,isDisabled:n}),[e,t,r,o,u,i,n])};exports.useLinkClick=k;
+//# sourceMappingURL=useLinkClick.cjs.map

package/dist/hooks/useLinkClick.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLinkClick.cjs","sources":["../../src/hooks/useLinkClick.ts"],"sourcesContent":["'use client';\n\nimport { type MouseEventHandler, useMemo } from 'react';\nimport { useRouter } from '../context/RouterContext';\nimport { type HandleLinkClickOptions, handleLinkClick } from '../utils/router';\n\nexport type UseLinkClickOptions = Omit<HandleLinkClickOptions, 'router'>;\n\nexport const useLinkClick = (options: UseLinkClickOptions): MouseEventHandler | undefined => {\n  const router = useRouter();\n  const { routerOptions, href, target, download, onClick, isDisabled } = options;\n\n  return useMemo(\n    () => handleLinkClick({ router, routerOptions, href, target, download, onClick, isDisabled }),\n    [router, routerOptions, href, target, download, onClick, isDisabled],\n  );\n};\n"],"names":["useLinkClick","options","router","useRouter","routerOptions","href","target","download","onClick","isDisabled","useMemo","handleLinkClick"],"mappings":"iMAQaA,EAAgBC,GAAgE,CAC3F,MAAMC,EAASC,EAAAA,UAAA,EACT,CAAE,cAAAC,EAAe,KAAAC,EAAM,OAAAC,EAAQ,SAAAC,EAAU,QAAAC,EAAS,WAAAC,GAAeR,EAEvE,OAAOS,EAAAA,QACL,IAAMC,EAAAA,gBAAgB,QAAET,EAAQ,cAAAE,EAAe,KAAAC,EAAM,OAAAC,EAAQ,SAAAC,EAAU,QAAAC,EAAS,WAAAC,EAAY,EAC5F,CAACP,EAAQE,EAAeC,EAAMC,EAAQC,EAAUC,EAASC,CAAU,CAAA,CAEvE"}

package/dist/hooks/useLinkClick.d.ts

@@ -0,0 +1,4 @@
+import { MouseEventHandler } from 'react';
+import { HandleLinkClickOptions } from '../utils/router';
+export type UseLinkClickOptions = Omit<HandleLinkClickOptions, 'router'>;
+export declare const useLinkClick: (options: UseLinkClickOptions) => MouseEventHandler | undefined;