@mt-gloss/ui 0.0.6 → 0.0.8

package/lib/{SegmentedControl.d.ts → primitives/SegmentedControl.d.ts}

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { IconValue } from './types/icon';
+import { IconValue } from '../types/icon';
 export interface SegmentedControlOption {
     /**
      * Unique value for this option

package/lib/{Select.d.ts → primitives/Select.d.ts}

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { IconValue } from './types/icon';
+import { IconValue } from '../types/icon';
 /**
  * Configuration for a single select option
  */

package/lib/{SplitButton.d.ts → primitives/SplitButton.d.ts}

@@ -1,6 +1,6 @@
 import { default as React } from 'react';
 import { ButtonVariant } from './Button';
-import { IconValue } from './types/icon';
+import { IconValue } from '../types/icon';
 export interface SplitButtonMenuItem {
     /**
      * Menu item label

package/lib/{Transition.d.ts → primitives/Transition.d.ts}

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { AnimationPresetName } from './utils/animations';
+import { AnimationPresetName } from '../utils/animations';
 interface AnimatedElementProps {
     className?: string;
     style?: React.CSSProperties;

package/lib/{dashboard → primitives/dashboard}/ChartControlBar/types.d.ts

@@ -2,7 +2,10 @@ import { TabGroupProps } from '../TabGroup/types';
 /** A selectable filter option for entity/item dropdowns. */
 export interface FilterOption {
     id: string;
-    label: string;
+    /** Display text (dashboard convention) */
+    name?: string;
+    /** Display text (gloss-ui convention) */
+    label?: string;
     type?: string;
     group?: string;
 }

package/lib/primitives/dashboard/MetricCard/CardBack.d.ts

@@ -0,0 +1,31 @@
+export interface CardBackProps {
+    currentTimeframe?: string;
+    onSelectTimeframe?: (presetId: string) => void;
+    title?: string;
+    mode?: 'single' | 'stacked';
+    currentStackedTimeframes?: string[];
+    onSelectStackedTimeframes?: (timeframes: string[]) => void;
+}
+/**
+ * CardBack - Back face of the 3D flipped card.
+ * Shows timeframe preset grid for quick configuration.
+ *
+ * Supports two modes:
+ * - `single`: select one timeframe preset
+ * - `stacked`: select 2-3 timeframes for stacked group cards
+ *
+ * @example
+ * ```tsx
+ * import { CardBack } from '@mt-gloss/ui';
+ *
+ * <CardBack
+ *   mode="single"
+ *   currentTimeframe="MTD"
+ *   onSelectTimeframe={(presetId) => console.log(presetId)}
+ * />
+ * ```
+ */
+export declare const CardBack: {
+    ({ currentTimeframe, onSelectTimeframe, title, mode, currentStackedTimeframes, onSelectStackedTimeframes, }: CardBackProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/lib/primitives/dashboard/MetricCard/CardShell.d.ts

@@ -0,0 +1,22 @@
+import { CardShellProps } from './types';
+/**
+ * CardShell - Shared card wrapper with hover states, 180ms leave timeout,
+ * 3D perspective container, and GutterActions integration.
+ *
+ * Supports 3D flip to a CardBack panel for quick timeframe settings when
+ * `enableQuickSettings` is true. Stacked group cards can flip to select
+ * multiple timeframes.
+ *
+ * @example
+ * ```tsx
+ * import { CardShell, MetricCard } from '@mt-gloss/ui';
+ *
+ * <CardShell colSpan={1} enableQuickSettings onUpdateTimeframe={handleTimeframe}>
+ *   <MetricCard variant="standard" label="Revenue" value={125430} />
+ * </CardShell>
+ * ```
+ */
+export declare const CardShell: {
+    ({ children, colSpan, isStale, isRetrying, beta, disabled, style, onGraph, onDetails, onCustomize, onRemove, onWhatsThis, onExpand, onShrink, onMove, onReplace, onNavigate, onRetry, onRefresh, enableQuickSettings, onUpdateTimeframe, instanceTimeframe, cardTitle, onViewAsStack, onUnstack, isStackedGroup, onUpdateStackedTimeframes, instanceStackedTimeframes, isGraphActive, isTableActive, isGraphCard, canExpand, cardRef: externalCardRef, }: CardShellProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/lib/{dashboard → primitives/dashboard}/MetricCard/index.d.ts

@@ -1,10 +1,12 @@
 export { MetricCard } from './MetricCard';
 export { CardShell } from './CardShell';
+export { CardBack } from './CardBack';
 export { TrendIndicator } from './TrendIndicator';
 export { GutterActions } from './GutterActions';
 export { StackedGroupCard } from './StackedGroupCard';
 export { useSlideOutReveal } from './useSlideOutReveal';
 export * from './types';
+export type { CardBackProps } from './CardBack';
 export type { GutterActionsProps } from './GutterActions';
 export type { StackedGroupCardProps, StackedValueEntry } from './StackedGroupCard';
 export type { SlideOutRevealConfig, SlideOutRevealReturn } from './useSlideOutReveal';

package/lib/{dashboard → primitives/dashboard}/MetricCard/types.d.ts

@@ -80,6 +80,14 @@ export interface SegmentedVariant extends BaseMetricCardProps {
 }
 /** Discriminated union of all MetricCard variant props. */
 export type MetricCardProps = StandardVariant | SparklineVariant | BarsVariant | DonutVariant | HighlightVariant | ArrowVariant | ObjectArrowVariant | VersusVariant | SegmentedVariant;
+/**
+ * All card type identifiers for type-guard compatibility.
+ * The 9 renderable variants (standard through segmented) map to MetricCardProps discriminated union.
+ * The 4 additional types (name, ratio, action, stacked-group) are handled by separate
+ * dashboard-specific components (NameCard, RatioCard, ErrorCard, StackedGroupCard).
+ * INTEG-10: 'action' variant rendering is intentionally out of scope -- ErrorCard handles it.
+ */
+export type MetricCardType = 'standard' | 'sparkline' | 'bars' | 'donut' | 'highlight' | 'arrow' | 'object-arrow' | 'versus' | 'segmented' | 'name' | 'ratio' | 'action' | 'stacked-group';
 /** Props for the CardShell wrapper component. */
 export interface CardShellProps {
     children: ReactNode;
@@ -101,6 +109,15 @@ export interface CardShellProps {
     onRetry?: () => void;
     onRefresh?: () => void;
     onWhatsThis?: () => void;
+    enableQuickSettings?: boolean;
+    onUpdateTimeframe?: (presetId: string) => void;
+    instanceTimeframe?: string;
+    cardTitle?: string;
+    onViewAsStack?: () => void;
+    onUnstack?: () => void;
+    isStackedGroup?: boolean;
+    onUpdateStackedTimeframes?: (timeframes: string[]) => void;
+    instanceStackedTimeframes?: string[];
     isGraphActive?: boolean;
     isTableActive?: boolean;
     isGraphCard?: boolean;

package/lib/{dashboard → primitives/dashboard}/UnifiedContextMenu/UnifiedContextMenu.d.ts

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
 import { UnifiedContextMenuProps } from './types';
-declare function UnifiedContextMenuInner({ anchorEl, open, onClose, actions, row, entityType, dispatch, onAddTab, onFilter, onUpdateViz, onActionClick, }: UnifiedContextMenuProps): import("react/jsx-runtime").JSX.Element;
+declare function UnifiedContextMenuInner({ anchorEl, open, onClose, actions: actionsProp, cellKind, row, entityType, entityId, entityName, timeFrame, userType, tableType, field, syncTimeFrame, dispatch, onAddTab, onFilter, onUpdateViz, onActionClick, }: UnifiedContextMenuProps): import("react/jsx-runtime").JSX.Element;
 export declare const UnifiedContextMenu: React.MemoExoticComponent<typeof UnifiedContextMenuInner>;
 export {};

package/lib/primitives/dashboard/UnifiedContextMenu/config.d.ts

@@ -0,0 +1,42 @@
+import { CellKind, UnifiedMenuAction, MenuFilterOptions, EntityType } from './types';
+/** Maps entity type to profile navigation route key and param key */
+export declare const ENTITY_PROFILE_ROUTES: Record<EntityType, {
+    routeKey: string;
+    paramKey: string;
+    icon: string;
+}>;
+/** Maps singular entity type to filter key for tab creation */
+export declare const ENTITY_FILTER_KEYS: Record<EntityType, string>;
+/** Maps singular entity type to plural form */
+export declare const ENTITY_TYPE_PLURAL: Record<EntityType, string>;
+export declare const MENU_ACTIONS: UnifiedMenuAction[];
+/**
+ * Get filtered menu actions for a given cell kind and context.
+ *
+ * Filters by: cellKind, entityType, userType, orderStatus, tableType, field.
+ * Actions are returned in registry order (sections are grouped).
+ */
+export declare function getMenuActions(cellKind: CellKind, options?: MenuFilterOptions): UnifiedMenuAction[];
+/**
+ * Tab ID generation context -- data needed to construct backward-compatible tab IDs.
+ */
+export interface TabIdContext {
+    entityType?: string;
+    entityId?: string;
+    pluralEntityType?: string;
+    itemNumber?: string;
+    orderId?: string;
+    instanceId?: string;
+}
+/**
+ * Generate a backward-compatible tab ID for a given action.
+ *
+ * Patterns:
+ *   Entity tabs: ${pluralEntityType}-${entityId}
+ *   Item orders: item-orders-${itemNumber}
+ *   Item customers: item-customers-${itemNumber}
+ *   Item customers (revenue): item-customers-${itemNumber}-revenue
+ *   Order items: order-items-${orderId}
+ *   Metric tabs: metric-${instanceId}
+ */
+export declare function generateTabId(actionId: string, context: TabIdContext): string;

package/lib/{dashboard → primitives/dashboard}/UnifiedContextMenu/index.d.ts

@@ -1,3 +1,5 @@
 export { UnifiedContextMenu } from './UnifiedContextMenu';
+export { getMenuActions, generateTabId, ENTITY_PROFILE_ROUTES, ENTITY_FILTER_KEYS, ENTITY_TYPE_PLURAL } from './config';
+export type { TabIdContext } from './config';
 export type { UnifiedContextMenuProps, UnifiedMenuAction, MenuActionContext, MenuFilterOptions, CellKind, MenuSection, EntityType, } from './types';
 export { entityNameActions, orderIdActions, numericActions, allFixtures as contextMenuFixtures } from './fixtures/menuActions';

package/lib/{dashboard → primitives/dashboard}/UnifiedContextMenu/types.d.ts

@@ -101,8 +101,12 @@ export interface MenuFilterOptions {
 }
 /**
  * Props for the glossui UnifiedContextMenu component.
- * Receives pre-filtered actions from the container.
- * Supports dual-mode: dispatch prop OR individual callbacks.
+ *
+ * Supports dual-mode input:
+ * - Mode 1 (pre-filtered): Pass `actions` array directly
+ * - Mode 2 (cellKind-based): Pass `cellKind` and let the component compute actions via getMenuActions
+ *
+ * Supports dual-mode dispatch: `dispatch` prop OR individual callbacks.
  */
 export interface UnifiedContextMenuProps {
     /** Anchor element for menu positioning */
@@ -111,12 +115,28 @@ export interface UnifiedContextMenuProps {
     open: boolean;
     /** Close handler */
     onClose: () => void;
-    /** Pre-filtered actions from container */
-    actions: UnifiedMenuAction[];
     /** The data row that triggered the menu */
     row: Record<string, unknown>;
     /** Entity type context */
     entityType?: string;
+    /** Pre-filtered actions from container */
+    actions?: UnifiedMenuAction[];
+    /** Cell kind for automatic action filtering via getMenuActions */
+    cellKind?: CellKind;
+    /** Entity ID from the row */
+    entityId?: string;
+    /** Entity display name from the row */
+    entityName?: string;
+    /** Current timeframe for the table/context */
+    timeFrame?: unknown;
+    /** Current user type (sales-agency, manufacturer, buyer) */
+    userType?: string;
+    /** Current table type */
+    tableType?: string;
+    /** Clicked field name */
+    field?: string;
+    /** Sync timeframe flag for leaderboard tabs */
+    syncTimeFrame?: boolean;
     /** Dashboard dispatch function (if available) */
     dispatch?: (action: Record<string, unknown>) => void;
     /** Callback for tab creation actions */

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@mt-gloss/ui",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
   "main": "./index.js",
   "module": "./index.js",
   "types": "./index.d.ts",
@@ -10,7 +13,12 @@
       "import": {
         "types": "./index.d.ts",
         "default": "./index.js"
-      }
+      },
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "default": "./index.js"
     },
     "./styles.css": "./index.css"
   },

package/lib/composed/PasswordInput.d.ts

@@ -1,75 +0,0 @@
-import { default as React } from 'react';
-import { InputProps } from '../Input';
-export interface PasswordStrengthRule {
-    /**
-     * Unique identifier for the rule
-     */
-    id: string;
-    /**
-     * Display label for the rule
-     */
-    label: string;
-    /**
-     * Validation function
-     */
-    validate: (password: string) => boolean;
-}
-export type PasswordStrength = 'weak' | 'fair' | 'good' | 'strong';
-export interface PasswordInputProps extends Omit<InputProps, 'type' | 'rightIcon'> {
-    /**
-     * Whether to show the visibility toggle button
-     * @default true
-     */
-    showToggle?: boolean;
-    /**
-     * Whether to show the password strength indicator
-     * @default false
-     */
-    showStrength?: boolean;
-    /**
-     * Pre-calculated password strength (if you want to control it externally)
-     */
-    strength?: PasswordStrength;
-    /**
-     * Custom strength calculation rules
-     * If not provided, uses default rules
-     */
-    strengthRules?: PasswordStrengthRule[];
-    /**
-     * Whether to show a generate password button
-     * @default false
-     */
-    showGenerate?: boolean;
-    /**
-     * Callback when generate button is clicked
-     * If not provided, uses built-in generator
-     */
-    onGenerate?: (password: string) => void;
-    /**
-     * Length of generated password
-     * @default 16
-     */
-    generateLength?: number;
-    /**
-     * Whether to show rule checklist
-     * @default false
-     */
-    showRules?: boolean;
-}
-/**
- * PasswordInput - Specialized input for password entry
- *
- * Features visibility toggle, strength indicator, rule checklist,
- * and password generation.
- *
- * @example
- * ```tsx
- * <PasswordInput
- *   label="Password"
- *   showStrength
- *   showRules
- *   showGenerate
- * />
- * ```
- */
-export declare const PasswordInput: React.ForwardRefExoticComponent<PasswordInputProps & React.RefAttributes<HTMLInputElement>>;

package/lib/composed/SearchInput.d.ts

@@ -1,80 +0,0 @@
-import { default as React } from 'react';
-import { InputProps } from '../Input';
-export interface SearchSuggestion {
-    /**
-     * Unique identifier for the suggestion
-     */
-    id: string;
-    /**
-     * Display text for the suggestion
-     */
-    label: string;
-    /**
-     * Optional description text
-     */
-    description?: string;
-    /**
-     * Optional icon name
-     */
-    icon?: string;
-}
-export interface SearchInputProps extends Omit<InputProps, 'leftIcon' | 'rightIcon' | 'clearable'> {
-    /**
-     * Callback when search is triggered (Enter key or search button)
-     */
-    onSearch?: (value: string) => void;
-    /**
-     * Debounce delay in milliseconds for onChange
-     * @default 0
-     */
-    debounce?: number;
-    /**
-     * Whether a search is currently in progress
-     */
-    isSearching?: boolean;
-    /**
-     * List of suggestions to display in dropdown
-     */
-    suggestions?: SearchSuggestion[];
-    /**
-     * Callback when a suggestion is selected
-     */
-    onSuggestionSelect?: (suggestion: SearchSuggestion) => void;
-    /**
-     * Whether to show suggestions dropdown
-     * @default false
-     */
-    showSuggestions?: boolean;
-    /**
-     * Show keyboard shortcut hint (e.g., Cmd+K)
-     */
-    showShortcut?: boolean;
-    /**
-     * Keyboard shortcut key (works with Cmd/Ctrl)
-     * @default 'k'
-     */
-    shortcutKey?: string;
-    /**
-     * Whether the search input should always show clear button when has value
-     * @default true
-     */
-    clearable?: boolean;
-}
-/**
- * SearchInput - Specialized input for search functionality
- *
- * Features search icon, debounced onChange, suggestions dropdown,
- * keyboard shortcut support, and loading state.
- *
- * @example
- * ```tsx
- * <SearchInput
- *   placeholder="Search..."
- *   onSearch={(query) => searchProducts(query)}
- *   suggestions={suggestions}
- *   onSuggestionSelect={handleSelect}
- *   showShortcut
- * />
- * ```
- */
-export declare const SearchInput: React.ForwardRefExoticComponent<SearchInputProps & React.RefAttributes<HTMLInputElement>>;

package/lib/dashboard/MetricCard/CardShell.d.ts

@@ -1,22 +0,0 @@
-import { CardShellProps } from './types';
-/**
- * CardShell - Shared card wrapper with hover states, 180ms leave timeout,
- * and perspective container.
- *
- * GlossUI version: accepts `gutterContent` as a ReactNode slot instead of
- * importing GutterActions directly. This keeps CardShell free of dashboard-
- * specific UI dependencies.
- *
- * @example
- * ```tsx
- * import { CardShell, MetricCard } from '@mt-gloss/ui';
- *
- * <CardShell colSpan={1}>
- *   <MetricCard variant="standard" label="Revenue" value={125430} />
- * </CardShell>
- * ```
- */
-export declare const CardShell: {
-    ({ children, colSpan, isStale, isRetrying, beta, disabled, style, onGraph, onDetails, onCustomize, onRemove, onWhatsThis, onExpand, onShrink, onMove, onReplace, onNavigate, onRetry, onRefresh, isGraphActive, isTableActive, isGraphCard, canExpand, cardRef: externalCardRef, }: CardShellProps): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};

package/lib/patterns/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * Gloss UI Patterns
- *
- * Composite, pre-configured component groupings for common use cases.
- * Each pattern exports:
- * - Default: The React component
- * - metadata: PatternMetadata for database sync
- * - schema (optional): Zod validation schema
- */
-export type { PatternMetadata, PatternPropDefinition, PatternCategory, PatternRecord, } from './types';
-export { default as LoginForm, metadata as loginFormMetadata, loginSchema, type LoginFormProps, } from './forms/LoginForm';
-export { default as AddressGroup, metadata as addressGroupMetadata, addressSchema, type AddressGroupProps, } from './forms/AddressGroup';
-export { default as CreditCardForm, metadata as creditCardFormMetadata, creditCardSchema, type CreditCardFormProps, } from './forms/CreditCardForm';
-export { default as DestructiveModal, metadata as destructiveModalMetadata, type DestructiveModalProps, } from './feedback/DestructiveModal';