@remit/ui 0.0.113 → 0.0.115

package/src/components/selection-wizard.tsx

@@ -69,6 +69,7 @@ import {
 	scopeLabel,
 } from "./filter-rule.js";
 import type { ClauseEditState } from "./filter-rule-editor.js";
+import { FlowScreen, FlowStepRail } from "./flow-screen.js";
 import { type FolderTreeNode, FolderTreePicker } from "./folder-tree-picker.js";
 import { Input } from "./input.js";
 import { ProgressBar } from "./progress-bar.js";
@@ -91,21 +92,8 @@ export interface StepRailProps {
 }
 
 export function StepRail({ steps, step }: StepRailProps) {
-	const active = stepIndex(steps, step);
 	return (
-		<ol className="flex items-center gap-1.5" aria-label="Progress">
-			{steps.map((id, i) => (
-				<li key={id} className="flex flex-1 items-center gap-1.5">
-					<span
-						className={cn(
-							"h-1 flex-1 rounded-full transition-colors",
-							i <= active ? "bg-accent" : "bg-surface-sunken",
-						)}
-						aria-current={i === active ? "step" : undefined}
-					/>
-				</li>
-			))}
-		</ol>
+		<FlowStepRail count={steps.length} activeStep={stepIndex(steps, step)} />
 	);
 }
 
@@ -135,61 +123,22 @@ export function WizardScreen({
 	footer,
 	children,
 }: WizardScreenProps) {
-	const active = stepIndex(steps, step);
+	// A modal at every width: full-bleed below 768px it covers the list rather
+	// than sitting beside it, so the list behind must leave the accessibility
+	// tree with it — otherwise the verbs that opened the wizard are still
+	// reachable underneath the screen that replaced them.
 	return (
-		// A modal at every width: full-bleed below 768px it covers the list rather
-		// than sitting beside it, so the list behind must leave the accessibility
-		// tree with it — otherwise the verbs that opened the wizard are still
-		// reachable underneath the screen that replaced them.
-		<div
-			role="dialog"
-			aria-modal="true"
-			aria-label={title}
-			className="fixed inset-0 z-50 flex flex-col font-sans text-fg md:items-center md:justify-center md:bg-black/40 md:p-6"
+		<FlowScreen
+			title={title}
+			subtitle={subtitle}
+			steps={steps.map(stepLabel)}
+			activeStep={stepIndex(steps, step)}
+			onBack={onBack}
+			onExit={onExit}
+			footer={footer}
 		>
-			<div className="flex min-h-0 w-full flex-1 flex-col bg-canvas md:h-[45rem] md:max-h-[calc(100dvh-3rem)] md:w-[35rem] md:max-w-[calc(100vw-3rem)] md:flex-none md:overflow-hidden md:rounded-xl md:border md:border-line md:shadow-lg">
-				<header className="shrink-0 border-b border-line px-3 pb-2 pt-[calc(0.75rem+env(safe-area-inset-top,0px))] md:pt-3">
-					<div className="flex items-center gap-1">
-						<button
-							type="button"
-							onClick={onBack}
-							aria-label="Back"
-							className="flex size-11 items-center justify-center rounded-md text-fg-muted"
-						>
-							<ArrowLeft className="size-5" />
-						</button>
-						<div className="min-w-0 flex-1 text-center">
-							<h1 className="truncate text-sm font-semibold">{title}</h1>
-							{subtitle && (
-								<p className="truncate text-2xs text-fg-muted">{subtitle}</p>
-							)}
-						</div>
-						<button
-							type="button"
-							onClick={onExit}
-							aria-label="Cancel"
-							className="flex size-11 items-center justify-center rounded-md text-fg-muted"
-						>
-							<X className="size-5" />
-						</button>
-					</div>
-					<div className="space-y-1 px-1 pt-2">
-						<StepRail steps={steps} step={step} />
-						<p className="text-2xs text-fg-subtle">
-							Step {active + 1} of {steps.length} · {stepLabel(steps[active])}
-						</p>
-					</div>
-				</header>
-
-				<div className="min-h-0 flex-1 overflow-y-auto px-4 py-4">
-					{children}
-				</div>
-
-				<footer className="shrink-0 border-t border-line px-4 py-3 pb-[max(0.75rem,env(safe-area-inset-bottom))] md:pb-3">
-					{footer}
-				</footer>
-			</div>
-		</div>
+			{children}
+		</FlowScreen>
 	);
 }
 
