@lotics/ui 27.8.0 → 27.9.0

package/docs/composition.md

@@ -286,6 +286,11 @@ leaves the reader no reason to open the chevron.
 
 ## No dead rows — registers & tables
 
+**The identifier leads.** A register's FIRST column is the thing the reader came to find the row
+by — its key, code, or id — because that is what they are scanning against a document, an email,
+or someone on the phone. Pushing it right of a name or a status makes every lookup a hunt across
+the row, and no other column can take its place: a name repeats, a status is shared by dozens.
+
 Every listed record is actionable. PRIMARY entity rows press-open the workspace `Drawer`
 (sequenced — see [master-detail](#master-detail--list--workspace-drawer-with-sequencing));
 read-only drill-downs expand via `Accordion` or glance via `Peek`; every other row gets an
@@ -770,6 +775,15 @@ Anything pressable is ≥ 40px tall (8px minimum gap between pressables). 16px b
 canvas padding, 16–20 inside bands, 10–12 between content lines. Density comes from alignment +
 hierarchy, not cramming.
 
+**The trim test — does this element RESTATE something already on the screen?** Run it over every
+screen before shipping: a per-row proportion bar when the percentage is already on the row; the
+percentage itself when the column holds four values and a total; a state line that only says
+nothing has happened; a gloss explaining the WIDGET rather than the domain. A gloss earns its
+place only by stating a truth that is otherwise INVISIBLE. This is the hardest slop to see and the
+most common, because it survives every other check: each piece is defensible alone, and only the
+question "what does this tell me that the screen does not already say" catches decoration wearing
+an information costume.
+
 ## Testing an overlay component — assert through the logic, prove in a browser
 
 **A `Popover`-backed surface does not mount under jsdom.** It positions in a `useLayoutEffect` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/ui",
-  "version": "27.8.0",
+  "version": "27.9.0",
   "type": "module",
   "exports": {
     "./vite": {