# Desk illustrations

These components are controlled React illustrations. Their gallery previews use direct controls, without video players or scene props.

## Reuse and composition

- `Hand` is static artwork with seven poses: `open`, `point`, `pinch`, `grip`, `type`, `hold`, and `write`. `Mano` adds placement and rotation; neither owns a folder, a pen, or a timeline.
- `Pluma` draws a pen held in the Hand, in `pinch` (its default grip) or `write` (a tripod grip drawn for a pen), and exports `plumaNib`, the nib point for the same props, so writing (a `PaperLine` reveal, a thread's start) follows the pen, and `plumaGrip`, where the grip sits in the Hand's box.
- `Cajon` is the drawer; its folders are the shared `FolderOutline`, not a separate folder drawing. `FileCabinet` supplies its enclosure. `Escritorio` is an empty desk with an optional `FileCabinet`.
- `Bandeja` is a paper tray. `ToolCaddy` is an empty divided organizer. Neither adds a loading/cost line or labels unrelated to the object.
- `Burbuja` composes `ChatBubble` and `TextFill`. Selected word indices receive a controlled highlight; ordinary HTML handles wrapping. It has no folder or connector.

## Top-down desk

`Escritorio` is a front elevation. `DeskTop` is the same desk seen from above: an empty cream surface that sheets, axes, and props lie on. Its `box` is fixed; `edge` (0–1) is a camera tilt that reveals the front edge band inside that box, and `drawer` pulls an open drawer out on one edge: a box narrower than the desk, meeting the desk top at one seam line, its outer wall thicker and carrying the same ink bar pull as `Cajon`, its opening darker and empty until a consumer composes `Cajon` or folders there. Tilt shows the desk's front edge and a side drawer's own near face. `light` is the visual language's depth-as-light rule kept on the palette: every fill mixes in OKLab toward the line token, reaching it at 0.72, then toward ink (`deskLight`); the ink never changes.

`Ejes` are two ink axes, independent of the desk. `h` and `v` draw each axis on its own; labels name the half-planes (top and bottom flank the horizontal axis at its left end, left and right flank the vertical axis at its top end) and arrive as their axis reaches them. `quiet` shrinks them in place. `focus` calls out one or more quadrants with an ink outline or a light fill; focus outlines keep clear of the labels and are one size, hugging the crossing and mirrored about both axes. `center` moves the crossing, but only as far as the labels allow (`ejesLayout(...).range`). `focusTone="accent"` is the only vermilion, on the first focused quadrant only, and is opt-in, for the one beat whose script names it (the answer quadrant in *pregunta*). `ejesLayout` returns the quadrant boxes for placing a sheet under each reader.

`DeskProp` is a free-standing keycap, keyboard, or mug drawn from above, or the same mug standing upright from the side (`mug-side`), placed by its centre with `scale` and `rotate`. The keyboard is a compact board about 3:1, with letter rows of 14, 13, and 12 keys offset by tab, caps, and shift and a modifier row around the space bar, so it never reads as a keypad; the side-view mug has one C-shaped handle whose ends tuck under the body. It owns no hand: `deskPropLayout(...).contact` is where a fingertip or grip lands (the home-row key nearest the middle, the top-down handle, or the side-view mug's free side, with `rim` where a thumb crosses the top), so `Mano` composes on top. `press` sinks the keycap or the listed keyboard keys: the face insets and takes an ink wash deep enough to read at small sizes. The ink stroke stays `weight` units (default the shared outline, 3) at any scale; a preview that frames each prop in its own viewBox passes a weight that keeps the on-screen line constant.

## Physical geometry

Folder count never changes the desk or drawer dimensions. Folder index zero is at the front. In an open `Cajon` each folder further back sits one `depthSpacing` higher and slightly narrower (the inset follows how far back it sits: its rise over the rise of eight folders, up to a fifth of the width at the back wall, whatever the label size; never larger), so the folders fan as a stair. The drawer front carries a small label holder near its top edge and a separate pull under it, flat rectangles at the shared outline. The side walls narrow toward the back (one-point perspective: the front is nearest the viewer), and the front is as tall as the folders it hides, so a closed drawer holds complete folders. Drawers wider than 420 units scale their walls, travel, rise, label holder, and pull with the width. The front folder is `Folder`'s body at `folderScaleForDrawer(w)`, so a loose folder at that scale is the same object. The default spacing is the tab height plus a band of back panel and a lip of the front flap: up to six folders, every tab name and the band under it (which carries the optional `sublabel`) stay visible. More folders share the rise of six, so a crowded drawer packs tighter instead of growing; names stay whole at twelve, and a sublabel whose band the folder in front would cover is not printed (`folders[i].sublabel.visible`). The inside of an open drawer is flat drawer shades, a back wall, the floor, and lighter side walls, so an empty drawer reads as an empty box. A `FileCabinet` keeps its drawer packed under the enclosure top (48 units of rise, tabs staggered with `tabLayout: "stagger3"`), unless the caller passes its own spacing.

Depth reads as light. Each folder's `k` defaults to a ramp from 1 at the front to 0.72 at the back (`backLight`), and `drawerLight(k)` turns it into a fill mixed in OKLab from the card, cream, and ink tokens only. Lifting a folder (`pulled`) brings it to full light. Vermilion appears only on a folder marked `accent`.

Tab names are set in Geist 800 (sublabels in Geist italic): the tab widens to fit the name (`sansWidth` from the tokens), up to the folder width; a name that still does not fit squeezes at most to 0.94 and otherwise ends in an ellipsis, so no name is visibly condensed. A sublabel prints only when nothing in front covers any of it, so a half-open or crowded drawer never shows fragments; a closed front flap's top edge draws side to side (like `Folder`'s front panel) only where a tab height or more of flap shows under it clear of everything in front, so a fan at rest shows no seams and a lifted folder gains its edge (`folders[i].flapEdge`), and a lifted folder stops with its bottom just behind the front's rim. `reveal` inks the name in grapheme by grapheme from its first letter. `cajonLayout(props).anchors(i, n)` spreads `n` thread endpoints along the tab midline for connectors, starting just before the name so a knot never covers its first letter; a tab inside the closed drawer keeps its endpoints at the drawer's rim, and `folders[i].visible` says how much of the tab shows. A folder's `open` stands its front flap ajar: the folder rises (by the flap's drop plus a lip, never far enough to cover the tab behind it) so the shaded opening shows above whatever is in front of it, the flap's top edge drops straight down, never wider than the folder, and its bottom corners stay fixed.

