@mt-gloss/ui 0.1.81 → 0.1.83

package/COMMITS-or4m2o8k.js

@@ -0,0 +1,219 @@
+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
+};

package/composites-panels.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Composites/panels entry point — flat-root mirror for the subpath export
+ * '@mt-gloss/ui/composites/panels'.
+ *
+ * Mirrors the catalog.ts / internals.ts shape so that vite emits
+ * `dist/libs/gloss-ui/composites-panels.{js,d.ts}` at the package root,
+ * matching the package.json exports map (F12).
+ *
+ * Usage:
+ *   import { PanelProvider, PanelHost } from '@mt-gloss/ui/composites/panels';
+ */
+export * from './lib/composites/panels/index';

package/composites-panels.js

@@ -0,0 +1,82 @@
+import { u as c, a as u, c as d } from "./COMMITS-or4m2o8k.js";
+import { C as L, b as O, P as _, e as k, i as N, r as w, d as g } from "./COMMITS-or4m2o8k.js";
+import { jsx as r } from "react/jsx-runtime";
+import { useEffect as l, useRef as p, useLayoutEffect as f, useCallback as P } from "react";
+const v = {
+  position: "fixed",
+  inset: 0,
+  pointerEvents: "none",
+  zIndex: 55
+}, E = {
+  position: "absolute",
+  inset: 0,
+  zIndex: 1,
+  pointerEvents: "auto",
+  background: "rgba(0, 0, 0, 0.04)"
+};
+function S() {
+  const { state: n, dispatch: e, getCloseLog: t } = c();
+  l(() => {
+    if (n.activePanelId == null) return;
+    function s(i) {
+      i.key === "Escape" && e({ type: "CLOSE_PANEL", reason: "escape-key" });
+    }
+    return document.addEventListener("keydown", s), () => document.removeEventListener("keydown", s);
+  }, [n.activePanelId, e]);
+  const o = p(n);
+  f(() => {
+    o.current = n;
+  }), l(() => {
+    if (process.env.NODE_ENV !== "production")
+      return window.__panelsHostHandle = {
+        dispatch: e,
+        getState: () => o.current,
+        getCloseLog: t
+      }, () => {
+        delete window.__panelsHostHandle;
+      };
+  }, [e, t]);
+  const a = P(() => {
+    e({ type: "CLOSE_PANEL", reason: "nav-escape-hatch" });
+  }, [e]);
+  return /* @__PURE__ */ r("div", { "data-panel-host": "true", style: v, children: n.activePanelId != null && /* @__PURE__ */ r(
+    "div",
+    {
+      "data-panel-scrim": "true",
+      style: E,
+      onClick: a
+    }
+  ) });
+}
+function h({ panelComponents: n }) {
+  const e = u();
+  if (e == null) return null;
+  const { state: t, dispatch: o } = e;
+  if (t.activePanelId == null) return null;
+  const a = n[t.activePanelId];
+  return a == null ? (process.env.NODE_ENV !== "production" && console.error(
+    "[panels] No panel component registered for activePanelId:",
+    t.activePanelId
+  ), null) : /* @__PURE__ */ r(
+    d,
+    {
+      isOpen: !0,
+      onClose: () => o({ type: "CLOSE_PANEL", reason: "header-x" }),
+      children: /* @__PURE__ */ r(a, { isOpen: !0 })
+    }
+  );
+}
+export {
+  L as COMMITS,
+  d as PanelChrome,
+  O as PanelHost,
+  S as PanelHostShell,
+  _ as PanelProvider,
+  h as PanelSlot,
+  k as deriveSurfaceState,
+  N as initialState,
+  w as reducer,
+  c as usePanelContext,
+  u as usePanelContextOptional,
+  g as usePanelCoordinator
+};

package/index.d.ts

