mirror of
https://github.com/hanzoai/o11y-components.git
synced 2026-11-02 09:37:38 +00:00
zeekay
464e1eece0
A version written into a manifest is written into every manifest that wants it, which is how eslint came to exist in a hundred and four forms across this estate and how a package came to resolve twice at run time. The catalog moves the number out of the manifest: a manifest names the package, the workspace names the version. Four are held below their latest because the newer release cannot be used, and the reason is recorded rather than the version alone: @noble/hashes 2 renamed every subpath the web3 stack imports, @splinetool/runtime 2 depends on a package that was never published, @dynamic-labs 5.4.1 the same, and react-resizable-panels 3 points its types condition at the bundle.
254 lines
6.3 KiB
TypeScript
254 lines
6.3 KiB
TypeScript
import { Avatar, type AvatarColor, type AvatarSize } from '@signozhq/ui';
|
|
import type { Meta, StoryObj } from '@storybook/react-vite';
|
|
|
|
const meta: Meta<typeof Avatar> = {
|
|
title: 'Primitive Components/Avatar',
|
|
component: Avatar,
|
|
parameters: {
|
|
layout: 'fullscreen',
|
|
docs: {
|
|
description: {
|
|
component:
|
|
'A versatile avatar component for displaying user profile images, initials, or icons. Supports multiple sizes, shapes, color themes, image loading with fallback, and a skeleton loading state.',
|
|
},
|
|
},
|
|
},
|
|
argTypes: {
|
|
size: {
|
|
control: 'inline-radio',
|
|
options: ['sm', 'md', 'lg', 'xl'],
|
|
description: 'The size of the avatar.',
|
|
table: { category: 'Appearance', defaultValue: { summary: 'md' } },
|
|
},
|
|
shape: {
|
|
control: 'inline-radio',
|
|
options: ['circle', 'square'],
|
|
description: 'The shape of the avatar.',
|
|
table: { category: 'Appearance', defaultValue: { summary: 'circle' } },
|
|
},
|
|
color: {
|
|
control: 'select',
|
|
options: [
|
|
'primary',
|
|
'secondary',
|
|
'success',
|
|
'error',
|
|
'warning',
|
|
'robin',
|
|
'forest',
|
|
'amber',
|
|
'sienna',
|
|
'cherry',
|
|
'sakura',
|
|
'aqua',
|
|
'vanilla',
|
|
],
|
|
description: 'The color theme of the avatar background.',
|
|
table: { category: 'Appearance' },
|
|
},
|
|
src: {
|
|
control: 'text',
|
|
description: 'Image URL for the avatar.',
|
|
table: { category: 'Content' },
|
|
},
|
|
alt: {
|
|
control: 'text',
|
|
description: 'Alt text for the avatar image.',
|
|
table: { category: 'Accessibility' },
|
|
},
|
|
loading: {
|
|
control: 'boolean',
|
|
description: 'When true, renders a shimmer skeleton placeholder.',
|
|
table: { category: 'Behavior', defaultValue: { summary: 'false' } },
|
|
},
|
|
children: {
|
|
control: 'text',
|
|
description: 'Fallback content (initials, icon) when no image is provided.',
|
|
table: { category: 'Content' },
|
|
},
|
|
testId: {
|
|
control: 'text',
|
|
description: 'Test ID for the avatar.',
|
|
table: { category: 'Testing', type: { summary: 'string' } },
|
|
},
|
|
className: {
|
|
control: 'text',
|
|
description: 'Additional CSS classes.',
|
|
table: { category: 'Styling', type: { summary: 'string' } },
|
|
},
|
|
},
|
|
};
|
|
|
|
export default meta;
|
|
|
|
type Story = StoryObj<typeof Avatar>;
|
|
|
|
export const Playground: Story = {
|
|
args: {
|
|
size: 'md',
|
|
shape: 'circle',
|
|
children: 'AB',
|
|
color: 'robin',
|
|
loading: false,
|
|
},
|
|
};
|
|
|
|
export const AllSizes: Story = {
|
|
parameters: {
|
|
docs: {
|
|
description: {
|
|
story: 'Avatar comes in four sizes: sm (24px), md (32px), lg (40px), and xl (48px).',
|
|
},
|
|
},
|
|
},
|
|
render: () => {
|
|
const sizes: AvatarSize[] = ['sm', 'md', 'lg', 'xl'];
|
|
return (
|
|
<div style={{ display: 'flex', alignItems: 'flex-end', gap: 16 }}>
|
|
{sizes.map((size) => (
|
|
<div
|
|
key={size}
|
|
style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 8 }}
|
|
>
|
|
<Avatar size={size} color="robin">
|
|
{size.toUpperCase()}
|
|
</Avatar>
|
|
<span style={{ color: 'var(--muted-foreground)', fontSize: 12, lineHeight: 1.33333 }}>
|
|
{size}
|
|
</span>
|
|
</div>
|
|
))}
|
|
</div>
|
|
);
|
|
},
|
|
};
|
|
|
|
export const Shapes: Story = {
|
|
parameters: {
|
|
docs: {
|
|
description: {
|
|
story: 'Avatars can be circular (default) or square with rounded corners.',
|
|
},
|
|
},
|
|
},
|
|
render: () => (
|
|
<div style={{ display: 'flex', alignItems: 'center', gap: 16 }}>
|
|
<div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 8 }}>
|
|
<Avatar size="lg" shape="circle" color="robin">
|
|
AB
|
|
</Avatar>
|
|
<span style={{ color: 'var(--muted-foreground)', fontSize: 12, lineHeight: 1.33333 }}>
|
|
circle
|
|
</span>
|
|
</div>
|
|
<div style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 8 }}>
|
|
<Avatar size="lg" shape="square" color="robin">
|
|
AB
|
|
</Avatar>
|
|
<span style={{ color: 'var(--muted-foreground)', fontSize: 12, lineHeight: 1.33333 }}>
|
|
square
|
|
</span>
|
|
</div>
|
|
</div>
|
|
),
|
|
};
|
|
|
|
export const AllColors: Story = {
|
|
parameters: {
|
|
docs: {
|
|
description: {
|
|
story: 'All available color themes for avatars with initials.',
|
|
},
|
|
},
|
|
},
|
|
render: () => {
|
|
const colors: AvatarColor[] = [
|
|
'robin',
|
|
'forest',
|
|
'amber',
|
|
'sienna',
|
|
'cherry',
|
|
'sakura',
|
|
'aqua',
|
|
'vanilla',
|
|
];
|
|
return (
|
|
<div style={{ display: 'flex', gap: 12, flexWrap: 'wrap' }}>
|
|
{colors.map((color) => (
|
|
<div
|
|
key={color}
|
|
style={{ display: 'flex', flexDirection: 'column', alignItems: 'center', gap: 8 }}
|
|
>
|
|
<Avatar size="lg" color={color}>
|
|
{color.slice(0, 2).toUpperCase()}
|
|
</Avatar>
|
|
<span style={{ color: 'var(--muted-foreground)', fontSize: 12, lineHeight: 1.33333 }}>
|
|
{color}
|
|
</span>
|
|
</div>
|
|
))}
|
|
</div>
|
|
);
|
|
},
|
|
};
|
|
|
|
export const WithImage: Story = {
|
|
parameters: {
|
|
docs: {
|
|
description: {
|
|
story:
|
|
'When a `src` prop is provided, the avatar displays an image. If the image fails to load, it falls back to `children`.',
|
|
},
|
|
},
|
|
},
|
|
render: () => (
|
|
<div style={{ display: 'flex', alignItems: 'center', gap: 16 }}>
|
|
<Avatar size="xl" src="https://i.pravatar.cc/96?u=1" alt="User avatar" />
|
|
<Avatar size="lg" src="https://i.pravatar.cc/80?u=2" alt="User avatar" />
|
|
<Avatar size="md" src="https://i.pravatar.cc/64?u=3" alt="User avatar" />
|
|
<Avatar size="sm" src="https://i.pravatar.cc/48?u=4" alt="User avatar" />
|
|
</div>
|
|
),
|
|
};
|
|
|
|
export const ImageFallback: Story = {
|
|
parameters: {
|
|
docs: {
|
|
description: {
|
|
story:
|
|
'When an image fails to load, the avatar falls back to displaying the `children` content (e.g., initials).',
|
|
},
|
|
},
|
|
},
|
|
render: () => (
|
|
<div style={{ display: 'flex', alignItems: 'center', gap: 16 }}>
|
|
<Avatar size="lg" src="https://broken-url.invalid/avatar.png" color="cherry">
|
|
JD
|
|
</Avatar>
|
|
<span style={{ color: 'var(--muted-foreground)', fontSize: 14, lineHeight: 1.42857 }}>
|
|
Broken image URL → falls back to initials
|
|
</span>
|
|
</div>
|
|
),
|
|
};
|
|
|
|
export const Loading: Story = {
|
|
parameters: {
|
|
docs: {
|
|
description: {
|
|
story:
|
|
'Set `loading` to render a shimmer skeleton placeholder. Useful while fetching user data.',
|
|
},
|
|
},
|
|
},
|
|
render: () => (
|
|
<div style={{ display: 'flex', alignItems: 'center', gap: 16 }}>
|
|
<Avatar size="xl" shape="circle" loading />
|
|
<Avatar size="lg" shape="circle" loading />
|
|
<Avatar size="lg" shape="square" loading />
|
|
<Avatar size="md" shape="circle" loading />
|
|
<Avatar size="sm" shape="circle" loading />
|
|
</div>
|
|
),
|
|
};
|