@mt-gloss/ui 0.1.94 → 0.1.96

package/index.js

@@ -6,7 +6,7 @@ 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-DAem0P4s.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-By42AA8m.js";
 import { createPortal as st } from "react-dom";
 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";

package/lib/composites/panels/asserter/domWalkAsserter.d.ts

@@ -0,0 +1,17 @@
+import { AssertReport } from '../orchestrator/transitionToPanel';
+export type { AssertReport };
+/**
+ * Pure DOM-walk — exported separately for tests + external callers that want a
+ * one-shot probe without flipping the global flag.
+ */
+export declare function assertPanelDomShape(): AssertReport;
+/**
+ * Enable the Q12-12 asserter. First call assigns `window.__panelsAsserter`
+ * (only on first enable — avoids repeated reassignment per Rule 29).
+ */
+export declare function enablePanelAsserter(): void;
+/**
+ * Disable the asserter. Keeps `lastReport` accessible (test 8 invariant) and
+ * keeps the window surface attached so future enable() calls don't reassign.
+ */
+export declare function disablePanelAsserter(): void;

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

@@ -0,0 +1,8 @@
+export declare const PANEL_IDS: {
+    readonly SETTINGS: "settings";
+    readonly CATALOG_ADD: "catalog-add";
+    readonly CATALOG_REPLACE: "catalog-replace";
+    readonly PAGE_MGMT: "page-management";
+    readonly NOTIFICATION_CENTER: "notification-center";
+};
+export type PanelIdKey = keyof typeof PANEL_IDS;

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

@@ -0,0 +1,2 @@
+import { PanelId, TriggerContext } from '../coordinator/types';
+export declare function useTransitionToPanel(): (panelId: PanelId, trigger: TriggerContext) => void;

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

@@ -9,6 +9,22 @@
  */
 export { PanelProvider, usePanelContext, usePanelContextOptional } from './PanelProvider';
 export { SettingsShell } from './shells/SettingsShell';
+export { CatalogAddShell } from './shells/CatalogAddShell';
+export type { CatalogAddShellProps } from './shells/CatalogAddShell';
+export { CatalogReplaceShell } from './shells/CatalogReplaceShell';
+export type { CatalogReplaceShellProps } from './shells/CatalogReplaceShell';
+export { PageMgmtShell } from './shells/PageMgmtShell';
+export type { PageMgmtShellProps } from './shells/PageMgmtShell';
+export { CatalogFooter, CatalogStateContext, useCatalogState, } from './shells/internals/CatalogFooter';
+export type { CatalogFooterMode, CatalogState, CatalogFooterProps, } from './shells/internals/CatalogFooter';
+export { PageMgmtFooter, PageMgmtStateContext, usePageMgmtState, } from './shells/internals/PageMgmtFooter';
+export type { PageMgmtState, PageMgmtFooterProps, } from './shells/internals/PageMgmtFooter';
+export type { CatalogTile } from './shells/internals/catalog-mocks';
+export { MOCK_LENSES, MOCK_DEFAULT_LENS, MOCK_TILES_BY_LENS, } from './shells/internals/catalog-mocks';
+export type { PageEntry } from './shells/internals/page-mgmt-mocks';
+export { MOCK_PAGES } from './shells/internals/page-mgmt-mocks';
+export { PANEL_IDS } from './coordinator/PANEL_IDS';
+export type { PanelIdKey } from './coordinator/PANEL_IDS';
 export { PanelHost } from './PanelHost';
 export { PanelHostShell } from './PanelHostShell';
 export { PanelSlot } from './PanelSlot';
@@ -21,6 +37,15 @@ export { positionKey } from './utils/positionKey';
 export { useReducedMotionPanel } from './hooks/useReducedMotionPanel';
 export { PanelMount } from './PanelMount';
 export type { PanelMountProps } from './PanelMount';
