eidos-ui 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Pedro Mealha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,175 @@
+# eidos-ui
+
+A modern, accessible React component library built with TypeScript, SCSS, and CSS custom properties.
+
+> **This package starts fresh at `0.1.0`.** It was previously published as `@pmealha/eidos-ui`
+> (versions `0.1.1` through `5.0.0`), which reached `5.x` well before the API was actually stable -
+> those version numbers didn't reflect real semantic versioning and are deprecated. `@pmealha/eidos-ui`
+> will not receive further updates; install `eidos-ui` instead. See [CHANGELOG.md](./CHANGELOG.md) for
+> what's changed release to release from here on.
+
+## ✨ Features
+
+- 🎨 **Customizable** - CSS custom properties for easy theming
+- 💪 **TypeScript** - Full type safety and IntelliSense support
+- 🎭 **SCSS** - Powerful styling with mixins and design tokens
+- 🏗️ **Optimized** - Built with tsup for minimal bundle size
+- ⚡ **Tree-shakeable** - Import only what you need
+- ♿ **Accessible** - Built with accessibility in mind
+- 🎯 **Icon Flexibility** - Works with any icon library (Lucide, MUI Icons, Font Awesome, Remix Icons, etc.)
+
+## 📦 Installation
+
+```bash
+npm install eidos-ui
+```
+
+**Optional:** If you want to use component-based icons (recommended):
+
+```bash
+npm install lucide-react
+# or use MUI Icons, Heroicons, etc.
+```
+
+## 🚀 Quick Start
+
+```tsx
+import { Button, Tooltip, DatePicker } from 'eidos-ui';
+import 'eidos-ui/styles';
+
+function App() {
+  return (
+    <div>
+      <Button variant="filled" color="primary">
+        Click me
+      </Button>
+
+      <Tooltip message="Helpful hint">
+        <Button>Hover me</Button>
+      </Tooltip>
+    </div>
+  );
+}
+```
+
+### With Icons
+
+```tsx
+// Using component icons (tree-shakeable)
+import { Plus, Download } from 'lucide-react';
+<Button icon={Plus} />
+<Button preIcon={Download}>Download</Button>
+
+// Or using string-based icons
+<Button icon="fa fa-plus" />  // Font Awesome
+<Button icon="ri-add-line" />  // Remix Icons
+```
+
+## 📦 Available Components
+
+- **Button** - Versatile button with variants, sizes, colors, icons, loading states
+- **Chip** - Compact elements for tags, labels, or selections
+- **DatePicker** - Date selection with single, multiple, and range modes
+- **Divider** - Visual separator with optional text
+- **Dropdown** - Customizable dropdown menus
+- **Input** - Text input with validation and icons
+- **Menu** - Navigation and action menus
+- **Modal** - Dialog overlays with customizable actions
+- **Select** - Dropdown selection with search
+- **Snackbar** - Toast notifications with actions
+- **Spinner** - Loading indicators
+- **Table** - Data tables with sorting, filtering, and pagination
+- **Tooltip** - Contextual hints with smart positioning
+
+## 📚 Documentation
+
+For detailed component documentation, props, and interactive examples, visit our Storybook:
+
+```bash
+npm run storybook
+```
+
+Or check the [live Storybook documentation](#) _(coming soon)_
+
+## 🎨 Customization
+
+### Theming with CSS Variables
+
+All design tokens are customizable via CSS custom properties:
+
+```css
+:root {
+  /* Colors */
+  --primary-color: #6366f1;
+  --secondary-color: #ec4899;
+
+  /* Spacing */
+  --spacing-md: 1em;
+  --spacing-lg: 1.5em;
+
+  /* Border radius */
+  --border-radius-md: 8px;
+}
+```
+
+### Dark Mode Example
+
+```css
+[data-theme='dark'] {
+  --primary-color: #818cf8;
+  --background: #1e293b;
+  --text-color: #f1f5f9;
+}
+```
+
+### Override Component Styles
+
+```css
+.eidos-button {
+  border-radius: 20px;
+}
+
+.eidos-button--primary {
+  background: linear-gradient(to right, #6366f1, #8b5cf6);
+}
+```
+
+## 💻 TypeScript Support
+
+Full TypeScript support with exported types:
+
+```tsx
+import type { ButtonProps, TooltipProps } from 'eidos-ui';
+
+const MyButton: React.FC<ButtonProps> = (props) => {
+  return <Button {...props} />;
+};
+```
+
+## 🎯 Icon Support
+
+The library supports multiple icon approaches:
+
+1. **Component Icons** (Lucide, MUI, Heroicons) - Recommended for tree-shaking
+2. **String-based Icons** (Font Awesome, Remix Icons) - Great for dynamic icons
+
+```tsx
+// Component-based (tree-shakeable)
+import { Plus } from 'lucide-react';
+<Button icon={Plus} />
+
+// String-based (requires icon CSS to be loaded)
+<Button icon="fa fa-plus" />
+```
+
+## 📄 License
+
+MIT
+
+## 👤 Author
+
+Pedro Mealha
+
+---
+
+Built with ❤️ using React, TypeScript, SCSS, and Storybook

package/dist/Breadcrumb.types-DaykU-C8.d.cts

@@ -0,0 +1,20 @@
+import React__default from 'react';
+
+interface BreadcrumbItem {
+    /** Display text for this step. */
+    label: string;
+    /** If provided, renders as an anchor tag. For SPAs, use onClick instead. */
+    href?: string;
+    /** Click handler - useful for SPA routing without full page navigations. */
+    onClick?: (e: React__default.MouseEvent) => void;
+    /** Icon to show before the label (optional). */
+    icon?: React__default.ReactNode;
+}
+interface BreadcrumbProps {
+    items: BreadcrumbItem[];
+    /** Separator between items. Default: '/'. */
+    separator?: React__default.ReactNode;
+    className?: string;
+}
+
+export type { BreadcrumbItem as B, BreadcrumbProps as a };

package/dist/Breadcrumb.types-DaykU-C8.d.ts

@@ -0,0 +1,20 @@
+import React__default from 'react';
+
+interface BreadcrumbItem {
+    /** Display text for this step. */
+    label: string;
+    /** If provided, renders as an anchor tag. For SPAs, use onClick instead. */
+    href?: string;
+    /** Click handler - useful for SPA routing without full page navigations. */
+    onClick?: (e: React__default.MouseEvent) => void;
+    /** Icon to show before the label (optional). */
+    icon?: React__default.ReactNode;
+}
+interface BreadcrumbProps {
+    items: BreadcrumbItem[];
+    /** Separator between items. Default: '/'. */
+    separator?: React__default.ReactNode;
+    className?: string;
+}
+
+export type { BreadcrumbItem as B, BreadcrumbProps as a };

package/dist/Button.types-BH0CPyPx.d.ts

@@ -0,0 +1,33 @@
+import { I as IconType } from './renderIcon-C2lEMMzb.js';
+import { C as ComponentSizeProps } from './sizes-DM6Rrrgq.js';
+
+/** Shared across every Button-family component (Button, ButtonGroup, SplitButton, bulk actions, ...). */
+type ButtonVariantProps = 'filled' | 'outlined' | 'text';
+/** Shared across every Button-family component (Button, ButtonGroup, SplitButton, bulk actions, ...). */
+type ButtonColorProps = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info';
+interface BaseButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: ButtonVariantProps;
+    color?: ButtonColorProps;
+    size?: ComponentSizeProps;
+    disabled?: boolean;
+    loading?: boolean;
+    className?: string;
+    tooltip?: string;
+}
+interface TextButtonProps extends BaseButtonProps {
+    children: React.ReactNode;
+    preIcon?: IconType;
+    posIcon?: IconType;
+    icon?: never;
+    loadingText?: string;
+}
+interface IconButtonProps extends BaseButtonProps {
+    icon: IconType;
+    children?: never;
+    preIcon?: never;
+    posIcon?: never;
+    loadingText?: never;
+}
+type ButtonProps = TextButtonProps | IconButtonProps;
+
+export type { ButtonColorProps as B, IconButtonProps as I, TextButtonProps as T, ButtonProps as a, ButtonVariantProps as b };

