@mt-gloss/ui 0.1.6 → 0.1.7

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

@@ -0,0 +1,82 @@
+/**
+ * gridMotionPrimitives — Grid v2 shared motion vocabulary (Phase 0).
+ *
+ * Single source of truth for all timing, easing, color-token-name, and feedback
+ * constants consumed by Phases 1–5 (Grid Foundation, Cascade, Drag Feedback,
+ * Drag-to-Edge Auto-Advance, Resize + [×]). Zero behavior — framework-agnostic,
+ * no React, no Framer Motion, no hooks. Consumers import plain constants +
+ * `getMotionMode()` and decide how to apply them.
+ *
+ * Requirement mapping:
+ *   MOTION-01 (no fade-from-nowhere) — documented principle; enforced in review
+ *   MOTION-02 — cascadePhysics
+ *   MOTION-03 — swingReveal
+ *   MOTION-04 — colorTokens.rejection*, colorTokens.valid*, colorTokens.validCellStroke
+ *   MOTION-05 — rejectionFeedback
+ *   MOTION-06 — provisional, colorTokens.provisionalWash
+ *   MOTION-07 — HARD_CLIP
+ *   MOTION-08 — this file is the lone source; no inline timing/hex/easing in
+ *               consuming component code (grep-enforced in each consumer phase)
+ *   MOTION-09 — reducedMotion, getMotionMode()
+ *
+ * Structural precedent: libs/gloss-ui/src/lib/primitives/overlays/ActionStrip/motion.ts
+ */
+/** MOTION-02 — Forward (digest) and reverse (undo) cascade physics. Asymmetric by design. */
+export declare const cascadePhysics: {
+    readonly forwardStaggerMs: 50;
+    readonly reverseStaggerMs: 30;
+    readonly springStiffness: 380;
+    readonly springDamping: 32;
+    readonly reverseVelocityMultiplier: 1.4;
+};
+/** MOTION-03 — Swing-from-behind reveal (resize handle, [×] affordance, future hover-intent micro-affordances). */
+export declare const swingReveal: {
+    readonly enterDurationMs: 220;
+    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;
+};
+/** MOTION-05 — Rejection kinesthetic: ghost shiver on invalid drop. */
+export declare const rejectionFeedback: {
+    readonly shiverCycles: 3;
+    readonly shiverAmplitudePx: 2;
+    readonly shiverDurationMs: 180;
+    readonly validCellOpacity: 0.6;
+};
+/** MOTION-06 — Provisional section/dot materialize + dematerialize. */
+export declare const provisional: {
+    readonly materializeMs: 180;
+    readonly dematerializeMs: 140;
+    readonly easing: "cubic-bezier(0.22, 1, 0.36, 1)";
+    readonly dotStrokePx: 2;
+    readonly dividerDashGapPx: 4;
+};
+/** MOTION-09 — Substitution values when prefers-reduced-motion: reduce is active. */
+export declare const reducedMotion: {
+    readonly cascadeStaggerMs: 0;
+    readonly cascadeSpringCapMs: 120;
+    readonly swingEnterMs: 100;
+    readonly swingEnterStyle: "opacity";
+    readonly provisionalMs: 80;
+    readonly provisionalStyle: "opacity";
+    readonly shiverMs: 200;
+    readonly shiverStyle: "color-flash";
+};
+/**
+ * MOTION-07 — Hard-clip marker. True = when fixed neighbor grows over a card,
+ * cards clip at advancing edge (no fade). Downstream phases must reference this
+ * constant as the canonical source for the hard-clip rule.
+ */
+export declare const HARD_CLIP: true;
+/** MOTION-04, MOTION-06 — CSS custom property NAMES (not literals). Consumers use var(...). */
+export declare const colorTokens: {
+    readonly rejectionFill: "var(--gloss-rejection-fill)";
+    readonly rejectionStroke: "var(--gloss-rejection-stroke)";
+    readonly validFill: "var(--gloss-valid-fill)";
+    readonly validStroke: "var(--gloss-valid-stroke)";
+    readonly validCellStroke: "var(--gloss-valid-cell-stroke)";
+    readonly provisionalWash: "var(--gloss-provisional-wash)";
+};
+/** MOTION-09 — Motion mode resolver. Pure; SSR-safe; returns 'full' when window is undefined. */
+export declare function getMotionMode(): 'full' | 'reduced';

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

@@ -17,3 +17,4 @@ export * from './DropAnchorCell';
 export * from './SpilloverArc';
 export * from './SectionDivider';
 export * from './EmptyCellPackAffordance';
+export * from './gridMotionPrimitives';

package/package.json

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