@mt-gloss/ui 0.0.48 → 0.1.0

package/internals.js

@@ -1,7 +1,7 @@
 import { b as B } from "./UIContext-C3E-k7HI.js";
 import { F as A, I, G as H, H as M, af as $, ah as R, c as E, h as F, t as O, D as U, w as z, x as W, v as L, y as j, A as G, z as V, k as X, ai as Z, a7 as q, aa as J, a9 as K, a8 as Q, ab as Y, Q as aa, W as sa, X as ea, V as oa, a0 as ta, a1 as la, e as ra, a4 as ia, a6 as da, a5 as na, g as ca, i as Ba, aj as ga, a3 as ba, J as ma, M as ua, K as pa, L as ya, a2 as ha, B as _a, ag as fa, l as va, ac as Ca, O as ka, P as Da, n as Ta, p as wa, r as xa, q as Sa, o as Na, s as Pa, d as Aa, ad as Ia, j as Ha, Y as Ma, $ as $a, _ as Ra, ae as Ea, m as Fa, N as Oa, f as Ua, C as za, E as Wa, R as La, S as ja, T as Ga, a as Va, U as Xa, Z as Za, u as qa } from "./UIContext-C3E-k7HI.js";
 import { jsx as d, jsxs as g, Fragment as b } from "react/jsx-runtime";