package/dist/Button.types-DZRCVqyN.d.cts

@@ -0,0 +1,33 @@
+import { I as IconType } from './renderIcon-C2lEMMzb.cjs';
+import { C as ComponentSizeProps } from './sizes-DM6Rrrgq.cjs';
+
+/** Shared across every Button-family component (Button, ButtonGroup, SplitButton, bulk actions, ...). */
+type ButtonVariantProps = 'filled' | 'outlined' | 'text';
+/** Shared across every Button-family component (Button, ButtonGroup, SplitButton, bulk actions, ...). */
+type ButtonColorProps = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info';
+interface BaseButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: ButtonVariantProps;
+    color?: ButtonColorProps;
+    size?: ComponentSizeProps;
+    disabled?: boolean;
+    loading?: boolean;
+    className?: string;
+    tooltip?: string;
+}
+interface TextButtonProps extends BaseButtonProps {
+    children: React.ReactNode;
+    preIcon?: IconType;
+    posIcon?: IconType;
+    icon?: never;
+    loadingText?: string;
+}
+interface IconButtonProps extends BaseButtonProps {
+    icon: IconType;
+    children?: never;
+    preIcon?: never;
+    posIcon?: never;
+    loadingText?: never;
+}
+type ButtonProps = TextButtonProps | IconButtonProps;
+
+export type { ButtonColorProps as B, IconButtonProps as I, TextButtonProps as T, ButtonProps as a, ButtonVariantProps as b };

