preview_placement
Read-onlyIdempotent
Validate proposed footprint placements against board constraints and design rules, returning a deterministic legality check without applying changes.
Instructions
Validate a proposed footprint placement against a board, without changing anything.
``request`` takes ``board``, ``constraints``, and ``subjects`` (the footprint references
the proposal may move), plus optional ``rules``, ``proposals`` and ``placement_grid_nm``.
Rules come in seven kinds - proximity, alignment, symmetry, edge, region, orientation and
side - and name objects only by the references a scene already returned. Proposals are
anchored the same way: an offset from another object's edge or centre, never an absolute
coordinate. Positions in the response are derived here and snapped to the placement grid.
A ``previewed`` result carries an immutable candidate whose legality was proven
deterministically. Note that ``pad_overlap`` is three-valued: ``inconclusive`` means
neither clearance nor collision could be proven, and is not a failure. Courtyard overlap is
reported as ``not_modelled`` and is genuinely not checked. This tool never applies a
placement, and a placement is not bound to KiCad DRC evidence in this version.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| request | Yes | ||
| candidate | Yes | ||
| board_path | Yes | ||
| diagnostic | Yes | ||
| board_revision | Yes | ||
| snapshot_digest | Yes | ||
| placement_version | Yes | ||
| conversion_diagnostic_counts | Yes |