Quick add

One line of typing becomes a draft event. parseQuickAdd("lunch with sam@acme.com tomorrow 1pm for 90 minutes", now) resolves the when, collects the attendees, and — the part that makes it feel magic rather than guessy — reports the exact source offsets of every phrase it consumed, so the input underlines what it understood as you type.

Using it

Double-click empty grid (or press C for a new event at the next hour) and type. The parser also powers the ⌘K palette's Quick add group. It's pure — no React, no DOM, not even an import — and exported for your own surfaces:

import { parseQuickAdd } from "@/components/kloq";

const r = parseQuickAdd("dinner @ Padella friday 7pm", new Date());
// r.title       → "dinner"
// r.start/r.end → Friday 19:00–19:30 (local time)
// r.location    → "Padella"
// r.confidence  → "full"
// r.tokens      → the claimed spans, sorted by source offset

now is a parameter on purpose — nothing inside calls new Date(), so every relative phrase resolves against the caller's clock and the whole thing is deterministic and testable. All arithmetic is local-time through the Date constructor's overflow, which is what keeps it correct across DST in every zone.

What it understands

Passes run in one fixed left-to-right claim table, and each may only claim source ranges no earlier pass took — how at 3pm beats the location rule, and how an email that happens to contain 3pm is never read as a time. A time that already passed today rolls to tomorrow — unless a day was named, in which case you said what you meant. What isn't recognised stays in the title, casing and punctuation intact.

A phrase can also be understood and overruled. An explicit range is authoritative: in design sync 3-4pm for 90 minutes the event runs 15:00–16:00, and for 90 minutes is neither applied nor left in the title — it is reported in ignored, so a field can show that it was read and set aside. The same goes for a second length (gym for 1h for 2h is one hour) and for a time or length beside all day.

The result

Options: dateOrder ("month-first" default; either way an unambiguous half wins) and defaultDurationMin (default 30, matching quick-create).

Building the preview UI

The view half is exported too. highlightSegments(input, result.tokens, result.ignored?) interleaves the input with its tokens — concatenating every segment's text reproduces the input exactly, the property the caret-aligned underline overlay depends on. Pass ignored and those runs come back flagged ignored: true, for a struck-through treatment. QUICK_ADD_KINDS holds each kind's label, swatch and mark classes — an underline style as well as a colour, because a theme may give two kinds the same colour — and QUICK_ADD_KIND_ORDER lists the kinds in legend order. quickAddPreview folds a result into one renderable line: the title (never blank — UNTITLED covers an all-metadata input), the resolved when, and chips for location and attendees.

And the finished field — underline, preview line, commit — ships assembled as QuickAddInput, with a live demo on its own page.