@mt-gloss/ui 0.1.109 → 0.1.111

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

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
 import { PanelShellProps } from '../PanelHost';
-import { CatalogLensMeta, CatalogLensTiles } from './internals/catalog-mocks';
+import { CatalogTile, CatalogLensMeta, CatalogLensTiles } from './internals/catalog-mocks';
 export interface CatalogAddShellProps extends PanelShellProps {
     /** Available lenses; defaults to MOCK_LENSES (spike §6.2.5). */
     lenses?: readonly string[];
@@ -17,5 +17,7 @@ export interface CatalogAddShellProps extends PanelShellProps {
      * Standalone tests (no PanelSlot) leave undefined → no footer.
      */
     footerSlot?: ReactNode;
+    /** PHASE 17.1 D-08 — forwarded to inner CatalogTileGrid (both primary + secondary instances). */
+    renderTile?: (tile: CatalogTile) => ReactNode;
 }
-export declare function CatalogAddShell({ isOpen, lenses, defaultLens, tilesByLens, lensMeta, footerSlot, }: CatalogAddShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function CatalogAddShell({ isOpen, lenses, defaultLens, tilesByLens, lensMeta, footerSlot, renderTile, }: CatalogAddShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,6 +1,6 @@
 import { ReactNode } from 'react';
 import { PanelShellProps } from '../PanelHost';
-import { CatalogLensTiles } from './internals/catalog-mocks';
+import { CatalogLensTiles, CatalogTile } from './internals/catalog-mocks';
 export interface CatalogReplaceShellProps extends PanelShellProps {
     /** Label of the card being replaced; rendered as 'replacing {label}' subtitle. */
     replacingLabel?: string;
@@ -9,5 +9,7 @@ export interface CatalogReplaceShellProps extends PanelShellProps {
     tilesByLens?: Readonly<Record<string, CatalogLensTiles>>;
     /** See CatalogAddShellProps.footerSlot — sibling slot inside Provider. */
     footerSlot?: ReactNode;
+    /** PHASE 17.1 D-08 — forwarded to inner CatalogTileGrid. */
+    renderTile?: (tile: CatalogTile) => ReactNode;
 }
-export declare function CatalogReplaceShell({ isOpen, replacingLabel, lenses, defaultLens, tilesByLens, footerSlot, }: CatalogReplaceShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function CatalogReplaceShell({ isOpen, replacingLabel, lenses, defaultLens, tilesByLens, footerSlot, renderTile, }: CatalogReplaceShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,8 +1,22 @@
+import { ReactNode } from 'react';
 import { CatalogTile } from './catalog-mocks';
 export interface CatalogTileGridProps {
     tiles: readonly CatalogTile[];
     selectedTileId: string | null;
     onSelectTile: (id: string, desc: string) => void;
+    /**
+     * PHASE 17.1 D-06 — host-supplied tile body renderer. When provided,
+     * its output replaces the inline 2-variant <MetricCard> dev fallback
+     * inside `.cat-tile-primitive-wrapper`. When OMITTED, the existing
+     * Phase 17 dev fallback continues to render (D-07 back-compat contract)
+     * so gloss-isolated W2 + Phase 17 RED-gate vitest suites stay GREEN.
+     *
+     * The renderer-provided wrapper carries `data-col-span={getCatalogColSpan(tile)}`
+     * per 17.1-D04-COLSPAN-DECISION.md Option B (button stays "1"; inner
+     * wrapper carries dynamic value). Plan 17.1-05 authors the HOF that
+     * supplies this renderer in reptime.
+     */
+    renderTile?: (tile: CatalogTile) => ReactNode;
 }
 /**
  * §6.2.8 — stack-tile value renderer. Splits a "LABEL N · LABEL N · LABEL N"
@@ -17,4 +31,4 @@ export interface CatalogTileGridProps {
  * 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;
+export declare function CatalogTileGrid({ tiles, selectedTileId, onSelectTile, renderTile }: CatalogTileGridProps): import("react/jsx-runtime").JSX.Element;

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

@@ -51,6 +51,84 @@ export interface CatalogTile {
     donut?: boolean;
     /** Accent HEX for donut/sparkline tiles. */
     accent?: string;
+    /** Drives the MetricCard router. Standard/sparkline/bars/donut/highlight/arrow/object-arrow/versus/segmented/compact/comparison/progress/channel/action/list/name/ratio/leaderboard/exception-list/pace/stacked-group/order-status-stack. */
+    cardType?: string;
+    /** standard/highlight — prefix string for the formatted value (e.g., "$"). */
+    prefix?: string;
+    /** standard/highlight — suffix string for the formatted value (e.g., "%"). */
+    suffix?: string;
+    /** standard/sparkline/bars — directional trend with magnitude. */
+    trend?: {
+        value: number;
+        direction: 'up' | 'down' | 'flat';
+    };
+    /** standard/sparkline — small label beneath the value (e.g., "vs last week"). */
+    subtext?: string;
+    /** sparkline — 10-30 datapoints rendered as the trend mini-chart. */
+    sparklineData?: number[];
+    /** donut — fractional value (0..1) independent of legacy `donut: boolean`. */
+    donutValue?: number;
+    /** donut — denominator/max for non-fractional donut representations. */
+    donutMax?: number;
+    /** bars — datapoints rendered as vertical bar chart. */
+    barData?: number[];
+    /** versus — TY vs LY comparison with labels. */
+    versusData?: {
+        current: number;
+        prior: number;
+        currentLabel?: string;
+        priorLabel?: string;
+    };
+    /** comparison — side-by-side string/number values with labels. */
+    comparison?: {
+        current: {
+            value: number | string;
+            label?: string;
+        };
+        prior: {
+            value: number | string;
+            label?: string;
+        };
+    };
+    /** segmented — segmented bar with labeled colored slices. */
+    segments?: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+    /** segmented — alternate inventory for the catalog view (vs runtime `segments`). */
+    catalogSegments?: Array<{
+        label: string;
+        value: number;
+        color: string;
+    }>;
+    /** color override — secondary to legacy `accent`; reads via `tile.accent ?? tile.accentColor ?? tile.highlightColor`. */
+    accentColor?: string;
+    /** highlight — warn/info-tinted background HEX. */
+    highlightColor?: string;
+    /** ratio — top half of the ratio (e.g., 47 of 60). */
+    numerator?: number;
+    /** ratio — bottom half of the ratio. */
+    denominator?: number;
+    /** standard — detail line beneath value. */
+    detail?: string;
+    /** catalog-only — alternate detail string for the catalog preview. */
+    catalogDetail?: string;
+    /** catalog-only — alternate display value for the catalog preview. */
+    catalogValue?: string | number;
+    /** order-status-stack — numeric status snapshot values per column. */
+    catalogStatusValues?: number[];
+    /** order-status-stack — column key + label definitions. */
+    statusColumns?: Array<{
+        key: string;
+        label: string;
+    }>;
+    /** stacked-group — timeframe segment ids (e.g., ['MTD','QTD','YTD']). */
+    stackedTimeframes?: string[];
+    /** sizing — default colSpan when first dropped into the grid. */
+    defaultColSpan?: number;
+    /** sizing — catalog tile colSpan (1, 2, or 3). */
+    _catalogTileColSpan?: 1 | 2 | 3;
 }
 export interface CatalogLensMeta {
     /** H2 question shown beneath the pill row when this lens is active. */

package/package.json

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