@mt-gloss/ui 0.1.137 → 0.1.138

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

@@ -3,11 +3,16 @@
  * Called inside the SET_BUFFER_VALUE reducer case (coordinator.ts).
  * Unknown keys pass through unchanged (forward-compat).
  *
- * Post-M003-S002-CFG discriminated union (D-14):
- *   timeframe → 30 (default), slots → []
+ * Fallback values per spike §6.1.4:
+ *   threshold → 80, timeframe → 30, accent → null, slots → []
  *
- * @param key  buffer-value key — 'timeframe' | 'slots' | any forward-compat string
- * @param value unknown
+ * Phase 17.2 additions:
+ *   thresholdEnabled → false, accentEnabled → false
+ *
+ * @param key  buffer-value key (e.g. 'threshold', 'timeframe', 'accent',
+ *             'slots', 'thresholdEnabled', 'accentEnabled')
+ * @param value unknown — number (sliders), string (color hex), string[]
+ *             (slots), or boolean (toggles)
  * @returns normalized value (clamped, parsed, or passthrough)
  */
 export declare function normalizeBufferValue(key: string, value: unknown): unknown;

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

@@ -10,8 +10,6 @@
 export { PanelProvider, usePanelContext, usePanelContextOptional } from './PanelProvider';
 export { useEditingCardId } from './hooks/useEditingCardId';
 export { SettingsShell } from './shells/SettingsShell';
-export { MetricInfoShell } from './shells/MetricInfoShell';
-export type { MetricInfoShellProps, MetricInfoBlock } from './shells/MetricInfoShell';
 export { NotificationCenterShell } from './shells/NotificationCenterShell';
 export { CatalogAddShell } from './shells/CatalogAddShell';
 export type { CatalogAddShellProps } from './shells/CatalogAddShell';

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

@@ -1,6 +1,7 @@
 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;
@@ -36,29 +37,26 @@ export interface SettingsShellProps extends PanelShellProps {
      *   - 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).
      *
-     * Post-M003-S002-CFG display precedence per dimension:
+     * 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 (timeframe=30, slots=['Orders','Quota','Unassigned'])
+     *   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; production persists
-     * via D-10 COMMIT_BUFFER → usePreferences('metricConfig').
+     * 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>;
+        /** Phase 17.2 Fix #2 — opt-in toggle for threshold overlay. Default false. */
+        thresholdEnabled: boolean;
+        /** Phase 17.2 Fix #2 — opt-in toggle for accent override. Default false. */
+        accentEnabled: boolean;
     }>;
-    /**
-     * M003-S005-SLT D-08 — Card's natural slot identifier list (registry data,
-     * NOT user-persisted). SlotsControls renders ghost pills for naturalSlots
-     * \ value so the user can re-add removed slots without Reset. Threaded by
-     * reptime MetricSettingsPanel (cardNaturalSlots derivation at ~L222-237).
-     *
-     * Kept as a top-level prop rather than nested under initialValues because
-     * `initialValues` is the *persisted-baseline* axis; naturalSlots is the
-     * *registry-data* axis — different semantics (RESEARCH Finding 5).
-     */
-    naturalSlots?: ReadonlyArray<string>;
 }
