@mt-gloss/ui 0.1.142 → 0.1.143

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

@@ -1,10 +1,12 @@
+export declare const TIMEFRAME_PRESETS: readonly ["today", "7d", "30d", "60d", "90d", "mtd", "qtd", "ytd"];
+export type TimeframePreset = (typeof TIMEFRAME_PRESETS)[number];
 /**
  * Normalizes a buffer value for a given key before writing to bufferByCard.
  * 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 → []
+ * Post-M003-S002-CFG discriminated union (D-14), updated by quick-260601-gyl:
+ *   timeframe → '30d' (default, preset-id string), slots → []
  *
  * @param key  buffer-value key — 'timeframe' | 'slots' | any forward-compat string
  * @param value unknown

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 { TimeframePreset } from '../coordinator/settingsBufferSchemas';
 export interface SettingsShellProps extends PanelShellProps {
     /** Span of the source card (1|2|3). Plumbed by V2FeedbackSurface HOF. */
     cardSpan?: 1 | 2 | 3;
@@ -45,10 +46,21 @@ export interface SettingsShellProps extends PanelShellProps {
      * via D-10 COMMIT_BUFFER → usePreferences('metricConfig').
      */
     initialValues?: Partial<{
-        timeframe: number;
+        /**
+         * quick-260601-gyl: timeframe is now a preset-id STRING (was a days-number).
+         * Seeded by reptime from instanceConfig.timeframe (with presetIdFromDays
+         * back-compat for legacy numeric values). Default '30d'.
+         */
+        timeframe: TimeframePreset | string;
         /** GAP-03 (sprint 2026-05-15): persisted slot order. Max 3, empty array valid. */
         slots: ReadonlyArray<string>;
     }>;
+    /**
+     * quick-260601-gyl: per-card pinned default preset (the orange star), read by
+     * reptime from instanceConfig.pinnedTimeframe. Defaults to '30d' in the bar when
+     * unset. Pinning a preset selects it AND persists it as the card's default.
+     */
+    pinnedTimeframe?: string;
     /**
      * M003-S005-SLT D-08 — Card's natural slot identifier list (registry data,
      * NOT user-persisted). SlotsControls renders ghost pills for naturalSlots
@@ -61,4 +73,4 @@ export interface SettingsShellProps extends PanelShellProps {
      */
     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, pinnedTimeframe, naturalSlots, }: SettingsShellProps): import("react/jsx-runtime").JSX.Element;

package/lib/primitives/dashboard/TimeFrame/TimeframeQuickBar.d.ts

