@mt-gloss/ui 0.1.106 → 0.1.107

package/index.js

@@ -5,8 +5,8 @@ import * as B from "react";
 import F, { useRef as P, useEffect as A, useState as I, useCallback as N, useId as Je, forwardRef as et, useMemo as re, useLayoutEffect as Ie, createContext as tt, useContext as at } from "react";
 import { motion as G, useMotionValue as nt, AnimatePresence as rt, useDragControls as st } from "framer-motion";
 import { createPortal as Ee } from "react-dom";
-import { u as it } from "./COMMITS-kaUvc5jL.js";
-import { C as Jo, c as el, b as tl, P as al, S as nl, e as rl, i as sl, r as il, a as ol, d as ll } from "./COMMITS-kaUvc5jL.js";
+import { u as it } from "./COMMITS-DG0Q_9DU.js";
+import { C as Jo, c as el, b as tl, P as al, S as nl, e as rl, i as sl, r as il, a as ol, d as ll } from "./COMMITS-DG0Q_9DU.js";
 import { B as ot, a as X, b as ce, U as fe } from "./UIContext-DP6JGCto.js";
 import { c as dl, u as ul } from "./UIContext-DP6JGCto.js";
 import { DEFAULT_MARKET_PRESETS as pl, DEFAULT_PINNED as gl, PERIOD_OPTIONS as hl, ROLLING_OPTIONS as fl, TODAY_PRESET as bl, findPreset as vl, formatDateRange as yl, formatMarketDates as wl, formatTrend as _l, formatValue as Cl, generateMarketId as Nl, getAllPresets as Sl, getDateRangeForPreset as kl, getPresetLabel as Dl, isInRange as xl, isMarketActive as Rl, isSameDay as Tl, normalizePresetId as Ml, toUppercasePresetId as Pl } from "@mt-gloss/utils";

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

@@ -9,5 +9,19 @@ export interface PanelChromeProps {
     isOpen?: boolean;
     /** P2 — optional footer slot. Notification-center keeps null (no footer). */
     footer?: ReactNode;
+    /**
+     * GAP-01 (sprint 2026-05-15): optional title rendered left-aligned in the
+     * header, on the same line as the close button. Spike §6.1 shows
+     * "Configure metric" over the stage gradient.
+     */
+    title?: string;
+    /**
+     * GAP-01 (sprint 2026-05-15): visual variant. 'merged-stage' fuses the
+     * header with the stage gradient region (title left + outlined close right),
+     * drops bottom rounding so the panel exits the toolbar bounds, and lets the
+     * body grow with content (no inner scroll). 'default' preserves the
+     * P3a fixed-3-row chrome used by notification-center / catalog / etc.
+     */
+    variant?: 'default' | 'merged-stage';
 }
-export declare function PanelChrome({ children, onClose, footer }: PanelChromeProps): import("react/jsx-runtime").JSX.Element;
+export declare function PanelChrome({ children, onClose, footer, title, variant }: PanelChromeProps): import("react/jsx-runtime").JSX.Element;

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

@@ -4,10 +4,10 @@
  * Unknown keys pass through unchanged (forward-compat).
  *
  * Fallback values per spike §6.1.4:
- *   threshold → 80, timeframe → 30, accent → null
+ *   threshold → 80, timeframe → 30, accent → null, slots → []
  *
  * @param key  buffer-value key (e.g. 'threshold', 'timeframe', 'accent', 'slots')
- * @param value unknown — usually number (sliders) or string (color hex)
+ * @param value unknown — number (sliders), string (color hex), or string[] (slots)
  * @returns normalized value (clamped, parsed, or passthrough)
  */
 export declare function normalizeBufferValue(key: string, value: unknown): unknown;

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

@@ -20,8 +20,8 @@ export { CatalogFooter, CatalogStateContext, useCatalogState, } from './shells/i
 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 { CatalogTile, CatalogTileSubStat, CatalogLensMeta, CatalogLensTiles, } from './shells/internals/catalog-mocks';
