# Matsuri-UI

## インストール方法

```command
yarn add matsuri-ui @emotion/react dayjs
```

## バグ報告、質問やエンハンスメントの提案

https://github.com/matsuri-tech/matsuri-ui/issues

## 機能を確認する

https://matsuri-ui.vercel.app

## FAQ

### master にマージされた機能をすぐに使いたい！

matsuri-ui では、デフォルトブランチにマージされた機能は即座に alpha リリースされます。
以下のようにして alpha 版をインストールしてください。

```command
yarn upgrade matsuri-ui@alpha
```

> ただし alpha 版は、デフォルトブランチだけでなくコントリビュータが任意のタイミングで publish することが許可されています。
> 壊れても仕方ないことを了承した上で利用してください。
> より安全に使うのであれば、ほしい機能が含まれたマージコミットのハッシュが付いている alpha バージョンを明示的にインストールしてください。

### 実験的な機能を利用したい！

実験的な機能は以下のようにして利用できます。

```tsx
import { TransferList } from "matsuri-ui/@experimental";
```

> ただし experimental な機能はメジャーバージョンを上げず、破壊的な変更が入る可能性があることを了承した上で利用してください。
> 面倒でなければ、参考実装として利用するのがベストです。

### 実験的な機能は何のためにあるんですか？

まだ具体的な用途や仕様が定まっていない、そのコンポーネントの利用が正しいか明らかでないが、実装が困難である場合に、参考実装または使用するために一時的に入れる場所として用意しています。

実際利用していく中で、具体的な用途や仕様がある程度定まり、複数のプロダクトで使用したいケースが発生した段階で、通常のコンポーネントに昇格します。
一方、不要または他のコンポーネントが適していると判断された場合は削除されます。