package/dist/CommandPalette.types-DRMMS_ev.d.cts

@@ -0,0 +1,73 @@
+import React__default from 'react';
+
+interface CommandItem {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: React__default.ComponentType<{
+        className?: string;
+        size?: number;
+    }>;
+    /** e.g. ['⌘', 'K'] - each key rendered as a <kbd> badge */
+    shortcut?: string[];
+    group?: string;
+    disabled?: boolean;
+    /** Called when the item is selected */
+    action?: () => void;
+    /** Additional terms used for filtering; not displayed */
+    keywords?: string[];
+}
+interface CommandPaletteProps {
+    /**
+     * Controlled open state. Omit it (along with `onClose`) to let the palette
+     * manage its own open state internally, which is enough on its own to wire
+     * up `shortcutKey` with no `useState`/`useEffect` in your app at all:
+     * ```tsx
+     * <CommandPalette items={items} />
+     * ```
+     */
+    open?: boolean;
+    /** Initial open state when uncontrolled (`open` omitted). @default false */
+    defaultOpen?: boolean;
+    /** Called whenever the palette closes. Required if `open` is controlled. */
+    onClose?: () => void;
+    /**
+     * Called when `shortcutKey` fires while `open` is controlled - the palette
+     * can't flip your `open` state itself, so this is the hook to do it
+     * (`onOpen={() => setOpen(true)}`). Not needed in uncontrolled mode.
+     */
+    onOpen?: () => void;
+    /**
+     * Global Cmd/Ctrl+<key> shortcut that opens the palette, e.g. `'k'` for
+     * ⌘K, `'r'` for ⌘R. Pass `null` to disable the built-in listener entirely
+     * (e.g. if you only want to open it from your own trigger). @default 'k'
+     */
+    shortcutKey?: string | null;
+    items: CommandItem[];
+    onSelect?: (item: CommandItem) => void;
+    /** @default 'Search commands…' */
+    placeholder?: string;
+    /** @default 'No commands found' */
+    emptyText?: string;
+    /** Scrollable list max-height. @default 360 (px) */
+    maxHeight?: number | string;
+    className?: string;
+    /** Optional content rendered on the right side of the footer */
+    footer?: React__default.ReactNode;
+    /**
+     * Renders a clickable entry point inline, wherever `<CommandPalette>` is
+     * mounted, wired up to open it - no external button/state required.
+     * - Omitted (default): nothing is rendered inline, matching the fully
+     *   headless behaviour of a bare `<CommandPalette items={items} />`.
+     * - `true`: renders a built-in default trigger (button + `Kbd` shortcut
+     *   badge reflecting `shortcutKey`).
+     * - A `ReactNode`: renders your own element instead, with the open click
+     *   handler wired onto a wrapping element (mirrors the `trigger` prop on
+     *   `Menu`/`Dropdown`).
+     */
+    trigger?: boolean | React__default.ReactNode;
+    /** Label used by the built-in default trigger (`trigger={true}`). @default 'Search' */
+    triggerLabel?: string;
+}
+
+export type { CommandItem as C, CommandPaletteProps as a };

