@volverjs/ui-vue 0.0.5 → 0.0.6-beta.2

package/src/components/VvAvatar/VvAvatar.vue

@@ -0,0 +1,21 @@
+<script setup lang="ts">
+	import { VvAvatarProps } from '@/components/VvAvatar'
+
+	const props = defineProps(VvAvatarProps)
+	const { modifiers } = toRefs(props)
+
+	// bem css classes
+	const bemCssClasses = useModifiers('vv-avatar', modifiers)
+</script>
+
+<template>
+	<span
+		:class="bemCssClasses"
+		:role="imgSrc ? undefined : 'img'"
+		:aria-label="imgSrc ? undefined : 'avatar'"
+	>
+		<slot name="default">
+			<img v-if="imgSrc" :src="imgSrc" alt="avatar" />
+		</slot>
+	</span>
+</template>

package/src/components/VvAvatar/index.ts

@@ -0,0 +1,9 @@
+import { ModifiersProps } from '@/props'
+
+export const VvAvatarProps = {
+	...ModifiersProps,
+	/**
+	 * Image src for avatar
+	 */
+	imgSrc: String,
+}

package/src/components/VvAvatarGroup/VvAvatarGroup.vue

@@ -0,0 +1,65 @@
+<script setup lang="ts">
+	import { VvAvatarGroupProps } from '@/components/VvAvatarGroup'
+	import VvAvatar from '@/components/VvAvatar/VvAvatar.vue'
+
+	const props = defineProps(VvAvatarGroupProps)
+	const { modifiers, items, toShow, totalItems, avatarModifiers } =
+		toRefs(props)
+
+	// bem css classes
+	const bemCssClasses = useModifiers('vv-avatar-group', modifiers)
+
+	const stringModifiers = computed(() => {
+		if (avatarModifiers?.value && Array.isArray(avatarModifiers?.value)) {
+			return avatarModifiers.value.join(' ')
+		}
+		return avatarModifiers?.value || ''
+	})
+
+	const avatarItems = computed(() => {
+		return items.value.slice(0, toShow.value).map((item, index) => {
+			let modifiers: string[] = []
+			let itemModifiers: string[] = []
+
+			if (avatarModifiers?.value) {
+				modifiers = Array.isArray(avatarModifiers?.value)
+					? avatarModifiers?.value
+					: [avatarModifiers?.value]
+			}
+
+			if (item.modifiers) {
+				itemModifiers = Array.isArray(item.modifiers)
+					? item.modifiers
+					: [item.modifiers]
+			}
+
+			return {
+				...item,
+				key: item.key || `${index}_${new Date().getTime()}`,
+				modifiers: [...modifiers, ...itemModifiers],
+			}
+		})
+	})
+</script>
+
+<template>
+	<span :class="bemCssClasses">
+		<slot name="default">
+			<VvAvatar
+				v-for="avatarItem in avatarItems"
+				:key="avatarItem.key"
+				v-bind="{
+					modifiers: avatarItem.modifiers,
+					imgSrc: avatarItem.imgSrc,
+				}"
+			>
+				<span v-if="avatarItem.text">{{ avatarItem.text }}</span>
+			</VvAvatar>
+			<VvAvatar
+				v-if="(totalItems || items.length) > toShow"
+				:modifiers="`${stringModifiers} surface bordered`"
+				>{{ `+${(totalItems || items.length) - toShow}` }}</VvAvatar
+			>
+		</slot>
+	</span>
+</template>

package/src/components/VvAvatarGroup/index.ts

@@ -0,0 +1,28 @@
+import { ModifiersProps } from '@/props'
+
+export type AvatarItem = {
+	key?: string
+	text?: string
+	imgSrc?: string
+	modifiers?: string | string[]
+}
+
+export const VvAvatarGroupProps = {
+	...ModifiersProps,
+	/**
+	 * avatar items
+	 */
+	items: {
+		type: Array<AvatarItem>,
+		default: () => [],
+		required: true,
+	},
+	toShow: {
+		type: Number,
+		default: 3,
+	},
+	totalItems: {
+		type: Number,
+	},
+	avatarModifiers: [String, Array] as PropType<string | Array<string>>,
+}

