@mt-gloss/ui 0.1.106 → 0.1.108

package/internals.js

@@ -1,7 +1,8 @@
-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 as B } from "./UIContext-Dm0GYHFT.js";
+import { z as A, F as I, A as H, D as M, ab as $, ad as R, e as E, q as F, y as O, s as U, t as z, r as W, v as L, x as j, w as G, h as V, ae as X, a4 as Z, a7 as q, a6 as J, a5 as K, a8 as Q, N as Y, P as aa, Q as sa, O as ea, Y as oa, _ as ta, a1 as la, a3 as ra, a2 as ia, d as da, f as na, af as ca, a0 as Ba, G as ga, J as ba, H as ma, I as ua, $ as pa, B as ya, ac as ha, i as _a, a9 as fa, L as va, M as Ca, k as ka, m as Da, o as Ta, n as xa, l as wa, p as Sa, c as Na, g as Pa, V as Aa, X as Ia, W as Ha, aa as Ma, j as $a, K as Ra, C as Ea, E as Fa, R as Oa, S as Ua, T as za, a as Wa, U as La, Z as ja, u as Ga } from "./UIContext-Dm0GYHFT.js";
+import { B as Xa, b as Za, a as qa, c as Ja } from "./BaseText-Dxbk1JJa.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 Qa, e as Ya, d as as, B as ss, b as es, a as os } from "./BaseAsyncButton-aDQ_TjJi.js";
 const T = {
   DurationFast: "var(--gloss-motion-duration-fast)",
   DurationNormal: "var(--gloss-motion-duration-normal)",
@@ -9,13 +10,13 @@ const T = {
   EasingDefault: "var(--gloss-motion-easing-default)",
   EasingEnter: "var(--gloss-motion-easing-enter)",
   EasingExit: "var(--gloss-motion-easing-exit)"
-}, w = {
+}, x = {
   Sm: "var(--gloss-breakpoint-sm)",
   Md: "var(--gloss-breakpoint-md)",
   Lg: "var(--gloss-breakpoint-lg)",
   Xl: "var(--gloss-breakpoint-xl)",
   "2xl": "var(--gloss-breakpoint-2xl)"
-}, x = {
+}, w = {
   Disabled: "var(--gloss-opacity-disabled)",
   Hover: "var(--gloss-opacity-hover)",
   Focus: "var(--gloss-opacity-focus)",
@@ -187,93 +188,93 @@ export {
   I as BaseAccordionContent,
   H as BaseAccordionItem,
   M as BaseAccordionTrigger,
-  Ka as BaseAlert,
-  Qa as BaseAsyncButton,
+  Qa as BaseAlert,
+  Ya as BaseAsyncButton,
   $ as BaseAvatar,
   R as BaseBadge,
-  E as BaseBox,
-  Ya as BaseBreadcrumbs,
-  F as BaseButton,
-  O as BaseCard,
-  U as BaseCardActions,
-  z as BaseCardBody,
-  W as BaseCardFooter,
-  L as BaseCardHeader,
-  j as BaseCardMedia,
-  G as BaseCardSubtitle,
-  V as BaseCardTitle,
-  X as BaseCheckbox,
-  Z as BaseChip,
-  q as BaseColorPicker,
-  J as BaseColorPickerAlpha,
-  K as BaseColorPickerHue,
-  Q as BaseColorPickerSaturation,
-  Y as BaseColorPickerSwatch,
-  aa as BaseDatePicker,
-  sa as BaseDatePickerCalendar,
-  ea as BaseDatePickerDay,
-  oa as BaseDatePickerHeader,
-  ta as BaseDateRangePicker,
-  la as BaseDateRangePickerDay,
+  Xa as BaseBox,
+  as as BaseBreadcrumbs,
+  E as BaseButton,
+  F as BaseCard,
+  O as BaseCardActions,
+  U as BaseCardBody,
+  z as BaseCardFooter,
+  W as BaseCardHeader,
+  L as BaseCardMedia,
+  j as BaseCardSubtitle,
+  G as BaseCardTitle,
+  V as BaseCheckbox,
+  X as BaseChip,
+  Z as BaseColorPicker,
+  q as BaseColorPickerAlpha,
+  J as BaseColorPickerHue,
+  K as BaseColorPickerSaturation,
+  Q as BaseColorPickerSwatch,
+  Y as BaseDatePicker,
+  aa as BaseDatePickerCalendar,
+  sa as BaseDatePickerDay,
+  ea as BaseDatePickerHeader,
+  oa as BaseDateRangePicker,
+  ta as BaseDateRangePickerDay,
   _ as BaseDialog,
   C as BaseDialogActions,
   v as BaseDialogBody,
   f as BaseDialogHeader,
-  ra as BaseDivider,
-  ia as BaseFileUpload,
-  da as BaseFileUploadItem,
-  na as BaseFileUploadList,
-  ca as BaseIcon,
-  Ba as BaseInput,
-  as as BaseLabel,
-  ga as BaseLink,
-  ba as BaseMaskedInput,
-  ma as BaseMenu,
-  ua as BaseMenuDivider,
-  pa as BaseMenuGroup,
-  ya as BaseMenuItem,
-  ha as BaseNumberInput,
+  Za as BaseDivider,
+  la as BaseFileUpload,
+  ra as BaseFileUploadItem,
+  ia as BaseFileUploadList,
+  da as BaseIcon,
+  na as BaseInput,
+  ss as BaseLabel,
+  ca as BaseLink,
+  Ba as BaseMaskedInput,
+  ga as BaseMenu,
+  ba as BaseMenuDivider,
+  ma as BaseMenuGroup,
+  ua as BaseMenuItem,
+  pa as BaseNumberInput,
   B as BaseOverlay,
-  _a as BasePopover,
-  fa as BaseProgressBar,
-  va as BaseRadio,
-  Ca as BaseRangeSlider,
-  ka as BaseRating,
-  Da as BaseSegmentedControl,
-  Ta as BaseSelect,
-  wa as BaseSelectDropdown,
-  xa as BaseSelectGroup,
-  Sa as BaseSelectOption,
-  Na as BaseSelectTrigger,
-  Pa as BaseSlider,
-  Aa as BaseStack,
+  ya as BasePopover,
+  ha as BaseProgressBar,
+  _a as BaseRadio,
+  fa as BaseRangeSlider,
+  va as BaseRating,
+  Ca as BaseSegmentedControl,
+  ka as BaseSelect,
+  Da as BaseSelectDropdown,
+  Ta as BaseSelectGroup,
+  xa as BaseSelectOption,
+  wa as BaseSelectTrigger,
+  Sa as BaseSlider,
+  Na as BaseStack,
   m as BaseTable,
   p as BaseTableBody,
   h as BaseTableCell,
   u as BaseTableHead,
   y as BaseTableRow,
-  Ia as BaseText,
-  Ha as BaseTextarea,
-  Ma as BaseTimePicker,
-  $a as BaseTimePickerCell,
-  Ra as BaseTimePickerColumn,
-  Ea as BaseTitle,
-  ss as BaseToast,
-  Fa as BaseToggle,
-  Oa as BaseTooltip,
-  Ua as BaseTypography,
-  es as BaseValue,
+  qa as BaseText,
+  Pa as BaseTextarea,
+  Aa as BaseTimePicker,
+  Ia as BaseTimePickerCell,
+  Ha as BaseTimePickerColumn,
+  Ma as BaseTitle,
+  es as BaseToast,
+  $a as BaseToggle,
+  Ra as BaseTooltip,
+  Ja as BaseTypography,
+  os as BaseValue,
   S as Border,
-  w as Breakpoint,
-  za as Color,
-  Wa as Elevation,
+  x as Breakpoint,
+  Ea as Color,
+  Fa as Elevation,
   T as Motion,
-  x as Opacity,
-  La as Radius,
-  ja as Spacing,
-  Ga as Typography,
-  Va as UIContext,
-  Xa as UIContextProvider,
-  Za as ZIndex,
-  qa as useUIContext
+  w as Opacity,
+  Oa as Radius,
+  Ua as Spacing,
+  za as Typography,
+  Wa as UIContext,
+  La as UIContextProvider,
+  ja as ZIndex,
+  Ga as useUIContext
 };

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.108",
   "type": "module",
   "publishConfig": {
     "access": "restricted"