@mt-gloss/ui 0.1.41 → 0.1.42

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

@@ -13,6 +13,9 @@ export interface CascadePreviewItem {
     cardId: string;
     x: MotionValue<number>;
     y: MotionValue<number>;
+    /** Static layout in CSS px. NOT MotionValue — Phase 10 does not animate dimensions (Track C/Phase 11). Consumer formula: width = (cell.colSpan ?? 1) * colWidth, height = (cell.rowSpan ?? 1) * rowHeight. */
+    width: number;
+    height: number;
 }
 export interface CascadePreviewProps {
     items: CascadePreviewItem[];
@@ -51,5 +54,7 @@ export interface CascadePreviewProps {
  *     hosts the DragGhost only.
  *   - Consumer places this inside a `position: relative` parent so `position:
  *     absolute` items stack correctly.
+ *
+ * Each item's inner motion.div renders at consumer-supplied {width, height} in CSS px. Dimensions are static; resize-cascade animation is Track C/Phase 11.
  */
 export declare function CascadePreview({ items, children, className, }: CascadePreviewProps): React.JSX.Element | null;

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

@@ -0,0 +1,66 @@
+/**
+ * gridChannels — Grid v3.1 channel vocabulary (Track A foundation).
+ *
+ * Single authoritative vocabulary for the 9 grid-gesture channels (G-01 spec).
+ * Channels are CONTRACTS — names + which lifecycle states they apply in.
+ * Zero behavior, zero runtime: const record + types-via-typeof.
+ *
+ * Requirement mapping:
+ *   GEV-01 — gridChannels (9-channel const record)
+ *   GEV-01 — ChannelName, ChannelDef, LifecycleState (derived types)
+ *
+ * Layered relationship (D-02 — no bridge by design):
+ *   - gridChannels.ts        = vocabulary / contracts (this file)
+ *   - gridMotionPrimitives.ts = physics / timing / color-token names
+ * Different abstraction layers stay in different files.
+ *
+ * Structural precedent: ./gridMotionPrimitives.ts
+ */
+/**
+ * GEV-01 (lifecycle) — 4 states. Section-jump path skips 'arming'
+ * (encoded in consumer reducer per D-05, not in this type).
+ */
+export type LifecycleState = 'idle' | 'arming' | 'active' | 'settling';
+/** GEV-01 — 9-channel vocabulary. Single authoritative gallery. No discriminated unions (D-04); no enums (bundle weight). */
+export declare const gridChannels: {
+    /** GEV-01 — Eligibility tint. Contiguous-from-source paint; blocked by first occupied cell (Principle 4). */
+    readonly eligibilityTint: {
+        readonly applicableStates: readonly ["arming", "active"];
+    };
+    /** GEV-01 — Commit tint. Fill+stroke emphasis on the commit-target cell footprint (G-02). */
+    readonly commitTint: {
+        readonly applicableStates: readonly ["active"];
+    };
+    /** GEV-01 — Rejection tint. Static fill on cells beyond reach. Stays while rejection condition holds. */
+    readonly rejectionTint: {
+        readonly applicableStates: readonly ["active"];
+    };
+    /** GEV-01 — Tracking outline. Solid 2.5px outline at commit footprint (G-02). Dashes + retreats on rejection — NEVER red (D-01 / Principle 1). */
+    readonly trackingOutline: {
+        readonly applicableStates: readonly ["active", "settling"];
+    };
+    /** GEV-01 — Commit ghost. Drag-only floating clone (D-01 — clean card with shadow + scale). Resize: N/A (subsumed by trackingOutline). */
+    readonly commitGhost: {
+        readonly applicableStates: readonly ["active", "settling"];
+    };
+    /** GEV-01 — Displaced preview. Neighbor-shift preview during cascade-insert. */
+    readonly displacedPreview: {
+        readonly applicableStates: readonly ["active"];
+    };
+    /** GEV-01 — Chrome. Drag/resize affordances — hidden when active per R-05 hide-on-active rule. */
+    readonly chrome: {
+        readonly applicableStates: readonly ["idle", "arming"];
+    };
+    /** GEV-01 — Hide-on-active rule. The rule itself: while a gesture is active, chrome+affordances suppress. */
+    readonly hideOnActive: {
+        readonly applicableStates: readonly ["active"];
+    };
+    /** GEV-01 — Refuse pulse. Discrete moment of crossing into rejection. Fires ONCE per transition (Principle 2). No strobing. */
+    readonly refusePulse: {
+        readonly applicableStates: readonly ["active"];
+    };
+};
+/** GEV-01 — Derived from gridChannels via typeof (D-04). */
+export type ChannelName = keyof typeof gridChannels;
+/** GEV-01 — Channel entry shape: { applicableStates: readonly LifecycleState[] }. */
+export type ChannelDef = (typeof gridChannels)[ChannelName];

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

@@ -0,0 +1,62 @@
+/**
+ * gridInteractivePalette — G-02 grid-interaction palette tokens (Phase 9 / Track A).
+ *
+ * Single authoritative source for the 7-token interactive grid palette consumed
+ * by Phases 10–14 visual primitives (drag feedback, resize choreography, section
+ * navigation, affordances, add/remove). Pure data — zero imports, no React, no
+ * runtime functions.
+ *
+ * D-07 dual-export pattern: BOTH locked hex literals (the spec) AND themable
+ * `var(...)` consumer hooks ship from this file. Hex values match the G-02 spec
+ * lock verbatim and never drift.
+ *
+ * Layered relationship: `paletteVars` uses the `--gloss-g02-*` prefix so it does
+ * NOT collide with Phase 0 `gridMotionPrimitives.colorTokens.rejectionFill` /
+ * `rejectionStroke` (which still resolve to `--gloss-rejection-{fill,stroke}`
+ * declared in `reptime-cloud/react-dashboard/app/styles/uplift-tokens.css`).
+ * Per D-02, the Phase 0 visual contract is preserved — this file is a sibling,
+ * not a replacement. SCSS defaults for the new vars are added in Plan 06 (only
+ * for vars consumed by the SnapOutline rewire smoke wire).
+ *
+ * Requirement mapping:
+ *   GEV-02 — paletteHex / paletteVars / STROKE_DASHED / STROKE_SOLID /
+ *            STROKE_SPARSE_DASH / STROKE_OUTLINE / PaletteToken
+ *
+ * Structural precedent: ./gridMotionPrimitives.ts §colorTokens (lines 79-87).
+ */
+/** GEV-02 — G-02 hex literals. AUTHORITATIVE SPEC LOCK. Defaults match. */
+export declare const paletteHex: {
+    readonly baseCellTint: "#F1F4F8";
+    readonly eligibilityFill: "#6F87D2";
+    readonly commitFill: "#4664C0";
+    readonly commitStroke: "#2541A1";
+    readonly rejectionFill: "#F0BAC1";
+    readonly rejectionStroke: "#BB2A39";
+    readonly trackingOutline: "#2541A1";
+};
+/**
+ * GEV-02 — Themable consumer hooks. Var names use `--gloss-g02-*` prefix to
+ * avoid colliding with Phase 0 `--gloss-rejection-{fill,stroke}` (D-02 keep
+ * Phase 0 untouched). Defaults are declared by Plan 06 SCSS for vars consumed
+ * by the smoke wire (currently only `--gloss-g02-tracking-outline` via
+ * SnapOutline rewire).
+ */
+export declare const paletteVars: {
+    readonly baseCellTint: "var(--gloss-g02-base-cell-tint)";
+    readonly eligibilityFill: "var(--gloss-g02-eligibility-fill)";
+    readonly commitFill: "var(--gloss-g02-commit-fill)";
+    readonly commitStroke: "var(--gloss-g02-commit-stroke)";
+    readonly rejectionFill: "var(--gloss-g02-rejection-fill)";
+    readonly rejectionStroke: "var(--gloss-g02-rejection-stroke)";
+    readonly trackingOutline: "var(--gloss-g02-tracking-outline)";
+};
+/** D-09 — Eligibility + provisional dashed stroke pattern. */
+export declare const STROKE_DASHED: "dashed";
+/** D-09 — Commit solid stroke pattern. */
+export declare const STROKE_SOLID: "solid";
+/** D-09 — Rejection sparse-dash stroke pattern (colorblind-safe redundancy). */
+export declare const STROKE_SPARSE_DASH: "sparse-dash";
+/** D-09 — Tracking-outline 2px no-fill pattern. */
+export declare const STROKE_OUTLINE: "2px no-fill";
+/** GEV-02 — Derived from paletteHex via typeof; symmetric with paletteVars. */
+export type PaletteToken = keyof typeof paletteHex;

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

@@ -36,3 +36,5 @@ export * from './LeaderboardCard';
 export * from './ExceptionListCard';
 export * from './StackedGroupTilePreview';
 export * from './gridMotionPrimitives';
+export * from './gridChannels';
+export * from './gridInteractivePalette';

package/package.json

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