English | Tiếng Việt | 中文
Headless calendar and date/time components for building fully customizable scheduling and date selection experiences in Vanilla TypeScript, React, Vue, and Svelte.
- Independent domains — Calendar, Date, Time and DateTime, each usable on its own.
- Core — an internal shared kernel for date/time logic, bundled inside every adapter and never published on its own.
- Adapters — one package per framework, each with a root entry and one subpath per domain.
Chrono is UI infrastructure. It proposes changes such as a selected range or a moved event; it never persists, fetches, or applies business rules, and it ships no styles or themes.
Note Chrono is a focused, headless set of Calendar views and Date, Time and DateTime components. It ships no CSS and renders no styled markup, so you keep full control of the visuals. Release 0.8.0 adds recurring events as an opt-in pack (RFC 5545 rules, exceptions, overrides and this/following/all apply helpers), resource views and drag-to-edit. One availability model (opening hours, lunch breaks, holidays, lead time) shades the calendar and blocks the same times in every picker. The new
/dateentry adds date inputs and panels; the/timeentry adds time inputs and panels; the/datetimeentry composes them.Chrono is not a full UI library or design system, and it ships no popup, overlay, or positioning code. Put its panels inside your own popup when you need one.
| Package | Framework/Runtime | Documentation |
|---|---|---|
@zealakit/chrono-core |
Internal kernel (bundled, not on npm) | README |
@zealakit/chrono-vanilla |
Vanilla JS / TS — 0.8.0 — Calendar views and events | README |
@zealakit/chrono-react |
React 18 / 19 — 0.8.0 — Calendar views and events | README |
@zealakit/chrono-vue |
Vue 3.5+ — 0.8.0 — Calendar views and events | README |
@zealakit/chrono-svelte |
Svelte 5.20+ — 0.8.0 — Calendar views and events | README |
@zealakit/chrono-picker-vanilla |
Vanilla JS / TS — 0.8.0 — Date, time and date-time pickers (optional, needs Overlay) | README |
@zealakit/chrono-picker-react |
React 18 / 19 — 0.8.0 — Date, time and date-time pickers (optional, needs Overlay) | README |
@zealakit/chrono-picker-vue |
Vue 3.5+ — 0.8.0 — Date, time and date-time pickers (optional, needs Overlay) | README |
@zealakit/chrono-picker-svelte |
Svelte 5.20+ — 0.8.0 — Date, time and date-time pickers (optional, needs Overlay) | README |
Install one adapter for your framework and import from its root entry or from a domain subpath such as /calendar. Each adapter bundles @zealakit/chrono-core; you never install core directly. The API may change between minor versions until 1.0.
npm i @zealakit/chrono-vanilla
npm i @zealakit/chrono-react
npm i @zealakit/chrono-vue
npm i @zealakit/chrono-svelte
# or yarn, pnpm, ...- Calendar views — month, week, work week, day, agenda, multi-month and custom views, with navigation, headers, week numbers and keyboard support.
- Mini Calendar — a month calendar that syncs with the main one and marks days of your choice.
- Events — layout in every view (month lanes, time-grid columns, the all-day row and the agenda), "+N more" overflow, the now-indicator, keyboard focus on events and range creation.
- Editing — drag, drop and resize in the month view, the time grid and the all-day row; Chrono proposes the change and your app saves it.
- Resource views — the opt-in
resourceViewspack: resource time-grids and timelines, groups, collapse and zoom. - Recurring events — the opt-in
recurrencepack: an RFC 5545 subset, EXDATE/RDATE, overrides, scope-aware apply helpers and server-side expansion. - Date inputs and panels — segmented or text
DateInputandDateRangeInput,DatePanel,DateRangePanelandMultiDatePanel, range presets, hidden form values and keyboard support, with no popup of their own. - Time inputs and panels — segmented or text
TimeInputandTimeRangeInput, columns or slot-listTimePanelandTimeRangePanel, 12/24-hour, minute steps, overnight ranges and hidden form values, with no date and no popup. - Date-time inputs and panels —
DateTimeInputandDateTimeRangeInput,DateTimePanelandDateTimeRangePanelthat compose the Date and Time parts, with time zones, daylight-saving handling,disablePastand one commit rule. - Availability — one
open/blockedrule model with per-resource rules, time zones, lead time, cutoffs and booking windows, shared by calendar backgrounds, selection blocking and every picker.
Not yet: recurrence editing UI, natural-language recurrence descriptions, moving events between resources and the treegrid keyboard model. They arrive in later releases.
The examples/ folder holds integration projects for Vanilla, React, Vue, Svelte, and Next.js: an Outlook-like shell with plain CSS. They import the compiled workspace packages, so build first.
pnpm install
pnpm build
pnpm dev:vanilla # or dev:react, dev:vue, dev:svelte, dev:nextjsThe *-overlay examples (dev:react-overlay, dev:vue-overlay, dev:svelte-overlay, dev:vanilla-overlay) show the ready-made date, time and date-time pickers from @zealakit/chrono-picker-<fw>. They install Overlay themselves; it is never a dependency of Chrono's own packages.
Public API (from 1.0) is every export of an adapter entry, component props and events, the documented data-* attributes and ARIA roles, every --chrono-* custom property, the documented keyboard behavior and the value types. Breaking changes only ship in major versions, and renaming or removing a data-* attribute or custom property counts as breaking. A deprecation is announced in a minor with a development warning and a README note, and removed in the next major at the earliest. Core internals, src/shared/, the file layout inside dist and the exact text of development warnings are not public.
Supported environments: the last two versions of Chrome, Edge, Firefox and Safari, plus current iOS Safari and Android Chrome. React 18 and 19, Vue 3.5 and later, Svelte 5.
Add the integration skill for your framework to your agent's skills directory:
- Chrono React — Components, controlled state, styling hooks and Server Components.
- Chrono Vue — Components, v-model state and Nuxt notes.
- Chrono Svelte — Components, snippets, bound state and SvelteKit notes.
- Chrono Vanilla — Controllers, delegated listeners and lifecycle.
MIT © Zealakit
