@mt-gloss/ui 0.1.80 → 0.1.82

package/internals.js

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

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

@@ -34,5 +34,18 @@ export interface SectionDotsProps {
     currentSection?: number;
     /** Phase 12 D-09 — how many sections fit in viewport at once. Default 1 (preserves v2.0 model). */
     sectionsPerView?: number;
+    /**
+     * Quick task 260510-nav T4 (D5 = fade_only). Additive opt-in: when `true`,
+     * the primitive skips its auto-hide early-return at lines 67-69 and renders
+     * with `data-hiding="true"` on the tablist root. SCSS animates opacity to
+     * 0 over 200ms. The CONSUMER drives mount/unmount lifecycle via the
+     * `useDelayedUnmount(shouldHide, 200)` hook in reptime — when shouldHide
+     * flips true → consumer sets isHiding=true immediately; 200ms later the
+     * consumer unmounts SectionDots entirely (this prop becomes irrelevant).
+     * Omitting this prop preserves the Phase 12 NAV-02/03 instant-hide
+     * behavior exactly (back-compat parity contract).
+     */
+    isHiding?: boolean;
 }
-export declare function SectionDots({ count, currentIndex, onSelect, 'aria-label': ariaLabel, provisionalIndex, pulseIndex, pulseNonce, currentSection, sectionsPerView, }: SectionDotsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SectionDots({ count, currentIndex, onSelect, 'aria-label': ariaLabel, provisionalIndex, pulseIndex, pulseNonce, currentSection, sectionsPerView, // D-09 default
+isHiding, }: SectionDotsProps): import("react/jsx-runtime").JSX.Element | null;

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/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/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,21 @@
+/**
+ * @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 { PanelChrome } from './PanelChrome';
+export type { PanelHostProps, PanelShellProps } from './PanelHost';
+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.80",
+  "version": "0.1.82",
   "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": [