-export declare function SettingsShell({ isOpen, cardSpan, cardLabel, cardValue, previewSlot, dimensions, initialTab, initialValues, naturalSlots, }: 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

@@ -3,8 +3,6 @@
  */
 export { SettingsShell } from './SettingsShell';
 export type { SettingsShellProps } from './SettingsShell';
-export { MetricInfoShell } from './MetricInfoShell';
-export type { MetricInfoShellProps, MetricInfoBlock } from './MetricInfoShell';
 export { CatalogAddShell } from './CatalogAddShell';
 export type { CatalogAddShellProps } from './CatalogAddShell';
 export { CatalogReplaceShell } from './CatalogReplaceShell';

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

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+declare const SWATCHES: readonly ["#1d6fd8", "#10b981", "#f59e0b", "#ef4444", "#8b5cf6"];
+export type AccentSwatch = typeof SWATCHES[number];
+export interface ColorControlsProps {
+    value: AccentSwatch | null;
+    onSelect: (hex: AccentSwatch) => void;
+    /** Phase 17.2 Fix #2 — opt-in toggle. Defaults false. */
+    enabled?: boolean;
+    /** Phase 17.2 Fix #2 — toggle dispatch (parent wires SET_BUFFER_VALUE 'accentEnabled'). */
+    onToggleEnabled?: (next: boolean) => void;
+}
+export declare function ColorControls({ value, onSelect, enabled, onToggleEnabled, }: ColorControlsProps): React.ReactElement;
+export {};

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

@@ -2,10 +2,5 @@ import { default as React } from 'react';
 export interface SlotsControlsProps {
     value: ReadonlyArray<string>;
     onChange: (next: ReadonlyArray<string>) => void;
-    /**
-     * M003-S005-SLT D-08 — natural slot list from the card registry. Ghosts =
-     * naturalSlots filtered to !value.includes. Default [].
-     */
-    naturalSlots?: ReadonlyArray<string>;
 }
-export declare function SlotsControls({ value, onChange, naturalSlots, }: SlotsControlsProps): React.ReactElement;
+export declare function SlotsControls({ value, onChange }: SlotsControlsProps): React.ReactElement;

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

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+export interface ThresholdControlsProps {
+    value: number;
+    onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    /** Phase 17.2 Fix #2 — opt-in toggle. Defaults false. */
+    enabled?: boolean;
+    /** Phase 17.2 Fix #2 — toggle dispatch (parent wires SET_BUFFER_VALUE 'thresholdEnabled'). */
+    onToggleEnabled?: (next: boolean) => void;
+}
+export declare function ThresholdControls({ value, onChange, enabled, onToggleEnabled, }: ThresholdControlsProps): React.ReactElement;

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

@@ -2,13 +2,11 @@
  * SettingsShell tab-body components. Each renders inside SettingsShell's role=tabpanel via React
  * conditional render (CC-15/16). Phase 16 D-08 keeps these co-located with SettingsShell — they are
  * not standalone primitives.
- *
- * M003-S002-CFG (2026-05-26): ThresholdControls + ColorControls removed per D-10 (per-metric-type
- * threshold + color deferred to later product conversation).
  */
+export { ThresholdControls } from './ThresholdControls';
+export type { ThresholdControlsProps } from './ThresholdControls';
 export { TimeframeControls } from './TimeframeControls';
 export type { TimeframeControlsProps } from './TimeframeControls';
 export { SlotsControls } from './SlotsControls';
-export type { SlotsControlsProps } from './SlotsControls';
-export { GhostSlotPill } from './GhostSlotPill';
-export type { GhostSlotPillProps } from './GhostSlotPill';
+export { ColorControls } from './ColorControls';
+export type { ColorControlsProps, AccentSwatch } from './ColorControls';

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

@@ -1,5 +1,15 @@
 import { ReactNode } from 'react';
 export interface CloneStageProps {
     children: ReactNode;
+    /** D-06 — incrementing counter. Every change fires one spin via motion/react animate(). */
+    spinTrigger?: number;
+    /** D-07 — fires from animate().then() / .finished, NOT animationend DOM event. */
+    onSpinComplete?: () => void;
+    /** D-03 — total spin duration (ms). Default 500. */
+    spinDuration?: number;
+    /** D-02 — number of 360° rotations. Default 1. */
+    spinRotations?: number;
+    /** D-05 — CSS color for the transient theme accent overlay. */
+    accentColor?: string;
 }
-export declare function CloneStage({ children }: CloneStageProps): import("react/jsx-runtime").JSX.Element;
+export declare function CloneStage({ children, spinTrigger, onSpinComplete, spinDuration, spinRotations, accentColor, }: CloneStageProps): import("react/jsx-runtime").JSX.Element;

package/lib/facade/index.d.ts

@@ -8,8 +8,6 @@ export * from './typography';
 export * from './inputs';
 export * from './display';
 export * from './overlay';
-export * from './layout';
-export * from './feedback';
 export * from './data-display';
 export * from './composites';
 export * from './compositions';

package/lib/presets/PresetMenu/PresetMenu.d.ts

@@ -30,6 +30,7 @@ export interface PresetMenuItemProps {
     as?: React.ElementType;
     icon?: React.ReactNode;
     children: React.ReactNode;
+    href?: string;
 }
 export declare const PresetMenuItem: {
     ({ ref, disabled, active, as, icon, children, ...rest }: PresetMenuItemProps & Omit<React.HTMLAttributes<HTMLElement>, "className" | "style"> & {

package/package.json

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