@mt-gloss/ui 0.0.23 → 0.0.24

package/lib/facade/data-display.d.ts

@@ -14,7 +14,7 @@ export type { MetricCardProps, CardShellProps } from '../primitives/dashboard/Me
 export type { StackedGroupCardProps, StackedValueEntry } from '../primitives/dashboard/MetricCard/StackedGroupCard';
 export type { CardBackProps } from '../primitives/dashboard/MetricCard/CardBack';
 export { ActionStrip, buildDefaultOverflow } from '../primitives/overlays/ActionStrip';
-export type { ActionStripProps, PrimaryAction, OverflowAction, ActionStripContext, ActionStripVariant, ActionStripMenuDirection, DefaultHandlers, } from '../primitives/overlays/ActionStrip';
+export type { ActionStripProps, PrimaryAction, OverflowAction, ActionStripContext, ActionStripMenuDirection, DefaultHandlers, } from '../primitives/overlays/ActionStrip';
 export { SparklineBg } from '../primitives/dashboard/MetricCard';
 export { BarsBg } from '../primitives/dashboard/MetricCard';
 export { DonutChart } from '../primitives/dashboard/MetricCard';

package/lib/primitives/dashboard/MetricCard/flipAndStage/types.d.ts

@@ -36,6 +36,13 @@ export interface FlipAndStageInternalState {
     activeCardId: string | null;
     activeDimensionId: string | null;
     dirtyState: Record<string, unknown>;
+    /**
+     * Phase 17: which dimension section the overlay should render.
+     * `null` means no section is open. Independent of `state` — the overlay
+     * is only shown after an explicit setOpenSection() call; `cancelConfig()`
+     * and `commitConfig()` MUST null this out (per 17-UI-SPEC §Sequencing).
+     */
+    openSection: string | null;
 }
 /**
  * The full value exposed by useFlipAndStage and FlipAndStageContext.
@@ -48,6 +55,8 @@ export interface FlipAndStageInternalState {
  * - `commitConfig` — persist edits and return to idle; optional patch merged into dirty
  * - `cancelConfig` — discard edits and return to idle
  * - `setDirty` — merge additional edits into dirtyState
+ * - `openSection` — (Phase 17) which dimension section the overlay should render
+ * - `setOpenSection` — (Phase 17) mutate openSection; cancel/commit auto-null it
  */
 export interface FlipAndStageValue {
     activeCardId: string | null;
@@ -70,6 +79,17 @@ export interface FlipAndStageValue {
     cancelConfig: () => void;
     /** Merge additional dirty fields. Successive calls accumulate (not replace). */
     setDirty: (patch: Record<string, unknown>) => void;
+    /**
+     * Phase 17: which dimension section the overlay should render.
+     * `null` = no section open. Independent of `state` — the overlay is only
+     * rendered once a consumer explicitly calls `setOpenSection(id)`.
+     */
+    openSection: string | null;
+    /**
+     * Phase 17: mutate openSection. `cancelConfig()` and `commitConfig()` MUST
+     * null this out as part of their state reset (per 17-UI-SPEC §Sequencing).
+     */
+    setOpenSection: (id: string | null) => void;
 }
 /**
  * Options for useFlipAndStage.

package/lib/primitives/dashboard/ReconfigBacksideButtons/ReconfigBacksideButtons.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { ReconfigBacksideButtonsProps, ReconfigDimension } from './types';
+/**
+ * Verbatim button labels per 17-UI-SPEC §Copywriting Contract.
+ * Exported as a const to make future localization extraction a single edit.
+ */
+declare const LABELS: Record<ReconfigDimension, string>;
+/**
+ * ReconfigBacksideButtons — renders the type-picker button strip on a
+ * metric-card backside. See module doc for parent wiring contract.
+ */
+export declare const ReconfigBacksideButtons: React.FC<ReconfigBacksideButtonsProps>;
+export { LABELS as RECONFIG_BACKSIDE_LABELS };

package/lib/primitives/dashboard/ReconfigBacksideButtons/__tests__/fixtures/nyquist-10-matrix.d.ts

@@ -0,0 +1,19 @@
+import { ReconfigDimension } from '../../types';
+export type Nyquist10Archetype = 'standard' | 'stacked-group' | 'order-status-stack';
+export interface Nyquist10MatrixRow {
+    /** cardType the matrix row describes. */
+    cardType: Nyquist10Archetype;
+    /** Dimension under test (the backside button to click). */
+    dimension: ReconfigDimension;
+    /** All dimensions expected on the backside for this cardType. */
+    expectedBacksideDimensions: ReadonlyArray<ReconfigDimension>;
+    /** data-section-id that MUST be the sole rendered section post-click. */
+    expectedOverlaySectionId: string;
+}
+export declare const NYQUIST_10_MATRIX: ReadonlyArray<Nyquist10MatrixRow>;
+/** Row count pin consumed by the contract runner. */
+export declare const NYQUIST_10_ROW_COUNT: number;
+/** The 3 archetypes enumerated (stable order, useful for grouped describes). */
+export declare const NYQUIST_10_ARCHETYPES: ReadonlyArray<Nyquist10Archetype>;
+/** Matrix lookup — parity check against reptime's CARD_TYPE_DIMENSION_MATRIX. */
+export declare const NYQUIST_10_DIMENSIONS_BY_CARD_TYPE: Readonly<Record<Nyquist10Archetype, ReadonlyArray<ReconfigDimension>>>;

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

@@ -0,0 +1,5 @@
+/**
+ * Phase 17, Plan 01 — ReconfigBacksideButtons barrel.
+ */
+export { ReconfigBacksideButtons, RECONFIG_BACKSIDE_LABELS } from './ReconfigBacksideButtons';
+export type { ReconfigBacksideButtonsProps, ReconfigDimension } from './types';

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

@@ -0,0 +1,47 @@
+/**
+ * Phase 17, Plan 01: ReconfigBacksideButtons primitive — public type contracts.
+ *
+ * Renders the card-back type-picker strip (one button per configurable
+ * dimension). Buttons only — NO dropdowns, NO popovers. See 17-UI-SPEC
+ * §Backside type-picker button labels for the full spec.
+ *
+ * @module primitives/dashboard/ReconfigBacksideButtons/types
+ */
+/**
+ * The six configurable dimensions exposable on any metric card backside.
+ * Per-card-type matrix lives downstream in reptime (`CARD_TYPE_DIMENSION_MATRIX`).
+ */
+export type ReconfigDimension = 'timeframe' | 'threshold' | 'slots' | 'size' | 'color' | 'pinned';
+/**
+ * Public props for ReconfigBacksideButtons.
+ *
+ * Minimal by design — no optional prop beyond these four. Parent wires
+ * onDimensionSelect to `flipAndStage.setOpenSection(dim)` + `flipToFace()`.
+ */
+export interface ReconfigBacksideButtonsProps {
+    /**
+     * Dimensions to render (order is preserved; empty array → component
+     * returns null — parent should avoid rendering at all for excluded types).
+     */
+    dimensions: ReadonlyArray<ReconfigDimension>;
+    /**
+     * Fired on button click. Parent wires:
+     *   flipAndStage.setOpenSection(dimension)
+     *   flipAndStage.flipToFace()
+     * in that order.
+     */
+    onDimensionSelect: (dimension: ReconfigDimension) => void;
+    /**
+     * Highlights the active dimension with aria-current="true" + persisted
+     * hover tint. Used when re-entering the backside with a previously-
+     * launched overlay still in memory.
+     */
+    activeDimension?: ReconfigDimension | null;
+    /**
+     * Screen-reader label substitution — rendered as
+     * `aria-label="Configure {ariaCardTypeLabel}: choose a dimension"` on root.
+     */
+    ariaCardTypeLabel?: string;
+    /** Optional consumer-provided class appended to the BEM root class. */
+    className?: string;
+}

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

@@ -7,6 +7,7 @@ export * from './UnifiedBreakdownTable';
 export * from './ChartControlBar';
 export * from './UnifiedContextMenu';
 export * from './TimeFrame';
+export * from './ReconfigBacksideButtons';
 export * from './MetricCardGrid';
 export * from './TabbedDataView';
 export * from './MetricGroupContainer';

package/lib/primitives/overlays/ActionStrip/__tests__/fixtures/nyquist-09-parity-matrix.d.ts

@@ -0,0 +1,18 @@
+export type FlipDir = 'up' | 'down';
+export type Variant = 'default' | 'config';
+export interface ParityHarness {
+    row: ParityRow;
+}
+export interface ParityRow {
+    behaviorId: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+    behaviorLabel: string;
+    flip: FlipDir;
+    variant: Variant;
+    /** Skip reason (row still emits as `test.skip` so it is visible in vitest output). */
+    skip?: string;
+    /** Concrete assertion executed by `it.each` runner. */
+    assert: (harness: ParityHarness) => Promise<void> | void;
+}
+export declare const PARITY_MATRIX: ParityRow[];
+/** Row count = 9 × 2 × 2 = 36. Exposed for assertion convenience in the runner. */
+export declare const MATRIX_ROW_COUNT: number;

package/lib/primitives/overlays/ActionStrip/index.d.ts

@@ -1,5 +1,5 @@
 export { ActionStrip } from './ActionStrip';
-export type { PrimaryAction, OverflowAction, ActionStripProps, ActionStripContext, ActionStripVariant, ActionStripMenuDirection, } from './types';
+export type { PrimaryAction, OverflowAction, ActionStripProps, ActionStripContext, ActionStripMenuDirection, } from './types';
 export { subscribe, getActive, setActive, resetForTests, } from './overflowMenuRegistry';
 export { useSlideOutReveal } from './useSlideOutReveal';
 export type { SlideOutRevealConfig, SlideOutRevealReturn, SlideOutRevealStyle, } from './useSlideOutReveal';

package/lib/primitives/overlays/ActionStrip/types.d.ts

@@ -71,12 +71,16 @@ export interface OverflowAction {
     visibleWhen?: (ctx: ActionStripContext) => boolean;
 }
 /**
- * `'default'` is the standard pill + menu. `'config'` is a transitional variant
- * that replaces the More trigger with Save/Cancel pills during reconfig flow;
- * Phase 17 retires this variant entirely.
+ * Menu-flip direction. Omit to let floating-ui's flip() middleware decide.
+ *
+ * AP-13 — the reconfig-surface pass-through variant was retired in Phase 17
+ * (plan 17-04): its type alias and Save / Cancel pass-through props were
+ * removed along with the render branch. Cancel / close now live in the
+ * Phase 17 overlay header, not inside ActionStrip. Only lingering references
+ * allowed in source: skip-marker strings in NYQUIST-09 parity-matrix fixtures
+ * under `__tests__/fixtures/`. Any resurrection in source is a regression and
+ * is blocked by `nyquist-10-ap-guards.test.ts` (AP-13 source-grep).
  */
-export type ActionStripVariant = 'default' | 'config';
-/** Menu-flip direction. Omit to let floating-ui's flip() middleware decide. */
 export type ActionStripMenuDirection = 'up' | 'down';
 /**
  * Public ActionStrip prop contract. Stable across Phase 16 plans 16-01..05.
@@ -92,8 +96,6 @@ export interface ActionStripProps {
     expanded: boolean;
     /** Called to toggle `expanded`. */
     onExpandedChange: (open: boolean) => void;
-    /** Defaults to 'default'. Phase 17 retires 'config'. */
-    variant?: ActionStripVariant;
     /** CardBack collapse-to-Undo. Preserved behavior #5. */
     isFlipped?: boolean;
     /** Called when the Undo button is clicked while isFlipped. */
@@ -110,8 +112,4 @@ export interface ActionStripProps {
     graphLabel?: string;
     /** Consumer-overridable tooltip for the Details pinned button. */
     detailsLabel?: string;
-    /** Config variant Save handler. Retired in Phase 17 — pass-through only this phase. */
-    onConfigSave?: () => void;
-    /** Config variant Cancel handler. Retired in Phase 17 — pass-through only this phase. */
-    onConfigCancel?: () => void;
 }

package/package.json

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