Feat/v0.3 icon button

[Mornieur]

Pull Request

Summary

Finalizes the FeitozaUI V1 by stabilizing package distribution, validating real consumer usage, expanding the initial component catalog, improving accessibility, and strengthening automated quality checks.

This PR also updates the documentation and visual baselines to reflect the current V1 state and fixes layout issues identified during the final visual review.

Key changes include:

• Fixed package distribution with styled-components v6.
• Fixed CommonJS output to use .cjs with "type": "module".
• Validated the packaged library through local tarball consumption in React + Vite and Next.js App Router applications.
• Expanded and documented the V1 component catalog, including Checkbox, Radio, and RadioGroup.
• Improved Button behavior by using type="button" by default.
• Improved Progress accessibility with a default accessible name.
• Documented component boundaries and responsibilities for Field, Box, Surface, Card, and Tabs.
• Fixed the Surface System preview to remain responsive and contained within its card.
• Added automated consumer, accessibility, and visual regression validation.
• Updated visual regression baselines after reviewing and approving intentional UI changes.
• Updated V1 documentation to reflect the current public API, architecture, usage, and component catalog.

Type

• Documentation
• Chore
• Fix
• Feature
• Refactor
• Test

Scope

• Package build and distribution
• ESM and CommonJS outputs
• Package exports
• React + Vite consumer validation
• Next.js App Router consumer validation
• V1 component catalog
• Button
• Checkbox
• Radio
• RadioGroup
• Progress
• Field
• Box
• Surface
• Card
• Tabs
• Design foundations documentation
• Surface System preview
• Storybook
• Accessibility testing
• Visual regression testing
• CI pipeline
• Documentation and README

Validation

• yarn.cmd type-check
• yarn.cmd lint
• yarn.cmd test --run
• yarn.cmd build

Additional validation:

• npm pack --dry-run
• Consumer validation with React + Vite
• Consumer validation with Next.js App Router
• Storybook production build
• Automated accessibility tests
• Visual regression tests
• Updated visual baselines were manually reviewed before approval

Checklist

• The change is scoped and reviewable.
• Documentation was updated when behavior or process changed.
• Public API changes are intentional and documented.
• Accessibility was considered when UI behavior changed.
• No secrets or generated artifacts were committed.

Notes

This PR represents the completion of the initial FeitozaUI V1 scope.

The focus of this release is not component quantity, but a stable foundation for a reusable React Design System with:

• typed and intentional public APIs;
• package distribution validated against real consumers;
• reusable design foundations and components;
• automated unit, accessibility, consumer, and visual regression testing;
• documented architectural and component decisions;
• CI validation for the main quality gates.

Further component expansion is intentionally outside the scope of this PR.