@fairmint/ui 0.1.5 → 0.1.7

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.5",
+  "version": "0.1.7",
   "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"}