@mt-gloss/ui 0.1.83 → 0.1.85

package/lib/composites/panels/coordinator/coordinator.d.ts

@@ -1,3 +1,8 @@
 import { PanelAction, PanelState } from './types';
 export declare const initialState: PanelState;
+/**
+ * Set of PanelIds that support the dirty-buffer flow.
+ * Only 'settings' in P2; future panels added here when P6+ wires buffer-becomes-dirty.
+ */
+export declare const PANELS_WITH_BUFFER: Set<string>;
 export declare function reducer(state: PanelState, action: PanelAction): PanelState;

package/lib/composites/panels/coordinator/types.d.ts

@@ -9,6 +9,10 @@
  * derivation in P1 reaches `'idle'` + `'notif-center'` only; other branches return
  * `'idle'` with a TODO until P2 extends the reducer to full 7-state.
  *
+ * P2 reach: full 7-state machine. All PanelIds supported. PanelState gains
+ * activeTrigger, bellCutoutOpen, isDirty, lockHint. PanelAction gains 6 new
+ * variants. SideEffect gains 5 new variants.
+ *
  * Plan refs:
  *   F1 — exhaustive types ship Day 1
  *   F4 — `lastClose` carries `{ panelId, reason }` so closeLog pump can append
@@ -48,9 +52,15 @@ export interface CloseLogEntry {
      * F21 — When `reason === 'nav-escape-hatch'`, the same enum literal fires for
      * both backdrop-click AND page-nav escape. Future analytics MUST inspect this
      * note before attributing UX intent.
+     * F22 — When `reason === 'mutex-handoff'`, synthetic close-log entry from pump 1.
      */
     note?: string;
 }