Every folder has a complete body, including the portion hidden behind the drawer front. Pulling translates that entire body without changing its width or height. Front surfaces occlude the stored body; lifting exposes it progressively.

Desk finish, cabinet visibility, and cabinet side are independent properties. The desk surface remains empty. Consumers can compose other objects explicitly.

The closed cabinet sits between the inner leg edges, below the apron, and on the same floor line as the desk. Its enclosure stays behind the desk frame; only the drawer moves toward the viewer. Changing the drawer opening never moves the enclosure or changes its dimensions.

The open palm keeps its four fingers together with a relaxed thumb. Poses change the silhouette; placement and rotation remain separate transforms.

`grip`, `type`, and `hold` trace generated references (Paper, page *hands*) in the open palm's construction: the same box, transform, outline weight, wrist cut, and 6.4-wide fingers with round tips, with no nails or detail lines beyond finger separations and hold's thumb crease. `grip` is a front-view fist, four fingers with knuckle bumps on top and the curled fingertips in a row beneath, the thumb lying across under them, pointing in; lay the knuckles over a sheet or tab edge. `type` is the hand from above on a keyboard with the fingers curled down onto the keys: four short stubs, the middle tallest, whose caps are the bent middle joints with the tips out of sight beneath, with no marks across them, and the thumb low, pointing left toward the space bar; place it upright with the fingertips on the keys. At thumbnail size it must never read as `open`: short folded fingers against tall straight ones. `hold` is upright, seen from the side: the palm rises straight from the wrist and its top sweeps up into the thumb, a finger-width digit (no longer than a finger) that bends at a rounded joint and lies over the held object's rim, tip toward the fingers, with a short crease carrying its underside into the palm; the four fingers lie stacked on the right, wrapped round the object's side with their tips facing the palm; the open pocket between palm, thumb, fingertips, and heel is the object's place. Draw the object behind the hand, its body in the pocket and its rim or top edge just under the thumb: a side-view mug (DeskProp `mug-side`) or a sheet's corner both read. Each of the three draws its ink as one path: the closed outline, with every interior line (dividers, fingertip row, grip's thumb fold, hold's thumb crease and little fingertip) retraced from it as a spur, so joins are tangent and show no steps; the valleys between fingertips and grip's palm edge between index and thumb round off in small fillets, and the palm side blends into the wrist cut with one fillet. The deliberate corners are the wrist cut, type's thumb web, hold's thumb web (where the pocket edge ends on the thumb's underside), and hold's heel meeting the little finger. Every pose keeps the wrist at the bottom of the 30×29 box and the same outline weight.

