Serial allocation

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

A receipt line's serial numbers. Serials generated from a first serial and how many (its digits counted up, padding kept; a first serial without digits said), or pasted one per line or separated by commas; kept and added to, or replacing, the serials the line holds, each choice saying what happens to them. The preview says what is new, kept and removed, in counts and serial by serial, and refuses a serial repeated in the list, already on the line or already on another receipt, with where. More serials than ordered, or units still without one, are said before saving; a save refused because a serial was taken meanwhile keeps the list.

Use it for

Giving serial numbers to a receipt or delivery line in bulk, from a delivery note's first number or a pasted list.
Anywhere a bulk change must show what it adds, keeps and removes before it is saved, and refuse duplicates with where they are.

Not for

Scanning serials one at a time at the dock (scan-station).
Counting stock (stock-count).

Anatomy

header: the product's mark, the title, the receipt, product and quantity ordered
source: Generate or Paste; first serial (an example as its placeholder) and how many, or the pasted list; keep and add, or replace (what each does shows in the preview's counts)
preview: after saving, the line's count of ordered as the figure (warning-toned when off); new, kept, removed and refused counts; the refused serials with why; each serial as kept, new or removed
foot: more than ordered or units without a serial, the refusal, saved, and Save with the count

States

generate: first serial without digits (said); nothing entered
paste: repeats in the list refused; serials on another receipt refused with where
add: kept and new; a serial already on the line refused
replace: kept, new and removed
count: matches the order; more than ordered (said, still savable); units without a serial (said)
save: nothing changed (disabled); saving; saved; refused with the reason (list kept)
phone: the source over the preview
right to left: the layout mirrors
reduced motion: through the tokens

Keyboard

Arrows within Generate and Paste and within the add or replace choice; Tab through the first serial, how many (arrows step) or the list, then Save

Motion

Nothing moves beyond the parts' own feedback. Nothing runs at rest.

Props

Prop	Type	Default	Description
`line` (required)	`SerialLine`	—
`defaultSerials` (required)	`string[]`	—	Serials on the line now.
`takenElsewhere`	`Record<string, string>`	—	Serials already on other lines or receipts, with where ("WH/IN/0219"); a serial there is refused.
`defaultSource`	`"generate" \| "paste"`	—
`defaultFirst`	`string`	—
`defaultCount`	`number \| null`	—
`defaultPasted`	`string`	—
`defaultMode`	`"add" \| "replace"`	—
`onSave`	`((serials: string[]) => Promise<unknown>)`	—	Save the line's serials; reject (a serial taken meanwhile) to keep the draft.
`product`	`string`	—	Your product's name, shown as its mark.
`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.

Built from

Import

import { SerialAllocation } from "@beamline/serial-allocation";

Get it

Serial allocation 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