# Changelog

Use this page to publish notable registry updates, new items, breaking changes, and migration notes.

---

## Current catalog

- **Components:** `accordion`, `alert`, `alert-dialog`, `aspect-ratio`, `avatar`, `badge`, `breadcrumb`, `button`, `button-group`, `calendar`, `card`, `carousel`, `chart`, `checkbox`, `code-block`, `collapsible`, `combobox`, `command`, `container`, `context-menu`, `data-table`, `datepicker`, `dialog`, `drawer`, `dropdown-menu`, `empty`, `field`, `heading`, `hover-card`, `icons`, `input`, `input-group`, `input-otp`, `item`, `kbd`, `label`, `link-spread`, `link-text`, `logos`, `menubar`, `native-select`, `navigation-menu`, `pagination`, `popover`, `progress`, `radio-group`, `range-calendar`, `resizable`, `scroll-area`, `select`, `separator`, `sheet`, `sidebar`, `skeleton`, `slider`, `sonner`, `spinner`, `switch`, `table`, `tabs`, `text`, `textarea`, `toggle`, `toggle-group`, `tooltip`, `trace`.
- **Blocks:** `hero`.
- **Utilities:** `dot-canvas`, `is-mobile`, `scroll-fade`, `shimmer`, `styles`, `use-highlighted-code`.

---

## October 24, 2026

### v0.11.1

- **Fix:** Gallery preview backgrounds use a solid theme background instead of a translucent fill.

- **Fix:** Component documentation previews show a theme-aware border matching the gallery previews.

- **Fix:** On This Page highlights the selected section when clicked and recognizes the final section when the page cannot scroll it up to the header.

---

## October 23, 2026

### v0.11.0

- **New:** `scroll-fade` and `shimmer` are installable utility class helpers backed by shadcn-svelte CSS, with usage docs, live previews, and Storybook examples for directions, sizing, customization, and disabled states.

- **Docs:** Component flow layout controls use Svelte orange for selection and keyboard focus.

- **New:** `trace` is installable with status lines and expandable details, plus a docs preview and Storybook examples.

- **Docs:** Utility hooks display the amber H badge in the sidebar, matching the React reference.

- **New:** `is-mobile` and `use-highlighted-code` are installable hooks listed under Utilities. Highlighting includes its Shiki helper, and Sidebar installs its mobile hook dependency.

- **Fix:** Docs pages load after relocating the mobile breakpoint hook to the registry; the app hook path now forwards to the shared source.

- **New:** `code-block` is installable with composable headers, copy controls, numbered lines, diff states, and styled tokens. Includes a docs preview and Storybook examples.

- **New:** `dot-canvas` is an installable decorative overlay with 12, 20, and 24 pixel grid spacing and a `class` override, matching the React reference.
- **Docs:** Component and block gallery cards and item detail previews now use the same radial-faded Dot Canvas background. Isolated gallery previews remain transparent to reveal the dots behind their content.

- **Docs:** Sidebar audience tags now match the React reference: blue DEV tags for developer docs, a violet MAINTAINERS tag for Registry authoring, and no tag on Introduction. Mark maintainer pages with `audience: maintainers` in their frontmatter.

---

## October 19, 2026

### v0.6.0

- **Fix:** Storybook previews use a shared typed decorator, and Slider stories render their authored controls without runtime errors. Validation now includes the Bun script types and a complete Shiki file-tree grammar.
- **Docs:** Introduction now opens at `/docs`; `/docs/index` redirects there. Sidebar sections open their indexes, keep their active state, and close the mobile navigation after a route change.
- **Docs:** Components and Blocks now offer searchable preview galleries, grid and list layouts, block categories, loading states, and empty-state reset controls. Previews follow the docs theme.
- **Docs:** The shell uses Geist typography, authored page descriptions, canonical links, page titles, and a page-actions menu with Markdown and assistant links.

---

## October 6, 2026

### v0.5.0

- **New:** [Component flows](/flows) traces what each registry item depends on, what uses it, and what it installs, in three layouts: a registry map, lineage lanes, and an install chain with each component's variants and props. Linked from the sidebar footer.

---

## September 27, 2026

### v0.4.2

- **Docs:** The homepage outline button now links to Storybook (`registryConfig.storybookUrl`) and shows the Storybook icon.
- **Update:** Sidebar section titles (Components, Blocks) now open the first item page instead of the section index, matching Docs.
- **Docs:** [Styles](/docs/styles) and [CLI](/docs/cli) now use the same package-manager dropdown as [Installation](/docs/installation) instead of separate npm/pnpm/yarn/bun code blocks.
- **Docs:** The item-layout tree on [Registry](/docs/registry) now uses the same green/blue token colors as the YAML `files:` examples.
- **Docs:** Item pages’ Manual install tab now shows a filename-header code block for each published file instead of a path-only list.

---

## September 20, 2026

### v0.4.1

