@mt-gloss/ui 0.1.35 → 0.1.37

package/lib/primitives/dashboard/ChartControlBar/useFilterLayout.d.ts

@@ -32,6 +32,27 @@ export interface Geometry {
  * Uses ResizeObserver and window resize to track geometry changes.
  * Returns pill positions, filter tray positions, and track rectangles.
  *
+ * ## Optional dimension group
+ *
+ * The dimension (entity-type) TabGroup is optional. Consumers may hide it via a
+ * feature flag (e.g. a per-userType template that disables the entity selector).
+ * When `dimensionGroupRef.current` is null the hook STILL measures and emits
+ * valid geometry for the remaining groups:
+ *
+ * - `tracks` contains 2 entries (metric + entity) instead of 3.
+ * - `entityPill`, `entityFilter.left`, `entityFilter.width` are zeroed —
+ *   dimension-driven filter is unreachable when its trigger is absent.
+ * - Item-related geometry (item pill + item filter) is still computed correctly
+ *   because those are derived from the entity group + entity tab refs, neither
+ *   of which depends on the dimension group.
+ *
+ * Historical note (2026-04-23): the hook previously early-returned whenever
+ * `dg` was null, leaving geometry frozen at `DEFAULT_GEO` (empty tracks, zero
+ * filter widths). That caused the entire control-bar shell + item-filter
+ * popover to disappear for personas that legitimately hid the dimension group.
+ * The null-dg path is now a first-class supported configuration. See debug
+ * session `.planning/debug/chart-control-bar-regression.md` for full trace.
+ *
  * @example
  * ```tsx
  * import { useFilterLayout } from '@mt-gloss/ui';

package/lib/primitives/dashboard/SnapOutline/SnapOutline.d.ts

@@ -18,11 +18,20 @@ export interface SnapOutlineProps {
  *
  * Renders a `position: absolute` 2px solid border rectangle, translated to the
  * target cell via `translate({left}px, {top}px)` where:
- *   - `left = cell.col * (colWidth + gap)`
- *   - `top  = cell.row * (rowHeight + gap)`
+ *   - `absCol = cell.section * 3 + cell.col`  (section offset applied)
+ *   - `left   = absCol * (colWidth + gap)`
+ *   - `top    = cell.row * (rowHeight + gap)`
  *   - `width  = colSpan * colWidth + (colSpan - 1) * gap`
  *   - `height = rowHeight`
  *
+ * COORDINATE CONTRACT: `cell.col` is SECTION-RELATIVE (0..2). The absolute grid
+ * column is computed here by adding `cell.section * 3`. Producers (useDragFeedback)
+ * emit section-relative col so predictCascade + snap outline share the same type.
+ * Prior to the `large-card-drop-positioning` debug fix (2026-04-22), this
+ * component treated `cell.col` as absolute, causing the outline to stick to
+ * section 1 regardless of cursor section — and to straddle the section boundary
+ * when a wide card hovered near the right of section 1.
+ *
  * Transitions the transform at `${transitionMs ?? 120}ms cubic-bezier(0.4, 0, 0.2, 1)`.
  * Under `prefers-reduced-motion: reduce`, `transition: none !important` strips
  * the slide (SCSS-level override; see snap-outline.scss).

package/lib/primitives/dashboard/gridMotionPrimitives.d.ts

@@ -35,7 +35,7 @@ export declare const swingReveal: {
     readonly exitDurationMs: 140;
     readonly enterEasing: "cubic-bezier(0.34, 1.56, 0.64, 1)";
     readonly exitEasing: "cubic-bezier(0.4, 0, 1, 1)";
-    readonly translateOffsetPx: 4;
+    readonly translateOffsetPx: 8;
 };
 /** MOTION-05 — Rejection kinesthetic: ghost shiver on invalid drop. */
 export declare const rejectionFeedback: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mt-gloss/ui",
-  "version": "0.1.35",
+  "version": "0.1.37",
   "type": "module",
   "publishConfig": {
     "access": "restricted"