+export { MOCK_LENSES, MOCK_DEFAULT_LENS, MOCK_LENS_META, 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';

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

@@ -1,13 +1,15 @@
 import { ReactNode } from 'react';
 import { PanelShellProps } from '../PanelHost';
-import { CatalogTile } from './internals/catalog-mocks';
+import { CatalogLensMeta, CatalogLensTiles } 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'). */
+    /** Initial active lens; defaults to MOCK_DEFAULT_LENS. */
     defaultLens?: string;
     /** Tile catalog keyed by lens; defaults to MOCK_TILES_BY_LENS. */
-    tilesByLens?: Readonly<Record<string, readonly CatalogTile[]>>;
+    tilesByLens?: Readonly<Record<string, CatalogLensTiles>>;
+    /** Per-lens H2 + helper + beta-chip metadata. */
+    lensMeta?: Readonly<Record<string, CatalogLensMeta>>;
     /**
      * Optional footer slot rendered as a SIBLING of the body, INSIDE the shell's
      * CatalogStateContext.Provider. PanelSlot passes <CatalogFooter/> here so it
@@ -16,4 +18,4 @@ export interface CatalogAddShellProps extends PanelShellProps {
      */
     footerSlot?: ReactNode;
 }
-export declare function CatalogAddShell({ isOpen, lenses, defaultLens, tilesByLens, footerSlot, }: CatalogAddShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function CatalogAddShell({ isOpen, lenses, defaultLens, tilesByLens, lensMeta, footerSlot, }: CatalogAddShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,12 +1,12 @@
 import { ReactNode } from 'react';
 import { PanelShellProps } from '../PanelHost';
-import { CatalogTile } from './internals/catalog-mocks';
+import { CatalogLensTiles } 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[]>>;
+    tilesByLens?: Readonly<Record<string, CatalogLensTiles>>;
     /** See CatalogAddShellProps.footerSlot — sibling slot inside Provider. */
     footerSlot?: ReactNode;
 }

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

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { PanelShellProps } from '../PanelHost';
+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). */

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

@@ -1,15 +1,58 @@
+import { default as React } from 'react';
 import { PanelShellProps } from '../PanelHost';
 import { SettingsDimension } from '../../../primitives/dashboard/SettingsTabStrip';
+import { AccentSwatch } from './settings';
 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'. */
+    /**
+     * Legacy fallback label on the clone card when `previewSlot` is not provided.
+     * GAP-02 (sprint 2026-05-15) replaced this with `previewSlot` for 1:1 clones;
+     * kept for backward compatibility with consumers that haven't migrated.
+     * @deprecated prefer `previewSlot`
+     */
     cardLabel?: string;
-    /** Visible value on the clone card. Defaults to '—'. */
+    /**
+     * Legacy fallback value on the clone card when `previewSlot` is not provided.
+     * @deprecated prefer `previewSlot`
+     */
     cardValue?: string;
+    /**
+     * GAP-02 (sprint 2026-05-15): render-as-children path for the Stage 3D clone.
+     * When provided, this ReactNode is rendered inside <CloneCard>{...}</CloneCard>
+     * instead of the legacy cardLabel/cardValue placeholder. Consumer is expected
+     * to produce a static (pointer-events: none) preview of the source card with
+     * buffer-merged config so the clone is a 1:1 representation of the live card.
+     */
+    previewSlot?: React.ReactNode;
     /** Phase 16 D-02: dimensions to render as tabs. Reptime computes via useCardDimensions(cardType, colSpan). */
     dimensions?: ReadonlyArray<SettingsDimension>;
     /** Phase 16: initial active tab. Defaults to dimensions[0]. */
     initialTab?: SettingsDimension;
+    /**
+     * Phase 16 P8 spot-fix — persisted baseline for this card.
+     *
+     * Consumer (reptime V2FeedbackSurface) computes this from
+     * `usePreferences('metricConfig')[cardId]` at OPEN time so that:
+     *   - Re-opening the panel after Apply shows the saved value (not React default).
+     *   - Reset (CLEAR_BUFFER) reverts to the saved value (CC-19 semantics with persistence).
+     *
+     * Display precedence per dimension:
+     *   1. live buffer (`state.bufferByCard[cardId].changes[dim]`) — user mid-edit
+     *   2. `initialValues[dim]` — last-applied baseline from localStorage
+     *   3. React-default per spike §6.1.4 (threshold=80, timeframe=30, accent=null, slots=['Orders','Quota','Unassigned'])
+     *
+     * Spike §6.1 documents the prototype's defaults (30/80). Production persists
+     * via D-10 COMMIT_BUFFER → usePreferences('metricConfig'); the seed-on-open
+     * round-trip closes the loop — without it the Apply'd value vanishes from the
+     * UI even though localStorage holds it.
+     */
+    initialValues?: Partial<{
+        threshold: number;
+        timeframe: number;
+        accent: AccentSwatch;
+        /** GAP-03 (sprint 2026-05-15): persisted slot order. Max 3, empty array valid. */
+        slots: ReadonlyArray<string>;
+    }>;
 }