package/src/stories/Avatar/Avatar.settings.ts

@@ -0,0 +1,36 @@
+import { VvAvatarProps } from '@/components/VvAvatar'
+import { DefaultSlotArgTypes, ModifiersArgTypes } from '@/stories/argTypes'
+
+export const defaultArgs = {
+	...propsToObject(VvAvatarProps),
+	imgSrc: 'https://i.pravatar.cc/300',
+}
+
+export const argTypes = {
+	...DefaultSlotArgTypes,
+	default: {
+		description: 'Content slot',
+		control: {
+			type: 'text',
+		},
+		table: {
+			category: 'Slots',
+			type: {
+				summary: 'html',
+			},
+		},
+	},
+	modifiers: {
+		...ModifiersArgTypes.modifiers,
+		options: ['rounded', 'square', 'bordered', 'ring', 'lg', 'md'],
+	},
+	imgSrc: {
+		type: {
+			summary: 'string',
+		},
+		control: {
+			type: 'text',
+		},
+		description: 'The image url',
+	},
+}

package/src/stories/Avatar/Avatar.stories.mdx

@@ -0,0 +1,40 @@
+import { Meta, Story, Canvas } from '@storybook/addon-docs'
+import VvAvatar from '@/components/VvAvatar/VvAvatar.vue'
+import { defaultArgs, argTypes } from './Avatar.settings'
+import { defaultTest } from './Avatar.test'
+
+<Meta
+	title="Components/Avatar"
+	component={VvAvatar}
+	args={defaultArgs}
+	argTypes={argTypes}
+/>
+
+export const Template = (args) => ({
+	components: { VvAvatar },
+	setup() {
+		return { args }
+	},
+	template: /* html */ `
+		<div class="m-md">
+			<vv-avatar v-bind="args" data-testId="element">
+				<template v-if="args.default">{{ args.default }}</template>
+			</vv-avatar>
+		</div>`,
+})
+
+<Canvas>
+	<Story name="Default" play={defaultTest}>
+		{Template.bind()}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story
+		name="Image"
+		play={defaultTest}
+		args={{ imgSrc: 'https://i.pravatar.cc/300' }}
+	>
+		{Template.bind({})}
+	</Story>
+</Canvas>

package/src/stories/Avatar/Avatar.test.ts

@@ -0,0 +1,34 @@
+import type { PlayAttributes } from '@/test/types'
+import { expect } from '@/test/expect'
+import { within } from '@storybook/testing-library'
+
+export async function defaultTest({ canvasElement, args }: PlayAttributes) {
+	const element = (await within(canvasElement).findByTestId(
+		'element',
+	)) as HTMLElement
+
+	// slot default
+	if (!args.default && !args.imgSrc) {
+		throw new Error('Default slot or imgSrc is required!')
+	}
+
+	const modifiers =
+		!args.modifiers || Array.isArray(args.modifiers)
+			? args.modifiers
+			: [args.modifiers]
+
+	// modifiers
+	if (modifiers) {
+		for (const modifier of modifiers) {
+			expect(element).toHaveClass(`vv-avatar--${modifier}`)
+		}
+	}
+
+	// check img tag exist
+	if (args.imgSrc && !args.default) {
+		expect(element).toHaveImgChild('img')
+	}
+
+	// check accessibility
+	await expect(element).toHaveNoViolations()
+}

package/src/stories/Avatar/AvatarBadge.stories.mdx

