@half-built/css 0.3.1 → 0.4.1

package/README.md

@@ -46,6 +46,15 @@ const breakpoints = fileURLToPath(
 Sites add their own `site` cascade layer after these imports for local
 overrides. The layer order in `layers.css` already declares it.
 
+## Bottom-docked controls
+
+`--dock-bottom` (in `tokens/primitives.css`, default `0px`) is the
+room a viewport-fixed bottom component occupies. A site that pins a
+control cluster to the bottom corner sets it to the cluster's height
+plus its inset and a line of air, in the same media block that pins
+the cluster; the astro package's `Footer` reserves that much below its
+last link so the page scrolls on far enough to clear the cluster.
+
 ## Theming
 
 The entire third-party theming surface is six primitives: two brand

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@half-built/css",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Design tokens, base, patterns, and prose CSS for the half-built design system.",
   "license": "MIT",
   "repository": {

package/src/prose.css

@@ -9,6 +9,12 @@
    bare browser defaults, recorded as a deliberate deviation in the handoff. */
 .prose p { margin: 0 0 1.5em; }
 .prose h2 { font-size: var(--font-size-md); margin: 1.6em 0 0.6em; }
+/* Footnotes (Markdown [^1]) get no rules of their own: the reference
+   is a superscript link and the notes an ordered list under an h2,
+   all on the rhythm above. remark-gfm classes that h2 "sr-only",
+   expecting the sheet to hide it; this system defines no .sr-only on
+   purpose, so the Footnotes heading shows (owner call 2026-09-09).
+   Do not add an .sr-only rule or alias it to .screen-reader-text. */
 .prose h3 { font-size: var(--font-size-base); margin: 1.4em 0 0.5em; }
 .prose h4 { font-size: var(--font-size-sm); text-transform: uppercase; letter-spacing: 0.5px; margin: 1.4em 0 0.5em; }
 

package/src/tokens/primitives.css

@@ -93,6 +93,14 @@
     --shell-max: 1380px;
     --shell-pad: 15px;
     --header-clear: 65px;
+    /* Room for a viewport-bound bottom component (owner rule
+       2026-09-09): a fixed control cluster in the bottom corner takes
+       no room in flow, so the page's last lines end underneath it. A
+       site that pins one sets this to the height it occupies, inset
+       and air included, and the Footer reserves that much below its
+       last line so the page scrolls on far enough to clear it. Zero
+       when nothing is pinned. */
+    --dock-bottom: 0px;
     --shadow: 0 3px 12px -1px rgb(7 10 25 / 20%), 0 22px 27px -20px rgb(7 10 25 / 20%);
     --transition: all 0.1s ease;