-export declare function SettingsShell({ isOpen, cardSpan, cardLabel, cardValue, dimensions, initialTab, }: SettingsShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function SettingsShell({ isOpen, cardSpan, cardLabel, cardValue, previewSlot, dimensions, initialTab, initialValues, }: SettingsShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -15,5 +15,5 @@ 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';
+export type { CatalogTile, CatalogTileSubStat, CatalogLensMeta, CatalogLensTiles, } from './internals/catalog-mocks';
+export { MOCK_LENSES, MOCK_DEFAULT_LENS, MOCK_LENS_META, MOCK_TILES_BY_LENS, } from './internals/catalog-mocks';

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

@@ -1,6 +1,19 @@
+import { CatalogLensMeta } from './catalog-mocks';
 export interface CatalogLensPickerProps {
     lenses: readonly string[];
     activeLens: string;
     onLensChange: (lens: string) => void;
+    /**
+     * GAP-06 — `pills` matches the prior-modal contract (default for CatalogAdd);
+     * `segmented` preserves the W2 segmented-chip + overflow contract for
+     * back-compat (CatalogReplace and any legacy tests still default to this
+     * when they pass `variant='segmented'` explicitly).
+     */
+    variant?: 'pills' | 'segmented';
+    /**
+     * Per-lens metadata (beta chip, etc.); defaults to MOCK_LENS_META so the
+     * shell can omit the prop when using mocks.
+     */
+    lensMeta?: Readonly<Record<string, CatalogLensMeta>>;
 }
-export declare function CatalogLensPicker({ lenses, activeLens, onLensChange }: CatalogLensPickerProps): import("react/jsx-runtime").JSX.Element;
+export declare function CatalogLensPicker({ lenses, activeLens, onLensChange, variant, lensMeta, }: CatalogLensPickerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -12,6 +12,9 @@ export interface CatalogTileGridProps {
  *
  * 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>.
+ *
+ * Kept for back-compat with W2 tests + the `stack: true` legacy tile model.
+ * GAP-06 — new tiles prefer `subStats` (structured) over `·`-split strings.
  */
 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

@@ -2,6 +2,13 @@ import { PageEntry } from './page-mgmt-mocks';
 export interface PageMgmtState {
     pages: PageEntry[];
     setPages: (updater: (prev: PageEntry[]) => PageEntry[]) => void;
+    /** GAP-05 (sprint 2026-05-15) — rename via kebab menu. Mock-state operation. */
+    renamePage?: (id: string, name: string) => void;
+    /** GAP-05 — duplicate via kebab menu. Mock-state operation; real BFF wiring
+     *  in P5+ via HOF (PagesContext.duplicatePage already exists in reptime). */
+    duplicatePage?: (id: string) => void;
+    /** GAP-05 — delete via kebab menu. Mock-state operation. */
+    deletePage?: (id: string) => void;
 }
 export declare const PageMgmtStateContext: import('react').Context<PageMgmtState | null>;
 export declare function usePageMgmtState(): PageMgmtState | null;

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

@@ -1,8 +1,11 @@
 import { PageEntry } from './page-mgmt-mocks';
 export interface PageMgmtRowProps {
     page: PageEntry;
+    /** @deprecated GAP-05 wires rename via window.prompt() through context. */
     onRename?: (id: string) => void;
+    /** @deprecated GAP-05 wires kebab menu directly via context. */
     onKebab?: (id: string) => void;
+    /** Drag-to-reorder hook seam — DEBT.md tracks dnd-kit wiring. */
     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

@@ -1,20 +1,72 @@
 /**
- * Catalog panel mock data — Phase 11.5 P4 W2.
+ * Catalog panel mock data — Phase 11.5 P4 W2 + GAP-06 (sprint 2026-05-15).
  *
  * 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).
+ * §6.2.7 tile model.
  *
- * Real BFF binding will replace this seam in a future plan (P-N).
+ * GAP-06 (sprint 2026-05-15) — data shape widened to support spike-grade
+ * catalog rendering (SCREENSHOT-07/-08 visual contract):
+ *
+ *   - Lens names replaced with spike-correct vocabulary (Overbought / What's
+ *     selling / On track vs plan / Orders on time / Vendor performance /
+ *     Assortment mix / Customer retention BETA).
+ *   - `lensMeta` keyed by lens name carries `headline` (active-lens H2),
+ *     `helper` (sub-paragraph), `beta` flag.
+ *   - Tiles per lens split into `primary` (rendered in main grid; at most one
+ *     `startHere: true` per lens; small orange `isNew` dot opt-in) and
+ *     `secondary` (rendered under "MORE IN THIS LENS" subsection).
+ *   - `value` semantics: a single string for 1×1 tiles, OR `subStats` array
+ *     for multi-up tiles (3-up MTD/QTD/YTD, 5-up MTD/QTD/YTD/LYTD/7D). When
+ *     `subStats` is present, the renderer ignores `value` and stacks the
+ *     segments. Span is implicit: 0 stats = 1×1, 3 = 1×3, 5 = 1×5.
+ *   - `accent` color hint for sparkline/donut tiles (HEX); CSS reads via
+ *     inline style. `donut` flag enables the donut variant.
+ *
+ * Real BFF binding will replace this seam in a future plan (P5+); the
+ * `CatalogAddWithCards` HOF in V2FeedbackSurface will inject live-card
+ * snapshot values per Q4 (B_representative_static + mock fallback).
  */
+/** Multi-up segment for stack tiles (3-up MTD/QTD/YTD, 5-up MTD/QTD/YTD/LYTD/7D). */
+export interface CatalogTileSubStat {
+    label: string;
+    value: string;
+}
 export interface CatalogTile {
     id: string;
     label: string;
+    /** Single-value display; ignored when `subStats` is present. */
     value: string;
+    /** Sub-statistics for multi-up tiles (3-up or 5-up). When present, overrides `value`. */
+    subStats?: readonly CatalogTileSubStat[];
+    /** @deprecated GAP-06 — `stack` is inferred from `subStats.length > 0`. Kept for back-compat with W2 tests. */
     stack?: boolean;
     desc: string;
-    variants?: string[];
+    /** Span variant chips ("1×1", "1×3", "1×5"); rendered top-right of tile. */
+    variants?: readonly string[];
+    /** Small orange "new" dot, top-right. */
+    isNew?: boolean;
+    /** GAP-06 — primary tile flagged as the recommended starting metric for this lens. */
+    startHere?: boolean;
+    /** Donut + value combo variant (vs flat number). */
+    donut?: boolean;
+    /** Accent HEX for donut/sparkline tiles. */
+    accent?: string;
+}
+export interface CatalogLensMeta {
+    /** H2 question shown beneath the pill row when this lens is active. */
+    headline: string;
+    /** Sub-paragraph helper sentence. */
+    helper: string;
+    /** Renders BETA chip next to the pill label. */
+    beta?: boolean;
 }
 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[]>>;
+export declare const MOCK_DEFAULT_LENS = "Overbought";
+export declare const MOCK_LENS_META: Readonly<Record<string, CatalogLensMeta>>;
+/** Primary vs secondary tile groups for a lens. */
+export interface CatalogLensTiles {
+    primary: readonly CatalogTile[];
+    /** Rendered under "MORE IN THIS LENS" subsection (§6.2.7 extension). */
+    secondary?: readonly CatalogTile[];
+}
+export declare const MOCK_TILES_BY_LENS: Readonly<Record<string, CatalogLensTiles>>;

package/lib/composites/panels/shells/settings/SlotsControls.d.ts

@@ -1,2 +1,6 @@
 import { default as React } from 'react';
-export declare function SlotsControls(): React.ReactElement;
+export interface SlotsControlsProps {
+    value: ReadonlyArray<string>;
+    onChange: (next: ReadonlyArray<string>) => void;
+}
+export declare function SlotsControls({ value, onChange }: SlotsControlsProps): React.ReactElement;

package/package.json

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