`write` (#177) traces an owner-approved Quiver Arrow reference (Paper, page *hands*, artboard *Hands v7 · write (Quiver Arrow)*; `tools/blender/hand/reference/write.quiver.svg`), which is drawn at the Hand's outline weight at scale 0.45. `tools/blender/hand/trace` keeps its line centres and adds only the Hand's construction: one path from the right wrist corner round to the left, fillets at the valleys, and dividers and creases walked out and back as spurs. A right hand seen from the back and a little above, fingers toward the nib: the index lies along the barrel to its round tip near the nib, the thumb's round tip closes on the barrel just behind it in a round notch, the middle fingertip shows under the thumb, three curled knuckles run down the right side with short dividers, the thumb's top edge runs into the web as a crease, and the wrist is short. The pose is turned so a held pen slants as pinch's does, and `Pluma`'s `write` drops in for `pinch` at the same angle. It is drawn for a pen: show it with `Pluma`'s `write` grip.

There is no arm or sleeve: a scene frames the bare hand entering from the frame edge, and the edge implies the arm. The pen weaves with the pinch: the nib and lower shaft pass behind the thumb and the index pad, where a mask cut from the hand's outline (`handOutline`) keeps the pen's edge apart from the hand's contours; from the grip point, in the open pocket where the change of layer cannot show, the upper shaft crosses in front of the index knuckle, drawn over the hand after a mask cuts the hand's ink half an outline clear of the shaft (the cut is refilled with card only inside the hand's fill), so the contours end short of the barrel. Nothing is painted over the page outside the hand, so writing under the nib stays whole, and a custom `nibOffset` turns the hand with the pen. In the `write` grip the layers follow the reference: the pen lies over the hand (along the index finger, over the web and the back of the hand) and the hand's front (the thumb, `handOutline("write").front`) over the pen, so the thumb's tip closes on the barrel near the nib. The front is bounded, wherever it crosses the pen, by the hand's own ink (the thumb's tip and edges), so the barrel always stops a half-outline gap short of a drawn contour and never ends inside a finger; the hand's ink is cut along the pen plus the same gap, sparing the front's contours, and refilled with card inside the hand. The pen is one silhouette: the barrel tapers straight on to the nib.

At finger joins, the outer contour and interior dividers must meet on the same centerline with the same stroke width. Inspect these intersections enlarged: rounded caps alone do not fix misaligned paths or a sudden change in thickness.

## Visual review

Compare artwork against the issue reference and the existing Folder, Document, ChatBubble, and TextFill before accepting it. Use the library's simple geometric line art: solid fills, a clear outline, minimal interior detail. Anatomical rendering, wrinkles, and decorative scene furniture do not fit this system.

Inspect closed, intermediate, and open drawer states; full-range folder lifts; counts 0, 1, 6, 8, and 12 with and without titles; name reveal from blank to named; the front flap ajar; both tab layouts; every hand pose at several rotations; the pen nib against `plumaNib` in both grips, and `write` writing a word at 20°, 35°, and 50° beside `pinch`; both desk finishes and cabinet sides; and highlight progress 0–1. For the top-down pieces, inspect flat and tilted desks with each drawer edge, axes at 0, partial, and full draw from both origins, full and quiet labels, every focus tone including all four quadrants, and each prop at its scale and rotation extremes. Verify desktop and narrow layouts and keyboard controls. Test object completeness, occlusion, and independent controls, not just whether a frame renders.
