@pugi/cli 1.0.0-alpha.159 → 1.0.0-alpha.160

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pugi/cli",
-  "version": "1.0.0-alpha.159",
+  "version": "1.0.0-alpha.160",
   "description": "Pugi CLI - terminal-native software execution system",
   "license": "MIT",
   "homepage": "https://pugi.io",
@@ -40,11 +40,11 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@pugi/cli-darwin-arm64": "1.0.0-alpha.159",
-    "@pugi/cli-darwin-x64": "1.0.0-alpha.159",
-    "@pugi/cli-linux-arm64": "1.0.0-alpha.159",
-    "@pugi/cli-linux-x64": "1.0.0-alpha.159",
-    "@pugi/cli-windows-arm64": "1.0.0-alpha.159",
-    "@pugi/cli-windows-x64": "1.0.0-alpha.159"
+    "@pugi/cli-darwin-arm64": "1.0.0-alpha.160",
+    "@pugi/cli-darwin-x64": "1.0.0-alpha.160",
+    "@pugi/cli-linux-arm64": "1.0.0-alpha.160",
+    "@pugi/cli-linux-x64": "1.0.0-alpha.160",
+    "@pugi/cli-windows-arm64": "1.0.0-alpha.160",
+    "@pugi/cli-windows-x64": "1.0.0-alpha.160"
   }
 }

package/skills/css-tailwind/SKILL.md

@@ -19,7 +19,7 @@ Refactors CSS to Tailwind, fixes spacing rhythm, ensures dark/light parity.
 
 ## Known failure modes
 
-Read `quirks.md` in this directory BEFORE writing code in this domain. It records 5 failures that reached a customer build, each with the symptom, the cause, and the check that tells them apart.
+Read `quirks.md` in this directory BEFORE writing code in this domain. It records 8 failures that reached a customer build, each with the symptom, the cause, and the check that tells them apart.
 
 
 ## Grounding

package/skills/css-tailwind/quirks.md

@@ -45,6 +45,36 @@ actually observe; the build succeeds in every one of these cases.
 
 **Fix.** Use the v3 directives for a v3 pin, or move the pin to v4. Do not mix the two dialects.
 
+## black-bars-on-a-phone
+
+**Symptom.** On a real phone the app has black bands above and below the content, and they appear or grow when the page is pulled. On desktop it looks fine.
+
+**Cause.** The ground colour is set on `body` only. A mobile browser paints the area a rubber-band overscroll exposes from the ROOT element, so `html` keeps the user-agent default — black in dark mode.
+
+**Check.** Look for a `bg-*` on `body` in the base layer with nothing on `html`. Confirm on a phone by dragging the page past its end.
+
+**Fix.** Set the same background on `html` as on `body`, inside `@layer base`.
+
+## vh-leaves-dead-space-on-mobile
+
+**Symptom.** A full-height layout leaves a strip of empty space at the bottom on a phone, and the content jumps when the address bar collapses.
+
+**Cause.** `min-h-screen` compiles to `100vh`, which on mobile means the viewport WITH the browser chrome expanded and never changes. The visible area is smaller, then larger.
+
+**Check.** Search the layout for `min-h-screen` / `h-screen` and open the page on a phone-width viewport.
+
+**Fix.** Use `min-h-dvh` (dynamic viewport height), which follows the chrome as it collapses.
+
+## short-form-marooned-on-a-tall-screen
+
+**Symptom.** On a phone the whole app is a narrow card floating in the middle of a mostly empty screen; on a laptop the same layout looks balanced.
+
+**Cause.** A shell of `min-h-screen flex items-center justify-center` with `max-w-md` centres a short form in a tall viewport. What reads as elegant at 1440 reads as unfinished at 390.
+
+**Check.** Render at 390 wide and ask what fraction of the screen the content occupies. Below roughly half, it is marooned.
+
+**Fix.** Align to the top on small screens and centre only from `sm:` upward — `items-start sm:items-center` — and let the card go full width with real padding (`w-full px-4 sm:max-w-md`).
+
 ## dev-script-not-at-root
 
 **Symptom.** The app builds and runs, but the hosted preview shows nothing or a 503 — the runner reports it found no dev command.