@aircall/blocks 0.2.1

package/dist/index.d.ts

@@ -0,0 +1,350 @@
+import * as React from "react";
+import { Badge, Button, CounterBadge, SidebarProvider, TabsList, useSidebar } from "@aircall/ds";
+import * as react_jsx_runtime23 from "react/jsx-runtime";
+import { useRender } from "@base-ui/react/use-render";
+
+//#region src/components/copy-button.d.ts
+type CopyButtonProps = Omit<React.ComponentProps<typeof Button>, 'onClick' | 'variant'> & {
+  value: string;
+  timeout?: number;
+  onCopied?: () => void; /** Visual style of the underlying Button. Limited to non-primary variants suitable for copy actions. */
+  variant?: 'outline' | 'ghost';
+};
+declare function CopyButton({
+  value,
+  timeout,
+  onCopied,
+  variant,
+  children,
+  ...buttonProps
+}: CopyButtonProps): react_jsx_runtime23.JSX.Element;
+interface CopyButtonIconProps {
+  className?: string;
+}
+declare function CopyButtonIcon({
+  className
+}: CopyButtonIconProps): react_jsx_runtime23.JSX.Element;
+interface CopyButtonLabelProps {
+  label?: string;
+  copiedLabel?: string;
+  className?: string;
+}
+declare function CopyButtonLabel({
+  label,
+  copiedLabel,
+  className
+}: CopyButtonLabelProps): react_jsx_runtime23.JSX.Element;
+//#endregion
+//#region src/components/dashboard-page.d.ts
+declare function DashboardPage({
+  className,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageBanner({
+  className,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageContent({
+  className,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageMain({
+  className,
+  ...props
+}: React.ComponentProps<'main'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageTabs({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsList>): react_jsx_runtime23.JSX.Element;
+//#endregion
+//#region src/components/dashboard-page-header.d.ts
+declare function DashboardPageHeader({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageHeaderNav({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+type DashboardPageHeaderNavBackProps = Omit<React.ComponentProps<typeof Button>, 'variant' | 'size'>;
+declare function DashboardPageHeaderNavBack({
+  children,
+  ...props
+}: DashboardPageHeaderNavBackProps): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageHeaderPrefix({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageHeaderTitleGroup({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+type DashboardPageHeaderTitleProps = React.ComponentProps<'h1'> & {
+  size?: 'lg' | 'sm';
+};
+declare function DashboardPageHeaderTitle({
+  size,
+  className,
+  children,
+  ...props
+}: DashboardPageHeaderTitleProps): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageHeaderSubtitle({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageHeaderDescription({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardPageHeaderActions({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+type DashboardPageHeaderActionProps = Omit<React.ComponentProps<typeof Button>, 'size'> & {
+  size?: 'lg' | 'icon-lg';
+};
+declare const DashboardPageHeaderAction: React.ForwardRefExoticComponent<Omit<DashboardPageHeaderActionProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+//#endregion
+//#region src/components/product-badges.d.ts
+type BadgeBaseProps = Omit<React.ComponentProps<typeof Badge>, 'variant' | 'children'>;
+/** Blue pill — feature in beta, not yet GA */
+declare const BetaBadge: {
+  ({
+    className,
+    ...props
+  }: BadgeBaseProps): react_jsx_runtime23.JSX.Element;
+  displayName: string;
+};
+/** Green pill — recently launched feature */
+declare const NewBadge: {
+  ({
+    className,
+    ...props
+  }: BadgeBaseProps): react_jsx_runtime23.JSX.Element;
+  displayName: string;
+};
+/** Amber pill — feature being phased out */
+declare const DeprecatedBadge: {
+  ({
+    className,
+    ...props
+  }: BadgeBaseProps): react_jsx_runtime23.JSX.Element;
+  displayName: string;
+};
+/** Blue pill — user is in a trial period (same blue family as Beta) */
+declare const TrialBadge: {
+  ({
+    className,
+    ...props
+  }: BadgeBaseProps): react_jsx_runtime23.JSX.Element;
+  displayName: string;
+};
+/** Green pill — Professional tier (no gradient; uses default Badge variant) */
+declare function ProfessionalBadge({
+  className,
+  ...props
+}: BadgeBaseProps): react_jsx_runtime23.JSX.Element;
+type RoleBadgeRole = 'agent' | 'supervisor' | 'admin' | 'owner';
+type RoleBadgeProps = BadgeBaseProps & {
+  /** The user's role within Aircall. */role: RoleBadgeRole;
+};
+declare function RoleBadge({
+  role,
+  className,
+  ...props
+}: RoleBadgeProps): react_jsx_runtime23.JSX.Element;
+//#endregion
+//#region src/hooks/use-copy-to-clipboard.d.ts
+interface UseCopyToClipboardOptions {
+  timeout?: number;
+  onCopied?: () => void;
+}
+declare function useCopyToClipboard(value: string, {
+  timeout,
+  onCopied
+}?: UseCopyToClipboardOptions): {
+  copy: () => Promise<void>;
+  copied: boolean;
+};
+//#endregion
+//#region src/components/dashboard-sidebar-nav.d.ts
+type DashboardSidebarNavSubmenuSeparator = {
+  kind: 'separator';
+};
+/** Section heading inside a dropdown submenu. */
+type DashboardSidebarNavSubmenuGroupLabel = {
+  kind: 'label';
+  label: string;
+};
+type DashboardSidebarNavSubmenuLink = {
+  kind?: 'link';
+  label: string;
+  href?: string;
+  isActive?: boolean; /** Trailing badge — rendered inside <DropdownMenuAddon>. */
+  badge?: React.ReactNode;
+};
+type DashboardSidebarNavSubmenuItem = DashboardSidebarNavSubmenuLink | DashboardSidebarNavSubmenuSeparator | DashboardSidebarNavSubmenuGroupLabel;
+type DashboardSidebarNavItemBase = {
+  /** Stable key. */id: string;
+  label: string; /** Leading icon (required). */
+  icon: React.ReactNode;
+  isActive?: boolean;
+  /**
+   * Mutes the item visually (opacity, no hover) without removing interactivity.
+   * Use for upsell items that still need a tooltip or dropdown.
+   */
+  disabled?: boolean;
+  /**
+   * Trailing badge (<ProfessionalBadge />, <BetaBadge />, etc.).
+   * Rendered inside <DashboardSidebarMenuAddon>. Hidden when collapsed.
+   */
+  badge?: React.ReactNode;
+  /**
+   * Right-side action icon.
+   * - Active submenu items default to <ChevronRight />.
+   * - Disabled submenu items default to nothing — pass e.g. <LockKeyhole /> explicitly.
+   */
+  action?: React.ReactNode;
+  /**
+   * Tooltip shown on hover. When set, wraps the button in a Tooltip.
+   * Pairs naturally with disabled + a lock action icon.
+   * Requires <TooltipProvider> in the tree (the DashboardSidebar stories decorator provides one).
+   */
+  tooltip?: React.ReactNode;
+};
+/** Navigates on click. Renders as <a> (or custom element via `renderLink`). */
+type DashboardSidebarNavItemLink = DashboardSidebarNavItemBase & {
+  kind: 'link';
+  href: string; /** Count rendered as <DashboardSidebarMenuBadge>. Repositions when collapsed. */
+  count?: number;
+};
+/** Opens a dropdown submenu (sidebar-06 pattern). */
+type DashboardSidebarNavItemSubmenu = DashboardSidebarNavItemBase & {
+  kind: 'submenu';
+  items: DashboardSidebarNavSubmenuItem[];
+};
+/** Fires a callback — e.g. opens a modal or command palette. */
+type DashboardSidebarNavItemAction = DashboardSidebarNavItemBase & {
+  kind: 'action';
+  onClick: () => void;
+  count?: number;
+};
+type DashboardSidebarNavItem = DashboardSidebarNavItemLink | DashboardSidebarNavItemSubmenu | DashboardSidebarNavItemAction;
+type DashboardSidebarNavGroup = {
+  id: string;
+  label?: string;
+  items: DashboardSidebarNavItem[];
+};
+type DashboardSidebarNavProps = {
+  groups: DashboardSidebarNavGroup[];
+  /**
+   * Custom link renderer — integrates with React Router, Next.js, etc.
+   * The returned element is passed to DashboardSidebarMenuButton's `render` prop.
+   *
+   * @example
+   * renderLink={(href) => <Link to={href} />}
+   */
+  renderLink?: (href: string) => React.ReactElement;
+};
+declare function DashboardSidebarNav({
+  groups,
+  renderLink
+}: DashboardSidebarNavProps): react_jsx_runtime23.JSX.Element;
+//#endregion
+//#region src/components/dashboard-sidebar.d.ts
+type DashboardSidebarProviderProps = React.ComponentProps<typeof SidebarProvider>;
+declare function DashboardSidebarProvider({
+  className,
+  style,
+  ...props
+}: DashboardSidebarProviderProps): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebar({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebarHeader({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebarTrigger({
+  className,
+  onClick,
+  ...props
+}: React.ComponentProps<typeof Button>): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebarContent({
+  className,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebarFooter({
+  className,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebarGroup({
+  className,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebarGroupLabel({
+  className,
+  render,
+  ...props
+}: useRender.ComponentProps<'div'> & React.ComponentProps<'div'>): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+declare function DashboardSidebarMenu({
+  className,
+  ...props
+}: React.ComponentProps<'ul'>): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebarMenuItem({
+  className,
+  ...props
+}: React.ComponentProps<'li'>): react_jsx_runtime23.JSX.Element;
+type DashboardSidebarMenuButtonProps = useRender.ComponentProps<'button'> & React.ComponentProps<'button'> & {
+  isActive?: boolean;
+  /** Visual-only disabled state. The button remains clickable (e.g. to show an
+   *  upgrade dialog). Does NOT forward to the HTML disabled attribute. */
+  disabled?: boolean;
+  icon?: React.ReactNode;
+  /**
+   * Trailing "addon" rendered after the label span — mirrors the InputGroup
+   * right-addon pattern. Typically a chevron, lock, or similar icon.
+   * Hidden automatically when the sidebar is collapsed.
+   *
+   * @example
+   * <DashboardSidebarMenuButton icon={<Bot />} action={<ChevronRight />}>
+   *   AI Agents
+   * </DashboardSidebarMenuButton>
+   */
+  action?: React.ReactNode;
+};
+declare const DashboardSidebarMenuButton: React.ForwardRefExoticComponent<Omit<DashboardSidebarMenuButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+declare function DashboardSidebarMenuBadge({
+  className,
+  ...props
+}: React.ComponentProps<typeof CounterBadge>): react_jsx_runtime23.JSX.Element;
+declare function DashboardSidebarSubmenu({
+  className,
+  ...props
+}: React.ComponentProps<'div'>): react_jsx_runtime23.JSX.Element;
+type DashboardSidebarSubmenuItemProps = useRender.ComponentProps<'div'> & React.ComponentProps<'div'> & {
+  isActive?: boolean;
+};
+declare function DashboardSidebarSubmenuItem({
+  className,
+  render,
+  isActive,
+  ...props
+}: DashboardSidebarSubmenuItemProps): React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+declare function DashboardSidebarSubmenuSeparator({
+  className
+}: {
+  className?: string;
+}): react_jsx_runtime23.JSX.Element;
+//#endregion
+export { BetaBadge, CopyButton, CopyButtonIcon, CopyButtonLabel, DashboardPage, DashboardPageBanner, DashboardPageContent, DashboardPageHeader, DashboardPageHeaderAction, DashboardPageHeaderActions, DashboardPageHeaderDescription, DashboardPageHeaderNav, DashboardPageHeaderNavBack, DashboardPageHeaderPrefix, DashboardPageHeaderSubtitle, DashboardPageHeaderTitle, DashboardPageHeaderTitleGroup, DashboardPageMain, DashboardPageTabs, DashboardSidebar, DashboardSidebarContent, DashboardSidebarFooter, DashboardSidebarGroup, DashboardSidebarGroupLabel, DashboardSidebarHeader, DashboardSidebarMenu, DashboardSidebarMenuBadge, DashboardSidebarMenuButton, DashboardSidebarMenuItem, DashboardSidebarNav, type DashboardSidebarNavGroup, type DashboardSidebarNavItem, type DashboardSidebarNavItemAction, type DashboardSidebarNavItemLink, type DashboardSidebarNavItemSubmenu, type DashboardSidebarNavProps, type DashboardSidebarNavSubmenuItem, DashboardSidebarProvider, DashboardSidebarSubmenu, DashboardSidebarSubmenuItem, DashboardSidebarSubmenuSeparator, DashboardSidebarTrigger, DeprecatedBadge, NewBadge, ProfessionalBadge, RoleBadge, type RoleBadgeRole, TrialBadge, useCopyToClipboard, useSidebar as useDashboardSidebar };