- **Docs:** Install examples on [Installation](/docs/installation), [CLI](/docs/cli), and [Styles](/docs/styles) now use the published docs host `https://sveltedocs.canceydejean.dev` instead of the previous Vercel preview URL.
- **Docs:** The install command is now a single bar with a package-manager menu (npm, pnpm, yarn, bun, vp, deno) and a copy button, on [Installation](/docs/installation) and every item page.

---

## September 18, 2026

### v0.4.0

- **New:** Added `alert` (title, description, and corner-action composition), `logos` (a searchable brand/partner logo gallery, including a Svelte logo), `alert-dialog`, `aspect-ratio`, and `avatar` to the Components catalog.
- **Update:** `hero` is now configurable via props instead of hardcoded content: `announcement` (optional badge), `title`, `description`, `primaryCta`/`secondaryCta` (`{ label, href }`), and `images` (array of `{ src, alt? }`). All props default to the original copy and images, so existing usage is unaffected.
- **Update:** `registry/items/components/<name>/` is the source of truth for each component's `.svelte`/`.ts` files — not `src/lib/components/ui/<name>/`. Removed duplicate `src/lib/components/ui/` copies for `accordion`, `avatar`, `badge`, and `button`, repointed docs-site consumers at the `$registry` alias, and fixed each item's `_registry.svx` `files[].path`.
- **Fix:** `alert` and `logos` `_registry.svx` `files[].path` entries now use real on-disk paths so `registry:doctor` can find them. Removed a dead `LogoSvgProps` export in `logos` that pointed at a missing `logo-set/types.ts`.
- **Fix:** `alert-dialog` and `aspect-ratio` `files[].path` entries now use real on-disk paths. `alert-dialog` now declares `registryDependencies` instead of unrecognized `localRegistryDependencies`.

---

## August 9, 2026

### v0.3.0

- **New:** Finished registering and documenting the late component pass (installable JSON + Storybook + `_preview.svelte`): `field`, `hover-card`, `input-otp`, `item`, `kbd`, `menubar`, `native-select`, `navigation-menu`, `pagination`, `progress`, `radio-group`, `resizable`, `scroll-area`, `select`, `sheet`, `sidebar`, `skeleton`, `slider`, `sonner`, `switch`, `tabs`, `toggle`, `toggle-group`, `tooltip`, `trace`.
- **Update:** Composition wiring via `localRegistryDependencies` (e.g. `sidebar`, `toggle-group` → `toggle`).
- **Fix:** Docs SSR 500s caused by eager registry previews loading LayerChart. Vite `ssr.noExternal` now includes `layerchart` and `@layerstack/*`.

---

## August 8, 2026

### v0.2.0

- **New:** Large expansion of the installable component catalog, docs previews, and Storybook coverage across the full shadcn-svelte-style UI set.
- **New:** Layout and structure: `accordion`, `alert`, `alert-dialog`, `aspect-ratio`, `avatar`, `breadcrumb`, `button-group`, `card`, `container`, `empty`, `separator`, `table`.
- **New:** Forms and inputs: `checkbox`, `field`, `input`, `input-group`, `label`, `textarea`.
- **New:** Dates: `calendar`, `range-calendar`, `datepicker` (Popover + Calendar composition).
- **New:** Overlays and menus: `dialog`, `drawer`, `popover`, `dropdown-menu`, `context-menu`, `command`, `combobox` (Popover + Command composition).
- **New:** Feedback and motion: `collapsible`, `carousel`, `chart`, `spinner`.
- **New:** Data: `data-table` (TanStack Table v9 example built on `table`).
- **New:** Navigation and chrome: `hover-card`, `menubar`, `navigation-menu`, `pagination`, `sidebar`, `tabs`, `tooltip`.
- **New:** Forms and controls: `input-otp`, `native-select`, `radio-group`, `select`, `slider`, `switch`, `toggle`, `toggle-group`.
- **New:** Display and layout: `item`, `kbd`, `progress`, `scroll-area`, `sheet`, `skeleton`.
- **New:** Utilities: `resizable` (paneforge), `sonner` (toasts via `svelte-sonner` + `mode-watcher`).
- **New:** Storybook stories and docs previews (`_preview.svelte`) for registered items.
- **Update:** Relative imports between local registry items; list/button/toggle variants extracted to `*.variants.ts` where re-exported.
- **Update:** `localRegistryDependencies` for compositions (e.g. `sidebar` → sheet/tooltip/separator/input/skeleton/button; `toggle-group` → toggle).
- **Update:** Demo dependencies: `@tanstack/svelte-table`, `chrono-node`, `svelte-sonner`, `mode-watcher`, `paneforge` (where used).

---

## July 27, 2026

### v0.1.0

- **New:** Initial SvelteKit docs site and live shadcn-compatible registry.
- **New:** Published starter items: `button`, `heading`, `text`, `link-text`, `link-spread`, `hero-split`, and `styles`.
- **New:** Authoring scripts `registry:new` / `registry:doctor` and the `shadcn-registry` agent skill.