@fairmint/ui 0.1.4 → 0.1.6

package/dist/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useDebouncedCallback } from './useDebouncedCallback';
+export { useForm } from './useForm';
+export { MOBILE_BREAKPOINT, useIsMobile } from './useIsMobile';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/hooks/useDebouncedCallback.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns a debounced version of `fn` that delays invocation by `delay` ms.
+ * The debounced function is stable across renders (same reference).
+ */
+export declare function useDebouncedCallback<T extends (...args: Parameters<T>) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=useDebouncedCallback.d.ts.map

package/dist/hooks/useDebouncedCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedCallback.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebouncedCallback.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7E,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAoBlC"}

package/dist/hooks/useForm.d.ts

@@ -0,0 +1,8 @@
+import { UseFormReturnType } from '@mantine/form';
+import { z } from 'zod';
+export declare function useForm<T extends z.ZodType>(options: {
+    schema: T;
+    initialValues: z.infer<T>;
+    validateInputOnBlur?: boolean;
+}): UseFormReturnType<z.infer<T>>;
+//# sourceMappingURL=useForm.d.ts.map

package/dist/hooks/useForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForm.d.ts","sourceRoot":"","sources":["../../src/hooks/useForm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAA6B,MAAM,eAAe,CAAC;AAElF,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAgB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE;IACpD,MAAM,EAAE,CAAC,CAAC;IACV,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAOhC"}

package/dist/hooks/useIsMobile.d.ts

@@ -0,0 +1,6 @@
+export declare const MOBILE_BREAKPOINT = "(max-width: 48em)";
+/**
+ * Returns true when the viewport is below the Fairmint `sm` breakpoint (48em / 768px).
+ */
+export declare function useIsMobile(): boolean;
+//# sourceMappingURL=useIsMobile.d.ts.map

package/dist/hooks/useIsMobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsMobile.d.ts","sourceRoot":"","sources":["../../src/hooks/useIsMobile.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAMrC"}

package/dist/index.d.ts

@@ -1,18 +1,87 @@
-export type { AppHeaderProps } from './components/AppHeader/AppHeader';
-export { AppHeader } from './components/AppHeader/AppHeader';
 export type { ErrorFallbackProps } from './components/ErrorFallback/ErrorFallback';
 export { ErrorFallback } from './components/ErrorFallback/ErrorFallback';
 export type { FairmintLogoProps } from './components/FairmintLogo/FairmintLogo';
 export { FairmintLogo } from './components/FairmintLogo/FairmintLogo';
 export type { FairmintProviderProps } from './components/FairmintProvider/FairmintProvider';
 export { FairmintProvider } from './components/FairmintProvider/FairmintProvider';
