phoenix_live_calendar

# Changelog

## 0.3.0

### Added

- **Heatmap** (`PhoenixLiveCalendar.Heatmap`): turn a `%{date => value}` map into intensity `DayMarker`s — `:linear` or `:quantile` scale (min-rank ties), named palettes (`:success`/`:heat`/`:cool`/`:mono`) or a custom class list, `:fill` (cell tint) or `:dot` (corner dot) style, label/`show_label`/`id_prefix` options. Renders in month, year (mini-calendar tints + dots), week and day.
- **Widgets** (`PhoenixLiveCalendar.Widgets`): compressed dashboard components — `next_events/1` (graded when-labels incl. "Ongoing"), `week_strip/1`, `activity_grid/1` (GitHub-style N-week strip), `activity_month/1` (one-month activity calendar), `mini_timeline/1` (fitted, axis-less today strip).
- **Layers**: `Layer` struct + `Event.layer_id`, a legend of server-side toggle chips, `hidden_layers`/`on_layers_change` on the component, and Ecto store migration **V2** adding `layer_id` (rerun `Migrations.up/1`).
- **Theme color tokens**: 8 daisyUI semantic atoms (`:primary`, `:secondary`, `:accent`, `:info`, `:success`, `:warning`, `:error`, `:neutral`) plus a `config :phoenix_live_calendar, :color_tokens` map, resolved everywhere through one `Theme.event_colors/2` merge rule. Raw class strings keep working.
- **Timeline pass**: `date_mode: :clamp | :filter` (midnight clamping of cross-day bars), `fit_to_events` visible window, sticky resource column, now indicator, `show_time_axis`, and bar labels via `label_position: :fit | :inside | :outside | :none` with server-side fit estimation and collision-aware outside placement.
- **Week/day focused pass**: day markers (header chips, column tints, heat dots), greedy all-day lane packing, height-tiered event content (detail → inline → title → none, via server-side rem estimation), `min_event_height`, `event_content`, events clamped to their day column and the visible hour window, phone-ready grid columns.
- **Resource view parity**: shared per-day segment rule, plural `resource_ids`, all-day blocks rendered under timed bookings, `today`/`now`/`dir`/`event_content`/`min_event_height`.
- **Slot forwarding** through `CalendarComponent`: `:event`, `:day_cell`, `:time_label`, `:resource_label`, `:resource_header`, `:day_header`, `:no_events`, and `toolbar_start`/`toolbar_end`.
- `events_mode: :window` — the component trims events to the visible range before rendering (for hosts that pass one big list).
- `now` attr on week/day/N-day/resource/timeline (dependency-injectable now-line), `today: :none` sentinel (archive views render no today decorations while navigation still anchors on real today).
- `header_layout: :auto | :centered | :start`, and the toolbar auto-collapses when it has no content.
- Cross-midnight booking validation: a booking is split at midnight and every day-segment must fit that day's availability windows.
- Event helpers: `first_date/1`, `in_range?/3`, `dates_overlap?/2`, `on_resource?/2`, `day_window/4` (the shared per-day segment rule).

### Changed

- **Timeline defaults are behavior-changing** (the reason this is 0.3.0): bars are clamped/filtered to the visible day window by default instead of drawing raw time-of-day geometry for cross-midnight events, and resource labels clip instead of overflowing.
- Event DOM ids are scoped per view instance, so the same event rendered by two views on one page no longer collides.
- Mini-calendar event dots sit below the date pill and use the event's resolved color.
- RTL pass: geometry and decoration use logical properties (`inset-inline-start`, `border-s/e`, `rounded-s/e`, `ms/me`) throughout.

### Fixed

- `DayMarker` `color`/`text_color`/`class` are honored by the month grid (custom heatmap colors no longer silently dropped).
- Duplicate ticker DOM ids across the days of a multi-day marker, and `MarkerTicker` re-syncs after LiveView patches (rotation survives navigation; hover-resume is cancelled by an external pause and re-armed on interval changes).
- Slot sharing between a midnight-crossing event and an event starting on the crosser's last day no longer swallows bars.
- The calendar opens on the viewer's month: `internal_date` seeds from the `today` attr.
- A `slot_duration <= 0` no longer hangs the renderer in an infinite stream.
- `show_today_button: false` actually hides the button; the n-day view switcher round-trips; every documented view option is reachable through `CalendarComponent`.
- Layer visibility survives layer-list reloads (stale ids intersect at filter time; seeding happens once, on the first non-empty list).
- Header `:start` layout keeps its wing content; heatmap quantile ties stay in their bucket; week/agenda boundary events land on the right side of midnight; all-day `DateTime` events occupy the right days.

## 0.2.0

### Added

- `respect_hours` mode (month view): timed events cover only the hours they occupy — single-day events become inset bars sized to their duration; multi-day bars trim their boundary days to their start/end hours. Very short events keep a 1-hour minimum width so they stay visible. Opt-in (default off); all-day events and a custom `:event` slot are unaffected. Threaded through `CalendarComponent`.
- `Event.spans_multiple_dates?/1` and `Event.last_date/1` — the date-occupancy source of truth for bar rendering.

### Changed

- Month view renders any event spanning 2+ calendar dates as one continuous bar, including overnight timed events (e.g. 10pm→2am), instead of a chip per day.

### Fixed

- No stray stub on the day after a multi-day timed event ends (the last day is capped to the date the event actually ends on).
- Color-less events get a legible default background instead of an unreadable inherited one.
- Duplicate DOM ids when a single event renders across multiple day cells.

## 0.1.0

- Initial release
- Layer 0: Pure Elixir/HEEx calendar views (month, week, day, N-day, year, agenda, timeline, resource)
- Layer 1: Optional JS hooks (drag-to-select, drag-to-move, resize, responsive container, marker ticker)
- Layer 2: Optional PubSub integration for real-time updates
- Layer 3: Booking constraints (availability, slots, buffers, validation)
- Layer 4: Optional Ecto persistence layer
- Core data structures: Event, Resource, Availability, BookingConfig, DayMarker
- Accessibility-focused: ARIA grid roles + semantic labels (arrow-key grid navigation and focus restoration are on the roadmap)
- RTL support
- i18n via default English labels + an override translations map (supply your app's Gettext strings directly)
- Tailwind CSS / daisyUI compatible styling
- Responsive month view tuned for small screens (single-letter day headers, equal-width columns that never overflow). The other views are functional but less polished — the time-grid views are not yet optimised for phone widths