facehash 0.0.2

package/README.md

@@ -0,0 +1,329 @@
+# facehash
+
+Deterministic avatar faces from any string. Zero dependencies, unstyled, React 18/19 compatible.
+
+Following the [shadcn/ui](https://ui.shadcn.com/) philosophy: **unstyled, composable, and yours to customize**.
+
+<p align="center">
+  <img src="https://cossistant.com/facehash-preview.png" alt="facehash examples" width="600" />
+</p>
+
+## Features
+
+- **Deterministic** - Same string always generates the same face
+- **Unstyled** - Zero CSS included, bring your own Tailwind/CSS
+- **Composable** - Use standalone or as part of Avatar compound component
+- **Dark mode ready** - Built-in light/dark color palette support
+- **Accessible** - Proper ARIA attributes included
+- **Tiny** - Zero dependencies (React is a peer dep)
+- **TypeScript** - Full type safety
+
+## Installation
+
+```bash
+npm install facehash
+# or
+pnpm add facehash
+# or
+bun add facehash
+```
+
+## Quick Start
+
+### Standalone FacehashAvatar
+
+The simplest way to get started - just a fun face!
+
+```tsx
+import { FacehashAvatar } from "facehash";
+
+function App() {
+  return (
+    <FacehashAvatar
+      name="John Doe"
+      className="w-10 h-10 rounded-full"
+    />
+  );
+}
+```
+
+### With Avatar Compound Component
+
+For image avatars with FacehashAvatar as fallback:
+
+```tsx
+import { Avatar, AvatarImage, AvatarFallback } from "facehash";
+
+function UserAvatar({ user }) {
+  return (
+    <Avatar className="w-10 h-10 rounded-full overflow-hidden">
+      <AvatarImage src={user.avatarUrl} alt={user.name} />
+      <AvatarFallback name={user.name} facehash />
+    </Avatar>
+  );
+}
+```
+
+## Usage Examples
+
+### Basic Styling with Tailwind
+
+```tsx
+<FacehashAvatar
+  name="Jane Smith"
+  className="w-12 h-12 rounded-xl bg-gray-100 dark:bg-gray-800"
+/>
+```
+
+### Custom Color Palette
+
+```tsx
+<FacehashAvatar
+  name="Alex Johnson"
+  colors={["#264653", "#2a9d8f", "#e9c46a", "#f4a261", "#e76f51"]}
+  className="w-16 h-16 rounded-full"
+/>
+```
+
+### Light/Dark Mode Colors
+
+```tsx
+<FacehashAvatar
+  name="Sam Wilson"
+  colorsLight={["#fce7f3", "#fef3c7", "#dbeafe"]}
+  colorsDark={["#db2777", "#d97706", "#2563eb"]}
+  colorScheme="auto" // Uses CSS prefers-color-scheme
+  className="w-10 h-10 rounded-full"
+/>
+```
+
+### Without 3D Effect
+
+```tsx
+<FacehashAvatar
+  name="Chris Brown"
+  enable3D={false}
+  className="w-10 h-10 rounded-lg"
+/>
+```
+
+### Without Initial Letter
+
+```tsx
+<FacehashAvatar
+  name="Taylor Swift"
+  showInitial={false}
+  className="w-10 h-10 rounded-full"
+/>
+```
+
+### Avatar with Initials Fallback
+
+```tsx
+<Avatar className="w-10 h-10 rounded-full bg-gray-200">
+  <AvatarImage src="/photo.jpg" alt="User" />
+  <AvatarFallback name="John Doe" className="text-sm font-medium" />
+</Avatar>
+```
+
+### Avatar with Custom Fallback
+
+```tsx
+import { User } from "lucide-react";
+
+<Avatar className="w-10 h-10 rounded-full bg-gray-200">
+  <AvatarImage src="/photo.jpg" alt="User" />
+  <AvatarFallback>
+    <User className="w-5 h-5 text-gray-500" />
+  </AvatarFallback>
+</Avatar>
+```
+
+### Delayed Fallback (Prevent Flash)
+
+```tsx
+<Avatar className="w-10 h-10 rounded-full">
+  <AvatarImage src="/slow-loading-image.jpg" />
+  <AvatarFallback name="John" facehash delayMs={600} />
+</Avatar>
+```
+
+## Styling with CSS
+
+### Using CSS Variables (Dark Mode)
+
+When using `colorScheme="auto"`, the component sets CSS custom properties:
+
+```css
+/* Apply the background based on color scheme */
+[data-facehash-avatar][data-color-scheme="auto"] {
+  background-color: var(--facehash-avatar-bg-light);
+}
+
+@media (prefers-color-scheme: dark) {
+  [data-facehash-avatar][data-color-scheme="auto"] {
+    background-color: var(--facehash-avatar-bg-dark);
+  }
+}
+```
+
+### Using Data Attributes
+
+All components expose data attributes for styling:
+
+```css
+/* Root avatar */
+[data-avatar] { }
+[data-avatar][data-state="loading"] { }
+[data-avatar][data-state="loaded"] { }
+[data-avatar][data-state="error"] { }
+
+/* Facehash avatar */
+[data-facehash-avatar] { }
+[data-facehash-avatar-face] { }
+[data-facehash-avatar-initial] { }
+
+/* Image and fallback */
+[data-avatar-image] { }
+[data-avatar-fallback] { }
+```
+
+## API Reference
+
+### FacehashAvatar
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `name` | `string` | Required | Name used to generate deterministic avatar |
+| `colors` | `string[]` | Tailwind colors | Base color palette |
+| `colorsLight` | `string[]` | Light variants | Colors for light mode |
+| `colorsDark` | `string[]` | Dark variants | Colors for dark mode |
+| `colorScheme` | `"light" \| "dark" \| "auto"` | `"auto"` | Color scheme to use |
+| `showInitial` | `boolean` | `true` | Show first letter below face |
+| `enable3D` | `boolean` | `true` | Enable 3D sphere rotation effect |
+
+### Avatar
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `asChild` | `boolean` | `false` | Render as child element (Slot pattern) |
+
+### AvatarImage
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `src` | `string \| null` | - | Image source URL |
+| `alt` | `string` | `""` | Alt text for accessibility |
+| `onLoadingStatusChange` | `(status) => void` | - | Callback on status change |
+
+### AvatarFallback
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `name` | `string` | `""` | Name for initials/FacehashAvatar |
+| `facehash` | `boolean` | `false` | Use FacehashAvatar instead of initials |
+| `facehashProps` | `FacehashAvatarProps` | - | Props to pass to FacehashAvatar |
+| `delayMs` | `number` | `0` | Delay before showing fallback |
+| `children` | `ReactNode` | - | Custom fallback content |
+
+## Exports
+
+```tsx
+// Components
+import {
+  FacehashAvatar,
+  Avatar,
+  AvatarImage,
+  AvatarFallback,
+} from "facehash";
+
+// Face components (for custom compositions)
+import {
+  RoundFace,
+  CrossFace,
+  LineFace,
+  CurvedFace,
+  FACES,
+} from "facehash";
+
+// Utilities
+import {
+  stringHash,
+  DEFAULT_COLORS,
+  DEFAULT_COLORS_LIGHT,
+  DEFAULT_COLORS_DARK,
+} from "facehash";
+
+// Hooks
+import { useAvatarContext } from "facehash";
+```
+
+## Recipes
+
+### Next.js App Router
+
+```tsx
+// components/user-avatar.tsx
+"use client";
+
+import { Avatar, AvatarImage, AvatarFallback } from "facehash";
+
+export function UserAvatar({ user }: { user: { name: string; image?: string } }) {
+  return (
+    <Avatar className="relative flex h-10 w-10 shrink-0 overflow-hidden rounded-full">
+      {user.image && <AvatarImage src={user.image} alt={user.name} />}
+      <AvatarFallback
+        name={user.name}
+        facehash
+        className="flex h-full w-full items-center justify-center"
+      />
+    </Avatar>
+  );
+}
+```
+
+### Tailwind with Ring
+
+```tsx
+<Avatar className="h-10 w-10 rounded-full ring-2 ring-white dark:ring-gray-900">
+  <AvatarImage src={url} />
+  <AvatarFallback name="John Doe" facehash />
+</Avatar>
+```
+
+### Avatar Group
+
+```tsx
+function AvatarGroup({ users }) {
+  return (
+    <div className="flex -space-x-2">
+      {users.map((user) => (
+        <Avatar
+          key={user.id}
+          className="h-8 w-8 rounded-full ring-2 ring-white"
+        >
+          <AvatarImage src={user.avatar} />
+          <AvatarFallback name={user.name} facehash />
+        </Avatar>
+      ))}
+    </div>
+  );
+}
+```
+
+## Browser Support
+
+- Chrome 88+
+- Firefox 78+
+- Safari 14+
+- Edge 88+
+
+## Credits
+
+Built with love by the [Cossistant](https://cossistant.com) team.
+
+Inspired by [Boring Avatars](https://boringavatars.com/) by Josep Martins.
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,261 @@
+import * as React from "react";
+
+//#region src/facehash.d.ts
+type Intensity3D = "none" | "subtle" | "medium" | "dramatic";
+type Variant = "gradient" | "solid";
+interface FacehashProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+  /**
+   * String to generate a deterministic face from.
+   * Same string always produces the same face.
+   */
+  name: string;
+  /**
+   * Size in pixels or CSS units.
+   * @default 40
+   */
+  size?: number | string;
+  /**
+   * Background style.
+   * - "gradient": Adds gradient overlay (default)
+   * - "solid": Plain background color
+   * @default "gradient"
+   */
+  variant?: Variant;
+  /**
+   * 3D effect intensity.
+   * @default "dramatic"
+   */
+  intensity3d?: Intensity3D;
+  /**
+   * Enable hover interaction.
+   * When true, face "looks straight" on hover.
+   * @default true
+   */
+  interactive?: boolean;
+  /**
+   * Show first letter of name below the face.
+   * @default true
+   */
+  showInitial?: boolean;
+  /**
+   * Hex color array for inline styles.
+   * Use this OR colorClasses, not both.
+   */
+  colors?: string[];
+  /**
+   * Tailwind class array for background colors.
+   * Example: ["bg-pink-500 dark:bg-pink-600", "bg-blue-500 dark:bg-blue-600"]
+   * Use this OR colors, not both.
+   */
+  colorClasses?: string[];
+  /**
+   * Custom gradient overlay class (Tailwind).
+   * When provided, replaces the default pure CSS gradient.
+   * Only used when variant="gradient".
+   */
+  gradientOverlayClass?: string;
+}
+/**
+ * Facehash - Deterministic avatar faces from any string.
+ *
+ * @example
+ * ```tsx
+ * // With Tailwind classes
+ * <Facehash
+ *   name="John"
+ *   colorClasses={["bg-pink-500", "bg-blue-500"]}
+ * />
+ *
+ * // With hex colors
+ * <Facehash
+ *   name="John"
+ *   colors={["#ec4899", "#3b82f6"]}
+ * />
+ *
+ * // Plain color (no gradient)
+ * <Facehash name="John" variant="solid" />
+ * ```
+ */
+declare const Facehash: React.ForwardRefExoticComponent<FacehashProps & React.RefAttributes<HTMLDivElement>>;
+//#endregion
+//#region src/avatar.d.ts
+type ImageLoadingStatus$1 = "idle" | "loading" | "loaded" | "error";
+type AvatarContextValue = {
+  imageLoadingStatus: ImageLoadingStatus$1;
+  onImageLoadingStatusChange: (status: ImageLoadingStatus$1) => void;
+};
+/**
+ * Hook to access the Avatar context.
+ * Throws an error if used outside of Avatar.
+ */
+declare const useAvatarContext: () => AvatarContextValue;
+type AvatarProps = React.HTMLAttributes<HTMLSpanElement> & {
+  /**
+   * Render as a different element using the asChild pattern.
+   * When true, Avatar renders its child and merges props.
+   */
+  asChild?: boolean;
+};
+/**
+ * Root avatar component that provides context for image loading state.
+ *
+ * @example
+ * ```tsx
+ * <Avatar className="w-10 h-10 rounded-full overflow-hidden">
+ *   <AvatarImage src="/photo.jpg" alt="John" />
+ *   <AvatarFallback name="John Doe" />
+ * </Avatar>
+ * ```
+ */
+declare const Avatar: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+  /**
+   * Render as a different element using the asChild pattern.
+   * When true, Avatar renders its child and merges props.
+   */
+  asChild?: boolean;
+} & React.RefAttributes<HTMLSpanElement>>;
+//#endregion
+//#region src/avatar-fallback.d.ts
+type AvatarFallbackProps = Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
+  /**
+   * The name to derive initials and Facehash from.
+   */
+  name?: string;
+  /**
+   * Delay in milliseconds before showing the fallback.
+   * Useful to prevent flashing when images load quickly.
+   * @default 0
+   */
+  delayMs?: number;
+  /**
+   * Custom children to render instead of initials or Facehash.
+   */
+  children?: React.ReactNode;
+  /**
+   * Use the Facehash component as fallback instead of initials.
+   * @default true
+   */
+  facehash?: boolean;
+  /**
+   * Props to pass to the Facehash component.
+   */
+  facehashProps?: Omit<FacehashProps, "name">;
+};
+/**
+ * Fallback component that displays when the image fails to load.
+ * Uses Facehash by default, can show initials or custom content.
+ *
+ * @example
+ * ```tsx
+ * // With Facehash (default)
+ * <AvatarFallback name="John Doe" />
+ *
+ * // With initials
+ * <AvatarFallback name="John Doe" facehash={false} />
+ *
+ * // With custom content
+ * <AvatarFallback>
+ *   <UserIcon />
+ * </AvatarFallback>
+ * ```
+ */
+declare const AvatarFallback: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLSpanElement>, "children"> & {
+  /**
+   * The name to derive initials and Facehash from.
+   */
+  name?: string;
+  /**
+   * Delay in milliseconds before showing the fallback.
+   * Useful to prevent flashing when images load quickly.
+   * @default 0
+   */
+  delayMs?: number;
+  /**
+   * Custom children to render instead of initials or Facehash.
+   */
+  children?: React.ReactNode;
+  /**
+   * Use the Facehash component as fallback instead of initials.
+   * @default true
+   */
+  facehash?: boolean;
+  /**
+   * Props to pass to the Facehash component.
+   */
+  facehashProps?: Omit<FacehashProps, "name">;
+} & React.RefAttributes<HTMLSpanElement>>;
+//#endregion
+//#region src/avatar-image.d.ts
+type ImageLoadingStatus = "idle" | "loading" | "loaded" | "error";
+type AvatarImageProps = Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src"> & {
+  /**
+   * The image source URL. If empty or undefined, triggers error state.
+   */
+  src?: string | null;
+  /**
+   * Callback when the image loading status changes.
+   */
+  onLoadingStatusChange?: (status: ImageLoadingStatus) => void;
+};
+/**
+ * Image component that syncs its loading state with the Avatar context.
+ * Automatically hides when loading fails, allowing fallback to show.
+ *
+ * @example
+ * ```tsx
+ * <Avatar>
+ *   <AvatarImage src="/photo.jpg" alt="User" />
+ *   <AvatarFallback name="John Doe" />
+ * </Avatar>
+ * ```
+ */
+declare const AvatarImage: React.ForwardRefExoticComponent<Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src"> & {
+  /**
+   * The image source URL. If empty or undefined, triggers error state.
+   */
+  src?: string | null;
+  /**
+   * Callback when the image loading status changes.
+   */
+  onLoadingStatusChange?: (status: ImageLoadingStatus) => void;
+} & React.RefAttributes<HTMLImageElement>>;
+//#endregion
+//#region src/faces.d.ts
+type FaceProps = {
+  className?: string;
+  style?: React.CSSProperties;
+};
+/**
+ * Round eyes face - simple circular eyes
+ */
+declare const RoundFace: React.FC<FaceProps>;
+/**
+ * Cross eyes face - X-shaped eyes
+ */
+declare const CrossFace: React.FC<FaceProps>;
+/**
+ * Line eyes face - horizontal line eyes
+ */
+declare const LineFace: React.FC<FaceProps>;
+/**
+ * Curved eyes face - sleepy/happy curved eyes
+ */
+declare const CurvedFace: React.FC<FaceProps>;
+/**
+ * All available face components
+ */
+declare const FACES: readonly [React.FC<FaceProps>, React.FC<FaceProps>, React.FC<FaceProps>, React.FC<FaceProps>];
+type FaceComponent = (typeof FACES)[number];
+//#endregion
+//#region src/utils/hash.d.ts
+/**
+ * Generates a consistent numeric hash from a string.
+ * Used to deterministically select faces and colors for avatars.
+ *
+ * @param str - The input string to hash
+ * @returns A positive 32-bit integer hash
+ */
+declare function stringHash(str: string): number;
+//#endregion
+export { Avatar, type AvatarContextValue, AvatarFallback, type AvatarFallbackProps, AvatarImage, type AvatarImageProps, type AvatarProps, CrossFace, CurvedFace, FACES, type FaceComponent, type FaceProps, Facehash, type FacehashProps, type Intensity3D, LineFace, RoundFace, type Variant, stringHash, useAvatarContext };
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/facehash.tsx","../src/avatar.tsx","../src/avatar-fallback.tsx","../src/avatar-image.tsx","../src/faces.tsx","../src/utils/hash.ts"],"sourcesContent":[],"mappings":"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"}

