# `@inspect` Variables
Mark a top-level `const` with an `@inspect` JSDoc tag and the editor's right sidebar grows a control for it, at the stage level, below the background picker. Moving the control moves the composition **live** — the variable is compiled into a signal on the editor's reactive graph, so nothing remounts — and the value it settles on is written back into the initializer, the same way a dragged rect lands in the file.
```tsx
/** @inspect number min=0 max=100 step=1 */
const padding = 24;
/** @inspect font path="Typography/Font" */
const fontFamily = "Inter";
/** @inspect color path="Typography/Color" */
const textColor = "#ff3366";
/** @inspect text */
const title = "Hello world";
export default function Project() {
return (
{title}
);
}
```
## The annotation
```
@inspect [min=…] [max=…] [step=…] [options="a,b,c"] [path="Group/Label"] [label="Label"]
```
| Type | Control | Initializer |
| ---- | ------- | ----------- |
| `number` | Slider when `min` and `max` are both given, a draggable number field otherwise | a number literal |
| `color` | Color picker | a string literal (`"#ff3366"`) |
| `text` | Text area | a string literal |
| `font` | Font picker (web + system fonts) | a string literal naming the family |
| `boolean` | Toggle | `true` or `false` |
| `select` | Dropdown over `options="a,b,c"` (required, at least two) | a string literal that is one of the options |
`min`, `max` and `step` only apply to `number`; `options` only to `select`.
```tsx
/** @inspect boolean */
const showFrame = true;
/** @inspect select options="left,center,right" */
const align = "center";
```
**Identity is the file and the variable name** — nothing else. Renaming the variable renames the control's identity; no id is minted, and nothing extra is written into your source.
**Presentation derives from the name.** The label is the variable's own name prettified (`fontFamily` → "Font Family"), and the control sits ungrouped under a "Variables" section. `path="Typography/Font"` overrides both: the last segment is the label, the segments before it the group the control is filed under. `label="Font"` names the control without grouping it. Deeper paths (`"Theme/Colors/Primary"`) flatten into one section title ("Theme / Colors").
## Rules
- **Top-level `const` only**, one declaration per annotation, initialized with a plain literal matching the type — the literal is what the editor overwrites.
- **Not exportable.** References are rewritten per file, so an importer would receive the accessor where it expects the value. Declare the variable in the file that uses it.
- **Module-level derivation is computed once.** `const doubled = padding * 2` at the top level does not follow the slider — like any module-level expression, it runs once at evaluate. Reads inside JSX props and component bodies are reactive; derive inside the component (or a memo) when the derivation should be live.
- **An initializer you rewrite into an expression is yours again.** The write-back only touches a declaration that still carries the annotation and still holds a literal; anything else is skipped, like a prop bound to an expression.
## How it behaves
- Changes are debounced into the same write pipeline as canvas edits, land in the undo history (slider bursts coalesce into one step), and never trigger a recompile or remount — the file catches up with the canvas, not the other way round.
- A hand edit to the file reloads the project as always; the controls rebuild from the new source.
- Export and capture recompile from source, so the values the inspector settled on are the values a render uses.