@@ -366,3 +366,5 @@ export { UIContext, UIContextProvider, useUIContext, ContainerCard, ContainerCar
 export type { UIContextValue, UIRegion, UIDensity, UIContextProviderProps, ContainerCardProps, ContainerCardVariant, ContainerDialogProps, ContainerDialogHeaderProps, ContainerDialogBodyProps, ContainerDialogActionsProps, ContainerPanelProps, ContainerToolbarProps, ContainerFormSectionProps, ContainerTableProps, } from './lib/containers';
 export { mergeRefs, mergeHandlers, Actionable, Selectable, Dismissible, Sortable, Expandable, } from './lib/wrappers';
 export type { ActionableProps, SelectableProps, DismissibleProps, SortableProps, ExpandableProps, } from './lib/wrappers';
+export { PanelProvider, usePanelContext, usePanelContextOptional, PanelHost, PanelChrome, usePanelCoordinator, reducer as panelsReducer, initialState as panelsInitialState, deriveSurfaceState as panelsDeriveSurfaceState, COMMITS as PANEL_COMMITS, } from './lib/composites/panels';
+export type { PanelProviderProps, PanelHostProps, PanelChromeProps, PanelShellProps, UsePanelCoordinatorReturn, PanelId, PanelState, PanelAction, CloseReason, SurfaceState, TriggerContext, SideEffect, CloseLogEntry, LockHint, } from './lib/composites/panels';

package/index.js

@@ -6,8 +6,9 @@ import F, { useRef as P, useEffect as A, useState as E, useCallback as C, useId
 import { motion as G, useMotionValue as tt, AnimatePresence as at, useDragControls as nt } from "framer-motion";
 import { B as rt, a as X, b as ce, U as fe } from "./UIContext-DP6JGCto.js";
 import { c as Wo, u as Vo } from "./UIContext-DP6JGCto.js";
+import { C as Uo, c as Yo, b as Zo, P as qo, e as Qo, i as Xo, r as Jo, u as el, a as tl, d as al } from "./COMMITS-or4m2o8k.js";
 import { createPortal as st } from "react-dom";
-import { DEFAULT_MARKET_PRESETS as Uo, DEFAULT_PINNED as Yo, PERIOD_OPTIONS as Zo, ROLLING_OPTIONS as qo, TODAY_PRESET as Qo, findPreset as Xo, formatDateRange as Jo, formatMarketDates as el, formatTrend as tl, formatValue as al, generateMarketId as nl, getAllPresets as rl, getDateRangeForPreset as sl, getPresetLabel as il, isInRange as ol, isMarketActive as ll, isSameDay as cl, normalizePresetId as dl, toUppercasePresetId as ul } from "@mt-gloss/utils";
+import { DEFAULT_MARKET_PRESETS as rl, DEFAULT_PINNED as sl, PERIOD_OPTIONS as il, ROLLING_OPTIONS as ol, TODAY_PRESET as ll, findPreset as cl, formatDateRange as dl, formatMarketDates as ul, formatTrend as ml, formatValue as gl, generateMarketId as pl, getAllPresets as hl, getDateRangeForPreset as fl, getPresetLabel as bl, isInRange as vl, isMarketActive as yl, isSameDay as wl, normalizePresetId as _l, toUppercasePresetId as Cl } from "@mt-gloss/utils";
 import it from "@mui/icons-material/AccessTime";
 import ot from "@mui/icons-material/Tune";
 import lt from "@mui/icons-material/ViewColumn";
@@ -4686,9 +4687,9 @@ export {
   hs as CreditCardForm,
   fs as DEFAULT_FOOTER_IDS,
   U as DEFAULT_GRID_INTERACTION_PHYSICS,
-  Uo as DEFAULT_MARKET_PRESETS,
+  rl as DEFAULT_MARKET_PRESETS,
   bs as DEFAULT_OVERFLOW_IDS,
-  Yo as DEFAULT_PINNED,
+  sl as DEFAULT_PINNED,
   _t as DEFAULT_RESIZE_PHYSICS,
   Ie as DEFAULT_RESIZE_PILL_PHYSICS,
   vs as DataTable,
@@ -4760,11 +4761,15 @@ export {
   mi as NumberInput,
   gi as ObjectArrow,
   pi as OrderFilterBar,
-  Zo as PERIOD_OPTIONS,
+  Uo as PANEL_COMMITS,
+  il as PERIOD_OPTIONS,
   or as PaceCard,
   lr as PaceTilePreview,
   Et as PageChip,
   Oe as PageDropdown,
+  Yo as PanelChrome,
+  Zo as PanelHost,
+  qo as PanelProvider,
   hi as PasswordInput,
   fi as PaymentForm,
   bi as PaymentMethodSelect,
@@ -4775,7 +4780,7 @@ export {
   _i as ProgressCard,
   Ci as QuickConfigPanel,
   Bt as RECONFIG_BACKSIDE_LABELS,
-  qo as ROLLING_OPTIONS,
+  ol as ROLLING_OPTIONS,
   Ni as Radio,
   Si as RadioGroup,
   ki as RangeSlider,
@@ -4824,7 +4829,7 @@ export {
   yt as StatusSlotChipMenu,
   Ui as Stepper,
   De as SwingReveal,
-  Qo as TODAY_PRESET,
+  ll as TODAY_PRESET,
   V as TUNING_DEFAULTS,
   Be as TUNING_STORAGE_KEY,
   Yi as TabGroup,
@@ -4879,26 +4884,26 @@ export {
   Tt as errorFixture,
   yo as evaluateTintCondition,
   Rn as filteredState,
-  Xo as findPreset,
-  Jo as formatDateRange,
-  el as formatMarketDates,
-  tl as formatTrend,
-  al as formatValue,
+  cl as findPreset,
+  dl as formatDateRange,
+  ul as formatMarketDates,
+  ml as formatTrend,
+  gl as formatValue,
   Hn as fullLayout,
-  nl as generateMarketId,
+  pl as generateMarketId,
   wo as generateTabId,
-  rl as getAllPresets,
-  sl as getDateRangeForPreset,
+  hl as getAllPresets,
+  fl as getDateRangeForPreset,
   _o as getMenuActions,
   Ke as getMotionMode,
-  il as getPresetLabel,
+  bl as getPresetLabel,
   Co as getTransitionStyle,
   Bn as gridCards,
   cr as gridChannels,
   No as interpolate,
-  ol as isInRange,
-  ll as isMarketActive,
-  cl as isSameDay,
+  vl as isInRange,
+  yl as isMarketActive,
+  wl as isSameDay,
   Tn as itemColumns,
   Dn as itemRows,
   xt as loadingFixture,
@@ -4910,7 +4915,7 @@ export {
   xo as mergeRefs,
   sn as metricTabGroup,
   Vn as mixedTabs,
-  dl as normalizePresetId,
+  _l as normalizePresetId,
   zt as numericActions,
   xn as orderColumns,
   $t as orderIdActions,
@@ -4918,6 +4923,9 @@ export {
   Wn as ordersTabs,
   Me as paletteHex,
   j as paletteVars,
+  Qo as panelsDeriveSurfaceState,
+  Xo as panelsInitialState,
+  Jo as panelsReducer,
   To as parseNumericValue,
   Ro as paymentFormMetadata,
   Mo as paymentSchema,
@@ -4950,7 +4958,7 @@ export {
   gn as tableSamples,
   dn as textSamples,
   ln as timeFrameTabGroup,
-  ul as toUppercasePresetId,
+  Cl as toUppercasePresetId,
   Ze as useAffordanceVisibility,
   nn as useArrowNavigation,
   Ao as useCheckboxGroupContext,
@@ -4962,6 +4970,9 @@ export {
   zo as useFocusTrap,
   Bo as useFormContext,
   Ko as useGestureState,
+  el as usePanelContext,
+  tl as usePanelContextOptional,
+  al as usePanelCoordinator,
   Go as useRadioGroupContext,
   yr as useResizeChoreography,
   fn as useResizePill,

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

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+export interface PanelChromeProps {
+    children: ReactNode;
+    onClose: () => void;
+    isOpen?: boolean;
+}
+export declare function PanelChrome({ children, onClose, isOpen }: PanelChromeProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,19 @@
+import { ComponentType } from 'react';
+import { PanelId } from './coordinator/types';
+/**
+ * Shape contract for panel shell components (F10).
+ * Receives `isOpen` so future plans may always-mount panels and rely on this
+ * prop for animation gating; P1 mounts only the active panel.
+ */
+export interface PanelShellProps {
+    isOpen: boolean;
+}
+export interface PanelHostProps {
+    /**
+     * Map of PanelId → shell component. Only the active panel mounts in P1.
+     * F8 — callers SHOULD declare this at module scope as a `const` for
+     *      referential stability.
+     */
+    panelComponents: Partial<Record<PanelId, ComponentType<PanelShellProps>>>;
+}
+export declare function PanelHost({ panelComponents }: PanelHostProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1 @@
+export declare function PanelHostShell(): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+export interface PanelProviderProps {
+    children: ReactNode;
+}
+export declare function PanelProvider({ children }: PanelProviderProps): import("react/jsx-runtime").JSX.Element;
+export { usePanelContext, usePanelContextOptional } from './hooks/usePanelContext';

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

@@ -0,0 +1,7 @@
+import { ComponentType } from 'react';
+import { PanelId } from './coordinator/types';
+import { PanelShellProps } from './PanelHost';
+export interface PanelSlotProps {
+    panelComponents: Partial<Record<PanelId, ComponentType<PanelShellProps>>>;
+}
+export declare function PanelSlot({ panelComponents }: PanelSlotProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,2 @@
+import { CloseReason } from './types';
+export declare const COMMITS: Record<CloseReason, boolean>;

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

@@ -0,0 +1,3 @@
+import { PanelAction, PanelState } from './types';
+export declare const initialState: PanelState;
+export declare function reducer(state: PanelState, action: PanelAction): PanelState;

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

@@ -0,0 +1,2 @@
+import { PanelState, SurfaceState } from './types';
+export declare function deriveSurfaceState(state: PanelState): SurfaceState;

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

@@ -0,0 +1,84 @@
+/**
+ * Panel system — type contract.
+ *
+ * Authority: `.planning/spikes/toolbar/panels/SPIKE-DELIVERABLES.md` §1.2 (PanelId),
+ * §1.3 (SurfaceState), §1.10/§1.15 (CloseReason taxonomy), §1.17 (TriggerContext).
+ *
+ * P1 reach: reducer only OPENs/CLOSEs `'notification-center'`; other PanelIds are
+ * present in the union but emit INVALID_DISPATCH per F15 branch 3. Surface-state
+ * derivation in P1 reaches `'idle'` + `'notif-center'` only; other branches return
+ * `'idle'` with a TODO until P2 extends the reducer to full 7-state.
+ *
+ * Plan refs:
+ *   F1 — exhaustive types ship Day 1
+ *   F4 — `lastClose` carries `{ panelId, reason }` so closeLog pump can append
+ *   F6 — `SCHEDULE_TIMER` is a SideEffect, NOT a PanelAction (external callers
+ *        cannot dispatch it). Only `OPEN_PANEL | CLOSE_PANEL | DRAIN_SIDE_EFFECTS`
+ *        are dispatchable.
+ *   F9 + F21 — `NAV_ESCAPE_HATCH` carries dual P1 meaning: backdrop-click AND
+ *              page-nav escape; spike enum has no `BACKDROP_CLICK` literal.
+ */
+export type PanelId = 'settings' | 'catalog-add' | 'catalog-replace' | 'page-management' | 'notification-center';
+export type CloseReason = 'cancel-button' | 'apply-button' | 'header-x' | 'escape-key' | 'page-nav' | 'mutex-handoff' | 'ghost-anchor' | 'viewport-collapse' | 'unmount' | 'nav-escape-hatch';
+export type SurfaceState = 'idle' | 'bell-cutout-only' | 'panel-clean' | 'panel-dirty' | 'panel-clean+cutout' | 'panel-dirty+cutout' | 'notif-center';
+export type TriggerContext = {
+    kind: 'bell';
+} | {
+    kind: 'card-overflow';
+    cardId: string;
+    sectionIndex: number;
+    action: 'configure' | 'replace';
+} | {
+    kind: 'empty-cell';
+    sectionIndex: number;
+    cellPosition: {
+        row: number;
+        col: number;
+    };
+} | {
+    kind: 'manage-pages-action';
+    global: true;
+    align: 'left';
+};
+export interface CloseLogEntry {
+    panelId: PanelId;
+    reason: CloseReason;
+    at: number;
+    /**
+     * 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.
+     */
+    note?: string;
+}
+export type SideEffect = {
+    type: 'SCHEDULE_TIMER';
+    ms: number;
+    action: PanelAction;
+} | {
+    type: 'INVALID_DISPATCH';
+    reason: string;
+};
+export interface PanelState {
+    activePanelId: PanelId | null;
+    lastClose: {
+        panelId: PanelId;
+        reason: CloseReason;
+    } | null;
+    pendingSideEffects: SideEffect[];
+}
+export type PanelAction = {
+    type: 'OPEN_PANEL';
+    panelId: PanelId;
+    trigger: TriggerContext;
+} | {
+    type: 'CLOSE_PANEL';
+    reason: CloseReason;
+} | {
+    type: 'DRAIN_SIDE_EFFECTS';
+};
+export interface LockHint {
+    blockedTrigger: TriggerContext;
+    activeCardId: string | null;
+    expiresAt: number;
+}

package/lib/composites/panels/hooks/usePanelContext.d.ts

@@ -0,0 +1,4 @@
+import { UsePanelCoordinatorReturn } from './usePanelCoordinator';
+export declare const PanelContext: import('react').Context<UsePanelCoordinatorReturn | null>;
+export declare function usePanelContext(): UsePanelCoordinatorReturn;
+export declare function usePanelContextOptional(): UsePanelCoordinatorReturn | null;

package/lib/composites/panels/hooks/usePanelCoordinator.d.ts

@@ -0,0 +1,8 @@
+import { CloseLogEntry, PanelAction, PanelState, SurfaceState } from '../coordinator/types';
+export interface UsePanelCoordinatorReturn {
+    state: PanelState;
+    surfaceState: SurfaceState;
+    dispatch: React.Dispatch<PanelAction>;
+    getCloseLog: () => CloseLogEntry[];
+}
+export declare function usePanelCoordinator(): UsePanelCoordinatorReturn;

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

@@ -0,0 +1,24 @@
+/**
+ * @mt-gloss/ui/composites/panels — panel-system foundation.
+ *
+ * Consumers (reptime-cloud P1) import:
+ *   import { PanelProvider, PanelHost } from '@mt-gloss/ui/composites/panels';
+ *
+ * Subpath export wired in package.json (F12); flat package-root artifact
+ * `composites-panels.js` matching existing `internals` + `catalog` pattern.
+ */
+export { PanelProvider, usePanelContext, usePanelContextOptional } from './PanelProvider';
+export { PanelHost } from './PanelHost';
+export { PanelHostShell } from './PanelHostShell';
+export { PanelSlot } from './PanelSlot';
+export { PanelChrome } from './PanelChrome';
+export type { PanelHostProps, PanelShellProps } from './PanelHost';
+export type { PanelSlotProps } from './PanelSlot';
+export type { PanelProviderProps } from './PanelProvider';
+export type { PanelChromeProps } from './PanelChrome';
+export { usePanelCoordinator } from './hooks/usePanelCoordinator';
+export type { UsePanelCoordinatorReturn } from './hooks/usePanelCoordinator';
+export { reducer, initialState } from './coordinator/coordinator';
+export { deriveSurfaceState } from './coordinator/deriveSurfaceState';
+export { COMMITS } from './coordinator/COMMITS';
+export type { PanelId, PanelState, PanelAction, CloseReason, SurfaceState, TriggerContext, SideEffect, CloseLogEntry, LockHint, } from './coordinator/types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mt-gloss/ui",
-  "version": "0.1.81",
+  "version": "0.1.83",
   "type": "module",
   "publishConfig": {
     "access": "restricted"
@@ -38,6 +38,17 @@
       },
       "default": "./catalog.js"
     },
+    "./composites/panels": {
+      "import": {
+        "types": "./composites-panels.d.ts",
+        "default": "./composites-panels.js"
+      },
+      "require": {
+        "types": "./composites-panels.d.ts",
+        "default": "./composites-panels.js"
+      },
+      "default": "./composites-panels.js"
+    },
     "./styles.css": "./ui.css"
   },
   "files": [