+export type { EmailFieldProps } from './components/form/EmailField';
+export { EmailField, emailSchema } from './components/form/EmailField';
+export type { FormProps } from './components/form/Form';
+export { Form } from './components/form/Form';
+export type { FormFieldProps } from './components/form/FormField';
+export { FormField } from './components/form/FormField';
+export type { PasswordFieldProps } from './components/form/PasswordField';
+export { PasswordField, passwordSchema } from './components/form/PasswordField';
+export type { PhoneFieldProps } from './components/form/PhoneField';
+export { PhoneField, phoneSchema } from './components/form/PhoneField';
+export type { AnimateInDirection, AnimateInProps } from './components/generic/AnimateIn/AnimateIn';
+export { AnimateIn } from './components/generic/AnimateIn/AnimateIn';
+export type { ConfirmDialogProps } from './components/generic/ConfirmDialog/ConfirmDialog';
+export { ConfirmDialog } from './components/generic/ConfirmDialog/ConfirmDialog';
+export type { CurrencyProps } from './components/generic/Currency/Currency';
+export { Currency } from './components/generic/Currency/Currency';
+export type { DataTableColumn, DataTableProps } from './components/generic/DataTable/DataTable';
+export { DataTable } from './components/generic/DataTable/DataTable';
+export type { DateDisplayProps } from './components/generic/DateDisplay/DateDisplay';
+export { DateDisplay } from './components/generic/DateDisplay/DateDisplay';
+export type { DetailDrawerProps } from './components/generic/DetailDrawer/DetailDrawer';
+export { DetailDrawer } from './components/generic/DetailDrawer/DetailDrawer';
+export type { EmptyStateProps } from './components/generic/EmptyState/EmptyState';
+export { EmptyState } from './components/generic/EmptyState/EmptyState';
+export type { ListRowProps } from './components/generic/ListRow/ListRow';
+export { ListRow } from './components/generic/ListRow/ListRow';
+export type { PercentProps } from './components/generic/Percent/Percent';
+export { Percent } from './components/generic/Percent/Percent';
+export type { SearchInputProps } from './components/generic/SearchInput/SearchInput';
+export { SearchInput } from './components/generic/SearchInput/SearchInput';
+export type { StatCardProps } from './components/generic/StatCard/StatCard';
+export { StatCard } from './components/generic/StatCard/StatCard';
+export type { StatusBadgeProps } from './components/generic/StatusBadge/StatusBadge';
+export { StatusBadge } from './components/generic/StatusBadge/StatusBadge';
 export type { LoadingSpinnerProps } from './components/LoadingSpinner/LoadingSpinner';
 export { LoadingSpinner } from './components/LoadingSpinner/LoadingSpinner';
-export type { PageHeaderProps } from './components/PageHeader/PageHeader';
-export { PageHeader } from './components/PageHeader/PageHeader';
-export type { SideNavItem, SideNavProps } from './components/SideNav/SideNav';
-export { SideNav } from './components/SideNav/SideNav';
-export type { UserMenuItem, UserMenuProps } from './components/UserMenu/UserMenu';
-export { UserMenu } from './components/UserMenu/UserMenu';
-export { brandColors, neutralColors, semanticColors, theme } from './theme';
+export type { AppHeaderProps } from './components/layout/AppHeader/AppHeader';
+export { AppHeader } from './components/layout/AppHeader/AppHeader';
+export type { PageHeaderProps } from './components/layout/PageHeader/PageHeader';
+export { PageHeader } from './components/layout/PageHeader/PageHeader';
+export type { SideNavItem, SideNavProps } from './components/layout/SideNav/SideNav';
+export { SideNav } from './components/layout/SideNav/SideNav';
+export type { UserMenuItem, UserMenuProps } from './components/layout/UserMenu/UserMenu';
+export { UserMenu } from './components/layout/UserMenu/UserMenu';
+export { ActionIcon } from './components/primitives/ActionIcon/ActionIcon';
+export { Alert } from './components/primitives/Alert/Alert';
+export { Avatar } from './components/primitives/Avatar/Avatar';
+export { Badge } from './components/primitives/Badge/Badge';
+export { Button, type ButtonProps } from './components/primitives/Button/Button';
+export { Card } from './components/primitives/Card/Card';
+export { Checkbox } from './components/primitives/Checkbox/Checkbox';
+export { Drawer } from './components/primitives/Drawer/Drawer';
+export { Anchor, Box, Center, Collapse, Container, Divider, Flex, Grid, Group, Paper, ScrollArea, SimpleGrid, Space, Stack, Text, Title, useClickOutside, useClipboard, useDebouncedValue, useDisclosure, useHotkeys, useId, useIntersection, useMediaQuery, useScrollIntoView, useViewportSize, } from './components/primitives/layout';
+export { Menu } from './components/primitives/Menu/Menu';
+export { Modal } from './components/primitives/Modal/Modal';
+export { PasswordInput } from './components/primitives/PasswordInput/PasswordInput';
+export { Select } from './components/primitives/Select/Select';
+export { Skeleton } from './components/primitives/Skeleton/Skeleton';
+export { Switch } from './components/primitives/Switch/Switch';
+export { Table } from './components/primitives/Table/Table';
+export { Tabs } from './components/primitives/Tabs/Tabs';
+export { TextInput } from './components/primitives/TextInput/TextInput';
+export { Tooltip } from './components/primitives/Tooltip/Tooltip';
+export type { DocumentRowProps } from './components/specific/DocumentRow/DocumentRow';
+export { DocumentRow } from './components/specific/DocumentRow/DocumentRow';
+export type { EquityGrantCardProps } from './components/specific/EquityGrantCard/EquityGrantCard';
+export { EquityGrantCard } from './components/specific/EquityGrantCard/EquityGrantCard';
+export type { InvestmentCardProps } from './components/specific/InvestmentCard/InvestmentCard';
+export { InvestmentCard } from './components/specific/InvestmentCard/InvestmentCard';
+export type { InvestorProfileCardProps } from './components/specific/InvestorProfileCard/InvestorProfileCard';
+export { InvestorProfileCard } from './components/specific/InvestorProfileCard/InvestorProfileCard';
+export { useDebouncedCallback } from './hooks/useDebouncedCallback';
+export { useForm } from './hooks/useForm';
+export { MOBILE_BREAKPOINT, useIsMobile } from './hooks/useIsMobile';
+export { notify } from './notify';
+export type { AvatarPaletteColor, FairmintColor } from './theme';
+export { AVATAR_PALETTE, brandColors, colors, neutralColors, semanticColors, theme } from './theme';
+export { truncateAddress } from './utils/address';
+export { getAvatarColor } from './utils/avatar';
+export { formatCurrency, formatCurrencyPrecise, formatDate, formatNumber, formatPercent, formatPreciseWithCurrency, } from './utils/format';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,YAAY,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAE5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,YAAY,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAG5E,OAAO,gDAAgD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/notify.d.ts

