shadcn_ui

# Changelog

## 1.0.0 — unreleased

- Select `1.0.0` as the first public Hex release target and adopt Semantic
  Versioning for the stable component, stylesheet, fallback, and package
  contracts.
- Preserve the earlier `0.1.0` qualification records as historical evidence;
  the `1.0.0` archive, clean-consumer trial, CI, review, gallery identity, Hex
  publication, and public tag remain distinct release gates.

## Milestone F Phase 6 — unreleased

- Add deterministic release and health manifests with canonical identity,
  hashed local assets, complete static health targets, and secret rejection.
- Keep pull-request CI verification non-publishing, deploy the stateless
  controller-rendered gallery as an immutable Fly.io release, strengthen
  canonical smoke, and document image-identified rollback and recovery.
- Reconcile all 38 Milestone F requirements while keeping qualification blocked
  on exact-revision clean reproducibility, manual accessibility,
  deployed-source review, and final CI; SpecLed, Fly health, and canonical
  deployment smoke pass independently.

## Milestone F Phase 5 — unreleased

- Add committed-input candidate builds with output inventories and a disposable
  clean-checkout runner for the internal `0.1.0` archive.
- Add an isolated Phoenix consumer that installs the actual archive through a
  temporary signed Hex repository, compiles representative public HEEx, and
  serves the packaged stylesheet without a path dependency or consumer asset tooling.
- Record candidate qualification as blocked while mandatory manual, CI,
  integration, and SpecLed gates remain unresolved. No Hex publication, public
  tag, platform certification, marketplace listing, or upstream affiliation is claimed.

## Milestone F Phase 3 — unreleased

- Publish complete component/API, installation, capability/fallback, controller,
  Dstar, LiveView, upgrade, rollback, and provenance guidance for the internal
  `0.1.0` candidate.
- Keep gallery tooling, application transport, state, routes, runtime scripts,
  CI, deployment, and manual review outside the package API and release claims.
- Compile and render transport-shaped examples through the same public imports;
  no new component family or package JavaScript runtime is introduced.

## Milestone E Phase 6 — unreleased

- Complete the A–E catalogue audit, composition navigation/breadcrumbs and all
  Motion/Media publication smoke routes.
- Group all six public modules in ExDoc and add a compiled composition guide
  covering native semantics, bounded work, ownership, fallback and provenance.
- Add final cross-engine gallery and fixed 1/8/24-item budget acceptance,
  retaining explicit manual, CI, local runner and publication limitations.

## Milestone E Phase 5 — unreleased

- Add responsive Image Gallery with validated keyed media, native responsive
  hints, explicit alt intent, escaped/keyed trusted captions and real destinations.
- Compose existing native Dialog lightboxes with bounded contain images, complete
  captions, explicit close and inherited focus/dismissal; no slideshow state.
- Add the full local image-gallery composition, component reference, static
  export coverage and reviewed origin-effect deferral. No component runtime.

## Milestone E Phase 4 — unreleased

- Add named native Scroll Indicator with scoped, neutral-fallback decoration.
- Add structured Cover Flow over Carousel with gated image-only depth and flat fallbacks.
- Add both reference pages, real composition examples, provenance and three-engine evidence.

All notable changes to ShadcnUI will be documented in this file.

## Unreleased

- Add static-first Marquee with a native finite-preview checkbox, persistent
  stop/reset/replay and a safe inert decorative duplicate. Add keyed Stagger
  with visible defaults, explicit wrappers and a one-second entrance budget.
- Publish the Motion category, both complete references and a native motion-
  preferences composition, including no-script theme-preserving static export.

- Add native Carousel with a named scroll region, keyed ordered content, real
  fragment index, closed snap/alignment and focus-first oversized-card access.
  Deliver the Media reference and local media-browser composition immediately,
  with no component runtime, generated controls, clones or slide state.
- Keep gallery reference grids within narrow viewports and verify actual
  no-script static navigation through directory redirects and local images.

- Establish Milestone E capability evidence, shared internal media/motion
  contracts and scoped suppression without new public components or runtime.
  Add the capability gallery page, closed local media export and no-script
  theme/motion inspection, with three-engine foundation and static-export tests.

- Correct dark destructive-button contrast, wrap narrow Drawer headers to keep
  exits reachable, and exclude stale copied assets from the gallery export.

