volume

A storage volume — local disk, external drive, network share, or cloud drive. Distinct from folder: volumes have capacity, filesystem type, and mount state.

Metadata	Value
Plural	`volumes`
Subtitle field	`path`

Fields

Field	Type
`path`	`string`
`totalBytes`	`integer`
`freeBytes`	`integer`
`usedBytes`	`integer`
`filesystem`	`string`
`volumeType`	`string`
`removable`	`boolean`
`readOnly`	`boolean`

Relations

Relation	Target
`contains`	`folder[]`

Prior art

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

POSIX / Single Unix Specification (mount) — Our path = mount point; filesystem ≈ fs type; readOnly ≈ ro mount option.
macOS DiskArbitration + diskutil — Practical source. Our totalBytes/freeBytes/usedBytes/removable/ volumeType match diskutil info output.
Linux /proc/mounts + statvfs — POSIX-family source. Our filesystem values (apfs, hfs+, ext4, ntfs) are standard /proc/mounts fs-types.