package/dist/CommandPalette.types-DRMMS_ev.d.ts

@@ -0,0 +1,73 @@
+import React__default from 'react';
+
+interface CommandItem {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: React__default.ComponentType<{
+        className?: string;
+        size?: number;
+    }>;
+    /** e.g. ['⌘', 'K'] - each key rendered as a <kbd> badge */
+    shortcut?: string[];
+    group?: string;
+    disabled?: boolean;
+    /** Called when the item is selected */
+    action?: () => void;
+    /** Additional terms used for filtering; not displayed */
+    keywords?: string[];
+}
+interface CommandPaletteProps {
+    /**
+     * Controlled open state. Omit it (along with `onClose`) to let the palette
+     * manage its own open state internally, which is enough on its own to wire
+     * up `shortcutKey` with no `useState`/`useEffect` in your app at all:
+     * ```tsx
+     * <CommandPalette items={items} />
+     * ```
+     */
+    open?: boolean;
+    /** Initial open state when uncontrolled (`open` omitted). @default false */
+    defaultOpen?: boolean;
+    /** Called whenever the palette closes. Required if `open` is controlled. */
+    onClose?: () => void;
+    /**
+     * Called when `shortcutKey` fires while `open` is controlled - the palette
+     * can't flip your `open` state itself, so this is the hook to do it
+     * (`onOpen={() => setOpen(true)}`). Not needed in uncontrolled mode.
+     */
+    onOpen?: () => void;
+    /**
+     * Global Cmd/Ctrl+<key> shortcut that opens the palette, e.g. `'k'` for
+     * ⌘K, `'r'` for ⌘R. Pass `null` to disable the built-in listener entirely
+     * (e.g. if you only want to open it from your own trigger). @default 'k'
+     */
+    shortcutKey?: string | null;
+    items: CommandItem[];
+    onSelect?: (item: CommandItem) => void;
+    /** @default 'Search commands…' */
+    placeholder?: string;
+    /** @default 'No commands found' */
+    emptyText?: string;
+    /** Scrollable list max-height. @default 360 (px) */
+    maxHeight?: number | string;
+    className?: string;
+    /** Optional content rendered on the right side of the footer */
+    footer?: React__default.ReactNode;
+    /**
+     * Renders a clickable entry point inline, wherever `<CommandPalette>` is
+     * mounted, wired up to open it - no external button/state required.
+     * - Omitted (default): nothing is rendered inline, matching the fully
+     *   headless behaviour of a bare `<CommandPalette items={items} />`.
+     * - `true`: renders a built-in default trigger (button + `Kbd` shortcut
+     *   badge reflecting `shortcutKey`).
+     * - A `ReactNode`: renders your own element instead, with the open click
+     *   handler wired onto a wrapping element (mirrors the `trigger` prop on
+     *   `Menu`/`Dropdown`).
+     */
+    trigger?: boolean | React__default.ReactNode;
+    /** Label used by the built-in default trigger (`trigger={true}`). @default 'Search' */
+    triggerLabel?: string;
+}
+
+export type { CommandItem as C, CommandPaletteProps as a };

package/dist/Footer.types-Dv2TPN2J.d.cts

@@ -0,0 +1,24 @@
+import React__default from 'react';
+
+interface BaseFooterProps {
+    className?: string;
+}
+interface FooterCopyrightProps extends BaseFooterProps {
+    /** Copyright text, centered in the footer. */
+    copyright: string;
+    component?: never;
+}
+interface FooterComponentProps extends BaseFooterProps {
+    /** Custom content that fully replaces the default centered copyright text. */
+    component: React__default.ReactNode;
+    copyright?: never;
+}
+/**
+ * Discriminated union - pass exactly one of `copyright` or `component`, never
+ * both. Mirrors the `TextButtonProps | IconButtonProps` pattern used by
+ * `Button`: picking one variant's required prop forbids the other's via
+ * `?: never`.
+ */
+type FooterProps = FooterCopyrightProps | FooterComponentProps;
+
+export type { FooterComponentProps as F, FooterCopyrightProps as a, FooterProps as b };

