Changelog

# Changelog – library.circle.health

All notable changes to the Circle Content Library are documented here.
Each version uses an itemized record: **Added**, **Changed**, **Removed**.

---

## v1.0.0 — Initial Release

The first public release of the Circle Content Library at `library.circle.health`.

### Added

#### Pages

- **Components** — Catalog browser for core UI primitives, grouped by function
- **Blocks** — Pre-assembled flows and domain patterns built from core UI
- **I18n** — Shared locale dictionaries and copy packs
- **Utilities** — Utility reference page
- **Themes** — Theme browser with live previews
- **Showcase** — Featured compositions and usage examples
- **Get Started** — Onboarding guides for Components and Blocks

#### CMS (Registry Content System)

- **Registry Item Catalog** (`items.json`) — 98 indexed component entries with titles, descriptions, namespace assignments, and file mappings
- **Site Configuration** (`site.json`) — Namespace definitions, public paths, source policy, and base style/utils metadata
- **Styles Catalog** (`styles.json`) — Theme definitions with token overrides
- **Registry JSON API** (`/r/[name]`) — Serves cached registry payloads per item with cache headers for CLI consumption
- **Build Pipeline** — Automated scripts generating shadcn-compatible registry payloads from source

#### Core UI Components (30 primitives)

| Group | Items |
|-------|-------|
| Actions & Feedback | Alert, Badge, Button, Progress Bar, Spinner, Tag |
| Inputs & Forms | Checkbox, Switch, Date Picker, Dropdown, Form, Phone Input, Select With Input, TextArea, TextBox |
| Navigation & Disclosure | Back Button, Link, Sheet, Tabs, Text Link |
| Layout & Content | Card, Container, Empty, Flex, Spacer, Text, Text With Icon, Timeline |

#### Blocks (62 compositions)

| Group | Items |
|-------|-------|
| Flow Patterns | Floating Flow Actions, Flow, Flow Actions, Flow Button, Flow Head, Flow Options, Flow Progress, Top Bar |
| Commerce | Cart Line Item, Commerce, Discount Input, Input Discount, Pricing Table, Pricing Table Row, Product Card, Product Item, Quantity Adjustor |
| Media | Hero Gallery, Image Lightbox, Image With Lightbox, Lightbox, Media, Media Slide, Testimonials Carousel, Text Only Testimonial, Video |
| Booking | Booking Timeline, Booking Timeline Item, Booking Timeline Indicator, Booking Timeline Progress Dot, Booking Timeline Progress Separator, Booking Timeline Step, Booking Timeline Step Basics, Booking Timeline Step Content Notes, Booking Timeline Step Content Directions, Booking Timeline Step Content Todo List, Booking Timeline Todo Status Indicator |
| Address & Support | Address, Address Input, Auto Address Inputs, General, Map, Manual Address Inputs, Rating, Support |
| Compliance | Cookie Consent |
| Reporting Primitives | Metric Range Card, Metric Donut Card, Metric Split Card, Metric Stat Card, Text Columns Card |
| Patient Results | Patient Results Blocks (umbrella), Segment Muscle Analysis, Diagnostic Report Header, Diagnostic Report Footer, Diagnostic Report Intro, Diagnostic Report Page Shell, Patient Results Editor, Patient Results Report, Patient Results PDF, VO2 Max Report, VNS Report, Body Composition Report |

#### I18n Copy Packs

- Cookie Consent Copy — Shared locale dictionary for the cookie consent block

#### Themes

- **Berlin** — Default Circle product palette with warm sand surfaces and blue actions
- **Linen** — Brighter editorial variant with softer neutrals and a greener accent
- **Graphite** — Cooler, higher-contrast palette for dense internal tooling surfaces

#### Infrastructure

- shadcn CLI compatibility — All items installable via `npx shadcn@latest add`
- Namespace-based organization — `circle-ui`, `blocks`, `i18n`
- Berlin registry style — App-first Circle tokens and defaults
- Registry dependency graph — Items declare internal dependencies for automatic resolution
- Source policy — Primary (`circle-app`) and secondary (`legacy-design-system`) source references
- Storybook integration — Isolated component previews via Storybook 10