Instrument use

A React block (a whole screen) in Beamline's Construction app.

Shared instruments. The slot search reads as one sentence (how long, which instrument type, the dates and the working hours with the lab's time zone), each part opening what changes it; under it the window as a week: a row per instrument of that type with what it is doing now, a column per day's working hours, the bookings already made and maintenance (hatched) where they fall, and the slot found outlined among them. The slot found shows its time zone and that it isn't held; booking checks again, and when it was taken meanwhile the search stays and Find next carries on. The usage log keeps who used an instrument and who recorded it as two names, each use linked to the record it belongs to and its duration edited in place; Record a use opens its form.

Use it for

Finding and booking a free slot on one of several interchangeable machines or rooms.
Logging who used shared equipment, recorded by someone else, linked to the work it was for.

Not for

A calendar of every booking across instruments (the time-axis signature).
Desks or rooms booked by staff (desk-booking).

Anatomy

search: the sentence (hours, type, dates, working hours and zone as parts that each open a small editor), Find a slot
week: a row per instrument of the type (name, now: free, in use until, maintenance), a column per day with hour ticks, bookings with who, maintenance hatched, the found slot outlined, the key
header: the product's mark, Instruments; tabs Find a slot and Usage log
find: what happened; the slot with its zone, not held, Find next and Book
log: instrument filter; table of instrument, used by, recorded by, when, duration (edit in place), record; Record a use (opens its form)

States

find: not searched, looking, a slot, no more slots, booking, booked, taken meanwhile (search kept), refused
log: empty, filtered, editing a duration, edited (by whom, when), refused (unchanged), recorded
phone: fields stack, the table scrolls sideways
right to left: mirrors

Keyboard

Tab through the search fields, Find, Find next and Book; in the log, the filter, each row's edit and record link, and the new-use fields

Motion

None of its own.

Props

Prop	Type	Default	Description
`instruments` (required)	`Instrument[]`	—
`records` (required)	`UsageRecord[]`	—
`people` (required)	`string[]`	—
`user` (required)	`string`	—	Who's using the screen; they're "recorded by" on what they write down.
`timeZone` (required)	`string`	—	The lab's time zone; slots and uses are shown in it, with its name.
`sources`	`{ id: string; title: string; }[]`	—	Records a use can be linked to.
`onFind`	`((query: SlotQuery, after: number \| null) => Promise<SlotCandidate \| null>)`	—	The next free slot after `after` (epoch ms), or null when none is left in the window.
`onBook`	`((slot: SlotCandidate) => Promise<void>)`	—	Book a slot; it's checked again here. Reject with SlotTakenError when it went meanwhile.
`onRecord`	`((record: UsageRecord) => Promise<void>)`	—
`onEdit`	`((record: UsageRecord) => Promise<void>)`	—	Save an edited record (the same record, never a new one).
`onOpenSource`	`((id: string) => void)`	—
`defaultTab`	`"find" \| "log"`	—
`defaultQuery`	`Partial<SlotQuery>`	—
`defaultSearch`	`boolean`	—	Search at once with the default query.
`product`	`string`	—
`className`	`string`	—	Classes on the documented visual root; no override by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.
`now`	`InstrumentNow[]`	—	What each instrument is doing right now.
`bookings`	`InstrumentBooking[]`	—	Bookings already made in the search window, drawn on the week so a found slot is seen among them.

Built from

Dependencies

lucide-react

Import

import { InstrumentUse } from "@beamline/instrument-use";

Get it

Instrument use is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent

Instrument useComplete system · $49

Shared instruments.

A 4-hour confocal slot

The search reads as a sentence (each part opens what changes it); the week shows both confocals' bookings and the slot found among them, not held. The window is said in words; the slot found shows its time zone and that it isn't held. Booking checks again: the first slot was taken meanwhile, the search stays, and Find next carries on.

0 × 0full

Usage log

Record a use opens its form. Priya used Confocal A and Dana wrote it down: two names. Each use links to the record it belongs to; editing a duration changes that record, never adds one.