package/dist/Footer.types-Dv2TPN2J.d.ts

@@ -0,0 +1,24 @@
+import React__default from 'react';
+
+interface BaseFooterProps {
+    className?: string;
+}
+interface FooterCopyrightProps extends BaseFooterProps {
+    /** Copyright text, centered in the footer. */
+    copyright: string;
+    component?: never;
+}
+interface FooterComponentProps extends BaseFooterProps {
+    /** Custom content that fully replaces the default centered copyright text. */
+    component: React__default.ReactNode;
+    copyright?: never;
+}
+/**
+ * Discriminated union - pass exactly one of `copyright` or `component`, never
+ * both. Mirrors the `TextButtonProps | IconButtonProps` pattern used by
+ * `Button`: picking one variant's required prop forbids the other's via
+ * `?: never`.
+ */
+type FooterProps = FooterCopyrightProps | FooterComponentProps;
+
+export type { FooterComponentProps as F, FooterCopyrightProps as a, FooterProps as b };

package/dist/Header.types-BZi80bWz.d.cts

@@ -0,0 +1,17 @@
+import { T as TextButtonProps, I as IconButtonProps } from './Button.types-DZRCVqyN.cjs';
+
+interface HeaderProps {
+    /** Page or section title. */
+    title: string;
+    /** Supporting text rendered below the title. */
+    subtitle?: string | React.ReactNode;
+    /** Trailing action buttons, rendered right-aligned. */
+    actions?: HeaderActionProps[];
+    className?: string;
+}
+/**
+ * Restricted, discriminated subset of ButtonProps for Header actions.
+ */
+type HeaderActionProps = Pick<TextButtonProps, 'variant' | 'color' | 'loading' | 'disabled' | 'preIcon' | 'posIcon' | 'icon' | 'children' | 'onClick' | 'tooltip'> | Pick<IconButtonProps, 'variant' | 'color' | 'loading' | 'disabled' | 'preIcon' | 'posIcon' | 'icon' | 'children' | 'onClick' | 'tooltip'>;
+
+export type { HeaderActionProps as H, HeaderProps as a };

package/dist/Header.types-DJt-q01P.d.ts

@@ -0,0 +1,17 @@
+import { T as TextButtonProps, I as IconButtonProps } from './Button.types-BH0CPyPx.js';
+
+interface HeaderProps {
+    /** Page or section title. */
+    title: string;
+    /** Supporting text rendered below the title. */
+    subtitle?: string | React.ReactNode;
+    /** Trailing action buttons, rendered right-aligned. */
+    actions?: HeaderActionProps[];
+    className?: string;
+}
+/**
+ * Restricted, discriminated subset of ButtonProps for Header actions.
+ */
+type HeaderActionProps = Pick<TextButtonProps, 'variant' | 'color' | 'loading' | 'disabled' | 'preIcon' | 'posIcon' | 'icon' | 'children' | 'onClick' | 'tooltip'> | Pick<IconButtonProps, 'variant' | 'color' | 'loading' | 'disabled' | 'preIcon' | 'posIcon' | 'icon' | 'children' | 'onClick' | 'tooltip'>;
+
+export type { HeaderActionProps as H, HeaderProps as a };

package/dist/Input.types-DFZNyJGF.d.cts

@@ -0,0 +1,45 @@
+import React__default from 'react';
+import { I as IconType } from './renderIcon-C2lEMMzb.cjs';
+import { C as ComponentSizeProps } from './sizes-DM6Rrrgq.cjs';
+
+type InputVariantProps = 'filled' | 'outlined' | 'text' | 'bare';
+type InputColorProps = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info';
+interface BaseInputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'size'> {
+    variant?: InputVariantProps;
+    color?: InputColorProps;
+    size?: ComponentSizeProps;
+    disabled?: boolean;
+    loading?: boolean;
+    className?: string;
+    fullWidth?: boolean;
+    width?: number | string;
+    label?: string;
+    error?: string;
+    disclaimerIcon?: IconType;
+    disclaimerContent?: string;
+    preIcon?: IconType;
+    posIcon?: IconType;
+    posIconButton?: boolean;
+    onPosIconClick?: () => void;
+    required?: boolean;
+    isSelect?: boolean;
+    clearable?: boolean;
+}
+interface TextInputProps extends BaseInputProps {
+    type?: 'text' | 'email' | 'tel' | 'url' | 'search';
+}
+interface PasswordInputProps extends BaseInputProps {
+    type: 'password';
+}
+interface NumberInputProps extends BaseInputProps {
+    type: 'number';
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+}
+interface DateInputProps extends BaseInputProps {
+    type: 'date';
+}
+type InputProps = TextInputProps | PasswordInputProps | NumberInputProps | DateInputProps;
+
+export type { InputColorProps as I, InputProps as a, InputVariantProps as b };

