@evolve.ui/core-components 1.0.0

package/index-BXz3rMMk.d.cts

@@ -0,0 +1,322 @@
+import { t as GridHighlighter } from "./gridHighlighter-BU9PvG5f.cjs";
+import { Component, ComponentProps, ErrorInfo, HTMLProps, MouseEvent, ReactNode } from "react";
+import { CleanTheme } from "@evolve.ui/theme-system/themes/themeType";
+
+//#region src/providers/windowSizeProvider.d.ts
+declare const heightAtom: import("jotai").PrimitiveAtom<number> & {
+  init: number;
+};
+declare const widthAtom: import("jotai").PrimitiveAtom<number> & {
+  init: number;
+};
+declare const desktopAtom: import("jotai").Atom<boolean>;
+declare const mobileAtom: import("jotai").Atom<boolean>;
+declare const tabletAtom: import("jotai").Atom<boolean>;
+declare const tabletOrMobileAtom: import("jotai").Atom<boolean>;
+type WindowSizeProviderProps = {
+  children: ReactNode;
+  /**
+   * Only applies to first render. Useful for SSR when the screen height is known.
+   *
+   * @default window.innerHeight ?? 0
+   */
+  defaultHeight?: number;
+  /**
+   * Only applies to first render. Useful for SSR when the screen width is known.
+   *
+   * @default window.innerWidth ?? 0
+   */
+  defaultWidth?: number;
+  /**
+   * How often to refresh window size while resizing.
+   *
+   * Set this to milliseconds to wait, or `0` for per-animation-frame updates.
+   */
+  windowSizeThrottle?: number;
+};
+declare const WindowSizeProvider: {
+  ({
+    children,
+    defaultHeight: givenDefaultHeight,
+    defaultWidth: givenDefaultWidth,
+    windowSizeThrottle
+  }: WindowSizeProviderProps): ReactNode;
+  displayName: string;
+};
+declare const useWindowIsDesktop: () => boolean;
+declare const useWindowIsMobile: () => boolean;
+declare const useWindowIsTablet: () => boolean;
+declare const useWindowIsTabletOrMobile: () => boolean;
+declare const useWindowHeight: () => number;
+declare const useWindowWidth: () => number;
+//#endregion
+//#region src/providers/gridSizeProvider.d.ts
+declare const useGridSize: () => {
+  columnCount: number;
+  columnSize: number;
+  gapSize: number;
+};
+//#endregion
+//#region src/providers/errorBoundaryProvider.d.ts
+type ErrorBoundaryMeta = {
+  /** Additional metadata properties. */[key: string]: unknown; /** Required name to identify the error boundary. */
+  name: string;
+};
+/**
+ * Callback function when an error is caught.
+ */
+type OnErrorCallback = (error: Error, errorInfo: ErrorInfo, meta: ErrorBoundaryMeta) => void;
+/**
+ * Default fallback render function.
+ */
+type DefaultFallbackFunction = (error: Error, resetError: () => void) => ReactNode;
+type ErrorBoundaryContextValue = {
+  defaultFallback?: DefaultFallbackFunction;
+  onError: OnErrorCallback;
+};
+declare const ErrorBoundaryContext: import("react").Context<ErrorBoundaryContextValue | undefined>;
+type ErrorBoundaryProviderProps = {
+  children: ReactNode;
+  /**
+   * Optional default fallback UI to use across all ErrorBoundaries in this provider.
+   * Individual ErrorBoundaries can still override this with their own `fallback` prop.
+   */
+  defaultFallback?: DefaultFallbackFunction; /** Callback when an error is caught. */
+  onError: OnErrorCallback;
+};
+/**
+ * Provider that powers all ErrorBoundary components below it.
+ * A global provider can be overwritten by a more specific provider for section-level handling.
+ */
+declare const ErrorBoundaryProvider: {
+  ({
+    children,
+    defaultFallback,
+    onError
+  }: ErrorBoundaryProviderProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+/**
+ * Hook to get the error callback from context.
+ */
+declare const useOnError: () => OnErrorCallback | undefined;
+/**
+ * Hook that provides a callback with resetError functionality.
+ * Useful for creating custom error UIs that need to reset the boundary.
+ */
+declare const useErrorBoundaryReset: () => (error: Error, errorInfo: ErrorInfo, meta: ErrorBoundaryMeta) => void;
+type ErrorBoundaryState = {
+  hasError: boolean;
+};
+type ErrorBoundaryProps = {
+  children: ReactNode; /** Optional custom fallback UI to render when an error occurs. */
+  fallback?: (error: Error, resetError: () => void) => ReactNode;
+  /**
+   * Force the error boundary to throw an error for testing/demo purposes.
+   * Useful for previewing fallback UI in Storybook or tests.
+   */
+  forceError?: boolean;
+  /**
+   * Metadata to identify and provide context about this error boundary.
+   * The `name` field is required.
+   */
+  meta: ErrorBoundaryMeta; /** Optional custom onError callback that overrides the context callback. */
+  onError?: OnErrorCallback;
+};
+/**
+ * Catches errors in children, reports them through props or provider context, then renders a fallback UI.
+ */
+declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+  static contextType: import("react").Context<ErrorBoundaryContextValue | undefined>;
+  static getDerivedStateFromError(): ErrorBoundaryState;
+  context: React.ContextType<typeof ErrorBoundaryContext>;
+  private errorCache;
+  constructor(props: ErrorBoundaryProps);
+  componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+  resetError: () => void;
+  render(): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
+}
+//#endregion
+//#region src/providers/featureFlagProvider.d.ts
+type FeatureFlags = Record<string, boolean | undefined>;
+type FeatureFlagProviderProps = {
+  children: ReactNode;
+  featureFlags: FeatureFlags;
+};
+declare const FeatureFlagProvider: {
+  ({
+    children,
+    featureFlags
+  }: FeatureFlagProviderProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+declare const useFeatureFlagsContext: () => FeatureFlags;
+//#endregion
+//#region src/providers/designSystemProvider.d.ts
+type DesignSystemProviderProps = {
+  children: ReactNode;
+  /**
+   * Optional default fallback UI for all ErrorBoundaries.
+   * Individual ErrorBoundaries can override this with their own `fallback` prop.
+   */
+  defaultFallback?: (error: Error, resetError: () => void) => ReactNode;
+  /**
+   * Feature flags object with string keys and boolean values.
+   * Can be accessed via `useFeatureFlagsContext`.
+   */
+  featureFlags?: FeatureFlags;
+  /**
+   * Where to apply the normalization, either globally or to this provider subtree.
+   * Global normalization is preferred; scoped normalization helps when integrating into an existing reset.
+   */
+  normalizationType?: 'global' | 'scoped';
+  /**
+   * Adds an `ErrorBoundaryProvider` when passed.
+   * The consuming app should handle the error, such as logging, redirecting, or showing a toast.
+   */
+  onError?: (error: Error, errorInfo?: ErrorInfo, meta?: ErrorBoundaryMeta) => void;
+  /**
+   * Adds a `LinkProvider` when passed and can be overridden by a more specific provider.
+   */
+  onLinkClick?: (href: string) => void;
+  /**
+   * Runtime theme object supplied by `@evolve.ui/theme-system`.
+   * This installs the local `ThemeProvider` unless `withoutThemeProvider` is true.
+   */
+  theme?: CleanTheme;
+  /**
+   * Whether to remove DatePickerTarget from the DOM. You will need to provide it manually.
+   */
+  withoutDatePickerTarget?: boolean;
+  /**
+   * Disable the grid highlighter.
+   */
+  withoutHighlighter?: boolean;
+  /**
+   * Whether to disable the `jotai` `Provider`. You will need to provide it manually.
+   */
+  withoutJotaiProvider?: boolean;
+  /**
+   * Whether to remove ModalTarget from the DOM. You will need to provide it manually.
+   */
+  withoutModalTarget?: boolean;
+  /**
+   * Disable normalization CSS.
+   */
+  withoutNormalization?: boolean;
+  /**
+   * Skips the React context ThemeProvider.
+   * This repo does not install styled-components' ThemeProvider.
+   */
+  withoutThemeProvider?: boolean;
+  /**
+   * Whether to remove TimePickerTarget from the DOM. You will need to provide it manually.
+   */
+  withoutTimePickerTarget?: boolean;
+  /**
+   * Whether to disable the `WindowSizeProvider`. You will need to provide it manually.
+   */
+  withoutWindowSizeProvider?: boolean;
+};
+type Props = DesignSystemProviderProps & Partial<ComponentProps<typeof WindowSizeProvider>> & Partial<ComponentProps<typeof GridHighlighter>>;
+/**
+ * Root design-system provider runtime.
+ *
+ * Features:
+ * - Runtime theme context
+ * - Normalization
+ * - Window and grid sizing
+ * - Grid highlighter
+ * - Error boundary provider
+ * - React.StrictMode when not testing
+ */
+declare const DesignSystemProvider: {
+  ({
+    children,
+    defaultFallback,
+    defaultHeight,
+    defaultWidth,
+    featureFlags,
+    forceGridHighlight,
+    normalizationType,
+    onError,
+    onLinkClick,
+    theme,
+    windowSizeThrottle,
+    withoutDatePickerTarget,
+    withoutHighlighter,
+    withoutJotaiProvider,
+    withoutModalTarget,
+    withoutNormalization,
+    withoutThemeProvider,
+    withoutTimePickerTarget,
+    withoutWindowSizeProvider
+  }: Props): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+/** @deprecated Renamed to `DesignSystemProvider`. This alias ships for one major and is removed in a future release. */
+declare const HammerUIProvider: {
+  ({
+    children,
+    defaultFallback,
+    defaultHeight,
+    defaultWidth,
+    featureFlags,
+    forceGridHighlight,
+    normalizationType,
+    onError,
+    onLinkClick,
+    theme,
+    windowSizeThrottle,
+    withoutDatePickerTarget,
+    withoutHighlighter,
+    withoutJotaiProvider,
+    withoutModalTarget,
+    withoutNormalization,
+    withoutThemeProvider,
+    withoutTimePickerTarget,
+    withoutWindowSizeProvider
+  }: Props): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+//#endregion
+//#region src/providers/linkProvider.d.ts
+type LinkProviderProps = {
+  children: ReactNode;
+  onLinkClick: (href: string) => void;
+};
+declare const LinkProvider: {
+  ({
+    children,
+    onLinkClick
+  }: LinkProviderProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+declare const useOnLinkClick: () => (href: string) => void;
+declare const usePreventDefaultLinkOnClick: () => (href: string) => (event: MouseEvent<HTMLAnchorElement>) => void;
+//#endregion
+//#region src/providers/themeContext.d.ts
+declare const ThemeProvider: import("react").Provider<import("@evolve.ui/theme-system").Theme | undefined>;
+declare const useTheme: () => CleanTheme;
+/** @deprecated Renamed to `ThemeProvider`. This alias ships for one major and is removed in a future release. */
+declare const HammerThemeProvider: import("react").Provider<import("@evolve.ui/theme-system").Theme | undefined>;
+/** @deprecated Renamed to `useTheme`. This alias ships for one major and is removed in a future release. */
+declare const useHammerTheme: () => CleanTheme;
+//#endregion
+//#region src/providers/createContextProvider.d.ts
+declare const createContextProvider: <T>(defaultValue: T, contextName: string) => {
+  Context: import("react").Context<T>;
+  Provider: import("react").Provider<T>;
+  useContext: () => NonNullable<T>;
+};
+//#endregion
+//#region src/providers/normalize.d.ts
+declare const GLOBAL_NORMALIZE_CSS: string;
+declare const GlobalNormalize: {
+  (): null;
+  displayName: string;
+};
+declare const LocalNormalize: import("react").ForwardRefExoticComponent<Omit<HTMLProps<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+//#endregion
+export { useWindowIsDesktop as A, WindowSizeProvider as C, tabletAtom as D, mobileAtom as E, widthAtom as F, useWindowIsTablet as M, useWindowIsTabletOrMobile as N, tabletOrMobileAtom as O, useWindowWidth as P, useGridSize as S, heightAtom as T, ErrorBoundary as _, HammerThemeProvider as a, useErrorBoundaryReset as b, useTheme as c, usePreventDefaultLinkOnClick as d, DesignSystemProvider as f, useFeatureFlagsContext as g, FeatureFlags as h, createContextProvider as i, useWindowIsMobile as j, useWindowHeight as k, LinkProvider as l, FeatureFlagProvider as m, GlobalNormalize as n, ThemeProvider as o, HammerUIProvider as p, LocalNormalize as r, useHammerTheme as s, GLOBAL_NORMALIZE_CSS as t, useOnLinkClick as u, ErrorBoundaryMeta as v, desktopAtom as w, useOnError as x, ErrorBoundaryProvider as y };
+//# sourceMappingURL=index-BXz3rMMk.d.cts.map

package/index-BXz3rMMk.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BXz3rMMk.d.cts","names":[],"sources":["../src/providers/windowSizeProvider.tsx","../src/providers/gridSizeProvider.tsx","../src/providers/errorBoundaryProvider.tsx","../src/providers/featureFlagProvider.tsx","../src/providers/designSystemProvider.tsx","../src/providers/linkProvider.tsx","../src/providers/themeContext.tsx","../src/providers/createContextProvider.ts","../src/providers/normalize.tsx"],"mappings":"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"}

package/index-Bm-eSWuV.d.mts

@@ -0,0 +1,75 @@
+import { t as AnyIcon } from "./anyIcon-eR07wvJb.mjs";
+import { HTMLAttributes, HTMLProps, ReactNode } from "react";
+import { Placement } from "@floating-ui/react";
+
+//#region src/Menu/components/MenuItem/MenuItem.d.ts
+type MenuItemProps = {
+  /** additional CSS class name for the menu item*/className?: string; /** close menu after action is performed */
+  closeOnAction?: boolean; /** color of menu item */
+  color?: 'disabled' | 'inherit' | 'critical' | 'info' | 'inverse' | 'success' | 'secondary' | 'primary' | 'warning'; /** second row description, optional */
+  description?: string; /** disable menu item */
+  disabled?: boolean;
+  /** id required for all event handlers: click, checkbox,
+   * radio or toggle
+   */
+  id?: string | number; /** flag if using as header, alters style and hover state */
+  isHeader?: boolean; /** Icon to use on Left side of menu item, requires numberOfColumns of 3 */
+  leftIcon?: AnyIcon; /** primary menu label string, required */
+  primaryLabel: string; /** Icon to use on Right side of menu, requires numberOfColumns of 2 or 3  */
+  rightIcon?: AnyIcon; /** secondary label to be used to right of primary label, cannot be used with rightIcon, requires numberOfColumns of 2 or 3 */
+  secondaryLabel?: string;
+} & ({
+  checked?: never;
+  id?: never;
+  onCheckboxChange?: never;
+  onClick?: never;
+  onFocus?: never;
+  onRadioChange?: never;
+  onToggleChange?: never;
+} | {
+  /** current state of control */checked?: boolean;
+  /** id required for all event handlers: click, checkbox,
+   * radio or toggle
+   */
+  className?: string;
+  id?: string | number; /** if present, will show checkbox on in LeftIcon space, requires numberOfColumns of 3 */
+  onCheckboxChange?: (id: string | number, checked: boolean) => void; /** if present, will show checkbox on in LeftIcon space */
+  onClick?: (id: string | number) => void; /** if present, trigger when MenuItem is focused */
+  onFocus?: (id: string | number) => void; /** if present, will show checkbox on in LeftIcon space, requires numberOfColumns of 3 */
+  onRadioChange?: (id: string | number, checked: boolean) => void; /** if present, will show checkbox on in RightIcon space, requires numberOfColumns of 2 or 3 */
+  onToggleChange?: (id: string | number, checked: boolean) => void;
+});
+declare const MenuItem: import("react").ForwardRefExoticComponent<(MenuItemProps & HTMLAttributes<HTMLDivElement>) & import("react").RefAttributes<HTMLDivElement>>;
+//#endregion
+//#region src/Menu/components/MenuDivider/MenuDivider.d.ts
+declare const MenuDivider: ({
+  className
+}: {
+  className?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/Menu/Menu.d.ts
+type MenuProps = {
+  /** MenuItem children */children?: ReactNode; /** additional CSS class name for the menu container*/
+  className?: string; /** when true, menu will open on first render */
+  defaultOpen?: boolean; /** when true, menu borders are rounded */
+  hasRoundedBorders?: boolean;
+  /**
+   * Optional stable ID for SSR scenarios. If not provided, a unique ID will be generated.
+   * This helps prevent hydration mismatches when using SSR.
+   */
+  id?: string; /** Enable menu custom content vs MenuItem children */
+  isCustomContent?: boolean; /** initial menu placement */
+  menuPlacement?: Placement; /** custom menu width */
+  menuSize?: 'sm' | 'md' | 'lg' | 'xl'; /** number of grid columns required for children */
+  numberOfColumns: 1 | 2 | 3; /** callback that triggers when the menu is closed */
+  onMenuClose?: () => void; /** callback that triggers when the menu is opened */
+  onMenuOpen?: () => void; /** when true, menu will open on hover */
+  openOnHover?: boolean; /** trigger component to open menu */
+  trigger: ReactNode; /** additional CSS class name for the trigger */
+  triggerClassName?: string;
+};
+declare const Menu: import("react").ForwardRefExoticComponent<Omit<MenuProps & HTMLProps<HTMLSpanElement>, "ref"> & import("react").RefAttributes<HTMLSpanElement>>;
+//#endregion
+export { MenuItemProps as a, MenuItem as i, MenuProps as n, MenuDivider as r, Menu as t };
+//# sourceMappingURL=index-Bm-eSWuV.d.mts.map

package/index-Bm-eSWuV.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Bm-eSWuV.d.mts","names":[],"sources":["../src/Menu/components/MenuItem/MenuItem.tsx","../src/Menu/components/MenuDivider/MenuDivider.tsx","../src/Menu/Menu.tsx"],"mappings":";;;;;KAUY,aAAA;mDAER,SAAA,WAFQ;EAIR,aAAA;EAEA,KAAA,+GAJA;EAMA,WAAA,WAFA;EAIA,QAAA;EAAA;;;EAIA,EAAA,oBAIW;EAFX,QAAA,YAMA;EAJA,QAAA,GAAW,OAAA,EAMX;EAJA,YAAA,UAQM;EANN,SAAA,GAAY,OAAO,EAQb;EANN,cAAA;AAAA;EAGM,OAAA;EACA,EAAA;EACA,gBAAA;EACA,OAAA;EACA,OAAA;EACA,aAAA;EACA,cAAA;AAAA;EAaW,+BATX,OAAA;EAWW;;;EAPX,SAAA;EACA,EAAA,oBAUkB;EARlB,gBAAA,IAAoB,EAAA,mBAAqB,OAAA,oBAQc;EANvD,OAAA,IAAW,EAAA,4BAUR;EARH,OAAA,IAAW,EAAA;EAEX,aAAA,IAAiB,EAAA,mBAAqB,OAAA,oBAM3B;EAJX,cAAA,IAAkB,EAAA,mBAAqB,OAAA;AAAA;AAAA,cAIpC,QAAA,kBAAQ,yBAAA,EAAA,aAAA,GAAA,cAAA,CAAA,cAAA,qBAAA,aAAA,CAAA,cAAA;;;cChER,WAAA;EAAe;AAAA;EAAiB,SAAA;AAAA,kCAAoB,GAAA,CAAA,OAAA;;;KCuDrD,SAAA;0BAER,QAAA,GAAW,SAAA,EFjDH;EEmDR,SAAA;EAEA,WAAA,YFnDA;EEqDA,iBAAA;EFjDA;;;;EEsDA,EAAA,WF1CA;EE4CA,eAAA,YF1CA;EE4CA,aAAA,GAAgB,SAAA,EF1CJ;EE4CZ,QAAA,8BFvCM;EEyCN,eAAA,aFvCM;EEyCN,WAAA,eFvCM;EEyCN,UAAA,eFvCM;EEyCN,WAAA,YFjCM;EEmCN,OAAA,EAAS,SAAA,EFhCH;EEkCN,gBAAA;AAAA;AAAA,cAqQS,IAAA,kBAAI,yBAAA,CAAA,IAAA,CAAA,SAAA,GAAA,SAAA,CAAA,eAAA,4BAAA,aAAA,CAAA,eAAA"}

package/index-BsA0Oogf.d.cts

@@ -0,0 +1,75 @@
+import { t as AnyIcon } from "./anyIcon-C3IQzJJ9.cjs";
+import { HTMLAttributes, HTMLProps, ReactNode } from "react";
+import { Placement } from "@floating-ui/react";
+
+//#region src/Menu/components/MenuItem/MenuItem.d.ts
+type MenuItemProps = {
+  /** additional CSS class name for the menu item*/className?: string; /** close menu after action is performed */
+  closeOnAction?: boolean; /** color of menu item */
+  color?: 'disabled' | 'inherit' | 'critical' | 'info' | 'inverse' | 'success' | 'secondary' | 'primary' | 'warning'; /** second row description, optional */
+  description?: string; /** disable menu item */
+  disabled?: boolean;
+  /** id required for all event handlers: click, checkbox,
+   * radio or toggle
+   */
+  id?: string | number; /** flag if using as header, alters style and hover state */
+  isHeader?: boolean; /** Icon to use on Left side of menu item, requires numberOfColumns of 3 */
+  leftIcon?: AnyIcon; /** primary menu label string, required */
+  primaryLabel: string; /** Icon to use on Right side of menu, requires numberOfColumns of 2 or 3  */
+  rightIcon?: AnyIcon; /** secondary label to be used to right of primary label, cannot be used with rightIcon, requires numberOfColumns of 2 or 3 */
+  secondaryLabel?: string;
+} & ({
+  checked?: never;
+  id?: never;
+  onCheckboxChange?: never;
+  onClick?: never;
+  onFocus?: never;
+  onRadioChange?: never;
+  onToggleChange?: never;
+} | {
+  /** current state of control */checked?: boolean;
+  /** id required for all event handlers: click, checkbox,
+   * radio or toggle
+   */
+  className?: string;
+  id?: string | number; /** if present, will show checkbox on in LeftIcon space, requires numberOfColumns of 3 */
+  onCheckboxChange?: (id: string | number, checked: boolean) => void; /** if present, will show checkbox on in LeftIcon space */
+  onClick?: (id: string | number) => void; /** if present, trigger when MenuItem is focused */
+  onFocus?: (id: string | number) => void; /** if present, will show checkbox on in LeftIcon space, requires numberOfColumns of 3 */
+  onRadioChange?: (id: string | number, checked: boolean) => void; /** if present, will show checkbox on in RightIcon space, requires numberOfColumns of 2 or 3 */
+  onToggleChange?: (id: string | number, checked: boolean) => void;
+});
+declare const MenuItem: import("react").ForwardRefExoticComponent<(MenuItemProps & HTMLAttributes<HTMLDivElement>) & import("react").RefAttributes<HTMLDivElement>>;
+//#endregion
+//#region src/Menu/components/MenuDivider/MenuDivider.d.ts
+declare const MenuDivider: ({
+  className
+}: {
+  className?: string;
+}) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/Menu/Menu.d.ts
+type MenuProps = {
+  /** MenuItem children */children?: ReactNode; /** additional CSS class name for the menu container*/
+  className?: string; /** when true, menu will open on first render */
+  defaultOpen?: boolean; /** when true, menu borders are rounded */
+  hasRoundedBorders?: boolean;
+  /**
+   * Optional stable ID for SSR scenarios. If not provided, a unique ID will be generated.
+   * This helps prevent hydration mismatches when using SSR.
+   */
+  id?: string; /** Enable menu custom content vs MenuItem children */
+  isCustomContent?: boolean; /** initial menu placement */
+  menuPlacement?: Placement; /** custom menu width */
+  menuSize?: 'sm' | 'md' | 'lg' | 'xl'; /** number of grid columns required for children */
+  numberOfColumns: 1 | 2 | 3; /** callback that triggers when the menu is closed */
+  onMenuClose?: () => void; /** callback that triggers when the menu is opened */
+  onMenuOpen?: () => void; /** when true, menu will open on hover */
+  openOnHover?: boolean; /** trigger component to open menu */
+  trigger: ReactNode; /** additional CSS class name for the trigger */
+  triggerClassName?: string;
+};
+declare const Menu: import("react").ForwardRefExoticComponent<Omit<MenuProps & HTMLProps<HTMLSpanElement>, "ref"> & import("react").RefAttributes<HTMLSpanElement>>;
+//#endregion
+export { MenuItemProps as a, MenuItem as i, MenuProps as n, MenuDivider as r, Menu as t };
+//# sourceMappingURL=index-BsA0Oogf.d.cts.map

package/index-BsA0Oogf.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BsA0Oogf.d.cts","names":[],"sources":["../src/Menu/components/MenuItem/MenuItem.tsx","../src/Menu/components/MenuDivider/MenuDivider.tsx","../src/Menu/Menu.tsx"],"mappings":";;;;;KAUY,aAAA;mDAER,SAAA,WAFQ;EAIR,aAAA;EAEA,KAAA,+GAJA;EAMA,WAAA,WAFA;EAIA,QAAA;EAAA;;;EAIA,EAAA,oBAIW;EAFX,QAAA,YAMA;EAJA,QAAA,GAAW,OAAA,EAMX;EAJA,YAAA,UAQM;EANN,SAAA,GAAY,OAAO,EAQb;EANN,cAAA;AAAA;EAGM,OAAA;EACA,EAAA;EACA,gBAAA;EACA,OAAA;EACA,OAAA;EACA,aAAA;EACA,cAAA;AAAA;EAaW,+BATX,OAAA;EAWW;;;EAPX,SAAA;EACA,EAAA,oBAUkB;EARlB,gBAAA,IAAoB,EAAA,mBAAqB,OAAA,oBAQc;EANvD,OAAA,IAAW,EAAA,4BAUR;EARH,OAAA,IAAW,EAAA;EAEX,aAAA,IAAiB,EAAA,mBAAqB,OAAA,oBAM3B;EAJX,cAAA,IAAkB,EAAA,mBAAqB,OAAA;AAAA;AAAA,cAIpC,QAAA,kBAAQ,yBAAA,EAAA,aAAA,GAAA,cAAA,CAAA,cAAA,qBAAA,aAAA,CAAA,cAAA;;;cChER,WAAA;EAAe;AAAA;EAAiB,SAAA;AAAA,kCAAoB,GAAA,CAAA,OAAA;;;KCuDrD,SAAA;0BAER,QAAA,GAAW,SAAA,EFjDH;EEmDR,SAAA;EAEA,WAAA,YFnDA;EEqDA,iBAAA;EFjDA;;;;EEsDA,EAAA,WF1CA;EE4CA,eAAA,YF1CA;EE4CA,aAAA,GAAgB,SAAA,EF1CJ;EE4CZ,QAAA,8BFvCM;EEyCN,eAAA,aFvCM;EEyCN,WAAA,eFvCM;EEyCN,UAAA,eFvCM;EEyCN,WAAA,YFjCM;EEmCN,OAAA,EAAS,SAAA,EFhCH;EEkCN,gBAAA;AAAA;AAAA,cAqQS,IAAA,kBAAI,yBAAA,CAAA,IAAA,CAAA,SAAA,GAAA,SAAA,CAAA,eAAA,4BAAA,aAAA,CAAA,eAAA"}

package/index-Bu7c6X7O.d.mts

@@ -0,0 +1,117 @@
+import { a as MarginProps, n as LineClampProp, o as PaddingProps, r as LocationProp, t as GenericCSSMixinProps } from "./index-MX_CgDGs.mjs";
+import { HTMLProps, ReactElement, ReactNode } from "react";
+
+//#region src/ChoiceListItem/common.d.ts
+type ChoiceListItemLabelProps = {
+  /** Hammer passes `as="label"`; ignored at runtime (label is always `<label>`). */as?: 'label' | string;
+  children: ReactNode;
+  className?: string;
+};
+declare const ChoiceListItemLabel: ({
+  as: _as,
+  children,
+  className
+}: ChoiceListItemLabelProps) => import("react/jsx-runtime").JSX.Element;
+type GroupProps = Omit<HTMLProps<HTMLFieldSetElement>, 'as' | 'ref' | 'id' | 'children'> & {
+  /** Checkboxes or Radios for this group. */children: ReactElement<CommonProps> | ReactElement<CommonProps>[]; /** This will match children's name prop. */
+  id?: string; /** Text for the group label */
+  label?: ReactNode;
+} & GenericCSSMixinProps;
+type CommonProps = {
+  /** Secondary text for the input. Usually doesn't directly describe it */description?: ReactNode;
+  /**
+   * The size of the label.
+   *
+   * @default 'primary'
+   */
+  labelSize?: 'primary' | 'secondary';
+  /**
+   * Should match the id of the group that surrounds it.
+   *
+   * ```html
+   * <Component.Group id="someGroup">
+   *     <Component.Option value="someValue" name="someGroup">
+   *         Label 1
+   *     </Component.Option>
+   *     <Component.Option value={231} name="someGroup">
+   *         Label 2
+   *     </Component.Option>
+   * </Component.Group>
+   * ```
+   */
+  name?: string;
+  /**
+   * Represents the value that selecting this input provides.
+   *
+   * ```html
+   * <Component.Group id="someGroup">
+   *     <Component.Option value="someValue" name="someGroup">
+   *         Label 1
+   *     </Component.Option>
+   *     <Component.Option value={231} name="someGroup">
+   *         Label 2
+   *     </Component.Option>
+   * </Component.Group>
+   * ```
+   */
+  value?: string | number;
+} & Omit<HTMLProps<HTMLInputElement>, 'for' | 'ref' | 'type' | 'name' | 'value'> & GenericCSSMixinProps;
+//#endregion
+//#region src/ChoiceListItem/Radio.d.ts
+/**
+ * RadioOption component using Tailwind CSS.
+ * @see CommonProps for prop details.
+ */
+declare const RadioOption: import("react").ForwardRefExoticComponent<{
+  description?: import("react").ReactNode;
+  labelSize?: "primary" | "secondary";
+  name?: string;
+  value?: string | number;
+} & Omit<import("react").HTMLProps<HTMLInputElement>, "ref" | "name" | "type" | "value" | "for"> & LocationProp & PaddingProps & MarginProps & LineClampProp & import("react").RefAttributes<HTMLInputElement>>;
+declare const Radio: {
+  Group: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLProps<HTMLFieldSetElement>, "children" | "ref" | "as" | "id"> & {
+    children: import("react").ReactElement<CommonProps> | import("react").ReactElement<CommonProps>[];
+    id?: string;
+    label?: import("react").ReactNode;
+  } & LocationProp & PaddingProps & MarginProps & LineClampProp & import("react").RefAttributes<HTMLFieldSetElement>>;
+  Option: import("react").ForwardRefExoticComponent<{
+    description?: import("react").ReactNode;
+    labelSize?: "primary" | "secondary";
+    name?: string;
+    value?: string | number;
+  } & Omit<import("react").HTMLProps<HTMLInputElement>, "ref" | "name" | "type" | "value" | "for"> & LocationProp & PaddingProps & MarginProps & LineClampProp & import("react").RefAttributes<HTMLInputElement>>;
+};
+declare const RadioGroup: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLProps<HTMLFieldSetElement>, "children" | "ref" | "as" | "id"> & {
+  children: import("react").ReactElement<CommonProps> | import("react").ReactElement<CommonProps>[];
+  id?: string;
+  label?: import("react").ReactNode;
+} & LocationProp & PaddingProps & MarginProps & LineClampProp & import("react").RefAttributes<HTMLFieldSetElement>>;
+//#endregion
+//#region src/ChoiceListItem/Checkbox.d.ts
+declare const CheckboxOption: import("react").ForwardRefExoticComponent<{
+  description?: import("react").ReactNode;
+  labelSize?: "primary" | "secondary";
+  name?: string;
+  value?: string | number;
+} & Omit<import("react").HTMLProps<HTMLInputElement>, "ref" | "name" | "type" | "value" | "for"> & LocationProp & PaddingProps & MarginProps & LineClampProp & import("react").RefAttributes<HTMLInputElement | null>>;
+declare const Checkbox: {
+  Group: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLProps<HTMLFieldSetElement>, "children" | "ref" | "as" | "id"> & {
+    children: import("react").ReactElement<CommonProps> | import("react").ReactElement<CommonProps>[];
+    id?: string;
+    label?: import("react").ReactNode;
+  } & LocationProp & PaddingProps & MarginProps & LineClampProp & import("react").RefAttributes<HTMLFieldSetElement>>;
+  Option: import("react").ForwardRefExoticComponent<{
+    description?: import("react").ReactNode;
+    labelSize?: "primary" | "secondary";
+    name?: string;
+    value?: string | number;
+  } & Omit<import("react").HTMLProps<HTMLInputElement>, "ref" | "name" | "type" | "value" | "for"> & LocationProp & PaddingProps & MarginProps & LineClampProp & import("react").RefAttributes<HTMLInputElement | null>>;
+};
+declare const CheckboxGroup: import("react").ForwardRefExoticComponent<Omit<import("react").HTMLProps<HTMLFieldSetElement>, "children" | "ref" | "as" | "id"> & {
+  children: import("react").ReactElement<CommonProps> | import("react").ReactElement<CommonProps>[];
+  id?: string;
+  label?: import("react").ReactNode;
+} & LocationProp & PaddingProps & MarginProps & LineClampProp & import("react").RefAttributes<HTMLFieldSetElement>>;
+//#endregion
+export { RadioGroup as a, GroupProps as c, Radio as i, CheckboxGroup as n, RadioOption as o, CheckboxOption as r, ChoiceListItemLabel as s, Checkbox as t };
+//# sourceMappingURL=index-Bu7c6X7O.d.mts.map

package/index-Bu7c6X7O.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Bu7c6X7O.d.mts","names":[],"sources":["../src/ChoiceListItem/common.tsx","../src/ChoiceListItem/Radio.tsx","../src/ChoiceListItem/Checkbox.tsx"],"mappings":";;;;KAeK,wBAAA;EAAA,kFAED,EAAA;EACA,QAAA,EAAU,SAAS;EACnB,SAAA;AAAA;AAAA,cAGS,mBAAA;EAAuB,EAAA,EAAA,GAAA;EAAA,QAAA;EAAA;AAAA,GAAkC,wBAAA,iCAAwB,GAAA,CAAA,OAAA;AAAA,KA4ElF,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,mBAAA;EA5EJ,2CA8EhC,QAAA,EAAU,YAAA,CAAa,WAAA,IAAe,YAAA,CAAa,WAAA,KA9EuC;EAgF1F,EAAA,WAhFgC;EAkFhC,KAAA,GAAQ,SAAA;AAAA,IACR,oBAAA;AAAA,KAEQ,WAAA;EArFwB,yEAuFhC,WAAA,GAAc,SAAA;EAvFoD;;;;AAgBrE;EA6EG,SAAA;EAjBkB;;;;;;;;;;;;;;EAgClB,IAAA;EAhCoC;;;;;;;;;;;AAOhB;AAExB;;EAsCI,KAAA;AAAA,IACA,IAAA,CAAK,SAAA,CAAU,gBAAA,gDACf,oBAAA;;;;;;AAxID;cC8BU,WAAA,kBAAW,yBAAA;;;;;;cAaX,KAAA;;;;;;;;;;;;;cAMA,UAAA,kBAAU,yBAAA,CAAA,IAAA,iBAAA,SAAA,CAAA,mBAAA;;;;;;;cCXjB,cAAA,kBAAc,yBAAA;;;;;;cAaP,QAAA;;;;;;;;;;;;;cAMA,aAAA,kBAAa,yBAAA,CAAA,IAAA,iBAAA,SAAA,CAAA,mBAAA"}