# Changelog

All notable changes to the MirAI Design System are documented in this file. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [2.0.0] — 2026-05-21

### Added
- **Design tokens** (`tokens/`) as the new single source of truth:
  - `tokens.json` — W3C Design Tokens Community Group format
  - `figma.tokens.json` — Tokens Studio for Figma format (multi-set)
  - `shadcn.css` — CSS variables in shadcn HSL convention
  - `tailwind.preset.js` — Tailwind theme preset
  - `style-dictionary.config.js` — multi-platform build config
- **Storybook 8** scaffold (`.storybook/`, `stories/`) with foundations and component documentation.
- **Repo hygiene**: `package.json`, `LICENSE`, `.gitignore`, this `CHANGELOG.md`.
- **Brand sheet** (`preview/brand-sheet.html`) — one-page brutalist identity overview, prints to A3.
- **Logo system page** (`preview/logo-system.html`) — exportable variants with download links.
- **Repo overview** landing page at root `index.html`.

### Changed
- **Logo system rebuilt.** The original `mirai-logo.svg` / `mirai-icon.svg` (and PNG / white-bg / squared variants) used off-spec values (`#1D1D1B`, `#556ED7`). They are **replaced** by four files in the canonical palette:
  - `assets/mirai-logo-light.svg` / `.png` (full wordmark, color)
  - `assets/mirai-logo-white.svg` / `.png` (full wordmark, monochrome)
  - `assets/mirai-icon-light.svg` / `.png` (apostrophe icon, MirAI Blue)
  - `assets/mirai-icon-white.svg` / `.png` (apostrophe icon, monochrome)
- Paths are now grouped by color via `<g fill="…">`, with `<title>` and ARIA labels for accessibility.
- `ui_kits/ask/*` re-pointed to `mirai-icon-light.svg`.

### Removed
- Legacy assets: `mirai-logo.{svg,png}`, `mirai-logo-white-bg.png`, `mirai-icon.{svg,png}`, `mirai-icon-white-bg.png`, `mirai-icon-squared.svg`.
- Legacy previews: `preview/logo-wordmark.html`, `preview/logo-icon.html` (superseded by `logo-system.html`).

### Migration

Anywhere you reference an old asset, swap as follows:

| Old | New |
|---|---|
| `mirai-logo.svg` | `mirai-logo-light.svg` |
| `mirai-logo.png` | `mirai-logo-light.png` |
| `mirai-icon.svg` | `mirai-icon-light.svg` |
| `mirai-icon.png` | `mirai-icon-light.png` |
| `mirai-icon-squared.svg` | `mirai-icon-light.svg` (squared was redundant; size with CSS) |
| `mirai-*-white-bg.png` | `mirai-*-light.png` on `#FFFFFF` (white background is implicit) |

For dark contexts, switch to the `-white` variant — do **not** apply `filter: brightness(0) invert(1)` to the color logo (it destroys the blue accent).

## [1.0.0] — 2026-04-18

### Added
- Initial release authored by Matteo Rizzo (MirAI).
- Tri-color palette spec, Space Grotesk type system, brutalist component primitives.
- Reference UI kit for the ASK platform under `ui_kits/ask/`.
- Design-system review cards under `preview/`.