@@ -0,0 +1,41 @@
+import { Meta, Story, Canvas } from '@storybook/addon-docs'
+import VvAvatar from '@/components/VvAvatar/VvAvatar.vue'
+import VvBadge from '@/components/VvBadge/VvBadge.vue'
+import { defaultArgs, argTypes } from './Avatar.settings'
+import { defaultTest } from './Avatar.test'
+
+<Meta
+	title="Components/Avatar/Badge"
+	component={VvAvatar}
+	args={defaultArgs}
+	argTypes={argTypes}
+/>
+
+export const Template = (args) => ({
+	components: { VvAvatar, VvBadge },
+	setup() {
+		return { args }
+	},
+	template: /* html */ `
+		<div class="m-md">
+			<vv-avatar v-bind="args" data-testId="element">
+				{{ args.default }}
+                <sup>
+                    <vv-badge :modifiers="['danger', 'rounded']">99+</vv-badge>
+                </sup>
+			</vv-avatar>
+		</div>`,
+})
+
+<Canvas>
+	<Story
+		name="Badge"
+		play={defaultTest}
+		args={{
+			default: 'MR',
+			modifiers: 'lg',
+		}}
+	>
+		{Template.bind()}
+	</Story>
+</Canvas>

package/src/stories/Avatar/AvatarModifiers.stories.mdx

@@ -0,0 +1,87 @@
+import { Meta, Story, Canvas } from '@storybook/addon-docs'
+import VvAvatar from '@/components/VvAvatar/VvAvatar.vue'
+import { defaultArgs, argTypes } from './Avatar.settings'
+import { defaultTest } from './Avatar.test'
+import { Template } from './Avatar.stories.mdx'
+
+<Meta
+	title="Components/Avatar/Modifiers"
+	component={VvAvatar}
+	args={defaultArgs}
+	argTypes={argTypes}
+/>
+
+<Canvas>
+	<Story name="Small" play={defaultTest} args={{ modifiers: '' }}>
+		{Template.bind({})}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story name="Medium" play={defaultTest} args={{ modifiers: 'md' }}>
+		{Template.bind({})}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story name="Large" play={defaultTest} args={{ modifiers: 'lg' }}>
+		{Template.bind({})}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story
+		name="Rounded"
+		play={defaultTest}
+		args={{ modifiers: 'rounded', default: 'MR' }}
+	>
+		{Template.bind({})}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story
+		name="Square"
+		play={defaultTest}
+		args={{ modifiers: ['square', 'md'] }}
+	>
+		{Template.bind({})}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story
+		name="Bordered"
+		play={defaultTest}
+		args={{ modifiers: ['bordered', 'md'], default: 'MR' }}
+	>
+		{Template.bind({})}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story
+		name="Ring"
+		play={defaultTest}
+		args={{ modifiers: ['ring', 'md'], default: 'MR' }}
+	>
+		{Template.bind({})}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story
+		name="CustomColors"
+		play={defaultTest}
+		args={{ modifiers: ['accent', 'md'], default: 'MR' }}
+		argTypes={{
+			...argTypes,
+			modifiers: {
+				...argTypes.modifiers,
+				options: [...argTypes.modifiers.options, 'accent'],
+			},
+		}}
+	>
+		{Template.bind({})}
+	</Story>
+</Canvas>

package/src/stories/Avatar/AvatarSlotDefault.stories.mdx

@@ -0,0 +1,29 @@
+import { Meta, Story, Canvas } from '@storybook/addon-docs'
+import VvAvatar from '@/components/VvAvatar/VvAvatar.vue'
+import { defaultArgs, argTypes } from './Avatar.settings'
+import { defaultTest } from './Avatar.test'
+import { Template } from './Avatar.stories.mdx'
+
+<Meta
+	title="Components/Avatar/Slots"
+	component={VvAvatar}
+	args={defaultArgs}
+	argTypes={argTypes}
+/>
+
+<Canvas>
+	<Story
+		name="Default"
+		play={defaultTest}
+		args={{ default: 'MR' }}
+		argTypes={{
+			default: {
+				control: {
+					disable: true,
+				},
+			},
+		}}
+	>
+		{Template.bind({})}
+	</Story>
+</Canvas>