- Complete the Milestone D catalogue with seven dedicated overlay/supplemental
  references, a reviewed three-engine capability matrix, and four local-only
  compositions. Include canonical routes, complete ordinary alternatives,
  deterministic publication, public API guidance and release-boundary evidence.

- Add link-owned Hover Card with a constrained noninteractive HEEx preview,
  ordinary navigation fallbacks, and no interest events or client loading.

- Add CSS-first Tooltip with one text-labelled native trigger, a protected
  accessible description, and explicit supplemental-only fallbacks.

- Add Dropdown Actions with stable text-labelled native controls, optional
  groups/separators, native form attributes, and explicit non-menu ownership.

- Add native nonmodal Popover with protected invoker relationships, logical
  anchor placement, auto/manual modes, and bounded progressive fallbacks.

- Add a native modal Drawer with logical start/end/bottom presentation,
  protected commands and focus relationships, and an explicit ordinary-page fallback.

- Add native Dialog with declarative invocation, closed dismissal and focus
  policies, explicit fallback and exit regions, and browser-owned modality.
- Add consequential Alert Dialog with fixed close-request dismissal,
  least-destructive cancel focus, and a caller-owned native action region.

- Complete Milestone C with native Accordion, destination Navigation Menu,
  Header and Section Header compositions, Scroll Area, Separator, and honestly
  named Radio Panels with progressive CSS fallbacks and no package JavaScript.
- Add Disclosure, Navigation, and Content Surfaces gallery categories, seven
  component reference pages, and controller-rendered documentation, settings,
  and application-shell compositions to the deterministic static export.
- Add Milestone C semantic comparison guidance, pinned provenance mappings,
  browser fallback coverage, and independently distributable candidate evidence.

- Complete Milestone B with the closed Forms gallery, 15 focused component
  pages, sign-in/profile/settings compositions, a harmless native-submission
  fixture, static fallback evidence, provenance, and milestone acceptance.

- Initialize the independent Mix package and SpecLed workspace.
- Define Milestones A through F for the component library and online gallery.
- Establish the transport-neutral public import and release-file boundary.
- Pin and document the reviewed unscripted/ui source provenance and MIT notice.
- Add the native Button component with closed variants, sizes, slots, and
  presentation-only loading state.
- Add the passive Badge component with four closed semantic variants and no
  link, button, selection, or dismissal behavior.
- Add the Alert component with explicit announcement policy, composable icon
  and actions regions, and caller-owned lifecycle behavior.
- Add the Card component with deterministic composable regions and no inferred
  navigation, selection, data, or workflow behavior.
- Add the initials-first Avatar component with optional caller-owned imagery,
  closed sizes, and bounded stack presentation.
- Add the decorative Skeleton component with closed geometry, protected hidden
  semantics, and a static reduced-motion fallback.
- Add the separate controller-rendered Foundation gallery, closed catalogue,
  one reference page per component, local fingerprinted assets, and deterministic
  static export.
- Add GitHub Pages publication metadata, consumer and maintainer guidance,
  grouped ExDoc configuration, and the audited internal `0.1.0` release boundary.
- Add the shared Milestone B form normalization and deterministic accessibility
  contract plus Field, Label, Help, Field Errors, and Error Summary primitives.
- Add the native text-like Input component with closed types, native constraints,
  optional presentational regions, and caller-owned pending state.
- Add the native Textarea component with closed resize policies, escaped content,
  and capability-gated CSS content sizing over a stable native fallback.
- Add the native Checkbox component with explicit boolean sentinel and repeated-
  value modes, shared relationships, and caller-owned checked state.
- Add the native Radio Group component with validated stable option identity,
  fieldset semantics, scalar selection, and group or option disabled states.
- Add Switch as a track-and-thumb presentation of the native boolean Checkbox
  contract with an explicit accessible-label rule for hidden labels.
- Add Native Select with validated stable option and optgroup data, scalar and
  repeated-value modes, and the browser's visible classic picker as its floor.
- Add Enhanced Select as an opt-in standards-based presentation over the same
  native value, option, accessibility, fallback, and submission contract.
- Add Slider as a native range-input foundation with shared FormField
  relationships, resilient presentation, and no duplicated value state.
- Add distinct native Progress and Meter foundations with validated ranges,
  explicit accessible names, and caller-owned lifecycle semantics.