-import { c as Ka, e as Qa, d as Ya, B as as, b as ss, a as es } from "./BaseAsyncButton-nFOdhiBv.js";
+import { c as Ka, e as Qa, d as Ya, B as as, b as ss, a as es } from "./BaseAsyncButton-usdApZUY.js";
 const T = {
   DurationFast: "var(--gloss-motion-duration-fast)",
   DurationNormal: "var(--gloss-motion-duration-normal)",

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

@@ -0,0 +1,19 @@
+import * as React from 'react';
+/**
+ * Phase 23 — TOOLBAR-01 — persistent ~36px strip per D-23 / D-24.
+ *
+ * Always visible (not tied to edit-session state). Three named slots — left, center,
+ * right — composed by the consumer. Reptime supplies a `<PageDropdown>` in `slotLeft`
+ * and `<SectionDots>` in `slotCenter`; `slotRight` is reserved for future controls.
+ */
+export interface BottomToolbarProps {
+    slotLeft?: React.ReactNode;
+    slotCenter?: React.ReactNode;
+    slotRight?: React.ReactNode;
+    /** Override D-23 default 36px height. */
+    height?: number;
+    className?: string;
+    style?: React.CSSProperties;
+    'aria-label'?: string;
+}
+export declare function BottomToolbar({ slotLeft, slotCenter, slotRight, height, className, style, 'aria-label': ariaLabel, }: BottomToolbarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,14 @@
+/**
+ * Phase 23 — TOOLBAR-01 — N-button section navigator per D-24 / D-25.
+ *
+ * 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.
+ */
+export interface SectionDotsProps {
+    count: number;
+    currentIndex: number;
+    onSelect: (index: number) => void;
+    'aria-label'?: string;
+}
+export declare function SectionDots({ count, currentIndex, onSelect, 'aria-label': ariaLabel, }: SectionDotsProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,4 @@
+export { BottomToolbar } from './BottomToolbar';
+export type { BottomToolbarProps } from './BottomToolbar';
+export { SectionDots } from './SectionDots';
+export type { SectionDotsProps } from './SectionDots';

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

@@ -0,0 +1 @@
+export * from './BottomToolbar';

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

@@ -0,0 +1,29 @@
+import * as React from 'react';
+export type DropAnchorDensity = 'near' | 'adjacent' | 'far' | 'distant' | 'none';
+export interface DropAnchorCellProps extends React.HTMLAttributes<HTMLDivElement> {
+    density: DropAnchorDensity;
+    /** D-13 / DRAG-AN-02 — occupied cells never highlight. Pass false for occupied cells. */
+    canAccept: boolean;
+    /** Brief not-allowed pulse when user attempts drop on occupied. */
+    blocked?: boolean;
+    /** Stable cell id for test selectors + future instrumentation. */
+    ['data-cell-id']?: string;
+    children?: React.ReactNode;
+}
+/**
+ * DropAnchorCell — DRAG-AN-01/02/03 (Phase 23 D-13/D-14).
+ *
+ * Presentational cell wrapper that drives drop-anchor tint via `data-density`
+ * + `data-can-accept` attrs. Consumers (Plan 23-06) compute density bucket per
+ * cell relative to the cursor; this primitive owns the visual contract only.
+ *
+ * Visual contract (see drop-anchor-cell.scss):
+ * - data-density ∈ {near|adjacent|far|distant} drives ::after opacity per
+ *   D-14 array [0.80, 0.50, 0.30, 0.15].
+ * - data-can-accept="false" suppresses highlight unconditionally (D-13 —
+ *   occupied cells never light up).
+ * - data-blocked="true" + className modifier triggers brief not-allowed pulse.
+ *
+ * Respects prefers-reduced-motion.
+ */
+export declare function DropAnchorCell({ density, canAccept, blocked, className, children, ...rest }: DropAnchorCellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { DropAnchorCell } from './DropAnchorCell';
+export type { DropAnchorCellProps, DropAnchorDensity } from './DropAnchorCell';

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

@@ -0,0 +1,17 @@
+import * as React from 'react';
+/**
+ * Phase 23 — EMPTY-PACK-01 — `[×]` empty-cell pack affordance per D-19 / D-20.
+ *
+ * Renders a small top-right button on an empty cell that, when clicked, requests
+ * right-neighbor left-shift via `onPack()`. When `enabled=false` (all cells to
+ * the right are also empty), the affordance is fully hidden (returns `null`).
+ */
+export interface EmptyCellPackAffordanceProps {
+    /** D-19 — hide when all cells to the right are also empty. Consumer decides. */
+    enabled: boolean;
+    onPack: () => void;
+    ariaLabel?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare function EmptyCellPackAffordance({ enabled, onPack, ariaLabel, className, style, }: EmptyCellPackAffordanceProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,2 @@
+export { EmptyCellPackAffordance } from './EmptyCellPackAffordance';
+export type { EmptyCellPackAffordanceProps } from './EmptyCellPackAffordance';

package/lib/primitives/dashboard/MetricCard/gridInteractionPhysics.d.ts

@@ -0,0 +1,29 @@
+/**
+ * gridInteractionPhysics — D-26 Phase 23 config tokens.
+ *
+ * STRICT SEPARATION from resizePhysics.ts (D-27): this module contains
+ * ONLY grid-interaction timings not already in resizePhysics.ts. Spring +
+ * hysteresis + blueprint constants continue to live in resizePhysics.ts
+ * and are imported from there by consumers. Forking resizePhysics.ts is
+ * AP-16 equivalent and forbidden.
+ *
+ * Keys sourced from 23-CONTEXT.md D-26 + 23-RESEARCH.md Pattern 13.
+ */
+export declare const DEFAULT_GRID_INTERACTION_PHYSICS: {
+    readonly staggerMs: 50;
+    readonly reverseStaggerMs: 30;
+    readonly envelopeEnterMs: 180;
+    readonly envelopeExitMs: 140;
+    readonly rubberBandRatio: 0.33;
+    readonly dragEdgeHoldMs: 400;
+    readonly spilloverArcDurationMs: 600;
+    readonly spilloverStaggerMs: 50;
+    readonly anchorProximityOpacities: readonly [0.8, 0.5, 0.3, 0.15];
+    readonly anchorFadeStaggerMs: 30;
+    readonly editStandbyMs: 4000;
+    readonly editFadeOutMs: 600;
+    readonly sectionDividerFadeInMs: 120;
+    readonly sectionDividerFadeOutMs: 80;
+    readonly sectionDividerStaggerMs: 40;
+};
+export type GridInteractionPhysicsConfig = typeof DEFAULT_GRID_INTERACTION_PHYSICS;

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

@@ -13,6 +13,8 @@ export { DEFAULT_RESIZE_PHYSICS } from './resizePhysics';
 export type { ResizePhysicsConfig } from './resizePhysics';
 export { VelocityBuffer } from './velocityBuffer';
 export type { VelocitySample } from './velocityBuffer';
+export { DEFAULT_GRID_INTERACTION_PHYSICS } from './gridInteractionPhysics';
+export type { GridInteractionPhysicsConfig } from './gridInteractionPhysics';
 export * from './flipAndStage';
 export * from './types';
 export type { CardBackProps } from './CardBack';

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

@@ -0,0 +1,41 @@
+import * as React from 'react';
+export type ResizeEnvelopeState = 'hidden' | 'entering' | 'entered' | 'exiting';
+export interface ResizeEnvelopeProps {
+    state: ResizeEnvelopeState;
+    originX: number;
+    originY: number;
+    leftEdgeX: number;
+    rightEdgeX: number;
+    minBoundaryX: number;
+    /** Intermediate permeable snap positions between min and max; rendered as dotted lines. */
+    snapBoundariesX: number[];
+    topY: number;
+    bottomY: number;
+    /** Override D-07 enter duration (default: DEFAULT_GRID_INTERACTION_PHYSICS.envelopeEnterMs = 180ms). */
+    enterMs?: number;
+    /** Override D-07 exit duration (default: DEFAULT_GRID_INTERACTION_PHYSICS.envelopeExitMs = 140ms). */
+    exitMs?: number;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Phase 23 — RESIZE-ENV-01 — D-05/D-06/D-07
+ *
+ * Pure presentational overlay drawn on pointerdown of a resize handle. Shows
+ * the full resize option space:
+ *   - Solid LEFT edge (card's fixed anchor)
+ *   - Solid RIGHT edge (max colSpan extent)
+ *   - Solid MIN-BOUNDARY interior line (the wall — impermeable)
+ *   - Dotted INTERMEDIATE snap lines (permeable snap points)
+ *
+ * Asymmetric D-07 timings:
+ *   - Enter 180ms: 120ms solid edges fade-in + 60ms dotted fade-in (offset by 120ms)
+ *   - Exit 140ms: 40ms dotted fade-out + 100ms solid collapse (offset by 40ms)
+ *
+ * Defaults pull from `DEFAULT_GRID_INTERACTION_PHYSICS` (CONFIG-01); never
+ * hardcode duration strings in consumers. Respects `prefers-reduced-motion`.
+ *
+ * Aria-hidden — purely decorative overlay; the underlying resize gesture
+ * carries the semantic meaning.
+ */
+export declare function ResizeEnvelope({ state, originX, originY, leftEdgeX, rightEdgeX, minBoundaryX, snapBoundariesX, topY, bottomY, enterMs, exitMs, className, style, }: ResizeEnvelopeProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,2 @@
+export { ResizeEnvelope } from './ResizeEnvelope';
+export type { ResizeEnvelopeProps, ResizeEnvelopeState } from './ResizeEnvelope';

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

@@ -0,0 +1,29 @@
+import * as React from 'react';
+export type SectionDividerState = 'hidden' | 'revealed' | 'emphasized';
+export interface SectionDividerProps extends React.HTMLAttributes<HTMLDivElement> {
+    state: SectionDividerState;
+    /** Left-to-right cascade position (0, 1, 2, ...) multiplied by staggerMs for animation-delay. */
+    staggerIndex?: number;
+    fadeInMs?: number;
+    fadeOutMs?: number;
+    staggerMs?: number;
+}
+/**
+ * SectionDivider — SECTION-DIV-01 (Phase 23 D-22).
+ *
+ * Dashed vertical divider revealed only during grid manipulation. Three-state
+ * machine (hidden|revealed|emphasized) drives opacity + color via CSS class
+ * modifiers. Each instance accepts a `staggerIndex` so consumers (Plan 23-06)
+ * can render N dividers with a left-to-right cascade — index threads through
+ * a CSS custom property as `staggerIndex × staggerMs` ms.
+ *
+ * Visual contract (see section-divider.scss):
+ * - state='hidden': opacity 0, no chrome
+ * - state='revealed': opacity 0.4, neutral border color, fade-in over fadeInMs
+ * - state='emphasized': opacity 0.85, accent color (current section), fade-in
+ *   over fadeInMs
+ *
+ * Defaults bind to DEFAULT_GRID_INTERACTION_PHYSICS (CONFIG-01).
+ * Respects prefers-reduced-motion.
+ */
+export declare function SectionDivider({ state, staggerIndex, fadeInMs, fadeOutMs, staggerMs, className, style, ...rest }: SectionDividerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { SectionDivider } from './SectionDivider';
+export type { SectionDividerProps, SectionDividerState } from './SectionDivider';

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

@@ -0,0 +1,30 @@
+import * as React from 'react';
+export interface ArcSegment {
+    id: string;
+    fromX: number;
+    fromY: number;
+    toX: number;
+    toY: number;
+}
+export interface SpilloverArcProps {
+    segments: ArcSegment[];
+    /** D-18 — full arc lifetime (default spilloverArcDurationMs = 600). */
+    durationMs?: number;
+    /** D-18 — per-segment stagger (default spilloverStaggerMs = 50). */
+    staggerMs?: number;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * SpilloverArc — DRAG-SPILL-01 (Phase 23 D-17/D-18).
+ *
+ * Single `<svg>` overlay rendering N quadratic Bezier `<path>` arcs from a
+ * drop origin to each spilled card's final position. Each path fades over
+ * `durationMs` (default 600) with `staggerMs` (default 50) per-arc offset.
+ *
+ * Single-SVG strategy (vs. one SVG per segment) chosen for paint perf and to
+ * eliminate cross-arc clipping concerns. See 23-RESEARCH.md §Pattern 9.
+ *
+ * Respects prefers-reduced-motion.
+ */
+export declare function SpilloverArc({ segments, durationMs, staggerMs, className, style, }: SpilloverArcProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,2 @@
+export { SpilloverArc } from './SpilloverArc';
+export type { SpilloverArcProps, ArcSegment } from './SpilloverArc';

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

@@ -12,3 +12,8 @@ export * from './MetricCardGrid';
 export * from './TabbedDataView';
 export * from './MetricGroupContainer';
 export * from './DevTuningPanel';
+export * from './ResizeEnvelope';
+export * from './DropAnchorCell';
+export * from './SpilloverArc';
+export * from './SectionDivider';
+export * from './EmptyCellPackAffordance';

package/package.json

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