@@ -0,0 +1,23 @@
+interface NotifyOptions {
+    title?: string;
+    message: string;
+    autoClose?: number | false;
+}
+/**
+ * Fairmint notification helpers.
+ *
+ * Uses Mantine's notifications system with Fairmint semantic colors.
+ * Requires FairmintProvider to be mounted in the component tree.
+ *
+ * @example
+ * notify.success({ message: "Investment saved." });
+ * notify.error({ title: "Error", message: "Failed to load data." });
+ */
+export declare const notify: {
+    success: ({ title, message, autoClose }: NotifyOptions) => string;
+    error: ({ title, message, autoClose }: NotifyOptions) => string;
+    warning: ({ title, message, autoClose }: NotifyOptions) => string;
+    info: ({ title, message, autoClose }: NotifyOptions) => string;
+};
+export {};
+//# sourceMappingURL=notify.d.ts.map

package/dist/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM;6CAC+B,aAAa;2CAGf,aAAa;6CAGX,aAAa;0CAGhB,aAAa;CAE3D,CAAC"}

package/dist/styles.css

@@ -1,3 +1,4 @@
+/* fillUp — used by LoadingSpinner */
 @keyframes fillUp {
   0% {
     clip-path: inset(100% 0 0 0);
@@ -6,3 +7,71 @@
     clip-path: inset(0 0 0 0);
   }
 }
