Add compact desktop UI foundations

README.md

@@ -48,11 +48,12 @@ preference.
 - `--pw-font-*`, `--pw-text-*`, `--pw-leading-*`: typography.
 - `--pw-duration-*`, `--pw-ease-*`: motion.
 - `--pw-border-*`, `--pw-radius-*`, `--pw-shadow-*`: geometry and elevation.
-- `--pw-focus-*`, `--pw-hit-target-min`, `--pw-icon-*`: interaction and sizing.
+- `--pw-focus-*`, `--pw-hit-target-min`, `--pw-control-*`, `--pw-icon-*`: interaction
+  and sizing.
 
 `tailwind.css` exposes utilities such as `bg-background`, `text-foreground-muted`,
 `border-rule`, `bg-accent-clay`, `font-sans`, `text-body`, `rounded-tight`, `duration-quick`,
-and `ease-edit`.
+`ease-edit`, and `size-control-compact`.
 
 ## React UI
 
@@ -74,10 +75,15 @@ Import components directly so consumers only load what they use:
 
 ```tsx
 import { Button } from "@protocol-works/ui/button";
+import { IconButton } from "@protocol-works/ui/icon-button";
 import { Stack } from "@protocol-works/ui/stack";
 import { Heading } from "@protocol-works/ui/heading";
 ```
 
+Form controls and buttons accept `size="sm"` for compact desktop toolbars and inspectors. Modal
+and popover primitives use Radix behavior for focus management, escape handling, portals, and
+collision-aware positioning.
+
 See [`packages/ui/README.md`](./packages/ui/README.md) for the complete component catalogue.
 
 ## Fonts