An open source design system that's fully customizable and agent ready
TypeScript
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
* @file Center.test.tsx
* @input Uses vitest, @testing-library/react, Center component
* @output Unit tests for Center component behavior
* @position Testing; validates Center.tsx implementation
*
* SYNC: When Center.tsx changes, update tests to match new behavior
*/
import {describe, it, expect, vi} from 'vitest';
import {render, screen} from '@testing-library/react';
import {renderToString} from 'react-dom/server';
import {Center} from './Center';
/**
* The functional class output, as an order-insensitive set. StyleX's dev
* runtime also emits readable debug classes naming the style object a
* declaration came from ("padding__paddingBlockStyles.2"); those record
* provenance rather than applied CSS and survive even when the declaration
* they name loses a merge, so they are dropped here.
*/
function classSet(el: HTMLElement): Set<string> {
return new Set(
el.className
.split(' ')
.filter(Boolean)
.filter(c => !c.includes('__') && !c.includes('.')),
);
}
describe('Center', () => {
it('renders and centers children (both axes by default)', () => {
render(
<Center data-testid="center">
<div>Centered Content</div>
</Center>,
);
const element = screen.getByTestId('center');
expect(screen.getByText('Centered Content')).toBeInTheDocument();
expect(element).toBeInTheDocument();
expect(element).toHaveStyle({
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
});
});
it('centers horizontally only', () => {
render(
<Center axis="horizontal" data-testid="center">
<div>Horizontal Center</div>
</Center>,
);
const element = screen.getByTestId('center');
expect(screen.getByText('Horizontal Center')).toBeInTheDocument();
expect(element).toHaveStyle({
display: 'flex',
justifyContent: 'center',
});
expect(element).not.toHaveStyle({alignItems: 'center'});
});
it('centers vertically only', () => {
render(
<Center axis="vertical" data-testid="center">
<div>Vertical Center</div>
</Center>,
);
const element = screen.getByTestId('center');
expect(screen.getByText('Vertical Center')).toBeInTheDocument();
expect(element).toHaveStyle({
display: 'flex',
alignItems: 'center',
});
expect(element).not.toHaveStyle({justifyContent: 'center'});
});
it('applies height prop', () => {
render(
<Center height="100%" data-testid="center">
<div>Full Height</div>
</Center>,
);
const element = screen.getByTestId('center');
// Height is applied via StyleX dynamic styles
expect(element).toBeInTheDocument();
});
it('applies width prop', () => {
render(
<Center width={300} data-testid="center">
<div>Fixed Width</div>
</Center>,
);
const element = screen.getByTestId('center');
// Width is applied via StyleX dynamic styles
expect(element).toBeInTheDocument();
});
it('applies both width and height props', () => {
render(
<Center width="50%" height={200} data-testid="center">
<div>Sized Content</div>
</Center>,
);
const element = screen.getByTestId('center');
// Width and height are applied via StyleX dynamic styles
expect(element).toBeInTheDocument();
});
it('applies a class when padding is set', () => {
const {rerender} = render(
<Center data-testid="center">
<div>Content</div>
</Center>,
);
const baseline = screen.getByTestId('center').className;
rerender(
<Center padding={3} data-testid="center">
<div>Content</div>
</Center>,
);
const withPadding = screen.getByTestId('center').className;
expect(withPadding).not.toBe('');
expect(withPadding).not.toBe(baseline);
});
it('accepts paddingInline and paddingBlock without error', () => {
render(
<Center paddingInline={4} paddingBlock={2} data-testid="center">
<div>Content</div>
</Center>,
);
expect(screen.getByTestId('center')).toBeInTheDocument();
});
it('lets paddingInline/paddingBlock override padding on their axis', () => {
// padding sets both axes; paddingInline overrides the inline axis. The
// component should render without conflict and carry a class.
render(
<Center padding={2} paddingInline={5} data-testid="center">
<div>Content</div>
</Center>,
);
expect(screen.getByTestId('center').className).not.toBe('');
});
it('applies a class for explicit padding={0} (zero is a valid spacing step)', () => {
const {rerender} = render(
<Center data-testid="center">
<div>Content</div>
</Center>,
);
const baseline = screen.getByTestId('center').className;
rerender(
<Center padding={0} data-testid="center">
<div>Content</div>
</Center>,
);
expect(screen.getByTestId('center').className).not.toBe(baseline);
});
it('leaves the default className unchanged when no padding props are set', () => {
const {rerender} = render(
<Center data-testid="center">
<div>Content</div>
</Center>,
);
const baseline = screen.getByTestId('center').className;
// Opting in changes the className...
rerender(
<Center padding={3} data-testid="center">
<div>Content</div>
</Center>,
);
expect(screen.getByTestId('center').className).not.toBe(baseline);
// ...and dropping the prop restores the exact default output.
rerender(
<Center data-testid="center">
<div>Content</div>
</Center>,
);
expect(screen.getByTestId('center').className).toBe(baseline);
});
it('renders as inline-flex when isInline is true', () => {
render(
<Center isInline data-testid="center">
<div>Inline Content</div>
</Center>,
);
const element = screen.getByTestId('center');
expect(element).toHaveStyle({display: 'inline-flex'});
});
it('forwards ref correctly', () => {
const ref = vi.fn();
render(
<Center ref={ref}>
<div>Test</div>
</Center>,
);
expect(ref).toHaveBeenCalledWith(expect.any(HTMLDivElement));
});
it('applies xstyle prop', () => {
// Note: StyleX styles are transformed at build time, so we test that
// the component renders without error when xstyle is provided
render(
<Center data-testid="center" xstyle={undefined}>
<div>Styled Content</div>
</Center>,
);
expect(screen.getByTestId('center')).toBeInTheDocument();
});
it('passes through additional props', () => {
render(
<Center data-testid="center" aria-label="centered container">
<div>Content</div>
</Center>,
);
const element = screen.getByTestId('center');
expect(element).toHaveAttribute('aria-label', 'centered container');
});
it('does not let consumer data attributes override the reflected axis', () => {
const {container} = render(
<Center axis="horizontal" data-axis="vertical">
<div>Content</div>
</Center>,
);
expect(container.firstElementChild).toHaveAttribute(
'data-axis',
'horizontal',
);
});
it('renders on the server without a client boundary', () => {
const html = renderToString(
<Center axis="horizontal" paddingInlineStart={2}>
Centered content
</Center>,
);
expect(html).toContain('<div');
expect(html).toContain('astryx-center');
expect(html).toContain('data-axis="horizontal"');
expect(html).toContain('Centered content');
});
it('renders as div element', () => {
render(
<Center data-testid="center">
<div>Content</div>
</Center>,
);
const element = screen.getByTestId('center');
expect(element.tagName).toBe('DIV');
});
it('applies a class when paddingBlockStart is set on its own', () => {
const {rerender} = render(
<Center data-testid="center">
<div>Content</div>
</Center>,
);
const baseline = screen.getByTestId('center').className;
rerender(
<Center paddingBlockStart={2} data-testid="center">
<div>Content</div>
</Center>,
);
expect(screen.getByTestId('center').className).not.toBe(baseline);
});
it('lets paddingBlockStart/paddingBlockEnd override only their own edge', () => {
// padding={4} + paddingBlockStart={2} must equal spelling every edge out:
// both inline edges and the block-end edge stay at 4.
const {rerender} = render(
<Center padding={4} paddingBlockStart={2} data-testid="center">
<div>Content</div>
</Center>,
);
const perEdge = classSet(screen.getByTestId('center'));
rerender(
<Center
paddingInline={4}
paddingBlockStart={2}
paddingBlockEnd={4}
data-testid="center">
<div>Content</div>
</Center>,
);
expect(perEdge).toEqual(classSet(screen.getByTestId('center')));
});
it('gives paddingBlockEnd precedence over paddingBlock', () => {
const {rerender} = render(
<Center paddingBlock={6} paddingBlockEnd={0} data-testid="center">
<div>Content</div>
</Center>,
);
const overridden = classSet(screen.getByTestId('center'));
rerender(
<Center paddingBlockStart={6} paddingBlockEnd={0} data-testid="center">
<div>Content</div>
</Center>,
);
expect(overridden).toEqual(classSet(screen.getByTestId('center')));
});
it('leaves padding/paddingBlock output unchanged when no edge prop is set', () => {
const {rerender} = render(
<Center padding={3} data-testid="center">
<div>Content</div>
</Center>,
);
const uniform = classSet(screen.getByTestId('center'));
rerender(
<Center paddingInline={3} paddingBlock={3} data-testid="center">
<div>Content</div>
</Center>,
);
expect(uniform).toEqual(classSet(screen.getByTestId('center')));
});
it('applies a class when paddingInlineStart is set on its own', () => {
const {rerender} = render(
<Center data-testid="center">
<div>Content</div>
</Center>,
);
const baseline = screen.getByTestId('center').className;
rerender(
<Center paddingInlineStart={2} data-testid="center">
<div>Content</div>
</Center>,
);
expect(screen.getByTestId('center').className).not.toBe(baseline);
});
it('lets paddingInlineStart/paddingInlineEnd override only their own edge', () => {
const {rerender} = render(
<Center padding={4} paddingInlineStart={2} data-testid="center">
<div>Content</div>
</Center>,
);
const perEdge = classSet(screen.getByTestId('center'));
rerender(
<Center
paddingInlineStart={2}
paddingInlineEnd={4}
paddingBlock={4}
data-testid="center">
<div>Content</div>
</Center>,
);
expect(perEdge).toEqual(classSet(screen.getByTestId('center')));
});
it('gives paddingInlineEnd precedence over paddingInline', () => {
const {rerender} = render(
<Center paddingInline={6} paddingInlineEnd={0} data-testid="center">
<div>Content</div>
</Center>,
);
const overridden = classSet(screen.getByTestId('center'));
rerender(
<Center paddingInlineStart={6} paddingInlineEnd={0} data-testid="center">
<div>Content</div>
</Center>,
);
expect(overridden).toEqual(classSet(screen.getByTestId('center')));
});
it('resolves all four edges independently', () => {
// One prop per edge, each a different step: the four-edge spelling and the
// shorthand-plus-overrides spelling must agree.
const {rerender} = render(
<Center
paddingInlineStart={1}
paddingInlineEnd={2}
paddingBlockStart={3}
paddingBlockEnd={4}
data-testid="center">
<div>Content</div>
</Center>,
);
const explicit = classSet(screen.getByTestId('center'));
rerender(
<Center
padding={4}
paddingInlineStart={1}
paddingInlineEnd={2}
paddingBlockStart={3}
data-testid="center">
<div>Content</div>
</Center>,
);
expect(explicit).toEqual(classSet(screen.getByTestId('center')));
});
});