@mt-gloss/ui 0.1.97 → 0.1.99

package/lib/composites/dashboard/BellCutout/BellCutout.d.ts

@@ -1,11 +1,27 @@
 import { RefObject } from 'react';
 export type BellCutoutMode = 'default' | 'lock' | 'unread-count';
 export interface BellCutoutProps {
-    /** null → no chrome rendered. 'default' / 'lock' / 'unread-count' → chrome with corresponding data-mode. */
-    mode: BellCutoutMode | null;
+    /**
+     * Explicit prop-supplied mode (back-compat DEV-probe path). When
+     * subscribeToCoordinator=true (default) and ctx.state.lockHint != null,
+     * the ctx value WINS and this prop is ignored.
+     */
+    mode?: BellCutoutMode | null;
     /** When mode='unread-count', this drives the ::before count prefix via data-count. */
     count?: number;
     /** Anchor element to derive cutout circle center from. */
     anchorRef: RefObject<HTMLElement | null>;
+    /**
+     * When true (default), subscribe to PanelContext and derive 'lock' mode from
+     * state.lockHint. When false, BellCutout ignores context entirely and reflects
+     * only the `mode` prop — used by test scaffolds + isolated mounts.
+     */
+    subscribeToCoordinator?: boolean;
+    /**
+     * Optional cardId → display-label map. When state.lockHint.activeCardId is
+     * present, the rendered dwell text reads `cardLabels[activeCardId]`. When the
+     * id is absent from the map, the literal id is rendered as fallback.
+     */
+    cardLabels?: Record<string, string>;
 }
 export declare function BellCutout(props: BellCutoutProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -1,10 +1,96 @@
 import { AssertReport } from '../orchestrator/transitionToPanel';
+/**
+ * Phase 11.5 P6 W5 — per-constraint assertion row. `pass: 'wiring_only'`
+ * marks rows verified by source-proof (Rule 11) when no runtime probe is
+ * available (C13 same-position slide, C14 cross-position handoff).
+ */
+export type AssertRow = {
+    id: string;
+    constraint: string;
+    expected: string;
+    actual: string;
+    pass: boolean | 'wiring_only';
+};
 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;
+/**
+ * Canonical 14 CC ids (declaration order). G3 gate token — one literal
+ * `id: 'CN'` per line so a `-c` line-count grep for
+ * `id:\s*'C(1[0-4]|[1-9])'` returns ≥14.
+ */
+export declare const CC_IDS: readonly [{
+    readonly id: "C1";
+}, {
+    readonly id: "C2";
+}, {
+    readonly id: "C3";
+}, {
+    readonly id: "C4";
+}, {
+    readonly id: "C5";
+}, {
+    readonly id: "C6";
+}, {
+    readonly id: "C7";
+}, {
+    readonly id: "C8";
+}, {
+    readonly id: "C9";
+}, {
+    readonly id: "C10";
+}, {
+    readonly id: "C11";
+}, {
+    readonly id: "C12";
+}, {
+    readonly id: "C13";
+}, {
+    readonly id: "C14";
+}];
+/**
+ * Compute the 14 CC rows against the current live DOM. Pure walk; no
+ * side effects. Returns rows in C1..C14 declaration order.
+ */
+export declare function assertCcOnly(): AssertRow[];
+/**
+ * Look up a single CC row by id. Returns `undefined` if not present (e.g.,
+ * passed an out-of-range id). Convenience wrapper around `assertCcOnly()`.
+ */
+export declare function getCcRowById(id: string): AssertRow | undefined;
+/**
+ * Thin wrapper returning both Q12 + CC verdicts. Per user override
+ * (Option 3 de-scope, 2026-05-14): `q12` maps to the existing P3b
+ * Q12-12 single source-of-motion DOM check (the same AssertReport shape
+ * returned by `assertPanelDomShape()`), surfaced here as a 1-row array
+ * for shape uniformity. No fabricated Q12-01..Q12-11 walks.
+ */
+export declare function assertPanelTruths(): {
+    q12: AssertRow[];
+    cc: AssertRow[];
+};
+type AsserterSurface = {
+    enable: () => void;
+    disable: () => void;
+    isEnabled: () => boolean;
+    getLastReport: () => AssertReport | null;
+    recordTransition: (r: AssertReport) => void;
+    assertOnce: () => AssertReport;
+    assertCcOnly: () => AssertRow[];
+    getCcRowById: (id: string) => AssertRow | undefined;
+    assertPanelTruths: () => {
+        q12: AssertRow[];
+        cc: AssertRow[];
+    };
+};
+declare global {
+    interface Window {
+        __panelsAsserter?: AsserterSurface;
+    }
+}
 /**
  * Enable the Q12-12 asserter. First call assigns `window.__panelsAsserter`
  * (only on first enable — avoids repeated reassignment per Rule 29).

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

@@ -61,6 +61,11 @@ export interface LockHint {
     activeCardId: string | null;
     expiresAt: number;
 }
+export interface SettingsBufferDelta {
+    kind: 'settings';
+    changes: Record<string, unknown>;
+}
+export type BufferDelta = SettingsBufferDelta;
 export type SideEffect = {
     type: 'SCHEDULE_TIMER';
     ms: number;
@@ -77,6 +82,10 @@ export type SideEffect = {
     previousPanelId: PanelId;
 } | {
     type: 'COMMIT_BUFFER';
+    payload?: {
+        cardId: string;
+        delta: BufferDelta;
+    };
 } | {
     type: 'DISCARD_BUFFER';
 } | {
@@ -88,6 +97,7 @@ export interface PanelState {
     bellCutoutOpen: boolean;
     isDirty: boolean;
     lockHint: LockHint | null;
+    bufferByCard: Record<string, BufferDelta>;
     lastClose: {
         panelId: PanelId;
         reason: CloseReason;
@@ -114,6 +124,14 @@ export type PanelAction = {
     hint: LockHint;
 } | {
     type: 'CLEAR_LOCK_HINT';
+} | {
+    type: 'SET_BUFFER_VALUE';
+    cardId: string;
+    key: string;
+    value: unknown;
+} | {
+    type: 'CLEAR_BUFFER';
+    cardId: string;
 } | {
     type: 'DRAIN_SIDE_EFFECTS';
 };

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

@@ -44,7 +44,8 @@ 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 { enablePanelAsserter, disablePanelAsserter, assertPanelDomShape, assertCcOnly, getCcRowById, assertPanelTruths, } from './asserter/domWalkAsserter';
+export type { AssertRow } from './asserter/domWalkAsserter';
 export type { SettingsShellProps } from './shells/SettingsShell';
 export { usePanelCoordinator } from './hooks/usePanelCoordinator';
 export type { UsePanelCoordinatorReturn } from './hooks/usePanelCoordinator';

package/package.json

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