@salilvnair/dui 1.0.12 → 1.0.13

package/dist/lib/components/input/select-position.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Where a select's menu goes, and how tall it is allowed to be.
+ *
+ * ── Why this is its own module ──
+ *
+ * It used to live inline in `SelectInputView`, with a copy of the same
+ * arithmetic in the test beside it and a comment promising the two were "kept
+ * in step by construction". They were, for a while. A test that owns a second
+ * copy of the thing it is testing cannot fail when the first copy drifts,
+ * which is the one job it had — so there is now one function, and the test
+ * imports it.
+ *
+ * ── The rule ──
+ *
+ * The decision has to use the height the menu will ACTUALLY be, not the height
+ * of its contents. `scrollHeight` for a few hundred options is many thousands
+ * of pixels; comparing that against the space on either side made every long
+ * list decide nothing fitted, fall through to opening downward, and run off
+ * the bottom of the window. The longer the list, the more certain it was to do
+ * the wrong thing.
+ *
+ * So: cap the height first, then choose the side with room, then clamp to the
+ * room that side actually has. The menu scrolls internally rather than past
+ * the edge of the window.
+ */
+/** Nothing taller than this, however long the list. */
+export declare const MAX_MENU_H = 380;
+/**
+ * Never collapse to a sliver.
+ *
+ * A trigger a few pixels from an edge has almost no room on that side, and a
+ * 12px menu is unusable — better to overlap the trigger slightly and stay
+ * readable. `placeSelectMenu` honours that by keeping the height and sliding
+ * the menu back inside the window, rather than by letting it hang over the
+ * edge where the overlapped part cannot be reached at all.
+ */
+export declare const MIN_MENU_H = 120;
+export interface MenuPlacement {
+    side: 'above' | 'below';
+    /** Viewport coordinate for the menu's top edge. */
+    top: number;
+    /** What the menu may grow to. It scrolls beyond this. */
+    maxHeight: number;
+}
+/**
+ * Place the menu for a trigger at `rect` in a window `viewportHeight` tall.
+ *
+ * `contentHeight` is the menu's `scrollHeight` — what it would be if nothing
+ * constrained it. It informs the choice of side and never the final height.
+ */
+export declare function placeSelectMenu(rect: {
+    top: number;
+    bottom: number;
+}, contentHeight: number, viewportHeight: number): MenuPlacement;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salilvnair/dui",
-  "version": "1.0.12",
-  "description": "Daakia UI component library — shared across ck8t and daakia",
+  "version": "1.0.13",
+  "description": "Daakia UI component library \u2014 shared across ck8t and daakia",
   "type": "module",
   "license": "MIT",
   "author": "Salil V Nair",
@@ -75,6 +75,8 @@
     "sheets": "node scripts/screenshots/sheets.mjs",
     "catalog": "node scripts/screenshots/readme-catalog.mjs",
     "catalog:check": "node scripts/screenshots/readme-catalog.mjs --check",
+    "coverage": "node scripts/showcase/coverage.mjs",
+    "coverage:check": "node scripts/showcase/coverage.mjs --check",
     "demo-video:record": "node scripts/demo-video/record.js",
     "demo-video:compose": "node scripts/demo-video/compose.js",
     "demo-video:refine": "node scripts/demo-video/refine.js",