@@ -0,0 +1,80 @@
+import { default as React } from 'react';
+/**
+ * TimeframeQuickBar — the controls-only slice of the HybridDatePicker Quick Bar.
+ *
+ * Renders the "Today" chip + the rolling (7D/30D/60D/90D) and period (MTD/QTD/YTD)
+ * ExpandableChip dropdowns, WITHOUT any MUI Popover wrapper, calendar grid, or
+ * markets/events tab. Both the live top-bar HybridDatePicker and the metric
+ * Settings → Timeframe tab consume this component.
+ *
+ * Extracted in quick-260601-gyl (RESEARCH Finding 4, approach (b): extract a
+ * standalone component rather than thread a mode prop through HybridDatePicker's
+ * compare/calendar machine).
+ *
+ * IMPORTANT (memory feedback_compiler_uppercase_jsx_helper_trap): this is a real
+ * PascalCase component rendered as `<TimeframeQuickBar />` — NEVER invoke it as a
+ * function (`timeframeQuickBar(props)`). React Compiler over-memoizes uppercase
+ * JSX-returning helpers invoked as functions and corrupts the calling fiber's hook
+ * list.
+ *
+ * @example
+ * ```tsx
+ * // Live picker (hover-to-open, keeps the calendar/events entry buttons):
+ * <TimeframeQuickBar
+ *   selectedPreset={selectedPreset}
+ *   onSelect={handlePresetSelect}
+ *   pinnedPreset={preferences.pinnedPreset}
+ *   onPin={handlePin}
+ *   openGroup={activeHoverGroup}
+ *   onOpenChange={handleChipGroupHover}
+ *   calendarEntry={<>{calendarBtn}{eventsBtn}</>}
+ * />
+ *
+ * // Settings panel (click-to-open, no calendar/events):
+ * <TimeframeQuickBar
+ *   selectedPreset={timeframeValue}
+ *   onSelect={handlePresetSelect}
+ *   pinnedPreset={pinnedTimeframe ?? '30d'}
+ *   onPin={handlePin}
+ *   openGroup={openGroup}
+ *   onOpenChange={(g, open) => setOpenGroup(open ? g : null)}
+ *   disableHover
+ *   showCalendarEntry={false}
+ * />
+ * ```
+ */
+export interface TimeframeQuickBarProps {
+    /** Currently selected preset id (e.g. 'today' | '30d' | 'mtd'). */
+    selectedPreset: string;
+    /** Called when a preset is selected from any control. */
+    onSelect: (presetId: string) => void;
+    /** Pinned/default preset id (drives the chip label when nothing in-group is selected). */
+    pinnedPreset?: string;
+    /** Called when a preset's star is toggled. Pin-also-selects is the caller's responsibility. */
+    onPin?: (presetId: string) => void;
+    /** Controlled open group: 'rolling' | 'period' | null. Maps to each ExpandableChip's isOpen. */
+    openGroup: string | null;
+    /** Called when an ExpandableChip's open state changes (groupId, isOpen). */
+    onOpenChange: (groupId: string, isOpen: boolean) => void;
+    /**
+     * When true the dropdowns only toggle on chip click (no hover-to-open). Defaults
+     * false so the live picker keeps hover behaviour. The Settings panel passes true.
+     */
+    disableHover?: boolean;
+    /**
+     * When true (default) the calendar/events entry slot renders after a divider. The
+     * Settings panel passes false (controls-only — no calendar grid, no markets tab).
+     */
+    showCalendarEntry?: boolean;
+    /**
+     * The calendar/events entry buttons rendered after the divider when
+     * showCalendarEntry is true. HybridDatePicker passes its own tab-switch
+     * IconButtons here so the live picker stays byte-behavior-identical; the
+     * standalone bar owns no tab state of its own.
+     */
+    calendarEntry?: React.ReactNode;
+}
+export declare function TimeframeQuickBar({ selectedPreset, onSelect, pinnedPreset, onPin, openGroup, onOpenChange, disableHover, showCalendarEntry, calendarEntry, }: TimeframeQuickBarProps): React.ReactElement;
+export declare namespace TimeframeQuickBar {
+    var displayName: string;
+}

package/lib/primitives/dashboard/TimeFrame/index.d.ts

@@ -7,6 +7,8 @@ export { HybridDatePicker } from './HybridDatePicker';
 export { TimeFrame } from './TimeFrame';
 export { MiniCalendar } from './MiniCalendar';
 export { ExpandableChip } from './ExpandableChip';
+export { TimeframeQuickBar } from './TimeframeQuickBar';
+export type { TimeframeQuickBarProps } from './TimeframeQuickBar';
 export { MarketPresetRow } from './MarketPresetRow';
 export { SimpleSelector } from './SimpleSelector';
 export type { SimpleSelectorProps } from './SimpleSelector';

package/lib/primitives/dashboard/TimeFrame/types.d.ts

@@ -147,6 +147,13 @@ export interface ExpandableChipProps {
     isOpen?: boolean;
     /** Called when open state changes */
     onOpenChange?: (groupId: string, isOpen: boolean) => void;
+    /**
+     * When true, mouse-enter/leave no longer call onOpenChange — the dropdown only
+     * toggles via chip click (click-to-open). Defaults false so the live top-bar
+     * HybridDatePicker keeps hover-to-open. quick-260601-gyl: the Settings-panel
+     * Quick Bar passes true.
+     */
+    disableHover?: boolean;
 }
 /** Market preset data for MarketPresetRow */
 export interface MarketPresetData {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mt-gloss/ui",
-  "version": "0.1.142",
+  "version": "0.1.143",
   "type": "module",
   "publishConfig": {
     "access": "public"