Stock moves

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

Where stock went, and moving it. The ledger lists movements newest first: moves on info, stock added on success, stock taken out on warning; each with its reason as named when it was made (and what it's called now, when renamed), who, when and its number; a move's two legs shown as out of one folder and into another, never counted as stock used; a folder the person can't see said without its name; a move with only one half recorded said. Filter by item or folder; for one item, what was added, taken out and moved between folders. Moving: one or several items, each from its own folder with how many of what's there (unknown said), to one destination with a reason and note; more than a folder holds, a move into its own folder and a destination stock can't go into each said where they are; sending carries a key formed with the draft, so a lost answer is said apart from a refusal and the same request sends again without moving twice; done lists each movement's number, which lands at the top of the ledger. Reasons: adding, taking out and moving, one default each that can't be hidden, built-in ones locked, custom ones up to 15 of 20 characters, renamed with past movements keeping their wording, deleted from a menu.

Use it for

Stock kept in folders, rooms, vans or bins, moved between them with a reason and audited after.
Where a transfer must never be counted as consumption and a lost answer must not move twice.

Not for

Changing one count with a reason (stock-adjust).
Counting a shelf (stock-count).

Anatomy

header: the tool's mark, Stock movements or Movement reasons, the view switch, Move stock
ledger: item and folder filters, the item's totals, movements with kind, reason, who, when, number, legs, note
move panel: lines with quantity of what's there, Add an item, Move to, Reason, Note, the outcome, Move
reasons: three groups, each reason with default, built-in lock, offered switch, menu; Add a reason

States

no movements, none matching, a renamed reason, a hidden folder, half a move
move: no lines, too many, same folder, locked destination, sending, refused, answer lost, done
reasons: default, hidden, built-in, renaming, too long, limit reached, refused
phone: the move panel first, one column
right to left: mirrored
reduced motion: through the tokens

Keyboard

Tab through the filters, the movements, the move panel's fields and the reasons' switches and menus

Motion

Nothing runs at rest.

Props

Prop	Type	Default	Description
`items` (required)	`StockItem[]`	—
`folders` (required)	`StockFolder[]`	—
`movements`	`Movement[]`	—
`defaultMovements`	`Movement[]`	—
`onMovementsChange`	`((movements: Movement[]) => void)`	—
`reasons`	`StockReason[]`	—
`defaultReasons`	`StockReason[]`	—
`onReasonsChange`	`((reasons: StockReason[]) => void)`	—
`onMove` (required)	`(request: MoveRequest) => Promise<MoveAnswer>`	—
`onSaveReason` (required)	`(reason: StockReason) => Promise<StockReason>`	—	Saves (or creates) a reason; reject with why not.
`onDeleteReason` (required)	`(id: string) => Promise<void>`	—	Deletes a custom reason; reject with why not.
`defaultDraft`	`MoveDraft \| null`	—	A move draft open at first (opened mid-way).
`defaultView`	`"ledger" \| "reasons"`	—
`product`	`string`	—
`className`	`string`	—	Classes on the documented visual root; no override by default.
`style`	`CSSProperties`	—	Inline styles on the documented visual root; no overrides by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.

Built from

Dependencies

lucide-react

Import

import { StockMoves } from "@beamline/stock-moves";

Get it

Stock moves 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

Stock movesComplete system · $49

Where stock went, and moving it.

Topping up a van

Priya is moving four filters and six tubes of sealant into Van 2. The ledger beside her shows each move as one movement: out of one folder and into another, never counted as stock used. The sealant used on 1 November reads Consumed, the reason's name at the time; it has been renamed since. A move of a filter out of a folder she can't see names that folder only as hidden.

0 × 0full

States

A move whose answer is lost: the same request can be sent again without moving twice. The reasons, each type with one default. A ledger with nothing in it yet.