+export interface LockHint {
+    blockedTrigger: TriggerContext;
+    activeCardId: string | null;
+    expiresAt: number;
+}
 export type SideEffect = {
     type: 'SCHEDULE_TIMER';
     ms: number;
@@ -58,9 +68,26 @@ export type SideEffect = {
 } | {
     type: 'INVALID_DISPATCH';
     reason: string;
+} | {
+    type: 'SET_LOCK_HINT';
+    hint: LockHint;
+} | {
+    type: 'HANDOFF_CLOSE';
+    reason: CloseReason;
+    previousPanelId: PanelId;
+} | {
+    type: 'COMMIT_BUFFER';
+} | {
+    type: 'DISCARD_BUFFER';
+} | {
+    type: 'AUTO_CLOSE_NOTIF_CENTER';
 };
 export interface PanelState {
     activePanelId: PanelId | null;
+    activeTrigger: TriggerContext | null;
+    bellCutoutOpen: boolean;
+    isDirty: boolean;
+    lockHint: LockHint | null;
     lastClose: {
         panelId: PanelId;
         reason: CloseReason;
@@ -74,11 +101,19 @@ export type PanelAction = {
 } | {
     type: 'CLOSE_PANEL';
     reason: CloseReason;
+} | {
+    type: 'OPEN_BELL_CUTOUT';
+} | {
+    type: 'CLOSE_BELL_CUTOUT';
+} | {
+    type: 'BUFFER_BECOMES_DIRTY';
+} | {
+    type: 'BUFFER_BECOMES_CLEAN';
+} | {
+    type: 'SET_LOCK_HINT';
+    hint: LockHint;
+} | {
+    type: 'CLEAR_LOCK_HINT';
 } | {
     type: 'DRAIN_SIDE_EFFECTS';
 };
-export interface LockHint {
-    blockedTrigger: TriggerContext;
-    activeCardId: string | null;
-    expiresAt: number;
-}

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

@@ -17,6 +17,6 @@ import { CardShellProps } from './types';
  * ```
  */
 export declare const CardShell: {
-    ({ contentSlot, children, colSpan, isStale, isRetrying, beta, disabled, style, accentRing, onGraph, onDetails, onCustomize, onRemove, onWhatsThis, onExpand, onShrink, onMove, onReplace, onNavigate, onRetry, onRefresh, enableQuickSettings, onUpdateTimeframe, instanceTimeframe, cardTitle, quickConfigSlot, isStackedGroup, onUpdateStackedTimeframes, instanceStackedTimeframes, isGraphActive, isTableActive, isGraphCard, canExpand, anchorX, extensionOverflow, cardRef: externalCardRef, hovered, forceHide, resizePhase, outgoingSnapshot, isFlipped, onFlipChange, }: CardShellProps): import("react/jsx-runtime").JSX.Element;
+    ({ contentSlot, children, colSpan, isStale, isRetrying, beta, disabled, style, accentRing, onGraph, onDetails, onCustomize, onRemove, onWhatsThis, onExpand, onShrink, onMove, onReplace, onNavigate, onRetry, onRefresh, enableQuickSettings, onUpdateTimeframe, instanceTimeframe, cardTitle, quickConfigSlot, isStackedGroup, onUpdateStackedTimeframes, instanceStackedTimeframes, isGraphActive, isTableActive, isGraphCard, canExpand, anchorX, extensionOverflow, cardRef: externalCardRef, hovered, forceHide, resizePhase, outgoingSnapshot, isFlipped, onFlipChange, clickShadowSlot, }: CardShellProps): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };

package/lib/primitives/dashboard/MetricCard/types/cardShellProps.d.ts

@@ -129,4 +129,12 @@ export interface CardShellProps {
     resizePhase?: import('../useResizeChoreography').ChoreographyPhase;
     /** Phase 11.2 — outgoing composition snapshot (B-path). Rendered above live content during 'outgoing'; fades out on 'incoming'. */
     outgoingSnapshot?: ReactNode;
+    /**
+     * Quick 260511-6xk T3 — optional transparent click-proxy region rendered
+     * at card-root level (above the front-face z-layer). Consumer renders this
+     * when the ActionStrip is visible to extend the strip's click area upward
+     * into the card body without repositioning the strip. The consumer owns
+     * z-index, sizing, and click routing; CardShell only renders the slot.
+     */
+    clickShadowSlot?: ReactNode;
 }

package/lib/primitives/dashboard/MetricCard/types/shared.d.ts

@@ -30,6 +30,8 @@ export type SlotCapacity = 1 | 3 | 5;
 /** Base props shared by all MetricCard variants. */
 export interface BaseMetricCardProps {
     label: string;
+    /** Optional ReactNode rendered alongside the label in zone-a (geo badge, beta chip, etc.). */
+    labelAdornment?: import('react').ReactNode;
     value?: number | string | null;
     valueFormat?: ValueFormat;
     trend?: TrendData | null;

package/lib/primitives/dashboard/PageChip/types.d.ts

@@ -1,10 +1,12 @@
-import { RefObject } from 'react';
+import { RefObject, ReactNode } from 'react';
 /** Describes a single page entry in the dropdown list. */
 export interface PageInfo {
     id: string;
     name: string;
     named: boolean;
     cardCount: number;
+    /** Optional trailing decoration (geo badge, etc.). Rendered after the page name. */
+    icon?: ReactNode;
 }
 /** Props for the PageChip corner navigation element. */
 export interface PageChipProps {

package/package.json

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

package/COMMITS-or4m2o8k.js

@@ -1,219 +0,0 @@
-import { jsx as a, jsxs as u, Fragment as I } from "react/jsx-runtime";
-import { createContext as h, useContext as p, useReducer as g, useRef as i, useEffect as r, useMemo as f, useCallback as v, useLayoutEffect as C } from "react";
-const c = h(null);
-function m() {
-  const e = p(c);
-  if (!e)
-    throw new Error(
-      "[panels] usePanelContext must be used inside <PanelProvider>. See @mt-gloss/ui/composites/panels."
-    );
-  return e;
-}
-function O() {
-  return p(c);
-}
-const S = {
-  activePanelId: null,
-  lastClose: null,
-  pendingSideEffects: []
-};
-function _(e, n) {
-  switch (n.type) {
-    case "OPEN_PANEL":
-      return n.panelId === "notification-center" && e.activePanelId === null ? {
-        activePanelId: "notification-center",
-        lastClose: null,
-        // reset lastClose on fresh open
-        pendingSideEffects: e.pendingSideEffects
-        // preserve any draining queue
-      } : n.panelId === "notification-center" && e.activePanelId === "notification-center" ? e : {
-        ...e,
-        pendingSideEffects: [
-          ...e.pendingSideEffects,
-          {
-            type: "INVALID_DISPATCH",
-            reason: `panel-not-supported-in-P1:${n.panelId}`
-          }
-        ]
-      };
-    case "CLOSE_PANEL":
-      return e.activePanelId === null ? e : {
-        activePanelId: null,
-        lastClose: { panelId: e.activePanelId, reason: n.reason },
-        pendingSideEffects: e.pendingSideEffects
-      };
-    case "DRAIN_SIDE_EFFECTS":
-      return e.pendingSideEffects.length === 0 ? e : {
-        ...e,
-        pendingSideEffects: []
-      };
-    default:
-      return e;
-  }
-}
-function y(e) {
-  return e.activePanelId === "notification-center" ? "notif-center" : (e.activePanelId != null, "idle");
-}
-function N() {
-  const [e, n] = g(_, S), t = i([]);
-  i(null), r(() => {
-    if (e.pendingSideEffects.length !== 0) {
-      for (const o of e.pendingSideEffects)
-        o.type === "SCHEDULE_TIMER" ? window.setTimeout(() => n(o.action), Math.max(0, o.ms)) : o.type === "INVALID_DISPATCH" && process.env.NODE_ENV !== "production" && console.warn("[panels] INVALID_DISPATCH:", o.reason);
-      n({ type: "DRAIN_SIDE_EFFECTS" });
-    }
-  }, [e.pendingSideEffects]), r(() => {
-    if (!e.lastClose) return;
-    const o = {
-      panelId: e.lastClose.panelId,
-      reason: e.lastClose.reason,
-      at: Date.now(),
-      note: e.lastClose.reason === "nav-escape-hatch" ? "F21: backdrop-click OR page-nav escape" : void 0
-    };
-    t.current = [
-      ...t.current.slice(-99),
-      o
-    ];
-  }, [e.lastClose]);
-  const l = f(
-    () => y(e),
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [e.activePanelId]
-  ), s = v(() => t.current.slice(), []);
-  return { state: e, surfaceState: l, dispatch: n, getCloseLog: s };
-}
-function k({ children: e }) {
-  const n = N(), t = f(
-    () => n,
-    // Re-publish only when one of the four coordinator fields changes identity.
-    // dispatch + getCloseLog are stable. state + surfaceState change on dispatch.
-    [n.state, n.surfaceState, n.dispatch, n.getCloseLog]
-  );
-  return /* @__PURE__ */ a(c.Provider, { value: t, children: e });
-}
-const x = {
-  position: "relative",
-  pointerEvents: "auto"
-};
-function L({ children: e, onClose: n, isOpen: t = !0 }) {
-  return /* @__PURE__ */ u(
-    "div",
-    {
-      "data-chrome": "panel",
-      "data-open": t ? "true" : "false",
-      role: "dialog",
-      "aria-modal": "true",
-      className: "gloss-panel-chrome",
-      style: x,
-      children: [
-        /* @__PURE__ */ a("div", { className: "gloss-panel-chrome__header", children: /* @__PURE__ */ a(
-          "button",
-          {
-            id: "panel-close",
-            type: "button",
-            "aria-label": "Close panel",
-            className: "gloss-panel-chrome__close",
-            onClick: n,
-            children: "×"
-          }
-        ) }),
-        /* @__PURE__ */ a("div", { className: "gloss-panel-chrome__body", children: e })
-      ]
-    }
-  );
-}
-const b = {
-  position: "fixed",
-  top: 0,
-  left: 0,
-  right: 0,
-  height: "var(--tb-h, 60px)",
-  perspective: "1200px",
-  perspectiveOrigin: "center bottom",
-  overflow: "visible",
-  pointerEvents: "none",
-  zIndex: 55
-}, w = {
-  position: "fixed",
-  top: "var(--tb-h, 60px)",
-  left: 0,
-  right: 0,
-  bottom: 0,
-  zIndex: 1,
-  pointerEvents: "auto",
-  background: "rgba(0, 0, 0, 0.04)"
-};
-function H({ panelComponents: e }) {
-  const { state: n, dispatch: t, getCloseLog: l } = m(), s = n.activePanelId ? e[n.activePanelId] : null;
-  n.activePanelId && !s && process.env.NODE_ENV !== "production" && console.error(
-    "[panels] No panel component registered for activePanelId:",
-    n.activePanelId
-  ), r(() => {
-    if (n.activePanelId == null) return;
-    function d(P) {
-      P.key === "Escape" && t({ type: "CLOSE_PANEL", reason: "escape-key" });
-    }
-    return document.addEventListener("keydown", d), () => {
-      document.removeEventListener("keydown", d);
-    };
-  }, [n.activePanelId, t]);
-  const o = i(n);
-  C(() => {
-    o.current = n;
-  }), r(() => {
-    if (process.env.NODE_ENV !== "production")
-      return window.__panelsHostHandle = {
-        dispatch: t,
-        getState: () => o.current,
-        getCloseLog: l
-      }, () => {
-        delete window.__panelsHostHandle;
-      };
-  }, [t, l]);
-  const E = v(() => {
-    t({ type: "CLOSE_PANEL", reason: "nav-escape-hatch" });
-  }, [t]);
-  return /* @__PURE__ */ a("div", { "data-panel-host": "true", style: b, children: n.activePanelId != null && s != null && /* @__PURE__ */ u(I, { children: [
-    /* @__PURE__ */ a(
-      "div",
-      {
-        "data-panel-scrim": "true",
-        style: w,
-        onClick: E
-      }
-    ),
-    /* @__PURE__ */ a(
-      L,
-      {
-        isOpen: !0,
-        onClose: () => t({ type: "CLOSE_PANEL", reason: "header-x" }),
-        children: /* @__PURE__ */ a(s, { isOpen: !0 })
-      }
-    )
-  ] }) });
-}
-const R = {
-  "apply-button": !0,
-  // the ONLY commit reason
-  "cancel-button": !1,
-  "header-x": !1,
-  "escape-key": !1,
-  "page-nav": !1,
-  "mutex-handoff": !1,
-  "ghost-anchor": !1,
-  "viewport-collapse": !1,
-  unmount: !1,
-  "nav-escape-hatch": !1
-};
-export {
-  R as C,
-  k as P,
-  O as a,
-  H as b,
-  L as c,
-  N as d,
-  y as e,
-  S as i,
-  _ as r,
-  m as u
-};