@mt-gloss/ui 0.1.8 → 0.1.10

package/lib/composites/dashboard/BottomToolbar/SectionDots.d.ts

@@ -4,11 +4,28 @@
  * Renders `count` buttons inside a `role="tablist"`. Click dispatches
  * `onSelect(index)`. Keyboard ← → loop forward/backward with wrap semantics
  * (D-25). Hollow default, filled for the current section.
+ *
+ * Phase 4 — drag-to-edge-auto-advance — additive extension per D-09/D-10/D-11:
+ * - `provisionalIndex` marks an unconfirmed section with hollow-stroke dot
+ *   (`data-state='provisional-hollow'`) and `aria-label='Unconfirmed section'`.
+ * - `pulseIndex` triggers the refuse-pulse animation (`data-state='pulse'`).
+ * - `pulseNonce` is composited into the React `key` for the pulsed index so a
+ *   nonce bump forces a re-mount — which restarts the CSS keyframe animation
+ *   even if the same index is pulsed twice in a row.
+ *
+ * All new props are optional; omitting them preserves the Phase 23 two-state
+ * `data-state='current'|'hollow'` render exactly (parity contract).
  */
 export interface SectionDotsProps {
     count: number;
     currentIndex: number;
     onSelect: (index: number) => void;
     'aria-label'?: string;
+    /** Phase 4 D-09 — index of the unconfirmed ("provisional") section, if any. */
+    provisionalIndex?: number;
+    /** Phase 4 D-09 — index of the dot currently playing the refuse pulse, if any. */
+    pulseIndex?: number;
+    /** Phase 4 D-10 — monotonically-increasing nonce; bump to replay the pulse keyframe. */
+    pulseNonce?: number;
 }
-export declare function SectionDots({ count, currentIndex, onSelect, 'aria-label': ariaLabel, }: SectionDotsProps): import("react/jsx-runtime").JSX.Element;
+export declare function SectionDots({ count, currentIndex, onSelect, 'aria-label': ariaLabel, provisionalIndex, pulseIndex, pulseNonce, }: SectionDotsProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,5 @@
 import * as React from 'react';
-export type SectionDividerState = 'hidden' | 'revealed' | 'emphasized';
+export type SectionDividerState = 'hidden' | 'revealed' | 'emphasized' | 'provisional';
 export interface SectionDividerProps extends React.HTMLAttributes<HTMLDivElement> {
     state: SectionDividerState;
     /** Left-to-right cascade position (0, 1, 2, ...) multiplied by staggerMs for animation-delay. */

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

@@ -0,0 +1,33 @@
+import * as React from 'react';
+/**
+ * SwingReveal — shared swing-from-behind reveal wrapper (Phase 5 Plan 01).
+ *
+ * MOTION-03 source of truth: gridMotionPrimitives.swingReveal (enterDurationMs, exitDurationMs,
+ *   enterEasing, exitEasing, translateOffsetPx). See gridMotionPrimitives.ts for values.
+ *
+ * MOTION-08 invariant: ALL timing/easing values come from gridMotionPrimitives.
+ * No inline literals in this file or swing-reveal.scss (SCSS reads via CSS custom props).
+ *
+ * MOTION-09 under prefers-reduced-motion: 100ms opacity-only (reducedMotion.swingEnterMs);
+ *   transform: none. Handled entirely by CSS @media query in swing-reveal.scss (research Q3).
+ *
+ * D-05-07 flat-sibling placement; D-05-08 variant-gated API (no open timing props);
+ * D-05-09 trigger="hover+focus" uses CSS :has(:focus-visible) (research Q2); D-05-10 4px from swingReveal.translateOffsetPx.
+ *
+ * RESIZE-12 consumers: EdgeHoverHandle (Plan 02) + EmptyCellPackAffordance (Plan 02).
+ */
+export type SwingRevealVariant = 'pack' | 'handle';
+export type SwingRevealTrigger = 'hover' | 'hover+focus';
+export interface SwingRevealProps {
+    /** Imperative visibility flag — toggles data-visible attribute and .gloss-swing-reveal[data-visible='true'] CSS state. */
+    visible: boolean;
+    /** Variant drives modifier class + future per-variant timing differentiation (D-05-08 variant-gated API — no open timing props). */
+    variant: SwingRevealVariant;
+    /** 'hover' = imperative only; 'hover+focus' = also reveal under :has(:focus-visible) via CSS (research Q2 CSS approach). */
+    trigger: SwingRevealTrigger;
+    /** Children rendered inside the span wrapper. */
+    children: React.ReactNode;
+    /** Optional caller class appended after built-in classes. */
+    className?: string;
+}
+export declare const SwingReveal: React.FC<SwingRevealProps>;

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

@@ -0,0 +1,2 @@
+export { SwingReveal } from './SwingReveal';
+export type { SwingRevealProps, SwingRevealVariant, SwingRevealTrigger } from './SwingReveal';

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

@@ -20,4 +20,5 @@ export * from './EmptyCellPackAffordance';
 export * from './DragGhost';
 export * from './SnapOutline';
 export * from './CascadePreview';
+export * from './SwingReveal';
 export * from './gridMotionPrimitives';

package/package.json

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