@mt-gloss/ui 0.1.93 → 0.1.95

package/lib/composites/panels/asserter/domWalkAsserter.d.ts

@@ -0,0 +1,17 @@
+import { AssertReport } from '../orchestrator/transitionToPanel';
+export type { AssertReport };
+/**
+ * Pure DOM-walk — exported separately for tests + external callers that want a
+ * one-shot probe without flipping the global flag.
+ */
+export declare function assertPanelDomShape(): AssertReport;
+/**
+ * Enable the Q12-12 asserter. First call assigns `window.__panelsAsserter`
+ * (only on first enable — avoids repeated reassignment per Rule 29).
+ */
+export declare function enablePanelAsserter(): void;
+/**
+ * Disable the asserter. Keeps `lastReport` accessible (test 8 invariant) and
+ * keeps the window surface attached so future enable() calls don't reassign.
+ */
+export declare function disablePanelAsserter(): void;

package/lib/composites/panels/hooks/useTransitionToPanel.d.ts

@@ -0,0 +1,2 @@
+import { PanelId, TriggerContext } from '../coordinator/types';
+export declare function useTransitionToPanel(): (panelId: PanelId, trigger: TriggerContext) => void;

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

@@ -21,6 +21,15 @@ export { positionKey } from './utils/positionKey';
 export { useReducedMotionPanel } from './hooks/useReducedMotionPanel';
 export { PanelMount } from './PanelMount';
 export type { PanelMountProps } from './PanelMount';
+export { transitionToPanel } from './orchestrator/transitionToPanel';
+export type { TransitionToPanelArgs, AssertReport } from './orchestrator/transitionToPanel';
+export { useTransitionToPanel } from './hooks/useTransitionToPanel';
+export { CloneStage } from './stage3d/CloneStage';
+export type { CloneStageProps } from './stage3d/CloneStage';
+export { CloneCard } from './stage3d/CloneCard';
+export type { CloneCardProps } from './stage3d/CloneCard';
+export { enablePanelAsserter, disablePanelAsserter, assertPanelDomShape, } from './asserter/domWalkAsserter';
+export type { SettingsShellProps } from './shells/SettingsShell';
 export { usePanelCoordinator } from './hooks/usePanelCoordinator';
 export type { UsePanelCoordinatorReturn } from './hooks/usePanelCoordinator';
 export { reducer, initialState } from './coordinator/coordinator';

package/lib/composites/panels/orchestrator/transitionToPanel.d.ts

@@ -0,0 +1,21 @@
+import { PanelAction, PanelId, PanelState, TriggerContext } from '../coordinator/types';
+export interface AssertReport {
+    valid?: boolean;
+    mount?: 'present' | 'absent';
+    chrome?: 'present' | 'absent';
+    frozen?: 'cleaned' | 'lingering';
+    orphans?: string[];
+    branch?: string;
+    timestamp?: number;
+}
+export interface TransitionToPanelArgs {
+    panelId: PanelId;
+    trigger: TriggerContext;
+    state: PanelState;
+    dispatch: (action: PanelAction) => void;
+    mountEl: HTMLElement | null;
+    chromeEl: HTMLElement | null;
+    reducedMotion: boolean;
+    onAssert?: (report: AssertReport) => void;
+}
+export declare function transitionToPanel(args: TransitionToPanelArgs): void;

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

@@ -1,2 +1,10 @@
 import { PanelShellProps } from '../PanelHost';
-export declare function SettingsShell({ isOpen }: PanelShellProps): import("react/jsx-runtime").JSX.Element;
+export interface SettingsShellProps extends PanelShellProps {
+    /** Span of the source card (1|2|3). Plumbed by V2FeedbackSurface HOF. */
+    cardSpan?: 1 | 2 | 3;
+    /** Visible label on the clone card. Defaults to 'Metric'. */
+    cardLabel?: string;
+    /** Visible value on the clone card. Defaults to '—'. */
+    cardValue?: string;
+}
+export declare function SettingsShell({ isOpen, cardSpan, cardLabel, cardValue, }: SettingsShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+export interface CloneCardProps {
+    span: 1 | 2 | 3;
+    rotating?: boolean;
+    children?: ReactNode;
+}
+export declare function CloneCard({ span, rotating, children }: CloneCardProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,5 @@
+import { ReactNode } from 'react';
+export interface CloneStageProps {
+    children: ReactNode;
+}
+export declare function CloneStage({ children }: CloneStageProps): import("react/jsx-runtime").JSX.Element;

package/package.json

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