+export { transitionToPanel } from './orchestrator/transitionToPanel';
+export type { TransitionToPanelArgs, AssertReport } from './orchestrator/transitionToPanel';
+export { useTransitionToPanel } from './hooks/useTransitionToPanel';
+export { CloneStage } from './stage3d/CloneStage';
+export type { CloneStageProps } from './stage3d/CloneStage';
+export { CloneCard } from './stage3d/CloneCard';
+export type { CloneCardProps } from './stage3d/CloneCard';
+export { enablePanelAsserter, disablePanelAsserter, assertPanelDomShape, } from './asserter/domWalkAsserter';
+export type { SettingsShellProps } from './shells/SettingsShell';
 export { usePanelCoordinator } from './hooks/usePanelCoordinator';
 export type { UsePanelCoordinatorReturn } from './hooks/usePanelCoordinator';
 export { reducer, initialState } from './coordinator/coordinator';

package/lib/composites/panels/orchestrator/transitionToPanel.d.ts

@@ -0,0 +1,21 @@
+import { PanelAction, PanelId, PanelState, TriggerContext } from '../coordinator/types';
+export interface AssertReport {
+    valid?: boolean;
+    mount?: 'present' | 'absent';
+    chrome?: 'present' | 'absent';
+    frozen?: 'cleaned' | 'lingering';
+    orphans?: string[];
+    branch?: string;
+    timestamp?: number;
+}
+export interface TransitionToPanelArgs {
+    panelId: PanelId;
+    trigger: TriggerContext;
+    state: PanelState;
+    dispatch: (action: PanelAction) => void;
+    mountEl: HTMLElement | null;
+    chromeEl: HTMLElement | null;
+    reducedMotion: boolean;
+    onAssert?: (report: AssertReport) => void;
+}
+export declare function transitionToPanel(args: TransitionToPanelArgs): void;

