KirinCode/packages/ui/src/components/avatar.stories.tsx

// @ts-nocheck
import * as mod from "./avatar"
import { create } from "../storybook/scaffold"

const docs = `### Overview
User avatar with image fallback to initials.

Use in user lists and headers.

### API
- Required: \`fallback\` string.
- Optional: \`src\`, \`background\`, \`foreground\`, \`size\`.

### Variants and states
- Sizes: small, normal, large.
- Image vs fallback state.

### Behavior
- Uses grapheme-aware fallback rendering.

### Accessibility
- TODO: provide alt text when using images; currently image is decorative.

### Theming/tokens
- Uses \`data-component="avatar"\` with size and image state attributes.

`

const story = create({ title: "UI/Avatar", mod, args: { fallback: "A" } })

export default {
  title: "UI/Avatar",
  id: "components-avatar",
  component: story.meta.component,
  tags: ["autodocs"],
  parameters: {
    docs: {
      description: {
        component: docs,
      },
    },
  },
  argTypes: {
    size: {
      control: "select",
      options: ["small", "normal", "large"],
    },
  },
}

export const Basic = story.Basic

export const WithImage = {
  args: {
    src: "https://placehold.co/80x80/png",
    fallback: "J",
  },
}

export const Sizes = {
  render: () => (
    <div style={{ display: "flex", gap: "12px", "align-items": "center" }}>
      <mod.Avatar size="small" fallback="S" />
      <mod.Avatar size="normal" fallback="N" />
      <mod.Avatar size="large" fallback="L" />
    </div>
  ),
}

export const CustomColors = {
  args: {
    fallback: "C",
    background: "#1f2a44",
    foreground: "#f2f5ff",
  },
}