package/src/stories/AvatarGroup/AvatarGroup.settings.ts

@@ -0,0 +1,60 @@
+import { VvAvatarGroupProps } from '@/components/VvAvatarGroup'
+import { DefaultSlotArgTypes, ModifiersArgTypes } from '@/stories/argTypes'
+
+export const defaultArgs = {
+	...propsToObject(VvAvatarGroupProps),
+	items: [
+		{
+			text: 'MR',
+			imgSrc: 'https://i.pravatar.cc/300',
+			modifiers: 'rounded',
+		},
+		{
+			imgSrc: 'https://i.pravatar.cc/300',
+			modifiers: 'rounded',
+		},
+		{
+			imgSrc: 'https://i.pravatar.cc/300',
+			modifiers: 'rounded',
+		},
+		{
+			imgSrc: 'https://i.pravatar.cc/300',
+			modifiers: 'rounded',
+		},
+	],
+	avatarModifiers: 'rounded',
+}
+
+export const argTypes = {
+	...DefaultSlotArgTypes,
+	default: {
+		description: 'Default slot',
+		control: {
+			type: 'text',
+		},
+		table: {
+			category: 'Slots',
+			type: {
+				summary: 'html',
+			},
+		},
+	},
+	modifiers: {
+		...ModifiersArgTypes.modifiers,
+		options: ['tight', 'relaxed'],
+	},
+	avatarModifiers: {
+		...ModifiersArgTypes.modifiers,
+		options: ['rounded', 'square', 'bordered', 'ring', 'lg', 'md'],
+	},
+	toShow: {
+		control: {
+			type: 'number',
+		},
+	},
+	totalItems: {
+		control: {
+			type: 'number',
+		},
+	},
+}

package/src/stories/AvatarGroup/AvatarGroup.stories.mdx

@@ -0,0 +1,30 @@
+import { Meta, Story, Canvas } from '@storybook/addon-docs'
+import VvAvatarGroup from '@/components/VvAvatarGroup/VvAvatarGroup.vue'
+import { defaultArgs, argTypes } from './AvatarGroup.settings'
+import { defaultTest } from './AvatarGroup.test'
+
+<Meta
+	title="Components/AvatarGroup"
+	component={VvAvatarGroup}
+	args={defaultArgs}
+	argTypes={argTypes}
+/>
+
+export const Template = (args) => ({
+	components: { VvAvatarGroup },
+	setup() {
+		return { args }
+	},
+	template: /* html */ `
+		<div class="m-md">
+			<vv-avatar-group v-bind="args" data-testId="element">
+				<template v-if="args.default">{{ args.default }}</template>
+			</vv-avatar-group>
+		</div>`,
+})
+
+<Canvas>
+	<Story name="Default" play={defaultTest}>
+		{Template.bind()}
+	</Story>
+</Canvas>

package/src/stories/AvatarGroup/AvatarGroup.test.ts

@@ -0,0 +1,36 @@
+import type { PlayAttributes } from '@/test/types'
+import { expect } from '@/test/expect'
+import { within } from '@storybook/testing-library'
+
+export async function defaultTest({ canvasElement, args }: PlayAttributes) {
+	const element = (await within(canvasElement).findByTestId(
+		'element',
+	)) as HTMLElement
+
+	// slot default
+	if (!args.default && !args.items && !args.items?.length) {
+		throw new Error('Default slot or items is required!')
+	}
+
+	const modifiers =
+		!args.modifiers || Array.isArray(args.modifiers)
+			? args.modifiers
+			: [args.modifiers]
+
+	// modifiers
+	if (modifiers) {
+		for (const modifier of modifiers) {
+			expect(element).toHaveClass(`vv-avatar-group--${modifier}`)
+		}
+	}
+
+	// check children numbers
+	if (args.items && args.items.length && !args.default) {
+		if ((args.totalItems || args.items.length) > args.toShow) {
+			expect(element.children.length).toEqual(args.toShow + 1)
+		}
+	}
+
+	// check accessibility
+	await expect(element).toHaveNoViolations()
+}