package/lib/composites/panels/shells/CatalogAddShell.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { PanelShellProps } from '../PanelHost';
+import { CatalogTile } from './internals/catalog-mocks';
+export interface CatalogAddShellProps extends PanelShellProps {
+    /** Available lenses; defaults to MOCK_LENSES (spike §6.2.5). */
+    lenses?: readonly string[];
+    /** Initial active lens; defaults to MOCK_DEFAULT_LENS ('Order flow'). */
+    defaultLens?: string;
+    /** Tile catalog keyed by lens; defaults to MOCK_TILES_BY_LENS. */
+    tilesByLens?: Readonly<Record<string, readonly CatalogTile[]>>;
+    /**
+     * Optional footer slot rendered as a SIBLING of the body, INSIDE the shell's
+     * CatalogStateContext.Provider. PanelSlot passes <CatalogFooter/> here so it
+     * can read live selectedTileId/description from this shell instance.
+     * Standalone tests (no PanelSlot) leave undefined → no footer.
+     */
+    footerSlot?: ReactNode;
+}
+export declare function CatalogAddShell({ isOpen, lenses, defaultLens, tilesByLens, footerSlot, }: CatalogAddShellProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/CatalogReplaceShell.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+import { PanelShellProps } from '../PanelHost';
+import { CatalogTile } from './internals/catalog-mocks';
+export interface CatalogReplaceShellProps extends PanelShellProps {
+    /** Label of the card being replaced; rendered as 'replacing {label}' subtitle. */
+    replacingLabel?: string;
+    lenses?: readonly string[];
+    defaultLens?: string;
+    tilesByLens?: Readonly<Record<string, readonly CatalogTile[]>>;
+    /** See CatalogAddShellProps.footerSlot — sibling slot inside Provider. */
+    footerSlot?: ReactNode;
+}
+export declare function CatalogReplaceShell({ isOpen, replacingLabel, lenses, defaultLens, tilesByLens, footerSlot, }: CatalogReplaceShellProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/PageMgmtShell.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+import { PanelShellProps } from '../PanelHost';
+import { PageEntry } from './internals/page-mgmt-mocks';
+export interface PageMgmtShellProps extends PanelShellProps {
+    /** Initial page list; defaults to MOCK_PAGES (§6.4.3 verbatim). */
+    pages?: readonly PageEntry[];
+    /** See CatalogAddShellProps.footerSlot — sibling slot inside Provider. */
+    footerSlot?: ReactNode;
+}
+export declare function PageMgmtShell({ isOpen, pages: initialPages, footerSlot, }: PageMgmtShellProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/SettingsShell.d.ts

@@ -1,2 +1,10 @@
 import { PanelShellProps } from '../PanelHost';
-export declare function SettingsShell({ isOpen }: PanelShellProps): import("react/jsx-runtime").JSX.Element;
+export interface SettingsShellProps extends PanelShellProps {
+    /** Span of the source card (1|2|3). Plumbed by V2FeedbackSurface HOF. */
+    cardSpan?: 1 | 2 | 3;
+    /** Visible label on the clone card. Defaults to 'Metric'. */
+    cardLabel?: string;
+    /** Visible value on the clone card. Defaults to '—'. */
+    cardValue?: string;
+}
+export declare function SettingsShell({ isOpen, cardSpan, cardLabel, cardValue, }: SettingsShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -2,3 +2,18 @@
  * Panel shells barrel — all shells available from '@mt-gloss/ui/composites/panels'.
  */
 export { SettingsShell } from './SettingsShell';
+export type { SettingsShellProps } from './SettingsShell';
+export { CatalogAddShell } from './CatalogAddShell';
+export type { CatalogAddShellProps } from './CatalogAddShell';
+export { CatalogReplaceShell } from './CatalogReplaceShell';
+export type { CatalogReplaceShellProps } from './CatalogReplaceShell';
+export { PageMgmtShell } from './PageMgmtShell';
+export type { PageMgmtShellProps } from './PageMgmtShell';
+export { PageMgmtFooter, PageMgmtStateContext, usePageMgmtState } from './internals/PageMgmtFooter';
+export type { PageMgmtState, PageMgmtFooterProps } from './internals/PageMgmtFooter';
+export { MOCK_PAGES } from './internals/page-mgmt-mocks';
+export type { PageEntry } from './internals/page-mgmt-mocks';
+export { CatalogFooter, CatalogStateContext, useCatalogState } from './internals/CatalogFooter';
+export type { CatalogFooterMode, CatalogState, CatalogFooterProps } from './internals/CatalogFooter';
+export type { CatalogTile } from './internals/catalog-mocks';
+export { MOCK_LENSES, MOCK_DEFAULT_LENS, MOCK_TILES_BY_LENS } from './internals/catalog-mocks';

package/lib/composites/panels/shells/internals/CatalogFooter.d.ts

@@ -0,0 +1,18 @@
+import { PanelAction } from '../../coordinator/types';
+export type CatalogFooterMode = 'add' | 'replace';
+export interface CatalogState {
+    mode: CatalogFooterMode;
+    selectedTileId: string | null;
+    description: string | null;
+}
+export declare const CatalogStateContext: import('react').Context<CatalogState | null>;
+export declare function useCatalogState(): CatalogState | null;
+export interface CatalogFooterProps {
+    /**
+     * Override mode if needed (rare — usually the context's `mode` wins). PanelSlot
+     * passes mode explicitly for safety when no context Provider is mounted.
+     */
+    mode?: CatalogFooterMode;
+    dispatch: (action: PanelAction) => void;
+}
+export declare function CatalogFooter({ mode, dispatch }: CatalogFooterProps): import("react/jsx-runtime").JSX.Element | null;

package/lib/composites/panels/shells/internals/CatalogLensPicker.d.ts

@@ -0,0 +1,6 @@
+export interface CatalogLensPickerProps {
+    lenses: readonly string[];
+    activeLens: string;
+    onLensChange: (lens: string) => void;
+}
+export declare function CatalogLensPicker({ lenses, activeLens, onLensChange }: CatalogLensPickerProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/internals/CatalogTileGrid.d.ts

@@ -0,0 +1,17 @@
+import { CatalogTile } from './catalog-mocks';
+export interface CatalogTileGridProps {
+    tiles: readonly CatalogTile[];
+    selectedTileId: string | null;
+    onSelectTile: (id: string, desc: string) => void;
+}
+/**
+ * §6.2.8 — stack-tile value renderer. Splits a "LABEL N · LABEL N · LABEL N"
+ * (or "N today · N MTD · …") value string into per-segment React nodes.
+ * Each segment becomes `<span><strong>{num}</strong><small>{lbl}</small></span>`
+ * with the numeric token first (W2-G6 enforces strong+small+split present).
+ *
+ * The regex captures the leading numeric/currency/percent token; the remainder
+ * is the label. If the segment has no number, the whole text falls into <small>.
+ */
+export declare function renderStackValue(val: string): import("react/jsx-runtime").JSX.Element[];
+export declare function CatalogTileGrid({ tiles, selectedTileId, onSelectTile }: CatalogTileGridProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/internals/PageMgmtFooter.d.ts

@@ -0,0 +1,16 @@
+import { PageEntry } from './page-mgmt-mocks';
+export interface PageMgmtState {
+    pages: PageEntry[];
+    setPages: (updater: (prev: PageEntry[]) => PageEntry[]) => void;
+}
+export declare const PageMgmtStateContext: import('react').Context<PageMgmtState | null>;
+export declare function usePageMgmtState(): PageMgmtState | null;
+export interface PageMgmtFooterProps {
+    /**
+     * Optional dispatch — unused by footer per §6.4.6 (live-commit; no CLOSE_PANEL).
+     * Kept on the prop signature so PanelSlot can pass it uniformly with other
+     * footers without TS errors.
+     */
+    dispatch?: unknown;
+}
+export declare function PageMgmtFooter(_?: PageMgmtFooterProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/internals/PageMgmtRow.d.ts

@@ -0,0 +1,8 @@
+import { PageEntry } from './page-mgmt-mocks';
+export interface PageMgmtRowProps {
+    page: PageEntry;
+    onRename?: (id: string) => void;
+    onKebab?: (id: string) => void;
+    onDragStart?: (id: string) => void;
+}
+export declare function PageMgmtRow({ page, onRename, onKebab, onDragStart }: PageMgmtRowProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/internals/catalog-mocks.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Catalog panel mock data — Phase 11.5 P4 W2.
+ *
+ * Module-level constants; no fetch, no PII. Spike-verbatim §6.2.5 lens list +
+ * §6.2.7 tile model. Tiles per lens are illustrative (≥4 each; ≥1 stack under
+ * 'Order flow' to exercise `.span-2` + renderStackValue per §6.2.8).
+ *
+ * Real BFF binding will replace this seam in a future plan (P-N).
+ */
+export interface CatalogTile {
+    id: string;
+    label: string;
+    value: string;
+    stack?: boolean;
+    desc: string;
+    variants?: string[];
+}
+export declare const MOCK_LENSES: readonly string[];
+export declare const MOCK_DEFAULT_LENS = "Order flow";
+export declare const MOCK_TILES_BY_LENS: Readonly<Record<string, readonly CatalogTile[]>>;

package/lib/composites/panels/shells/internals/page-mgmt-mocks.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Page Mgmt mock data — Phase 11.5 P4 W4.
+ *
+ * Spike §6.4.3 verbatim: 4 entries with My Pipeline as the active page.
+ * Real BFF binding will replace this seam in a future plan (P-N).
+ */
+export interface PageEntry {
+    id: string;
+    name: string;
+    active: boolean;
+}
+export declare const MOCK_PAGES: readonly PageEntry[];

package/lib/composites/panels/stage3d/CloneCard.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+export interface CloneCardProps {
+    span: 1 | 2 | 3;
+    rotating?: boolean;
+    children?: ReactNode;
+}
+export declare function CloneCard({ span, rotating, children }: CloneCardProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/stage3d/CloneStage.d.ts

@@ -0,0 +1,5 @@
+import { ReactNode } from 'react';
+export interface CloneStageProps {
+    children: ReactNode;
+}
+export declare function CloneStage({ children }: CloneStageProps): import("react/jsx-runtime").JSX.Element;

package/package.json

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