+/* gradientFlow — animated gradient text/background */
+@keyframes gradientFlow {
+  0% {
+    background-position: 0% center;
+  }
+  50% {
+    background-position: 100% center;
+  }
+  100% {
+    background-position: 0% center;
+  }
+}
+/* fadeUp — staggered entrance for list items */
+@keyframes fadeUp {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+/* breathe — subtle pulsing glow effect */
+@keyframes breathe {
+  0%,
+  100% {
+    opacity: 0.6;
+    transform: scale(1);
+  }
+  50% {
+    opacity: 1;
+    transform: scale(1.05);
+  }
+}
+/* rowSlideIn — list rows slide in from left */
+@keyframes rowSlideIn {
+  from {
+    opacity: 0;
+    transform: translateX(-12px);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+/* rowSlideInRight — list rows slide in from right */
+@keyframes rowSlideInRight {
+  from {
+    opacity: 0;
+    transform: translateX(12px);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+/* fadeDown — entrance from above */
+@keyframes fadeDown {
+  from {
+    opacity: 0;
+    transform: translateY(-10px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}

package/dist/theme/colors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Branded color constants for Fairmint UI.
+ * These map to Mantine color names defined in src/theme/index.ts.
+ * Import from here instead of hardcoding color name strings.
+ */
+export declare const colors: {
+    /** Primary UI color — buttons, links, active states. */
+    readonly primary: "indigo";
+    /** Fairmint brand blue — gradients, brand elements. */
+    readonly brandBlue: "fairmintBlue";
+    /** Fairmint brand purple — gradients, brand elements. */
+    readonly brandPurple: "fairmintPurple";
+    /** Positive outcome — completed, approved, active. */
+    readonly success: "success";
+    /** Caution — pending, processing, review. */
+    readonly warning: "warning";
+    /** Negative outcome — failed, rejected, cancelled. */
+    readonly error: "error";
+    /** Informational — neutral status messages. */
+    readonly info: "info";
+    /** Neutral gray scale — borders, backgrounds, disabled. */
+    readonly neutral: "gray";
+    /** Accent color 1 for avatar palette. */
+    readonly accent1: "teal";
+    /** Accent color 2 for avatar palette. */
+    readonly accent2: "cyan";
+    /** Accent color 3 for avatar palette. */
+    readonly accent3: "green";
+};
+export type FairmintColor = (typeof colors)[keyof typeof colors];
+/**
+ * Avatar palette for deterministic color assignment.
+ * Used by getAvatarColor() to map names to colors.
+ */
+export declare const AVATAR_PALETTE: readonly ["indigo", "fairmintBlue", "fairmintPurple", "success", "info", "teal", "cyan", "green"];
+export type AvatarPaletteColor = (typeof AVATAR_PALETTE)[number];
+//# sourceMappingURL=colors.d.ts.map

package/dist/theme/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/theme/colors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,MAAM;IACjB,wDAAwD;;IAExD,uDAAuD;;IAEvD,yDAAyD;;IAEzD,sDAAsD;;IAEtD,6CAA6C;;IAE7C,sDAAsD;;IAEtD,+CAA+C;;IAE/C,2DAA2D;;IAE3D,yCAAyC;;IAEzC,yCAAyC;;IAEzC,yCAAyC;;CAEjC,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,cAAc,mGASjB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/theme/index.d.ts

@@ -71,8 +71,8 @@ export declare const theme: {
     } | undefined;
     radius?: {
         [x: string & {}]: string | undefined;
-        xs?: string | undefined;
         sm?: string | undefined;
+        xs?: string | undefined;
         md?: string | undefined;
         lg?: string | undefined;
         xl?: string | undefined;
@@ -81,40 +81,40 @@ export declare const theme: {
     spacing?: {
         [x: number]: string | undefined;
         [x: string & {}]: string | undefined;
-        xs?: string | undefined;
         sm?: string | undefined;
+        xs?: string | undefined;
         md?: string | undefined;
         lg?: string | undefined;
         xl?: string | undefined;
     } | undefined;
     fontSizes?: {
         [x: string & {}]: string | undefined;
-        xs?: string | undefined;
         sm?: string | undefined;
+        xs?: string | undefined;
         md?: string | undefined;
         lg?: string | undefined;
         xl?: string | undefined;
     } | undefined;
     lineHeights?: {
         [x: string & {}]: string | undefined;
-        xs?: string | undefined;
         sm?: string | undefined;
+        xs?: string | undefined;
         md?: string | undefined;
         lg?: string | undefined;
         xl?: string | undefined;
     } | undefined;
     breakpoints?: {
         [x: string & {}]: string | undefined;
-        xs?: string | undefined;
         sm?: string | undefined;
+        xs?: string | undefined;
         md?: string | undefined;
         lg?: string | undefined;
         xl?: string | undefined;
     } | undefined;
     shadows?: {
         [x: string & {}]: string | undefined;
-        xs?: string | undefined;
         sm?: string | undefined;
+        xs?: string | undefined;
         md?: string | undefined;
         lg?: string | undefined;
         xl?: string | undefined;
@@ -167,4 +167,6 @@ export declare const semanticColors: {
     readonly error: "#F04438";
     readonly info: "#06AED4";
 };
+export type { AvatarPaletteColor, FairmintColor } from './colors';
+export { AVATAR_PALETTE, colors } from './colors';
 //# sourceMappingURL=index.d.ts.map

package/dist/theme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAiIrE,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEhB,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,aAAa;;;;;;;;;;;CAWhB,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAiIrE,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEhB,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,aAAa;;;;;;;;;;;CAWhB,CAAC;AAEX,gDAAgD;AAChD,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/utils/address.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Truncate a wallet address to "0x1234...5678" format.
+ *
+ * @param address - Full address string (e.g., "0x1234567890abcdef...")
+ * @param chars - Characters to show on each side. @default 4
+ * @example truncateAddress("0x1234567890abcdef1234") → "0x1234...1234"
+ * @example truncateAddress("0x1234567890abcdef1234", 6) → "0x123456...ef1234"
+ */
+export declare function truncateAddress(address: string, chars?: number): string;
+//# sourceMappingURL=address.d.ts.map

package/dist/utils/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/utils/address.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAGlE"}

package/dist/utils/avatar.d.ts

@@ -0,0 +1,9 @@
+import { AvatarPaletteColor } from '../theme/colors';
+/**
+ * Deterministically map a string (e.g., company name) to a Mantine color name.
+ *
+ * @example getAvatarColor("Acme Corp") → "teal"
+ * @example getAvatarColor("") → colors.primary (fallback)
+ */
+export declare function getAvatarColor(name: string): AvatarPaletteColor;
+//# sourceMappingURL=avatar.d.ts.map

package/dist/utils/avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../src/utils/avatar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAO/D"}

package/dist/utils/format.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Shared formatting utilities.
+ *
+ * Reusable across features — currency, number, and date formatting
+ * using the Intl API for locale-aware output.
+ */
+/**
+ * Format a number as USD currency (no cents).
+ *
+ * @example formatCurrency(125000) → "$125,000"
+ */
+export declare function formatCurrency(n: number): string;
+/**
+ * Format a number as USD currency with up to 2 decimal places.
+ * Useful for per-share prices and exercise prices where cents matter.
+ * For sub-penny values (< $0.01), uses up to 6 decimal places to
+ * avoid showing "$0.00" for values like $0.0001.
+ *
+ * @example formatCurrencyPrecise(0.01)     → "$0.01"
+ * @example formatCurrencyPrecise(12.50)    → "$12.50"
+ * @example formatCurrencyPrecise(100)      → "$100.00"
+ * @example formatCurrencyPrecise(0.0001)   → "$0.0001"
+ * @example formatCurrencyPrecise(0.000001) → "$0.000001"
+ */
+export declare function formatCurrencyPrecise(n: number): string;
+/**
+ * Format a number as currency with the correct symbol for any currency code.
+ * Uses sub-penny precision for values < $0.01, same as formatCurrencyPrecise.
+ *
+ * @example formatPreciseWithCurrency(1.50, 'USD') → "$1.50"
+ * @example formatPreciseWithCurrency(1.50, 'EUR') → "€1.50"
+ * @example formatPreciseWithCurrency(0.0001, 'USD') → "$0.0001"
+ */
+export declare function formatPreciseWithCurrency(n: number, currency: string): string;
+/**
+ * Format a number with locale-aware comma separators.
+ *
+ * @example formatNumber(1234567) → "1,234,567"
+ */
+export declare function formatNumber(n: number): string;
+/**
+ * Format an ISO date string for display.
+ *
+ * Handles both full ISO timestamps and date-only strings (YYYY-MM-DD).
+ * Date-only strings are parsed as local time to avoid the classic
+ * off-by-one timezone bug where UTC midnight shifts to the previous
+ * day in western timezones.
+ *
+ * @example formatDate("2024-01-15T00:00:00.000Z") → "Jan 15, 2024"
+ * @example formatDate("2024-01-15") → "Jan 15, 2024"
+ */
+export declare function formatDate(dateString: string): string;
+/**
+ * Format a number as a percentage string.
+ *
+ * @param n - The decimal value (e.g., 12.5 for 12.5%)
+ * @param decimals - Number of decimal places. @default 2
+ * @example formatPercent(12.5) → "12.50%"
+ * @example formatPercent(0.5, 1) → "0.5%"
+ */
+export declare function formatPercent(n: number, decimals?: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY7E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAarD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAE7D"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './address';
+export * from './avatar';
+export * from './format';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fairmint/ui",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "Fairmint design system and UI component library",
   "license": "UNLICENSED",
@@ -39,7 +39,11 @@
   },
   "dependencies": {
     "@mantine/core": "~8.3.0",
-    "@mantine/hooks": "~8.3.0"
+    "@mantine/form": "~8.3.0",
+    "@mantine/hooks": "~8.3.0",
+    "@mantine/notifications": "~8.3.0",
+    "mantine-form-zod-resolver": "1.3.0",
+    "zod": "3.25.3"
   },
   "scripts": {
     "dev": "storybook dev -p 6006",
@@ -55,14 +59,13 @@
     "prepublishOnly": "bun run build"
   },
   "peerDependencies": {
-    "@mantine/core": "~8.3.0",
-    "@mantine/hooks": "~8.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.5",
     "@storybook/addon-a11y": "10.2.13",
+    "@storybook/addon-docs": "10.2.13",
     "@storybook/react": "10.2.13",
     "@storybook/react-vite": "10.2.13",
     "@tabler/icons-react": "3.37.1",
@@ -75,8 +78,8 @@
     "@types/react-dom": "19.2.3",
     "@vitejs/plugin-react": "5.1.4",
     "@vitest/coverage-v8": "4.0.18",
-    "jsdom": "28.1.0",
     "husky": "9.1.7",
+    "jsdom": "28.1.0",
     "react": "19.2.4",
     "react-dom": "19.2.4",
     "storybook": "10.2.13",

package/dist/components/AppHeader/AppHeader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AppHeader.d.ts","sourceRoot":"","sources":["../../../src/components/AppHeader/AppHeader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,IAAI,EAAE,SAAS,CAAC;IAChB,kDAAkD;IAClD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,YAAY,EACZ,eAAuB,EACvB,iBAAiB,EACjB,MAAW,GACZ,EAAE,cAAc,2CAkBhB"}

package/dist/components/PageHeader/PageHeader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../../src/components/PageHeader/PageHeader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,eAAe,2CActE"}

package/dist/components/SideNav/SideNav.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SideNav.d.ts","sourceRoot":"","sources":["../../../src/components/SideNav/SideNav.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,qEAAqE;IACrE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAgB,EAAE,EAAE,YAAY,2CA0B7E"}

package/dist/components/UserMenu/UserMenu.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"UserMenu.d.ts","sourceRoot":"","sources":["../../../src/components/UserMenu/UserMenu.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2GAA2G;IAC3G,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kBAAkB;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,sEAAsE;IACtE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,wBAAgB,QAAQ,CAAC,EACvB,WAAW,EACX,aAAa,EACb,WAAsB,EACtB,SAAS,EACT,KAAK,EACL,WAAW,GACZ,EAAE,aAAa,2CAsCf"}