@@ -354,7 +303,8 @@ export interface FooterNavProps {
 	onBack: () => void;
 	nextLabel: string;
 	onNext: () => void;
-	nextVariant?: "primary" | "danger";
+	/** `commit` reads as primary without the arrow: it ends the flow. */
+	nextVariant?: "primary" | "commit" | "danger";
 	/** What the step is still missing. Dims the control; never disables it. */
 	blockedReason?: string;
 	/** Continue was pressed while blocked, so the reason is on screen. */
@@ -397,7 +347,7 @@ export function FooterNav({
 					Back
 				</Button>
 				<Button
-					variant={nextVariant}
+					variant={nextVariant === "danger" ? "danger" : "primary"}
 					size="touch"
 					onClick={onNext}
 					aria-describedby={blockedReason ? reasonId : undefined}

package/src/index.ts

@@ -58,6 +58,14 @@ export {
 	AttachmentList,
 	type AttachmentListProps,
 } from "./components/attachment-list.js";
+export {
+	AttendeeList,
+	type AttendeeListProps,
+	AttendeeRow,
+	type AttendeeRowProps,
+	RsvpBadge,
+	type RsvpBadgeProps,
+} from "./components/attendee-row.js";
 export { AuthCard, type AuthCardProps } from "./components/auth-card.js";
 export {
 	AuthFooter,
@@ -112,6 +120,35 @@ export {
 	type ButtonLinkProps,
 	type ButtonProps,
 } from "./components/button.js";
+export {
+	CalendarEventChip,
+	type CalendarEventChipProps,
+} from "./components/calendar-event-chip.js";
+export {
+	CalendarList,
+	type CalendarListProps,
+} from "./components/calendar-list.js";
+export {
+	CalendarDateNav,
+	type CalendarDateNavProps,
+	CalendarViewSwitch,
+	type CalendarViewSwitchProps,
+	type SegmentOption,
+	segmentClassName,
+} from "./components/calendar-toolbar.js";
+export {
+	type CalendarAttendee,
+	type CalendarColorId,
+	type CalendarDescriptor,
+	type CalendarEventData,
+	type CalendarViewId,
+	calendarColorIds,
+	type EventDraft,
+	type EventSuggestion,
+	type RecurrenceScope,
+	type RsvpState,
+	type ZoneCertainty,
+} from "./components/calendar-types.js";
 export {
 	Card,
 	CardBody,
@@ -166,6 +203,12 @@ export {
 	ConfirmDialog,
 	type ConfirmDialogProps,
 } from "./components/confirm-dialog.js";
+export {
+	CustomRecurrenceDialog,
+	type CustomRecurrenceDialogProps,
+	CustomRecurrenceEditor,
+	type CustomRecurrenceEditorProps,
+} from "./components/custom-recurrence.js";
 export {
 	DangerZoneSection,
 	type DangerZoneSectionProps,
@@ -176,6 +219,36 @@ export {
 	type DialogBackdropProps,
 } from "./components/dialog-backdrop.js";
 export type { EmailFrameVariant } from "./components/email-frame-css.js";
+export {
+	EventDetail,
+	type EventDetailProps,
+} from "./components/event-detail.js";
+export {
+	EventCalendarField,
+	EventEditor,
+	type EventEditorLayout,
+	type EventEditorProps,
+	EventField,
+	type EventFieldProps,
+	EventGuestsField,
+	EventLocationField,
+	EventNotesField,
+	EventRepeatField,
+	EventTitleField,
+	EventWhenField,
+} from "./components/event-editor.js";
+export {
+	EventEditorPane,
+	type EventEditorPaneProps,
+} from "./components/event-editor-pane.js";
+export {
+	EventQuickEntry,
+	type EventQuickEntryProps,
+} from "./components/event-quick-entry.js";
+export {
+	EventSuggestionCard,
+	type EventSuggestionCardProps,
+} from "./components/event-suggestion-card.js";
 export {
 	FieldLabel,
 	type FieldLabelProps,
@@ -245,6 +318,12 @@ export {
 	type FilterSheetSource,
 	FilterToggle,
 } from "./components/filter-sheet.js";
+export {
+	FlowScreen,
+	type FlowScreenProps,
+	FlowStepRail,
+	type FlowStepRailProps,
+} from "./components/flow-screen.js";
 export {
 	FolderManageActions,
 	type FolderManageActionsProps,
@@ -400,7 +479,11 @@ export {
 export {
 	PopoverMenu,
 	type PopoverMenuItem,
+	PopoverMenuPanel,
+	type PopoverMenuPanelProps,
 	type PopoverMenuProps,
+	PopoverMenuRow,
+	type PopoverMenuRowProps,
 } from "./components/popover-menu.js";
 export {
 	ProgressBar,
@@ -448,6 +531,10 @@ export {
 	ReadingPaneEmpty,
 	type ReadingPaneEmptyProps,
 } from "./components/reading-pane-empty.js";
+export {
+	RecurrenceScopePrompt,
+	type RecurrenceScopePromptProps,
+} from "./components/recurrence-scope-prompt.js";
 export {
 	RefreshButton,
 	type RefreshButtonProps,
@@ -565,6 +652,8 @@ export {
 export {
 	FolderStepBody,
 	type FolderStepProps,
+	FooterNav,
+	type FooterNavProps,
 	MatchStepBody,
 	type MatchStepProps,
 	NameStepBody,
@@ -699,6 +788,10 @@ export {
 	setBriefCategoryInQuery,
 	toggleBriefFilterInQuery,
 } from "./lib/brief-filter-query.js";
+export {
+	type CalendarColorClasses,
+	calendarColorClasses,
+} from "./lib/calendar-color.js";
 export {
 	buildCidResolver,
 	type CidResolvableBodyPart,
@@ -731,6 +824,11 @@ export {
 	sanitizeInlineStyle,
 	sanitizeStyleElementCss,
 } from "./lib/email-sanitizer.js";
+export {
+	addMinutesToClock,
+	type PhraseParse,
+	parseEventPhrase,
+} from "./lib/event-phrase.js";
 export {
 	collapseFolderTree,
 	filterFolderTree,
@@ -787,6 +885,23 @@ export {
 	normalizeSubject,
 	sharedSubjectFragment,
 } from "./lib/property-prefill.js";
+export {
+	type CustomRecurrence,
+	dayOfMonthLabel,
+	defaultCustomRecurrence,
+	defaultEndDate,
+	endDateLabel,
+	formatCustomRecurrence,
+	type MonthlyMode,
+	NO_REPEAT,
+	ordinalWeekdayLabel,
+	type RecurrenceEnd,
+	type RecurrenceUnit,
+	readCustomRecurrence,
+	repeatChoices,
+	WEEKDAY_INITIALS,
+	weekdayName,
+} from "./lib/recurrence.js";
 export {
 	LIST_ROW_ATTRIBUTE,
 	LIST_ROW_SELECTOR,
@@ -835,6 +950,7 @@ export {
 	type UseLongPressResult,
 	useLongPress,
 } from "./lib/use-long-press.js";
+export { useMatchMedia } from "./lib/use-match-media.js";
 export {
 	MESSAGE_ROW_SELECTOR,
 	useRenderedRowIds,

package/src/lib/calendar-color.ts

@@ -0,0 +1,71 @@
+import type { CalendarColorId } from "../components/calendar-types.js";
+
+/**
+ * A calendar's hue is data, so the utility names cannot be built by
+ * interpolation — Tailwind only sees class strings it can read in source.
+ * Every calendar colour therefore names its utilities once, here, and every
+ * calendar surface reads them from this table.
+ */
+export interface CalendarColorClasses {
+	/** Solid fill: the swatch, the dot, the left rail of a chip. */
+	solid: string;
+	/** Tinted fill for the body of a chip or a day cell. */
+	soft: string;
+	/** Text and icons that sit on `soft`, or on a plain surface. */
+	text: string;
+	/** Hairline in the calendar's own hue. */
+	border: string;
+	/** Border on the leading edge only — the rail a timed chip carries. */
+	rail: string;
+}
+
+const table: Record<CalendarColorId, CalendarColorClasses> = {
+	"cal-1": {
+		solid: "bg-cal-1",
+		soft: "bg-cal-1-soft",
+		text: "text-cal-1",
+		border: "border-cal-1",
+		rail: "border-l-cal-1",
+	},
+	"cal-2": {
+		solid: "bg-cal-2",
+		soft: "bg-cal-2-soft",
+		text: "text-cal-2",
+		border: "border-cal-2",
+		rail: "border-l-cal-2",
+	},
+	"cal-3": {
+		solid: "bg-cal-3",
+		soft: "bg-cal-3-soft",
+		text: "text-cal-3",
+		border: "border-cal-3",
+		rail: "border-l-cal-3",
+	},
+	"cal-4": {
+		solid: "bg-cal-4",
+		soft: "bg-cal-4-soft",
+		text: "text-cal-4",
+		border: "border-cal-4",
+		rail: "border-l-cal-4",
+	},
+	"cal-5": {
+		solid: "bg-cal-5",
+		soft: "bg-cal-5-soft",
+		text: "text-cal-5",
+		border: "border-cal-5",
+		rail: "border-l-cal-5",
+	},
+	"cal-6": {
+		solid: "bg-cal-6",
+		soft: "bg-cal-6-soft",
+		text: "text-cal-6",
+		border: "border-cal-6",
+		rail: "border-l-cal-6",
+	},
+};
+
+export function calendarColorClasses(
+	color: CalendarColorId,
+): CalendarColorClasses {
+	return table[color];
+}

package/src/lib/event-phrase.test.ts

@@ -0,0 +1,89 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { addMinutesToClock, parseEventPhrase } from "./event-phrase.js";
+
+/** Wednesday 10 June 2026, 09:30 local — the fixtures' fixed "now". */
+const NOW = new Date(2026, 5, 10, 9, 30);
+
+describe("parseEventPhrase", () => {
+	it("reads a title, a guest, a weekday and a time", () => {
+		const parse = parseEventPhrase("lunch with Jane friday 1pm", NOW);
+		assert.equal(parse.title, "lunch");
+		assert.deepEqual(parse.attendees, ["Jane"]);
+		assert.equal(parse.date, "2026-06-12");
+		assert.equal(parse.startTime, "13:00");
+		assert.equal(parse.dateText, "friday");
+		assert.equal(parse.startTimeText, "1pm");
+	});
+
+	it("assumes an hour when no length is given, and says so", () => {
+		const parse = parseEventPhrase("standup tomorrow 9:30", NOW);
+		assert.equal(parse.date, "2026-06-11");
+		assert.equal(parse.startTime, "09:30");
+		assert.equal(parse.durationMinutes, 60);
+		assert.deepEqual(parse.assumptions, ["No length given — using an hour"]);
+	});
+
+	it("reads an explicit length instead of assuming one", () => {
+		const parse = parseEventPhrase("dentist next tuesday 15:00 for 45m", NOW);
+		assert.equal(parse.title, "dentist");
+		assert.equal(parse.date, "2026-06-23");
+		assert.equal(parse.durationMinutes, 45);
+		assert.deepEqual(parse.assumptions, []);
+	});
+
+	it("splits several guests", () => {
+		const parse = parseEventPhrase("coffee with Marcus and Dana thu 8am", NOW);
+		assert.equal(parse.title, "coffee");
+		assert.deepEqual(parse.attendees, ["Marcus", "Dana"]);
+		assert.equal(parse.date, "2026-06-11");
+		assert.equal(parse.startTime, "08:00");
+	});
+
+	it("reports a missing time rather than inventing one", () => {
+		const parse = parseEventPhrase("design review monday", NOW);
+		assert.equal(parse.startTime, "");
+		assert.deepEqual(parse.unresolved, ["No time given"]);
+	});
+
+	it("reports the day it fell back to", () => {
+		const parse = parseEventPhrase("call the plumber 3pm", NOW);
+		assert.equal(parse.date, "2026-06-10");
+		assert.deepEqual(parse.assumptions[0], "No day given — using today");
+	});
+
+	it("reads a named hour", () => {
+		const parse = parseEventPhrase("sandwich noon", NOW);
+		assert.equal(parse.startTime, "12:00");
+		assert.equal(parse.title, "sandwich");
+	});
+
+	it("has nothing to report on an empty phrase but the gaps", () => {
+		const parse = parseEventPhrase("", NOW);
+		assert.deepEqual(parse.unresolved, ["No title yet", "No time given"]);
+	});
+
+	it("keeps the same weekday when it is today", () => {
+		const parse = parseEventPhrase("retro wednesday 4pm", NOW);
+		assert.equal(parse.date, "2026-06-10");
+	});
+
+	it("reads hours as well as minutes", () => {
+		const parse = parseEventPhrase("workshop friday 10am 2h", NOW);
+		assert.equal(parse.durationMinutes, 120);
+	});
+});
+
+describe("addMinutesToClock", () => {
+	it("advances a clock", () => {
+		assert.equal(addMinutesToClock("13:00", 90), "14:30");
+	});
+
+	it("wraps past midnight", () => {
+		assert.equal(addMinutesToClock("23:30", 60), "00:30");
+	});
+
+	it("returns nothing for no clock", () => {
+		assert.equal(addMinutesToClock("", 60), "");
+	});
+});

package/src/lib/event-phrase.ts

@@ -0,0 +1,228 @@
+/**
+ * A deliberately small natural-language reader for the quick-entry field.
+ *
+ * It handles the phrasings a person actually types at a calendar — a title, a
+ * day, a time, a length, and who is coming — and it reports what it consumed
+ * for each one. The point is not coverage; it is that the machine's reading is
+ * on screen, attributed to the words it came from, before anything is
+ * committed. Whatever it could not settle comes back in `unresolved`, and
+ * whatever it filled in for you comes back in `assumptions`. Both are meant to
+ * be rendered, not swallowed.
+ */
+
+export interface PhraseParse {
+	/** What is left after the day, time, length and guests are taken out. */
+	title: string;
+	/** `YYYY-MM-DD`, empty when the phrase named no day. */
+	date: string;
+	/** The words the day was read from, e.g. "friday". */
+	dateText: string;
+	/** `HH:MM` on a 24-hour clock, empty when the phrase named no time. */
+	startTime: string;
+	startTimeText: string;
+	/** Minutes; 0 when the phrase named no length. */
+	durationMinutes: number;
+	durationText: string;
+	attendees: string[];
+	attendeesText: string;
+	/** Things the phrase never said, in the words the UI should show. */
+	unresolved: string[];
+	/** Defaults applied on the reader's own authority. */
+	assumptions: string[];
+}
+
+const WEEKDAYS: Record<string, number> = {
+	sun: 0,
+	sunday: 0,
+	mon: 1,
+	monday: 1,
+	tue: 2,
+	tues: 2,
+	tuesday: 2,
+	wed: 3,
+	weds: 3,
+	wednesday: 3,
+	thu: 4,
+	thur: 4,
+	thurs: 4,
+	thursday: 4,
+	fri: 5,
+	friday: 5,
+	sat: 6,
+	saturday: 6,
+};
+
+const WEEKDAY_ALTERNATION = Object.keys(WEEKDAYS)
+	.sort((a, b) => b.length - a.length)
+	.join("|");
+
+const DURATION_RE =
+	/\b(?:for\s+)?(\d+(?:[.,]\d+)?)\s*(hours|hour|hrs|hr|h|minutes|minute|mins|min|m)\b/i;
+const CLOCK_RE =
+	/\b(\d{1,2})(?:[:.](\d{2}))?\s*(am|pm)\b|\b(\d{1,2}):(\d{2})\b/i;
+const NOON_RE = /\b(noon|midday|midnight)\b/i;
+const RELATIVE_DAY_RE = /\b(today|tonight|tomorrow)\b/i;
+const NEXT_WEEKDAY_RE = new RegExp(
+	`\\bnext\\s+(${WEEKDAY_ALTERNATION})\\b`,
+	"i",
+);
+const WEEKDAY_RE = new RegExp(`\\b(?:on\\s+)?(${WEEKDAY_ALTERNATION})\\b`, "i");
+const WITH_RE = /\bwith\s+(.+)$/i;
+
+function pad(n: number): string {
+	return String(n).padStart(2, "0");
+}
+
+function isoDate(d: Date): string {
+	return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+
+function addDays(d: Date, days: number): Date {
+	const next = new Date(d);
+	next.setDate(next.getDate() + days);
+	return next;
+}
+
+/** The soonest day with this weekday, today included. */
+function comingWeekday(now: Date, weekday: number): Date {
+	return addDays(now, (weekday - now.getDay() + 7) % 7);
+}
+
+function minutesFrom(amount: number, unit: string): number {
+	const isHours = /^h/i.test(unit);
+	return Math.round(isHours ? amount * 60 : amount);
+}
+
+function cut(source: string, match: RegExpMatchArray): string {
+	const at = match.index ?? 0;
+	return `${source.slice(0, at)} ${source.slice(at + match[0].length)}`;
+}
+
+function tidy(text: string): string {
+	return text
+		.replace(/\s+/g, " ")
+		.replace(/^[\s,;–-]+|[\s,;–-]+$/g, "")
+		.replace(/\s+(on|at|with|for|from)$/i, "")
+		.trim();
+}
+
+function splitNames(clause: string): string[] {
+	return clause
+		.split(/\s*(?:,|\band\b|&)\s*/i)
+		.map((name) => tidy(name))
+		.filter((name) => name.length > 0);
+}
+
+function readClock(match: RegExpMatchArray): string {
+	if (match[3]) {
+		const meridiem = match[3].toLowerCase();
+		const hour12 = Number(match[1]) % 12;
+		const hour = meridiem === "pm" ? hour12 + 12 : hour12;
+		return `${pad(hour)}:${pad(Number(match[2] ?? 0))}`;
+	}
+	return `${pad(Number(match[4]))}:${pad(Number(match[5]))}`;
+}
+
+/**
+ * Reads `phrase` against `now`. `now` is a parameter rather than a call to the
+ * clock so the same phrase always gives the same answer in a story and a test.
+ */
+export function parseEventPhrase(phrase: string, now: Date): PhraseParse {
+	let rest = ` ${phrase} `;
+	const unresolved: string[] = [];
+	const assumptions: string[] = [];
+
+	let durationMinutes = 0;
+	let durationText = "";
+	const duration = rest.match(DURATION_RE);
+	if (duration) {
+		durationMinutes = minutesFrom(
+			Number(duration[1].replace(",", ".")),
+			duration[2],
+		);
+		durationText = duration[0].trim();
+		rest = cut(rest, duration);
+	}
+
+	let startTime = "";
+	let startTimeText = "";
+	const named = rest.match(NOON_RE);
+	const clock = rest.match(CLOCK_RE);
+	if (named) {
+		const word = named[1].toLowerCase();
+		startTime = word === "midnight" ? "00:00" : "12:00";
+		startTimeText = named[0].trim();
+		rest = cut(rest, named);
+	} else if (clock) {
+		startTime = readClock(clock);
+		startTimeText = clock[0].trim();
+		rest = cut(rest, clock);
+	}
+
+	let date = "";
+	let dateText = "";
+	const relative = rest.match(RELATIVE_DAY_RE);
+	const nextWeekday = rest.match(NEXT_WEEKDAY_RE);
+	const weekday = rest.match(WEEKDAY_RE);
+	if (relative) {
+		const word = relative[1].toLowerCase();
+		date = isoDate(word === "tomorrow" ? addDays(now, 1) : now);
+		dateText = relative[0].trim();
+		rest = cut(rest, relative);
+	} else if (nextWeekday) {
+		date = isoDate(
+			addDays(comingWeekday(now, WEEKDAYS[nextWeekday[1].toLowerCase()]), 7),
+		);
+		dateText = nextWeekday[0].trim();
+		rest = cut(rest, nextWeekday);
+	} else if (weekday) {
+		date = isoDate(comingWeekday(now, WEEKDAYS[weekday[1].toLowerCase()]));
+		dateText = weekday[0].trim();
+		rest = cut(rest, weekday);
+	}
+
+	let attendees: string[] = [];
+	let attendeesText = "";
+	const guests = tidy(rest).match(WITH_RE);
+	if (guests) {
+		attendees = splitNames(guests[1]);
+		attendeesText = guests[0].trim();
+		rest = tidy(rest).slice(0, guests.index ?? 0);
+	}
+
+	const title = tidy(rest);
+
+	if (title === "") unresolved.push("No title yet");
+	if (date === "") {
+		date = isoDate(now);
+		assumptions.push("No day given — using today");
+	}
+	if (startTime === "") {
+		unresolved.push("No time given");
+	} else if (durationMinutes === 0) {
+		durationMinutes = 60;
+		assumptions.push("No length given — using an hour");
+	}
+
+	return {
+		title,
+		date,
+		dateText,
+		startTime,
+		startTimeText,
+		durationMinutes,
+		durationText,
+		attendees,
+		attendeesText,
+		unresolved,
+		assumptions,
+	};
+}
+
+/** `13:00` + 90 → `14:30`. Empty in, empty out. */
+export function addMinutesToClock(clock: string, minutes: number): string {
+	if (clock === "") return "";
+	const [hours, mins] = clock.split(":").map(Number);
+	const total = (hours * 60 + mins + minutes) % 1440;
+	return `${pad(Math.floor(total / 60))}:${pad(total % 60)}`;
+}