package/index.js

@@ -0,0 +1,529 @@
+import * as React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/faces.tsx
+/**
+* Round eyes face - simple circular eyes
+*/
+const RoundFace = ({ className, style }) => /* @__PURE__ */ jsxs("svg", {
+	"aria-hidden": "true",
+	className,
+	fill: "none",
+	style,
+	viewBox: "0 0 63 15",
+	xmlns: "http://www.w3.org/2000/svg",
+	children: [
+		/* @__PURE__ */ jsx("title", { children: "Round Eyes" }),
+		/* @__PURE__ */ jsx("path", {
+			d: "M62.4 7.2C62.4 11.1765 59.1765 14.4 55.2 14.4C51.2236 14.4 48 11.1765 48 7.2C48 3.22355 51.2236 0 55.2 0C59.1765 0 62.4 3.22355 62.4 7.2Z",
+			fill: "currentColor"
+		}),
+		/* @__PURE__ */ jsx("path", {
+			d: "M14.4 7.2C14.4 11.1765 11.1765 14.4 7.2 14.4C3.22355 14.4 0 11.1765 0 7.2C0 3.22355 3.22355 0 7.2 0C11.1765 0 14.4 3.22355 14.4 7.2Z",
+			fill: "currentColor"
+		})
+	]
+});
+/**
+* Cross eyes face - X-shaped eyes
+*/
+const CrossFace = ({ className, style }) => /* @__PURE__ */ jsxs("svg", {
+	"aria-hidden": "true",
+	className,
+	fill: "none",
+	style,
+	viewBox: "0 0 71 23",
+	xmlns: "http://www.w3.org/2000/svg",
+	children: [
+		/* @__PURE__ */ jsx("title", { children: "Cross Eyes" }),
+		/* @__PURE__ */ jsx("path", {
+			d: "M11.5 0C12.9411 0 13.6619 0.000460386 14.1748 0.354492C14.3742 0.49213 14.547 0.664882 14.6846 0.864258C15.0384 1.37711 15.0391 2.09739 15.0391 3.53809V7.96094H19.4619C20.9027 7.96094 21.6229 7.9615 22.1357 8.31543C22.3352 8.45308 22.5079 8.62578 22.6455 8.8252C22.9995 9.3381 23 10.0589 23 11.5C23 12.9408 22.9995 13.661 22.6455 14.1738C22.5079 14.3733 22.3352 14.5459 22.1357 14.6836C21.6229 15.0375 20.9027 15.0381 19.4619 15.0381H15.0391V19.4619C15.0391 20.9026 15.0384 21.6229 14.6846 22.1357C14.547 22.3351 14.3742 22.5079 14.1748 22.6455C13.6619 22.9995 12.9411 23 11.5 23C10.0592 23 9.33903 22.9994 8.82617 22.6455C8.62674 22.5079 8.45309 22.3352 8.31543 22.1357C7.96175 21.6229 7.96191 20.9024 7.96191 19.4619V15.0381H3.53809C2.0973 15.0381 1.37711 15.0375 0.864258 14.6836C0.664834 14.5459 0.492147 14.3733 0.354492 14.1738C0.000498831 13.661 -5.88036e-08 12.9408 0 11.5C6.2999e-08 10.0589 0.000460356 9.3381 0.354492 8.8252C0.492144 8.62578 0.664842 8.45308 0.864258 8.31543C1.37711 7.9615 2.09731 7.96094 3.53809 7.96094H7.96191V3.53809C7.96191 2.09765 7.96175 1.37709 8.31543 0.864258C8.45309 0.664828 8.62674 0.492149 8.82617 0.354492C9.33903 0.000555366 10.0592 1.62347e-09 11.5 0Z",
+			fill: "currentColor"
+		}),
+		/* @__PURE__ */ jsx("path", {
+			d: "M58.7695 0C60.2107 0 60.9314 0.000460386 61.4443 0.354492C61.6437 0.49213 61.8165 0.664882 61.9541 0.864258C62.308 1.37711 62.3086 2.09739 62.3086 3.53809V7.96094H66.7314C68.1722 7.96094 68.8924 7.9615 69.4053 8.31543C69.6047 8.45308 69.7774 8.62578 69.915 8.8252C70.2691 9.3381 70.2695 10.0589 70.2695 11.5C70.2695 12.9408 70.269 13.661 69.915 14.1738C69.7774 14.3733 69.6047 14.5459 69.4053 14.6836C68.8924 15.0375 68.1722 15.0381 66.7314 15.0381H62.3086V19.4619C62.3086 20.9026 62.308 21.6229 61.9541 22.1357C61.8165 22.3351 61.6437 22.5079 61.4443 22.6455C60.9314 22.9995 60.2107 23 58.7695 23C57.3287 23 56.6086 22.9994 56.0957 22.6455C55.8963 22.5079 55.7226 22.3352 55.585 22.1357C55.2313 21.6229 55.2314 20.9024 55.2314 19.4619V15.0381H50.8076C49.3668 15.0381 48.6466 15.0375 48.1338 14.6836C47.9344 14.5459 47.7617 14.3733 47.624 14.1738C47.27 13.661 47.2695 12.9408 47.2695 11.5C47.2695 10.0589 47.27 9.3381 47.624 8.8252C47.7617 8.62578 47.9344 8.45308 48.1338 8.31543C48.6466 7.9615 49.3668 7.96094 50.8076 7.96094H55.2314V3.53809C55.2314 2.09765 55.2313 1.37709 55.585 0.864258C55.7226 0.664828 55.8963 0.492149 56.0957 0.354492C56.6086 0.000555366 57.3287 1.62347e-09 58.7695 0Z",
+			fill: "currentColor"
+		})
+	]
+});
+/**
+* Line eyes face - horizontal line eyes
+*/
+const LineFace = ({ className, style }) => /* @__PURE__ */ jsxs("svg", {
+	"aria-hidden": "true",
+	className,
+	fill: "none",
+	style,
+	viewBox: "0 0 82 8",
+	xmlns: "http://www.w3.org/2000/svg",
+	children: [
+		/* @__PURE__ */ jsx("title", { children: "Line Eyes" }),
+		/* @__PURE__ */ jsx("path", {
+			d: "M3.53125 0.164063C4.90133 0.164063 5.58673 0.163893 6.08301 0.485352C6.31917 0.638428 6.52075 0.840012 6.67383 1.07617C6.99555 1.57252 6.99512 2.25826 6.99512 3.62891C6.99512 4.99911 6.99536 5.68438 6.67383 6.18066C6.52075 6.41682 6.31917 6.61841 6.08301 6.77148C5.58672 7.09305 4.90147 7.09277 3.53125 7.09277C2.16062 7.09277 1.47486 7.09319 0.978516 6.77148C0.742356 6.61841 0.540772 6.41682 0.387695 6.18066C0.0662401 5.68439 0.0664063 4.999 0.0664063 3.62891C0.0664063 2.25838 0.0660571 1.57251 0.387695 1.07617C0.540772 0.840012 0.742356 0.638428 0.978516 0.485352C1.47485 0.163744 2.16076 0.164063 3.53125 0.164063Z",
+			fill: "currentColor"
+		}),
+		/* @__PURE__ */ jsx("path", {
+			d: "M25.1836 0.164063C26.5542 0.164063 27.24 0.163638 27.7363 0.485352C27.9724 0.638384 28.1731 0.8401 28.3262 1.07617C28.6479 1.57252 28.6484 2.25825 28.6484 3.62891C28.6484 4.99931 28.6478 5.68436 28.3262 6.18066C28.1731 6.41678 27.9724 6.61842 27.7363 6.77148C27.24 7.09321 26.5542 7.09277 25.1836 7.09277H11.3262C9.95557 7.09277 9.26978 7.09317 8.77344 6.77148C8.53728 6.61841 8.33569 6.41682 8.18262 6.18066C7.86115 5.68438 7.86133 4.99902 7.86133 3.62891C7.86133 2.25835 7.86096 1.57251 8.18262 1.07617C8.33569 0.840012 8.53728 0.638428 8.77344 0.485352C9.26977 0.163768 9.95572 0.164063 11.3262 0.164063H25.1836Z",
+			fill: "currentColor"
+		}),
+		/* @__PURE__ */ jsx("path", {
+			d: "M78.2034 7.09325C76.8333 7.09325 76.1479 7.09342 75.6516 6.77197C75.4155 6.61889 75.2139 6.4173 75.0608 6.18114C74.7391 5.6848 74.7395 4.99905 74.7395 3.62841C74.7395 2.2582 74.7393 1.57294 75.0608 1.07665C75.2139 0.840493 75.4155 0.638909 75.6516 0.485832C76.1479 0.164271 76.8332 0.164543 78.2034 0.164543C79.574 0.164543 80.2598 0.164122 80.7561 0.485832C80.9923 0.638909 81.1939 0.840493 81.347 1.07665C81.6684 1.57293 81.6682 2.25831 81.6682 3.62841C81.6682 4.99894 81.6686 5.68481 81.347 6.18114C81.1939 6.4173 80.9923 6.61889 80.7561 6.77197C80.2598 7.09357 79.5739 7.09325 78.2034 7.09325Z",
+			fill: "currentColor"
+		}),
+		/* @__PURE__ */ jsx("path", {
+			d: "M56.5511 7.09325C55.1804 7.09325 54.4947 7.09368 53.9983 6.77197C53.7622 6.61893 53.5615 6.41722 53.4085 6.18114C53.0868 5.6848 53.0862 4.99907 53.0862 3.62841C53.0862 2.258 53.0868 1.57296 53.4085 1.07665C53.5615 0.840539 53.7622 0.638898 53.9983 0.485832C54.4947 0.164105 55.1804 0.164543 56.5511 0.164543H70.4085C71.7791 0.164543 72.4649 0.164146 72.9612 0.485832C73.1974 0.638909 73.399 0.840493 73.552 1.07665C73.8735 1.57293 73.8733 2.25829 73.8733 3.62841C73.8733 4.99896 73.8737 5.68481 73.552 6.18114C73.399 6.4173 73.1974 6.61889 72.9612 6.77197C72.4649 7.09355 71.7789 7.09325 70.4085 7.09325H56.5511Z",
+			fill: "currentColor"
+		})
+	]
+});
+/**
+* Curved eyes face - sleepy/happy curved eyes
+*/
+const CurvedFace = ({ className, style }) => /* @__PURE__ */ jsxs("svg", {
+	"aria-hidden": "true",
+	className,
+	fill: "none",
+	style,
+	viewBox: "0 0 63 9",
+	xmlns: "http://www.w3.org/2000/svg",
+	children: [
+		/* @__PURE__ */ jsx("title", { children: "Curved Eyes" }),
+		/* @__PURE__ */ jsx("path", {
+			d: "M0 5.06511C0 4.94513 0 4.88513 0.00771184 4.79757C0.0483059 4.33665 0.341025 3.76395 0.690821 3.46107C0.757274 3.40353 0.783996 3.38422 0.837439 3.34559C2.40699 2.21129 6.03888 0 10.5 0C14.9611 0 18.593 2.21129 20.1626 3.34559C20.216 3.38422 20.2427 3.40353 20.3092 3.46107C20.659 3.76395 20.9517 4.33665 20.9923 4.79757C21 4.88513 21 4.94513 21 5.06511C21 6.01683 21 6.4927 20.9657 6.6754C20.7241 7.96423 19.8033 8.55941 18.5289 8.25054C18.3483 8.20676 17.8198 7.96876 16.7627 7.49275C14.975 6.68767 12.7805 6 10.5 6C8.21954 6 6.02504 6.68767 4.23727 7.49275C3.18025 7.96876 2.65174 8.20676 2.47108 8.25054C1.19668 8.55941 0.275917 7.96423 0.0342566 6.6754C0 6.4927 0 6.01683 0 5.06511Z",
+			fill: "currentColor"
+		}),
+		/* @__PURE__ */ jsx("path", {
+			d: "M42 5.06511C42 4.94513 42 4.88513 42.0077 4.79757C42.0483 4.33665 42.341 3.76395 42.6908 3.46107C42.7573 3.40353 42.784 3.38422 42.8374 3.34559C44.407 2.21129 48.0389 0 52.5 0C56.9611 0 60.593 2.21129 62.1626 3.34559C62.216 3.38422 62.2427 3.40353 62.3092 3.46107C62.659 3.76395 62.9517 4.33665 62.9923 4.79757C63 4.88513 63 4.94513 63 5.06511C63 6.01683 63 6.4927 62.9657 6.6754C62.7241 7.96423 61.8033 8.55941 60.5289 8.25054C60.3483 8.20676 59.8198 7.96876 58.7627 7.49275C56.975 6.68767 54.7805 6 52.5 6C50.2195 6 48.025 6.68767 46.2373 7.49275C45.1802 7.96876 44.6517 8.20676 44.4711 8.25054C43.1967 8.55941 42.2759 7.96423 42.0343 6.6754C42 6.4927 42 6.01683 42 5.06511Z",
+			fill: "currentColor"
+		})
+	]
+});
+/**
+* All available face components
+*/
+const FACES = [
+	RoundFace,
+	CrossFace,
+	LineFace,
+	CurvedFace
+];
+
+//#endregion
+//#region src/utils/hash.ts
+/**
+* Generates a consistent numeric hash from a string.
+* Used to deterministically select faces and colors for avatars.
+*
+* @param str - The input string to hash
+* @returns A positive 32-bit integer hash
+*/
+function stringHash(str) {
+	let hash = 0;
+	for (let i = 0; i < str.length; i++) {
+		const char = str.charCodeAt(i);
+		hash = (hash << 5) - hash + char;
+		hash &= hash;
+	}
+	return Math.abs(hash);
+}
+
+//#endregion
+//#region src/facehash.tsx
+const INTENSITY_PRESETS = {
+	none: {
+		rotateRange: 0,
+		translateZ: 0,
+		perspective: "none"
+	},
+	subtle: {
+		rotateRange: 5,
+		translateZ: 4,
+		perspective: "800px"
+	},
+	medium: {
+		rotateRange: 10,
+		translateZ: 8,
+		perspective: "500px"
+	},
+	dramatic: {
+		rotateRange: 15,
+		translateZ: 12,
+		perspective: "300px"
+	}
+};
+const SPHERE_POSITIONS = [
+	{
+		x: -1,
+		y: 1
+	},
+	{
+		x: 1,
+		y: 1
+	},
+	{
+		x: 1,
+		y: 0
+	},
+	{
+		x: 0,
+		y: 1
+	},
+	{
+		x: -1,
+		y: 0
+	},
+	{
+		x: 0,
+		y: 0
+	},
+	{
+		x: 0,
+		y: -1
+	},
+	{
+		x: -1,
+		y: -1
+	},
+	{
+		x: 1,
+		y: -1
+	}
+];
+const DEFAULT_GRADIENT_STYLE = { background: "radial-gradient(ellipse 100% 100% at 50% 50%, rgba(255,255,255,0.15) 0%, transparent 60%)" };
+/**
+* Facehash - Deterministic avatar faces from any string.
+*
+* @example
+* ```tsx
+* // With Tailwind classes
+* <Facehash
+*   name="John"
+*   colorClasses={["bg-pink-500", "bg-blue-500"]}
+* />
+*
+* // With hex colors
+* <Facehash
+*   name="John"
+*   colors={["#ec4899", "#3b82f6"]}
+* />
+*
+* // Plain color (no gradient)
+* <Facehash name="John" variant="solid" />
+* ```
+*/
+const Facehash = React.forwardRef(({ name, size = 40, variant = "gradient", intensity3d = "dramatic", interactive = true, showInitial = true, colors, colorClasses, gradientOverlayClass, className, style, onMouseEnter, onMouseLeave, ...props }, ref) => {
+	const [isHovered, setIsHovered] = React.useState(false);
+	const { FaceComponent, colorIndex, rotation } = React.useMemo(() => {
+		const hash = stringHash(name);
+		const faceIndex = hash % FACES.length;
+		const _colorIndex = hash % (colorClasses?.length ?? colors?.length ?? 1);
+		const position = SPHERE_POSITIONS[hash % SPHERE_POSITIONS.length] ?? {
+			x: 0,
+			y: 0
+		};
+		return {
+			FaceComponent: FACES[faceIndex] ?? FACES[0],
+			colorIndex: _colorIndex,
+			rotation: position
+		};
+	}, [
+		name,
+		colors?.length,
+		colorClasses?.length
+	]);
+	const preset = INTENSITY_PRESETS[intensity3d];
+	const transform = React.useMemo(() => {
+		if (intensity3d === "none") return;
+		return `rotateX(${isHovered && interactive ? 0 : rotation.x * preset.rotateRange}deg) rotateY(${isHovered && interactive ? 0 : rotation.y * preset.rotateRange}deg) translateZ(${preset.translateZ}px)`;
+	}, [
+		intensity3d,
+		isHovered,
+		interactive,
+		rotation,
+		preset
+	]);
+	const sizeValue = typeof size === "number" ? `${size}px` : size;
+	const initial = name.charAt(0).toUpperCase();
+	const bgColorClass = colorClasses?.[colorIndex];
+	const bgColorHex = colors?.[colorIndex];
+	const handleMouseEnter = React.useCallback((e) => {
+		if (interactive) setIsHovered(true);
+		onMouseEnter?.(e);
+	}, [interactive, onMouseEnter]);
+	const handleMouseLeave = React.useCallback((e) => {
+		if (interactive) setIsHovered(false);
+		onMouseLeave?.(e);
+	}, [interactive, onMouseLeave]);
+	return /* @__PURE__ */ jsxs("div", {
+		className: [bgColorClass, className].filter(Boolean).join(" "),
+		"data-facehash": "",
+		"data-interactive": interactive || void 0,
+		onMouseEnter: handleMouseEnter,
+		onMouseLeave: handleMouseLeave,
+		ref,
+		style: {
+			width: sizeValue,
+			height: sizeValue,
+			position: "relative",
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "center",
+			overflow: "hidden",
+			containerType: "size",
+			...intensity3d !== "none" && {
+				perspective: preset.perspective,
+				transformStyle: "preserve-3d"
+			},
+			...bgColorHex && !bgColorClass && { backgroundColor: bgColorHex },
+			...style
+		},
+		...props,
+		children: [variant === "gradient" && /* @__PURE__ */ jsx("div", {
+			className: gradientOverlayClass,
+			"data-facehash-gradient": "",
+			style: {
+				position: "absolute",
+				inset: 0,
+				pointerEvents: "none",
+				zIndex: 1,
+				...gradientOverlayClass ? {} : DEFAULT_GRADIENT_STYLE
+			}
+		}), /* @__PURE__ */ jsxs("div", {
+			"data-facehash-face": "",
+			style: {
+				position: "absolute",
+				inset: 0,
+				display: "flex",
+				flexDirection: "column",
+				alignItems: "center",
+				justifyContent: "center",
+				zIndex: 2,
+				transform,
+				transformStyle: intensity3d !== "none" ? "preserve-3d" : void 0,
+				transition: interactive ? "transform 0.3s cubic-bezier(0.4, 0, 0.2, 1)" : void 0,
+				color: "#000000"
+			},
+			children: [/* @__PURE__ */ jsx(FaceComponent, { style: {
+				width: "60%",
+				height: "auto",
+				maxWidth: "90%",
+				maxHeight: "40%"
+			} }), showInitial && /* @__PURE__ */ jsx("span", {
+				"data-facehash-initial": "",
+				style: {
+					marginTop: "8%",
+					fontSize: "26cqw",
+					lineHeight: 1,
+					fontFamily: "monospace",
+					fontWeight: "bold"
+				},
+				children: initial
+			})]
+		})]
+	});
+});
+Facehash.displayName = "Facehash";
+
+//#endregion
+//#region src/avatar.tsx
+const AvatarContext = React.createContext(null);
+/**
+* Hook to access the Avatar context.
+* Throws an error if used outside of Avatar.
+*/
+const useAvatarContext = () => {
+	const context = React.useContext(AvatarContext);
+	if (!context) throw new Error("Avatar compound components must be rendered within an Avatar component");
+	return context;
+};
+/**
+* Root avatar component that provides context for image loading state.
+*
+* @example
+* ```tsx
+* <Avatar className="w-10 h-10 rounded-full overflow-hidden">
+*   <AvatarImage src="/photo.jpg" alt="John" />
+*   <AvatarFallback name="John Doe" />
+* </Avatar>
+* ```
+*/
+const Avatar = React.forwardRef(({ children, className, style, asChild = false, ...props }, ref) => {
+	const [imageLoadingStatus, setImageLoadingStatus] = React.useState("idle");
+	const contextValue = React.useMemo(() => ({
+		imageLoadingStatus,
+		onImageLoadingStatusChange: setImageLoadingStatus
+	}), [imageLoadingStatus]);
+	const Element = asChild ? React.Fragment : "span";
+	const elementProps = asChild ? {} : {
+		ref,
+		className,
+		style: {
+			position: "relative",
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "center",
+			flexShrink: 0,
+			overflow: "hidden",
+			...style
+		},
+		"data-avatar": "",
+		"data-state": imageLoadingStatus,
+		...props
+	};
+	return /* @__PURE__ */ jsx(AvatarContext.Provider, {
+		value: contextValue,
+		children: /* @__PURE__ */ jsx(Element, {
+			...elementProps,
+			children
+		})
+	});
+});
+Avatar.displayName = "Avatar";
+
+//#endregion
+//#region src/avatar-fallback.tsx
+const WHITESPACE_REGEX = /\s+/;
+/**
+* Extracts initials from a name string.
+*/
+function getInitials(name) {
+	const parts = name.trim().split(WHITESPACE_REGEX);
+	if (parts.length === 0) return "";
+	if (parts.length === 1) return parts[0]?.charAt(0).toUpperCase() || "";
+	return ((parts[0]?.charAt(0) || "") + (parts.at(-1)?.charAt(0) || "")).toUpperCase();
+}
+/**
+* Fallback component that displays when the image fails to load.
+* Uses Facehash by default, can show initials or custom content.
+*
+* @example
+* ```tsx
+* // With Facehash (default)
+* <AvatarFallback name="John Doe" />
+*
+* // With initials
+* <AvatarFallback name="John Doe" facehash={false} />
+*
+* // With custom content
+* <AvatarFallback>
+*   <UserIcon />
+* </AvatarFallback>
+* ```
+*/
+const AvatarFallback = React.forwardRef(({ name = "", delayMs = 0, children, facehash = true, facehashProps, className, style, ...props }, ref) => {
+	const { imageLoadingStatus } = useAvatarContext();
+	const [canRender, setCanRender] = React.useState(delayMs === 0);
+	React.useEffect(() => {
+		if (delayMs > 0) {
+			const timerId = window.setTimeout(() => setCanRender(true), delayMs);
+			return () => window.clearTimeout(timerId);
+		}
+	}, [delayMs]);
+	const initials = React.useMemo(() => getInitials(name), [name]);
+	if (!(canRender && imageLoadingStatus !== "loaded" && imageLoadingStatus !== "loading")) return null;
+	if (children) return /* @__PURE__ */ jsx("span", {
+		className,
+		"data-avatar-fallback": "",
+		ref,
+		style: {
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "center",
+			width: "100%",
+			height: "100%",
+			...style
+		},
+		...props,
+		children
+	});
+	if (facehash) return /* @__PURE__ */ jsx(Facehash, {
+		className,
+		"data-avatar-fallback": "",
+		name,
+		ref,
+		size: "100%",
+		...facehashProps,
+		style: { ...style },
+		...props
+	});
+	return /* @__PURE__ */ jsx("span", {
+		className,
+		"data-avatar-fallback": "",
+		ref,
+		style: {
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "center",
+			width: "100%",
+			height: "100%",
+			...style
+		},
+		...props,
+		children: initials
+	});
+});
+AvatarFallback.displayName = "AvatarFallback";
+
+//#endregion
+//#region src/avatar-image.tsx
+/**
+* Image component that syncs its loading state with the Avatar context.
+* Automatically hides when loading fails, allowing fallback to show.
+*
+* @example
+* ```tsx
+* <Avatar>
+*   <AvatarImage src="/photo.jpg" alt="User" />
+*   <AvatarFallback name="John Doe" />
+* </Avatar>
+* ```
+*/
+const AvatarImage = React.forwardRef(({ src, alt = "", className, style, onLoadingStatusChange, ...props }, ref) => {
+	const { imageLoadingStatus, onImageLoadingStatusChange } = useAvatarContext();
+	const imageRef = React.useRef(null);
+	React.useImperativeHandle(ref, () => imageRef.current);
+	const updateStatus = React.useCallback((status) => {
+		onImageLoadingStatusChange(status);
+		onLoadingStatusChange?.(status);
+	}, [onImageLoadingStatusChange, onLoadingStatusChange]);
+	React.useLayoutEffect(() => {
+		if (!src) {
+			updateStatus("error");
+			return;
+		}
+		let isMounted = true;
+		const image = new Image();
+		const setStatus = (status) => {
+			if (!isMounted) return;
+			updateStatus(status);
+		};
+		setStatus("loading");
+		image.onload = () => setStatus("loaded");
+		image.onerror = () => setStatus("error");
+		image.src = src;
+		return () => {
+			isMounted = false;
+		};
+	}, [src, updateStatus]);
+	if (imageLoadingStatus !== "loaded") return null;
+	return /* @__PURE__ */ jsx("img", {
+		alt,
+		className,
+		"data-avatar-image": "",
+		ref: imageRef,
+		src: src ?? void 0,
+		style: {
+			aspectRatio: "1 / 1",
+			width: "100%",
+			height: "100%",
+			objectFit: "cover",
+			...style
+		},
+		...props
+	});
+});
+AvatarImage.displayName = "AvatarImage";
+
+//#endregion
+export { Avatar, AvatarFallback, AvatarImage, CrossFace, CurvedFace, FACES, Facehash, LineFace, RoundFace, stringHash, useAvatarContext };
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["RoundFace: React.FC<FaceProps>","CrossFace: React.FC<FaceProps>","LineFace: React.FC<FaceProps>","CurvedFace: React.FC<FaceProps>","DEFAULT_GRADIENT_STYLE: React.CSSProperties","contextValue: AvatarContextValue"],"sources":["../src/faces.tsx","../src/utils/hash.ts","../src/facehash.tsx","../src/avatar.tsx","../src/avatar-fallback.tsx","../src/avatar-image.tsx"],"sourcesContent":["import type * as React from \"react\";\n\nexport type FaceProps = {\n\tclassName?: string;\n\tstyle?: React.CSSProperties;\n};\n\n/**\n * Round eyes face - simple circular eyes\n */\nexport const RoundFace: React.FC<FaceProps> = ({ className, style }) => (\n\t<svg\n\t\taria-hidden=\"true\"\n\t\tclassName={className}\n\t\tfill=\"none\"\n\t\tstyle={style}\n\t\tviewBox=\"0 0 63 15\"\n\t\txmlns=\"http://www.w3.org/2000/svg\"\n\t>\n\t\t<title>Round Eyes</title>\n\t\t<path\n\t\t\td=\"M62.4 7.2C62.4 11.1765 59.1765 14.4 55.2 14.4C51.2236 14.4 48 11.1765 48 7.2C48 3.22355 51.2236 0 55.2 0C59.1765 0 62.4 3.22355 62.4 7.2Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t\t<path\n\t\t\td=\"M14.4 7.2C14.4 11.1765 11.1765 14.4 7.2 14.4C3.22355 14.4 0 11.1765 0 7.2C0 3.22355 3.22355 0 7.2 0C11.1765 0 14.4 3.22355 14.4 7.2Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t</svg>\n);\n\n/**\n * Cross eyes face - X-shaped eyes\n */\nexport const CrossFace: React.FC<FaceProps> = ({ className, style }) => (\n\t<svg\n\t\taria-hidden=\"true\"\n\t\tclassName={className}\n\t\tfill=\"none\"\n\t\tstyle={style}\n\t\tviewBox=\"0 0 71 23\"\n\t\txmlns=\"http://www.w3.org/2000/svg\"\n\t>\n\t\t<title>Cross Eyes</title>\n\t\t<path\n\t\t\td=\"M11.5 0C12.9411 0 13.6619 0.000460386 14.1748 0.354492C14.3742 0.49213 14.547 0.664882 14.6846 0.864258C15.0384 1.37711 15.0391 2.09739 15.0391 3.53809V7.96094H19.4619C20.9027 7.96094 21.6229 7.9615 22.1357 8.31543C22.3352 8.45308 22.5079 8.62578 22.6455 8.8252C22.9995 9.3381 23 10.0589 23 11.5C23 12.9408 22.9995 13.661 22.6455 14.1738C22.5079 14.3733 22.3352 14.5459 22.1357 14.6836C21.6229 15.0375 20.9027 15.0381 19.4619 15.0381H15.0391V19.4619C15.0391 20.9026 15.0384 21.6229 14.6846 22.1357C14.547 22.3351 14.3742 22.5079 14.1748 22.6455C13.6619 22.9995 12.9411 23 11.5 23C10.0592 23 9.33903 22.9994 8.82617 22.6455C8.62674 22.5079 8.45309 22.3352 8.31543 22.1357C7.96175 21.6229 7.96191 20.9024 7.96191 19.4619V15.0381H3.53809C2.0973 15.0381 1.37711 15.0375 0.864258 14.6836C0.664834 14.5459 0.492147 14.3733 0.354492 14.1738C0.000498831 13.661 -5.88036e-08 12.9408 0 11.5C6.2999e-08 10.0589 0.000460356 9.3381 0.354492 8.8252C0.492144 8.62578 0.664842 8.45308 0.864258 8.31543C1.37711 7.9615 2.09731 7.96094 3.53809 7.96094H7.96191V3.53809C7.96191 2.09765 7.96175 1.37709 8.31543 0.864258C8.45309 0.664828 8.62674 0.492149 8.82617 0.354492C9.33903 0.000555366 10.0592 1.62347e-09 11.5 0Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t\t<path\n\t\t\td=\"M58.7695 0C60.2107 0 60.9314 0.000460386 61.4443 0.354492C61.6437 0.49213 61.8165 0.664882 61.9541 0.864258C62.308 1.37711 62.3086 2.09739 62.3086 3.53809V7.96094H66.7314C68.1722 7.96094 68.8924 7.9615 69.4053 8.31543C69.6047 8.45308 69.7774 8.62578 69.915 8.8252C70.2691 9.3381 70.2695 10.0589 70.2695 11.5C70.2695 12.9408 70.269 13.661 69.915 14.1738C69.7774 14.3733 69.6047 14.5459 69.4053 14.6836C68.8924 15.0375 68.1722 15.0381 66.7314 15.0381H62.3086V19.4619C62.3086 20.9026 62.308 21.6229 61.9541 22.1357C61.8165 22.3351 61.6437 22.5079 61.4443 22.6455C60.9314 22.9995 60.2107 23 58.7695 23C57.3287 23 56.6086 22.9994 56.0957 22.6455C55.8963 22.5079 55.7226 22.3352 55.585 22.1357C55.2313 21.6229 55.2314 20.9024 55.2314 19.4619V15.0381H50.8076C49.3668 15.0381 48.6466 15.0375 48.1338 14.6836C47.9344 14.5459 47.7617 14.3733 47.624 14.1738C47.27 13.661 47.2695 12.9408 47.2695 11.5C47.2695 10.0589 47.27 9.3381 47.624 8.8252C47.7617 8.62578 47.9344 8.45308 48.1338 8.31543C48.6466 7.9615 49.3668 7.96094 50.8076 7.96094H55.2314V3.53809C55.2314 2.09765 55.2313 1.37709 55.585 0.864258C55.7226 0.664828 55.8963 0.492149 56.0957 0.354492C56.6086 0.000555366 57.3287 1.62347e-09 58.7695 0Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t</svg>\n);\n\n/**\n * Line eyes face - horizontal line eyes\n */\nexport const LineFace: React.FC<FaceProps> = ({ className, style }) => (\n\t<svg\n\t\taria-hidden=\"true\"\n\t\tclassName={className}\n\t\tfill=\"none\"\n\t\tstyle={style}\n\t\tviewBox=\"0 0 82 8\"\n\t\txmlns=\"http://www.w3.org/2000/svg\"\n\t>\n\t\t<title>Line Eyes</title>\n\t\t<path\n\t\t\td=\"M3.53125 0.164063C4.90133 0.164063 5.58673 0.163893 6.08301 0.485352C6.31917 0.638428 6.52075 0.840012 6.67383 1.07617C6.99555 1.57252 6.99512 2.25826 6.99512 3.62891C6.99512 4.99911 6.99536 5.68438 6.67383 6.18066C6.52075 6.41682 6.31917 6.61841 6.08301 6.77148C5.58672 7.09305 4.90147 7.09277 3.53125 7.09277C2.16062 7.09277 1.47486 7.09319 0.978516 6.77148C0.742356 6.61841 0.540772 6.41682 0.387695 6.18066C0.0662401 5.68439 0.0664063 4.999 0.0664063 3.62891C0.0664063 2.25838 0.0660571 1.57251 0.387695 1.07617C0.540772 0.840012 0.742356 0.638428 0.978516 0.485352C1.47485 0.163744 2.16076 0.164063 3.53125 0.164063Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t\t<path\n\t\t\td=\"M25.1836 0.164063C26.5542 0.164063 27.24 0.163638 27.7363 0.485352C27.9724 0.638384 28.1731 0.8401 28.3262 1.07617C28.6479 1.57252 28.6484 2.25825 28.6484 3.62891C28.6484 4.99931 28.6478 5.68436 28.3262 6.18066C28.1731 6.41678 27.9724 6.61842 27.7363 6.77148C27.24 7.09321 26.5542 7.09277 25.1836 7.09277H11.3262C9.95557 7.09277 9.26978 7.09317 8.77344 6.77148C8.53728 6.61841 8.33569 6.41682 8.18262 6.18066C7.86115 5.68438 7.86133 4.99902 7.86133 3.62891C7.86133 2.25835 7.86096 1.57251 8.18262 1.07617C8.33569 0.840012 8.53728 0.638428 8.77344 0.485352C9.26977 0.163768 9.95572 0.164063 11.3262 0.164063H25.1836Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t\t<path\n\t\t\td=\"M78.2034 7.09325C76.8333 7.09325 76.1479 7.09342 75.6516 6.77197C75.4155 6.61889 75.2139 6.4173 75.0608 6.18114C74.7391 5.6848 74.7395 4.99905 74.7395 3.62841C74.7395 2.2582 74.7393 1.57294 75.0608 1.07665C75.2139 0.840493 75.4155 0.638909 75.6516 0.485832C76.1479 0.164271 76.8332 0.164543 78.2034 0.164543C79.574 0.164543 80.2598 0.164122 80.7561 0.485832C80.9923 0.638909 81.1939 0.840493 81.347 1.07665C81.6684 1.57293 81.6682 2.25831 81.6682 3.62841C81.6682 4.99894 81.6686 5.68481 81.347 6.18114C81.1939 6.4173 80.9923 6.61889 80.7561 6.77197C80.2598 7.09357 79.5739 7.09325 78.2034 7.09325Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t\t<path\n\t\t\td=\"M56.5511 7.09325C55.1804 7.09325 54.4947 7.09368 53.9983 6.77197C53.7622 6.61893 53.5615 6.41722 53.4085 6.18114C53.0868 5.6848 53.0862 4.99907 53.0862 3.62841C53.0862 2.258 53.0868 1.57296 53.4085 1.07665C53.5615 0.840539 53.7622 0.638898 53.9983 0.485832C54.4947 0.164105 55.1804 0.164543 56.5511 0.164543H70.4085C71.7791 0.164543 72.4649 0.164146 72.9612 0.485832C73.1974 0.638909 73.399 0.840493 73.552 1.07665C73.8735 1.57293 73.8733 2.25829 73.8733 3.62841C73.8733 4.99896 73.8737 5.68481 73.552 6.18114C73.399 6.4173 73.1974 6.61889 72.9612 6.77197C72.4649 7.09355 71.7789 7.09325 70.4085 7.09325H56.5511Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t</svg>\n);\n\n/**\n * Curved eyes face - sleepy/happy curved eyes\n */\nexport const CurvedFace: React.FC<FaceProps> = ({ className, style }) => (\n\t<svg\n\t\taria-hidden=\"true\"\n\t\tclassName={className}\n\t\tfill=\"none\"\n\t\tstyle={style}\n\t\tviewBox=\"0 0 63 9\"\n\t\txmlns=\"http://www.w3.org/2000/svg\"\n\t>\n\t\t<title>Curved Eyes</title>\n\t\t<path\n\t\t\td=\"M0 5.06511C0 4.94513 0 4.88513 0.00771184 4.79757C0.0483059 4.33665 0.341025 3.76395 0.690821 3.46107C0.757274 3.40353 0.783996 3.38422 0.837439 3.34559C2.40699 2.21129 6.03888 0 10.5 0C14.9611 0 18.593 2.21129 20.1626 3.34559C20.216 3.38422 20.2427 3.40353 20.3092 3.46107C20.659 3.76395 20.9517 4.33665 20.9923 4.79757C21 4.88513 21 4.94513 21 5.06511C21 6.01683 21 6.4927 20.9657 6.6754C20.7241 7.96423 19.8033 8.55941 18.5289 8.25054C18.3483 8.20676 17.8198 7.96876 16.7627 7.49275C14.975 6.68767 12.7805 6 10.5 6C8.21954 6 6.02504 6.68767 4.23727 7.49275C3.18025 7.96876 2.65174 8.20676 2.47108 8.25054C1.19668 8.55941 0.275917 7.96423 0.0342566 6.6754C0 6.4927 0 6.01683 0 5.06511Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t\t<path\n\t\t\td=\"M42 5.06511C42 4.94513 42 4.88513 42.0077 4.79757C42.0483 4.33665 42.341 3.76395 42.6908 3.46107C42.7573 3.40353 42.784 3.38422 42.8374 3.34559C44.407 2.21129 48.0389 0 52.5 0C56.9611 0 60.593 2.21129 62.1626 3.34559C62.216 3.38422 62.2427 3.40353 62.3092 3.46107C62.659 3.76395 62.9517 4.33665 62.9923 4.79757C63 4.88513 63 4.94513 63 5.06511C63 6.01683 63 6.4927 62.9657 6.6754C62.7241 7.96423 61.8033 8.55941 60.5289 8.25054C60.3483 8.20676 59.8198 7.96876 58.7627 7.49275C56.975 6.68767 54.7805 6 52.5 6C50.2195 6 48.025 6.68767 46.2373 7.49275C45.1802 7.96876 44.6517 8.20676 44.4711 8.25054C43.1967 8.55941 42.2759 7.96423 42.0343 6.6754C42 6.4927 42 6.01683 42 5.06511Z\"\n\t\t\tfill=\"currentColor\"\n\t\t/>\n\t</svg>\n);\n\n/**\n * All available face components\n */\nexport const FACES = [RoundFace, CrossFace, LineFace, CurvedFace] as const;\n\nexport type FaceComponent = (typeof FACES)[number];\n","/**\n * Generates a consistent numeric hash from a string.\n * Used to deterministically select faces and colors for avatars.\n *\n * @param str - The input string to hash\n * @returns A positive 32-bit integer hash\n */\nexport function stringHash(str: string): number {\n\tlet hash = 0;\n\tfor (let i = 0; i < str.length; i++) {\n\t\tconst char = str.charCodeAt(i);\n\t\thash = (hash << 5) - hash + char;\n\t\thash &= hash; // Convert to 32bit integer\n\t}\n\treturn Math.abs(hash);\n}\n","import * as React from \"react\";\nimport { FACES } from \"./faces\";\nimport { stringHash } from \"./utils/hash\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type Intensity3D = \"none\" | \"subtle\" | \"medium\" | \"dramatic\";\nexport type Variant = \"gradient\" | \"solid\";\n\nexport interface FacehashProps\n\textends Omit<React.HTMLAttributes<HTMLDivElement>, \"children\"> {\n\t/**\n\t * String to generate a deterministic face from.\n\t * Same string always produces the same face.\n\t */\n\tname: string;\n\n\t/**\n\t * Size in pixels or CSS units.\n\t * @default 40\n\t */\n\tsize?: number | string;\n\n\t/**\n\t * Background style.\n\t * - \"gradient\": Adds gradient overlay (default)\n\t * - \"solid\": Plain background color\n\t * @default \"gradient\"\n\t */\n\tvariant?: Variant;\n\n\t/**\n\t * 3D effect intensity.\n\t * @default \"dramatic\"\n\t */\n\tintensity3d?: Intensity3D;\n\n\t/**\n\t * Enable hover interaction.\n\t * When true, face \"looks straight\" on hover.\n\t * @default true\n\t */\n\tinteractive?: boolean;\n\n\t/**\n\t * Show first letter of name below the face.\n\t * @default true\n\t */\n\tshowInitial?: boolean;\n\n\t/**\n\t * Hex color array for inline styles.\n\t * Use this OR colorClasses, not both.\n\t */\n\tcolors?: string[];\n\n\t/**\n\t * Tailwind class array for background colors.\n\t * Example: [\"bg-pink-500 dark:bg-pink-600\", \"bg-blue-500 dark:bg-blue-600\"]\n\t * Use this OR colors, not both.\n\t */\n\tcolorClasses?: string[];\n\n\t/**\n\t * Custom gradient overlay class (Tailwind).\n\t * When provided, replaces the default pure CSS gradient.\n\t * Only used when variant=\"gradient\".\n\t */\n\tgradientOverlayClass?: string;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst INTENSITY_PRESETS = {\n\tnone: {\n\t\trotateRange: 0,\n\t\ttranslateZ: 0,\n\t\tperspective: \"none\",\n\t},\n\tsubtle: {\n\t\trotateRange: 5,\n\t\ttranslateZ: 4,\n\t\tperspective: \"800px\",\n\t},\n\tmedium: {\n\t\trotateRange: 10,\n\t\ttranslateZ: 8,\n\t\tperspective: \"500px\",\n\t},\n\tdramatic: {\n\t\trotateRange: 15,\n\t\ttranslateZ: 12,\n\t\tperspective: \"300px\",\n\t},\n} as const;\n\nconst SPHERE_POSITIONS = [\n\t{ x: -1, y: 1 }, // down-right\n\t{ x: 1, y: 1 }, // up-right\n\t{ x: 1, y: 0 }, // up\n\t{ x: 0, y: 1 }, // right\n\t{ x: -1, y: 0 }, // down\n\t{ x: 0, y: 0 }, // center\n\t{ x: 0, y: -1 }, // left\n\t{ x: -1, y: -1 }, // down-left\n\t{ x: 1, y: -1 }, // up-left\n] as const;\n\n// Default gradient as pure CSS (works without Tailwind)\n// Matches: bg-[radial-gradient(ellipse_100%_100%_at_50%_50%,_COLOR_0%,_transparent_60%)]\n// Light mode: white glow in center, Dark mode: dark overlay in center\nconst DEFAULT_GRADIENT_STYLE: React.CSSProperties = {\n\tbackground:\n\t\t\"radial-gradient(ellipse 100% 100% at 50% 50%, rgba(255,255,255,0.15) 0%, transparent 60%)\",\n};\n\n// ============================================================================\n// Component\n// ============================================================================\n\n/**\n * Facehash - Deterministic avatar faces from any string.\n *\n * @example\n * ```tsx\n * // With Tailwind classes\n * <Facehash\n *   name=\"John\"\n *   colorClasses={[\"bg-pink-500\", \"bg-blue-500\"]}\n * />\n *\n * // With hex colors\n * <Facehash\n *   name=\"John\"\n *   colors={[\"#ec4899\", \"#3b82f6\"]}\n * />\n *\n * // Plain color (no gradient)\n * <Facehash name=\"John\" variant=\"solid\" />\n * ```\n */\nexport const Facehash = React.forwardRef<HTMLDivElement, FacehashProps>(\n\t(\n\t\t{\n\t\t\tname,\n\t\t\tsize = 40,\n\t\t\tvariant = \"gradient\",\n\t\t\tintensity3d = \"dramatic\",\n\t\t\tinteractive = true,\n\t\t\tshowInitial = true,\n\t\t\tcolors,\n\t\t\tcolorClasses,\n\t\t\tgradientOverlayClass,\n\t\t\tclassName,\n\t\t\tstyle,\n\t\t\tonMouseEnter,\n\t\t\tonMouseLeave,\n\t\t\t...props\n\t\t},\n\t\tref\n\t) => {\n\t\tconst [isHovered, setIsHovered] = React.useState(false);\n\n\t\t// Generate deterministic values from name\n\t\tconst { FaceComponent, colorIndex, rotation } = React.useMemo(() => {\n\t\t\tconst hash = stringHash(name);\n\t\t\tconst faceIndex = hash % FACES.length;\n\t\t\tconst colorsLength = colorClasses?.length ?? colors?.length ?? 1;\n\t\t\tconst _colorIndex = hash % colorsLength;\n\t\t\tconst positionIndex = hash % SPHERE_POSITIONS.length;\n\t\t\tconst position = SPHERE_POSITIONS[positionIndex] ?? { x: 0, y: 0 };\n\n\t\t\treturn {\n\t\t\t\tFaceComponent: FACES[faceIndex] ?? FACES[0],\n\t\t\t\tcolorIndex: _colorIndex,\n\t\t\t\trotation: position,\n\t\t\t};\n\t\t}, [name, colors?.length, colorClasses?.length]);\n\n\t\t// Get intensity preset\n\t\tconst preset = INTENSITY_PRESETS[intensity3d];\n\n\t\t// Calculate 3D transform\n\t\tconst transform = React.useMemo(() => {\n\t\t\tif (intensity3d === \"none\") {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst rotateX =\n\t\t\t\tisHovered && interactive ? 0 : rotation.x * preset.rotateRange;\n\t\t\tconst rotateY =\n\t\t\t\tisHovered && interactive ? 0 : rotation.y * preset.rotateRange;\n\n\t\t\treturn `rotateX(${rotateX}deg) rotateY(${rotateY}deg) translateZ(${preset.translateZ}px)`;\n\t\t}, [intensity3d, isHovered, interactive, rotation, preset]);\n\n\t\t// Size style\n\t\tconst sizeValue = typeof size === \"number\" ? `${size}px` : size;\n\n\t\t// Initial letter\n\t\tconst initial = name.charAt(0).toUpperCase();\n\n\t\t// Background: either hex color (inline) or class\n\t\tconst bgColorClass = colorClasses?.[colorIndex];\n\t\tconst bgColorHex = colors?.[colorIndex];\n\n\t\t// Event handlers\n\t\tconst handleMouseEnter = React.useCallback(\n\t\t\t(e: React.MouseEvent<HTMLDivElement>) => {\n\t\t\t\tif (interactive) {\n\t\t\t\t\tsetIsHovered(true);\n\t\t\t\t}\n\t\t\t\tonMouseEnter?.(e);\n\t\t\t},\n\t\t\t[interactive, onMouseEnter]\n\t\t);\n\n\t\tconst handleMouseLeave = React.useCallback(\n\t\t\t(e: React.MouseEvent<HTMLDivElement>) => {\n\t\t\t\tif (interactive) {\n\t\t\t\t\tsetIsHovered(false);\n\t\t\t\t}\n\t\t\t\tonMouseLeave?.(e);\n\t\t\t},\n\t\t\t[interactive, onMouseLeave]\n\t\t);\n\n\t\treturn (\n\t\t\t// biome-ignore lint/a11y/noNoninteractiveElementInteractions: Hover effect is purely cosmetic\n\t\t\t// biome-ignore lint/a11y/noStaticElementInteractions: This is a decorative avatar component\n\t\t\t<div\n\t\t\t\tclassName={[bgColorClass, className].filter(Boolean).join(\" \")}\n\t\t\t\tdata-facehash=\"\"\n\t\t\t\tdata-interactive={interactive || undefined}\n\t\t\t\tonMouseEnter={handleMouseEnter}\n\t\t\t\tonMouseLeave={handleMouseLeave}\n\t\t\t\tref={ref}\n\t\t\t\tstyle={{\n\t\t\t\t\t// Size\n\t\t\t\t\twidth: sizeValue,\n\t\t\t\t\theight: sizeValue,\n\t\t\t\t\t// Layout\n\t\t\t\t\tposition: \"relative\",\n\t\t\t\t\tdisplay: \"flex\",\n\t\t\t\t\talignItems: \"center\",\n\t\t\t\t\tjustifyContent: \"center\",\n\t\t\t\t\toverflow: \"hidden\",\n\t\t\t\t\t// Container for cqw units\n\t\t\t\t\tcontainerType: \"size\",\n\t\t\t\t\t// 3D setup\n\t\t\t\t\t...(intensity3d !== \"none\" && {\n\t\t\t\t\t\tperspective: preset.perspective,\n\t\t\t\t\t\ttransformStyle: \"preserve-3d\",\n\t\t\t\t\t}),\n\t\t\t\t\t// Background color (hex) - only if no colorClasses\n\t\t\t\t\t...(bgColorHex && !bgColorClass && { backgroundColor: bgColorHex }),\n\t\t\t\t\t// User styles (last to allow overrides)\n\t\t\t\t\t...style,\n\t\t\t\t}}\n\t\t\t\t{...props}\n\t\t\t>\n\t\t\t\t{/* Gradient overlay */}\n\t\t\t\t{variant === \"gradient\" && (\n\t\t\t\t\t<div\n\t\t\t\t\t\tclassName={gradientOverlayClass}\n\t\t\t\t\t\tdata-facehash-gradient=\"\"\n\t\t\t\t\t\tstyle={{\n\t\t\t\t\t\t\tposition: \"absolute\",\n\t\t\t\t\t\t\tinset: 0,\n\t\t\t\t\t\t\tpointerEvents: \"none\",\n\t\t\t\t\t\t\tzIndex: 1,\n\t\t\t\t\t\t\t// Use default pure CSS gradient if no class provided\n\t\t\t\t\t\t\t...(gradientOverlayClass ? {} : DEFAULT_GRADIENT_STYLE),\n\t\t\t\t\t\t}}\n\t\t\t\t\t/>\n\t\t\t\t)}\n\n\t\t\t\t{/* Face container with 3D transform */}\n\t\t\t\t<div\n\t\t\t\t\tdata-facehash-face=\"\"\n\t\t\t\t\tstyle={{\n\t\t\t\t\t\tposition: \"absolute\",\n\t\t\t\t\t\tinset: 0,\n\t\t\t\t\t\tdisplay: \"flex\",\n\t\t\t\t\t\tflexDirection: \"column\",\n\t\t\t\t\t\talignItems: \"center\",\n\t\t\t\t\t\tjustifyContent: \"center\",\n\t\t\t\t\t\tzIndex: 2,\n\t\t\t\t\t\ttransform,\n\t\t\t\t\t\ttransformStyle: intensity3d !== \"none\" ? \"preserve-3d\" : undefined,\n\t\t\t\t\t\ttransition: interactive\n\t\t\t\t\t\t\t? \"transform 0.3s cubic-bezier(0.4, 0, 0.2, 1)\"\n\t\t\t\t\t\t\t: undefined,\n\t\t\t\t\t\t// Default to black text/icons for contrast on colored backgrounds\n\t\t\t\t\t\tcolor: \"#000000\",\n\t\t\t\t\t}}\n\t\t\t\t>\n\t\t\t\t\t{/* Face SVG */}\n\t\t\t\t\t<FaceComponent\n\t\t\t\t\t\tstyle={{\n\t\t\t\t\t\t\twidth: \"60%\",\n\t\t\t\t\t\t\theight: \"auto\",\n\t\t\t\t\t\t\tmaxWidth: \"90%\",\n\t\t\t\t\t\t\tmaxHeight: \"40%\",\n\t\t\t\t\t\t}}\n\t\t\t\t\t/>\n\n\t\t\t\t\t{/* Initial letter */}\n\t\t\t\t\t{showInitial && (\n\t\t\t\t\t\t<span\n\t\t\t\t\t\t\tdata-facehash-initial=\"\"\n\t\t\t\t\t\t\tstyle={{\n\t\t\t\t\t\t\t\tmarginTop: \"8%\",\n\t\t\t\t\t\t\t\tfontSize: \"26cqw\",\n\t\t\t\t\t\t\t\tlineHeight: 1,\n\t\t\t\t\t\t\t\tfontFamily: \"monospace\",\n\t\t\t\t\t\t\t\tfontWeight: \"bold\",\n\t\t\t\t\t\t\t}}\n\t\t\t\t\t\t>\n\t\t\t\t\t\t\t{initial}\n\t\t\t\t\t\t</span>\n\t\t\t\t\t)}\n\t\t\t\t</div>\n\t\t\t</div>\n\t\t);\n\t}\n);\n\nFacehash.displayName = \"Facehash\";\n","import * as React from \"react\";\n\ntype ImageLoadingStatus = \"idle\" | \"loading\" | \"loaded\" | \"error\";\n\nexport type AvatarContextValue = {\n\timageLoadingStatus: ImageLoadingStatus;\n\tonImageLoadingStatusChange: (status: ImageLoadingStatus) => void;\n};\n\nconst AvatarContext = React.createContext<AvatarContextValue | null>(null);\n\n/**\n * Hook to access the Avatar context.\n * Throws an error if used outside of Avatar.\n */\nexport const useAvatarContext = () => {\n\tconst context = React.useContext(AvatarContext);\n\tif (!context) {\n\t\tthrow new Error(\n\t\t\t\"Avatar compound components must be rendered within an Avatar component\"\n\t\t);\n\t}\n\treturn context;\n};\n\nexport type AvatarProps = React.HTMLAttributes<HTMLSpanElement> & {\n\t/**\n\t * Render as a different element using the asChild pattern.\n\t * When true, Avatar renders its child and merges props.\n\t */\n\tasChild?: boolean;\n};\n\n/**\n * Root avatar component that provides context for image loading state.\n *\n * @example\n * ```tsx\n * <Avatar className=\"w-10 h-10 rounded-full overflow-hidden\">\n *   <AvatarImage src=\"/photo.jpg\" alt=\"John\" />\n *   <AvatarFallback name=\"John Doe\" />\n * </Avatar>\n * ```\n */\nexport const Avatar = React.forwardRef<HTMLSpanElement, AvatarProps>(\n\t({ children, className, style, asChild = false, ...props }, ref) => {\n\t\tconst [imageLoadingStatus, setImageLoadingStatus] =\n\t\t\tReact.useState<ImageLoadingStatus>(\"idle\");\n\n\t\tconst contextValue: AvatarContextValue = React.useMemo(\n\t\t\t() => ({\n\t\t\t\timageLoadingStatus,\n\t\t\t\tonImageLoadingStatusChange: setImageLoadingStatus,\n\t\t\t}),\n\t\t\t[imageLoadingStatus]\n\t\t);\n\n\t\tconst Element = asChild ? React.Fragment : \"span\";\n\t\tconst elementProps = asChild\n\t\t\t? {}\n\t\t\t: {\n\t\t\t\t\tref,\n\t\t\t\t\tclassName,\n\t\t\t\t\tstyle: {\n\t\t\t\t\t\tposition: \"relative\" as const,\n\t\t\t\t\t\tdisplay: \"flex\",\n\t\t\t\t\t\talignItems: \"center\",\n\t\t\t\t\t\tjustifyContent: \"center\",\n\t\t\t\t\t\tflexShrink: 0,\n\t\t\t\t\t\toverflow: \"hidden\",\n\t\t\t\t\t\t...style,\n\t\t\t\t\t},\n\t\t\t\t\t\"data-avatar\": \"\",\n\t\t\t\t\t\"data-state\": imageLoadingStatus,\n\t\t\t\t\t...props,\n\t\t\t\t};\n\n\t\treturn (\n\t\t\t<AvatarContext.Provider value={contextValue}>\n\t\t\t\t<Element {...elementProps}>{children}</Element>\n\t\t\t</AvatarContext.Provider>\n\t\t);\n\t}\n);\n\nAvatar.displayName = \"Avatar\";\n","import * as React from \"react\";\nimport { useAvatarContext } from \"./avatar\";\nimport { Facehash, type FacehashProps } from \"./facehash\";\n\nconst WHITESPACE_REGEX = /\\s+/;\n\nexport type AvatarFallbackProps = Omit<\n\tReact.HTMLAttributes<HTMLSpanElement>,\n\t\"children\"\n> & {\n\t/**\n\t * The name to derive initials and Facehash from.\n\t */\n\tname?: string;\n\n\t/**\n\t * Delay in milliseconds before showing the fallback.\n\t * Useful to prevent flashing when images load quickly.\n\t * @default 0\n\t */\n\tdelayMs?: number;\n\n\t/**\n\t * Custom children to render instead of initials or Facehash.\n\t */\n\tchildren?: React.ReactNode;\n\n\t/**\n\t * Use the Facehash component as fallback instead of initials.\n\t * @default true\n\t */\n\tfacehash?: boolean;\n\n\t/**\n\t * Props to pass to the Facehash component.\n\t */\n\tfacehashProps?: Omit<FacehashProps, \"name\">;\n};\n\n/**\n * Extracts initials from a name string.\n */\nfunction getInitials(name: string): string {\n\tconst parts = name.trim().split(WHITESPACE_REGEX);\n\tif (parts.length === 0) {\n\t\treturn \"\";\n\t}\n\tif (parts.length === 1) {\n\t\treturn parts[0]?.charAt(0).toUpperCase() || \"\";\n\t}\n\n\tconst firstInitial = parts[0]?.charAt(0) || \"\";\n\tconst lastInitial = parts.at(-1)?.charAt(0) || \"\";\n\treturn (firstInitial + lastInitial).toUpperCase();\n}\n\n/**\n * Fallback component that displays when the image fails to load.\n * Uses Facehash by default, can show initials or custom content.\n *\n * @example\n * ```tsx\n * // With Facehash (default)\n * <AvatarFallback name=\"John Doe\" />\n *\n * // With initials\n * <AvatarFallback name=\"John Doe\" facehash={false} />\n *\n * // With custom content\n * <AvatarFallback>\n *   <UserIcon />\n * </AvatarFallback>\n * ```\n */\nexport const AvatarFallback = React.forwardRef<\n\tHTMLSpanElement,\n\tAvatarFallbackProps\n>(\n\t(\n\t\t{\n\t\t\tname = \"\",\n\t\t\tdelayMs = 0,\n\t\t\tchildren,\n\t\t\tfacehash = true,\n\t\t\tfacehashProps,\n\t\t\tclassName,\n\t\t\tstyle,\n\t\t\t...props\n\t\t},\n\t\tref\n\t) => {\n\t\tconst { imageLoadingStatus } = useAvatarContext();\n\t\tconst [canRender, setCanRender] = React.useState(delayMs === 0);\n\n\t\tReact.useEffect(() => {\n\t\t\tif (delayMs > 0) {\n\t\t\t\tconst timerId = window.setTimeout(() => setCanRender(true), delayMs);\n\t\t\t\treturn () => window.clearTimeout(timerId);\n\t\t\t}\n\t\t}, [delayMs]);\n\n\t\tconst initials = React.useMemo(() => getInitials(name), [name]);\n\n\t\tconst shouldRender =\n\t\t\tcanRender &&\n\t\t\timageLoadingStatus !== \"loaded\" &&\n\t\t\timageLoadingStatus !== \"loading\";\n\n\t\tif (!shouldRender) {\n\t\t\treturn null;\n\t\t}\n\n\t\t// Custom children take precedence\n\t\tif (children) {\n\t\t\treturn (\n\t\t\t\t<span\n\t\t\t\t\tclassName={className}\n\t\t\t\t\tdata-avatar-fallback=\"\"\n\t\t\t\t\tref={ref}\n\t\t\t\t\tstyle={{\n\t\t\t\t\t\tdisplay: \"flex\",\n\t\t\t\t\t\talignItems: \"center\",\n\t\t\t\t\t\tjustifyContent: \"center\",\n\t\t\t\t\t\twidth: \"100%\",\n\t\t\t\t\t\theight: \"100%\",\n\t\t\t\t\t\t...style,\n\t\t\t\t\t}}\n\t\t\t\t\t{...props}\n\t\t\t\t>\n\t\t\t\t\t{children}\n\t\t\t\t</span>\n\t\t\t);\n\t\t}\n\n\t\t// Facehash mode (default)\n\t\tif (facehash) {\n\t\t\treturn (\n\t\t\t\t<Facehash\n\t\t\t\t\tclassName={className}\n\t\t\t\t\tdata-avatar-fallback=\"\"\n\t\t\t\t\tname={name}\n\t\t\t\t\tref={ref as React.Ref<HTMLDivElement>}\n\t\t\t\t\tsize=\"100%\"\n\t\t\t\t\t{...facehashProps}\n\t\t\t\t\tstyle={{\n\t\t\t\t\t\t...style,\n\t\t\t\t\t}}\n\t\t\t\t\t{...props}\n\t\t\t\t/>\n\t\t\t);\n\t\t}\n\n\t\t// Initials mode\n\t\treturn (\n\t\t\t<span\n\t\t\t\tclassName={className}\n\t\t\t\tdata-avatar-fallback=\"\"\n\t\t\t\tref={ref}\n\t\t\t\tstyle={{\n\t\t\t\t\tdisplay: \"flex\",\n\t\t\t\t\talignItems: \"center\",\n\t\t\t\t\tjustifyContent: \"center\",\n\t\t\t\t\twidth: \"100%\",\n\t\t\t\t\theight: \"100%\",\n\t\t\t\t\t...style,\n\t\t\t\t}}\n\t\t\t\t{...props}\n\t\t\t>\n\t\t\t\t{initials}\n\t\t\t</span>\n\t\t);\n\t}\n);\n\nAvatarFallback.displayName = \"AvatarFallback\";\n","import * as React from \"react\";\nimport { useAvatarContext } from \"./avatar\";\n\ntype ImageLoadingStatus = \"idle\" | \"loading\" | \"loaded\" | \"error\";\n\nexport type AvatarImageProps = Omit<\n\tReact.ImgHTMLAttributes<HTMLImageElement>,\n\t\"src\"\n> & {\n\t/**\n\t * The image source URL. If empty or undefined, triggers error state.\n\t */\n\tsrc?: string | null;\n\n\t/**\n\t * Callback when the image loading status changes.\n\t */\n\tonLoadingStatusChange?: (status: ImageLoadingStatus) => void;\n};\n\n/**\n * Image component that syncs its loading state with the Avatar context.\n * Automatically hides when loading fails, allowing fallback to show.\n *\n * @example\n * ```tsx\n * <Avatar>\n *   <AvatarImage src=\"/photo.jpg\" alt=\"User\" />\n *   <AvatarFallback name=\"John Doe\" />\n * </Avatar>\n * ```\n */\nexport const AvatarImage = React.forwardRef<HTMLImageElement, AvatarImageProps>(\n\t(\n\t\t{ src, alt = \"\", className, style, onLoadingStatusChange, ...props },\n\t\tref\n\t) => {\n\t\tconst { imageLoadingStatus, onImageLoadingStatusChange } =\n\t\t\tuseAvatarContext();\n\n\t\tconst imageRef = React.useRef<HTMLImageElement>(null);\n\t\t// biome-ignore lint/style/noNonNullAssertion: ref is guaranteed to be set\n\t\tReact.useImperativeHandle(ref, () => imageRef.current!);\n\n\t\tconst updateStatus = React.useCallback(\n\t\t\t(status: ImageLoadingStatus) => {\n\t\t\t\tonImageLoadingStatusChange(status);\n\t\t\t\tonLoadingStatusChange?.(status);\n\t\t\t},\n\t\t\t[onImageLoadingStatusChange, onLoadingStatusChange]\n\t\t);\n\n\t\tReact.useLayoutEffect(() => {\n\t\t\tif (!src) {\n\t\t\t\tupdateStatus(\"error\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tlet isMounted = true;\n\t\t\tconst image = new Image();\n\n\t\t\tconst setStatus = (status: ImageLoadingStatus) => {\n\t\t\t\tif (!isMounted) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tupdateStatus(status);\n\t\t\t};\n\n\t\t\tsetStatus(\"loading\");\n\n\t\t\timage.onload = () => setStatus(\"loaded\");\n\t\t\timage.onerror = () => setStatus(\"error\");\n\t\t\timage.src = src;\n\n\t\t\treturn () => {\n\t\t\t\tisMounted = false;\n\t\t\t};\n\t\t}, [src, updateStatus]);\n\n\t\tif (imageLoadingStatus !== \"loaded\") {\n\t\t\treturn null;\n\t\t}\n\n\t\treturn (\n\t\t\t// biome-ignore lint/performance/noImgElement: This is a library component, not a Next.js app\n\t\t\t// biome-ignore lint/nursery/useImageSize: Size is controlled by parent container\n\t\t\t<img\n\t\t\t\talt={alt}\n\t\t\t\tclassName={className}\n\t\t\t\tdata-avatar-image=\"\"\n\t\t\t\tref={imageRef}\n\t\t\t\tsrc={src ?? undefined}\n\t\t\t\tstyle={{\n\t\t\t\t\taspectRatio: \"1 / 1\",\n\t\t\t\t\twidth: \"100%\",\n\t\t\t\t\theight: \"100%\",\n\t\t\t\t\tobjectFit: \"cover\",\n\t\t\t\t\t...style,\n\t\t\t\t}}\n\t\t\t\t{...props}\n\t\t\t/>\n\t\t);\n\t}\n);\n\nAvatarImage.displayName = \"AvatarImage\";\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "facehash",
+  "type": "module",
+  "version": "0.0.2",
+  "private": false,
+  "author": "Cossistant team",
+  "description": "Deterministic avatar faces from any string. Lightweight, interactive, pure CSS. Works with any framework.",
+  "keywords": [
+    "facehash",
+    "avatar",
+    "react",
+    "react-avatar",
+    "deterministic",
+    "generative",
+    "profile-picture",
+    "profile-avatar",
+    "identicon",
+    "hash",
+    "face",
+    "3d",
+    "interactive",
+    "gradient",
+    "typescript",
+    "accessible",
+    "headless",
+    "unstyled",
+    "css",
+    "tailwind",
+    "boring-avatars",
+    "dicebear",
+    "jdenticon",
+    "gravatar-alternative",
+    "user-avatar",
+    "default-avatar"
+  ],
+  "bugs": {
+    "url": "https://github.com/cossistantcom/cossistant/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cossistantcom/cossistant.git",
+    "directory": "packages/facehash"
+  },
+  "license": "MIT",
+  "homepage": "https://cossistant.com",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "peerDependencies": {
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20",
+    "@types/react": ""
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}