package/dist/Input.types-XrJTI0JC.d.ts

@@ -0,0 +1,45 @@
+import React__default from 'react';
+import { I as IconType } from './renderIcon-C2lEMMzb.js';
+import { C as ComponentSizeProps } from './sizes-DM6Rrrgq.js';
+
+type InputVariantProps = 'filled' | 'outlined' | 'text' | 'bare';
+type InputColorProps = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info';
+interface BaseInputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'size'> {
+    variant?: InputVariantProps;
+    color?: InputColorProps;
+    size?: ComponentSizeProps;
+    disabled?: boolean;
+    loading?: boolean;
+    className?: string;
+    fullWidth?: boolean;
+    width?: number | string;
+    label?: string;
+    error?: string;
+    disclaimerIcon?: IconType;
+    disclaimerContent?: string;
+    preIcon?: IconType;
+    posIcon?: IconType;
+    posIconButton?: boolean;
+    onPosIconClick?: () => void;
+    required?: boolean;
+    isSelect?: boolean;
+    clearable?: boolean;
+}
+interface TextInputProps extends BaseInputProps {
+    type?: 'text' | 'email' | 'tel' | 'url' | 'search';
+}
+interface PasswordInputProps extends BaseInputProps {
+    type: 'password';
+}
+interface NumberInputProps extends BaseInputProps {
+    type: 'number';
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+}
+interface DateInputProps extends BaseInputProps {
+    type: 'date';
+}
+type InputProps = TextInputProps | PasswordInputProps | NumberInputProps | DateInputProps;
+
+export type { InputColorProps as I, InputProps as a, InputVariantProps as b };

package/dist/Menu.types-DNIpjSAK.d.ts

@@ -0,0 +1,49 @@
+import React__default from 'react';
+import { I as IconType } from './renderIcon-C2lEMMzb.js';
+
+interface BaseMenuItem {
+    id: string;
+    disabled?: boolean;
+}
+interface MenuItem extends BaseMenuItem {
+    type: 'item';
+    label: string;
+    icon?: IconType;
+    onClick?: () => void;
+    shortcut?: string;
+    /** Applies a semantic color to the item. Use `'danger'` for destructive actions. */
+    color?: 'danger';
+}
+interface MenuComponentItem extends BaseMenuItem {
+    type: 'component';
+    component: React__default.ReactNode;
+}
+interface MenuSeparator extends BaseMenuItem {
+    type: 'separator';
+}
+interface MenuNestedItem extends BaseMenuItem {
+    type: 'nested';
+    label: string;
+    icon?: IconType;
+    items: MenuItemType[];
+}
+type MenuItemType = MenuItem | MenuComponentItem | MenuSeparator | MenuNestedItem;
+interface MenuProps {
+    items: MenuItemType[];
+    className?: string;
+    onItemClick?: (item: MenuItem) => void;
+}
+interface MenuWrapperProps {
+    trigger: React__default.ReactNode;
+    items: MenuItemType[];
+    minWidth?: number | string;
+    maxWidth?: number | string;
+    minHeight?: number | string;
+    maxHeight?: number | string;
+    autoWidth?: boolean;
+    triggerRef?: React__default.RefObject<HTMLElement | null>;
+    closeOnItemClick?: boolean;
+    tooltip?: string;
+}
+
+export type { MenuComponentItem as M, MenuItem as a, MenuItemType as b, MenuNestedItem as c, MenuProps as d, MenuSeparator as e, MenuWrapperProps as f };