package/src/stories/AvatarGroup/AvatarGroupModifiers.stories.mdx

@@ -0,0 +1,24 @@
+import { Meta, Story, Canvas } from '@storybook/addon-docs'
+import VvAvatarGroup from '@/components/VvAvatarGroup/VvAvatarGroup.vue'
+import { defaultArgs, argTypes } from './AvatarGroup.settings'
+import { defaultTest } from './AvatarGroup.test'
+import { Template } from './AvatarGroup.stories.mdx'
+
+<Meta
+	title="Components/AvatarGroup/Modifiers"
+	component={VvAvatarGroup}
+	args={defaultArgs}
+	argTypes={argTypes}
+/>
+
+<Canvas>
+	<Story name="Tight" play={defaultTest} args={{ modifiers: 'tight' }}>
+		{Template.bind({})}
+	</Story>
+</Canvas>
+
+<Canvas>
+	<Story name="Relaxed" play={defaultTest} args={{ modifiers: 'relaxed' }}>
+		{Template.bind({})}
+	</Story>
+</Canvas>

package/src/stories/AvatarGroup/AvatarGroupSlotDefault.stories.mdx

@@ -0,0 +1,45 @@
+import { Meta, Story, Canvas } from '@storybook/addon-docs'
+import VvAvatarGroup from '@/components/VvAvatarGroup/VvAvatarGroup.vue'
+import VvAvatar from '@/components/VvAvatar/VvAvatar.vue'
+import { defaultArgs, argTypes } from './AvatarGroup.settings'
+import { defaultTest } from './AvatarGroup.test'
+import { Template } from './AvatarGroup.stories.mdx'
+
+<Meta
+	title="Components/AvatarGroup/Slots"
+	component={VvAvatarGroup}
+	args={defaultArgs}
+	argTypes={argTypes}
+/>
+
+export const TemplateSlot = (args) => ({
+	components: { VvAvatarGroup, VvAvatar },
+	setup() {
+		return { args }
+	},
+	template: /* html */ `
+		<div class="m-md">
+			<vv-avatar-group v-bind="args" data-testId="element" modifiers="relaxed">
+				<vv-avatar modifiers="rounded">MR</vv-avatar>
+				<vv-avatar modifiers="rounded accent">PB</vv-avatar>
+				<vv-avatar imgSrc="https://i.pravatar.cc/300" modifiers="rounded" />
+				<vv-avatar modifiers="rounded surface">+3</vv-avatar>
+			</vv-avatar-group>
+		</div>`,
+})
+
+<Canvas>
+	<Story
+		name="Default"
+		play={defaultTest}
+		argTypes={{
+			default: {
+				control: {
+					disable: true,
+				},
+			},
+		}}
+	>
+		{TemplateSlot.bind({})}
+	</Story>
+</Canvas>

package/src/test/expect.ts

@@ -21,6 +21,13 @@ declare global {
 				expected?: HTMLElement,
 			) => CustomMatcherResult
 		}
+		// eslint-disable-next-line
+		interface Matchers<R> {
+			toHaveImgChild: (
+				imgTag: string,
+				expected?: HTMLElement,
+			) => CustomMatcherResult
+		}
 	}
 }
 
@@ -68,6 +75,14 @@ expect.extend({
 				`One of these classes doesn't exist: ${classes.join(', ')}`,
 		}
 	},
+	async toHaveImgChild(element: HTMLElement, imgTag: string) {
+		const img = element.getElementsByTagName(imgTag)
+		return {
+			pass: img.length === 1,
+			message: () =>
+				`${imgTag} not exist!`,
+		}
+	},
 })
 
 export { expect }