bed-layout

# bed-layout

Visual canvas-based grid editor for assigning crops to garden bed cells. Companion relationships are shown live as you edit.

## When to Use

- Arranging crops in a specific bed on a visual grid
- Checking which cells have which crops assigned
- Detecting enemy crop adjacency (shown with red borders)
- Saving or updating the layout JSON for a bed

## Layout JSON Format

Each bed stores its layout as JSON in the `layout_json` column:

```json
{
  "cell_size_ft": 1,
  "cells": {
    "0,0": "crop-uuid-here",
    "0,1": "crop-uuid-here",
    "1,0": "another-crop-uuid"
  }
}
```

Keys are `"row,col"` strings. Values are crop UUIDs. Empty cells are absent from the `cells` map.

## API Usage

### Save a layout

```
PATCH /api/beds/:id/layout
Content-Type: application/json

{
  "cell_size_ft": 1,
  "cells": {
    "0,0": "uuid-tomato",
    "0,1": "uuid-basil"
  }
}
```

Returns 200 with the updated bed record, or 400 if the layout JSON is invalid.

### Get a bed with its layout

```
GET /api/beds/:id
```

Returns the bed with `layout_json` parsed as an object.

## Grid Dimensions

The grid size is computed from the bed dimensions:

```
cols = ceil(width_ft / cell_size_ft)
rows = ceil(length_ft / cell_size_ft)
```

A 4x12 ft bed with `cell_size_ft: 1` produces a 4-column, 12-row grid (48 cells total).

## Companion Warnings

The editor computes adjacency warnings client-side:

1. For each assigned cell, check its 4 neighbors (up, down, left, right).
2. If the neighbor has a different crop and the two crops have an `enemy` relationship, render a red dashed border on the shared edge.
3. Friend relationships show a subtle green tint on adjacent cells.

The companion data is fetched from `GET /api/crops/:id/companions` for each unique crop in the layout.

## Keyboard Shortcuts (in the canvas editor)

| Key | Action |
|---|---|
| Arrow keys | Move selection cursor |
| Space | Assign selected crop to current cell |
| Delete / Backspace | Clear current cell |
| E | Switch to Erase tool |
| 1-9 | Select crop at position N in palette |

## Notes

- The layout auto-saves every 500ms after a change (debounced). A "Saved" indicator appears in the toolbar.
- Undo/redo is not implemented. The last saved state can be restored by refreshing.
- The cell size can be changed (0.5 ft, 1 ft, 2 ft) but this resets the cell assignments for that bed.