@mt-gloss/ui 0.1.95 → 0.1.97

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

@@ -0,0 +1,11 @@
+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;
+    /** 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>;
+}
+export declare function BellCutout(props: BellCutoutProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,2 @@
+export { BellCutout } from './BellCutout';
+export type { BellCutoutProps, BellCutoutMode } from './BellCutout';

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

@@ -0,0 +1,12 @@
+import { ReactNode, RefObject } from 'react';
+export interface BellPopoverProps {
+    anchorRef: RefObject<HTMLElement | null>;
+    isOpen: boolean;
+    onRequestClose: () => void;
+    /** Called when the cursor lands on the popover — used by host to cancel pending close. */
+    onPopoverEnter?: () => void;
+    /** Called when the cursor leaves the popover — used by host to reschedule close. */
+    onPopoverLeave?: () => void;
+    children?: ReactNode;
+}
+export declare function BellPopover(props: BellPopoverProps): import("react/jsx-runtime").JSX.Element | null;

package/lib/composites/dashboard/BellPopover/index.d.ts

@@ -0,0 +1,2 @@
+export { BellPopover } from './BellPopover';
+export type { BellPopoverProps } from './BellPopover';

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

@@ -1 +1,3 @@
 export * from './BottomToolbar';
+export * from './BellPopover';
+export * from './BellCutout';

package/lib/composites/index.d.ts

@@ -5,3 +5,4 @@ export * from './data';
 export * from './overlay';
 export * from './navigation';
 export * from './controls';
+export * from './portal';

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

@@ -0,0 +1,8 @@
+export declare const PANEL_IDS: {
+    readonly SETTINGS: "settings";
+    readonly CATALOG_ADD: "catalog-add";
+    readonly CATALOG_REPLACE: "catalog-replace";
+    readonly PAGE_MGMT: "page-management";
+    readonly NOTIFICATION_CENTER: "notification-center";
+};
+export type PanelIdKey = keyof typeof PANEL_IDS;

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

@@ -9,6 +9,22 @@
  */
 export { PanelProvider, usePanelContext, usePanelContextOptional } from './PanelProvider';
 export { SettingsShell } from './shells/SettingsShell';
+export { CatalogAddShell } from './shells/CatalogAddShell';
+export type { CatalogAddShellProps } from './shells/CatalogAddShell';
+export { CatalogReplaceShell } from './shells/CatalogReplaceShell';
+export type { CatalogReplaceShellProps } from './shells/CatalogReplaceShell';
+export { PageMgmtShell } from './shells/PageMgmtShell';
+export type { PageMgmtShellProps } from './shells/PageMgmtShell';
+export { CatalogFooter, CatalogStateContext, useCatalogState, } from './shells/internals/CatalogFooter';
+export type { CatalogFooterMode, CatalogState, CatalogFooterProps, } from './shells/internals/CatalogFooter';
+export { PageMgmtFooter, PageMgmtStateContext, usePageMgmtState, } from './shells/internals/PageMgmtFooter';
+export type { PageMgmtState, PageMgmtFooterProps, } from './shells/internals/PageMgmtFooter';
+export type { CatalogTile } from './shells/internals/catalog-mocks';
+export { MOCK_LENSES, MOCK_DEFAULT_LENS, MOCK_TILES_BY_LENS, } from './shells/internals/catalog-mocks';
+export type { PageEntry } from './shells/internals/page-mgmt-mocks';
+export { MOCK_PAGES } from './shells/internals/page-mgmt-mocks';
+export { PANEL_IDS } from './coordinator/PANEL_IDS';
+export type { PanelIdKey } from './coordinator/PANEL_IDS';
 export { PanelHost } from './PanelHost';
 export { PanelHostShell } from './PanelHostShell';
 export { PanelSlot } from './PanelSlot';

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

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { PanelShellProps } from '../PanelHost';
+import { CatalogTile } from './internals/catalog-mocks';
+export interface CatalogAddShellProps extends PanelShellProps {
+    /** Available lenses; defaults to MOCK_LENSES (spike §6.2.5). */
+    lenses?: readonly string[];
+    /** Initial active lens; defaults to MOCK_DEFAULT_LENS ('Order flow'). */
+    defaultLens?: string;
+    /** Tile catalog keyed by lens; defaults to MOCK_TILES_BY_LENS. */
+    tilesByLens?: Readonly<Record<string, readonly CatalogTile[]>>;
+    /**
+     * Optional footer slot rendered as a SIBLING of the body, INSIDE the shell's
+     * CatalogStateContext.Provider. PanelSlot passes <CatalogFooter/> here so it
+     * can read live selectedTileId/description from this shell instance.
+     * Standalone tests (no PanelSlot) leave undefined → no footer.
+     */
+    footerSlot?: ReactNode;
+}
+export declare function CatalogAddShell({ isOpen, lenses, defaultLens, tilesByLens, footerSlot, }: CatalogAddShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+import { PanelShellProps } from '../PanelHost';
+import { CatalogTile } from './internals/catalog-mocks';
+export interface CatalogReplaceShellProps extends PanelShellProps {
+    /** Label of the card being replaced; rendered as 'replacing {label}' subtitle. */
+    replacingLabel?: string;
+    lenses?: readonly string[];
+    defaultLens?: string;
+    tilesByLens?: Readonly<Record<string, readonly CatalogTile[]>>;
+    /** See CatalogAddShellProps.footerSlot — sibling slot inside Provider. */
+    footerSlot?: ReactNode;
+}
+export declare function CatalogReplaceShell({ isOpen, replacingLabel, lenses, defaultLens, tilesByLens, footerSlot, }: CatalogReplaceShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+import { PanelShellProps } from '../PanelHost';
+import { PageEntry } from './internals/page-mgmt-mocks';
+export interface PageMgmtShellProps extends PanelShellProps {
+    /** Initial page list; defaults to MOCK_PAGES (§6.4.3 verbatim). */
+    pages?: readonly PageEntry[];
+    /** See CatalogAddShellProps.footerSlot — sibling slot inside Provider. */
+    footerSlot?: ReactNode;
+}
+export declare function PageMgmtShell({ isOpen, pages: initialPages, footerSlot, }: PageMgmtShellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -2,3 +2,18 @@
  * Panel shells barrel — all shells available from '@mt-gloss/ui/composites/panels'.
  */
 export { SettingsShell } from './SettingsShell';
+export type { SettingsShellProps } from './SettingsShell';
+export { CatalogAddShell } from './CatalogAddShell';
+export type { CatalogAddShellProps } from './CatalogAddShell';
+export { CatalogReplaceShell } from './CatalogReplaceShell';
+export type { CatalogReplaceShellProps } from './CatalogReplaceShell';
+export { PageMgmtShell } from './PageMgmtShell';
+export type { PageMgmtShellProps } from './PageMgmtShell';
+export { PageMgmtFooter, PageMgmtStateContext, usePageMgmtState } from './internals/PageMgmtFooter';
+export type { PageMgmtState, PageMgmtFooterProps } from './internals/PageMgmtFooter';
+export { MOCK_PAGES } from './internals/page-mgmt-mocks';
+export type { PageEntry } from './internals/page-mgmt-mocks';
+export { CatalogFooter, CatalogStateContext, useCatalogState } from './internals/CatalogFooter';
+export type { CatalogFooterMode, CatalogState, CatalogFooterProps } from './internals/CatalogFooter';
+export type { CatalogTile } from './internals/catalog-mocks';
+export { MOCK_LENSES, MOCK_DEFAULT_LENS, MOCK_TILES_BY_LENS } from './internals/catalog-mocks';

package/lib/composites/panels/shells/internals/CatalogFooter.d.ts

@@ -0,0 +1,18 @@
+import { PanelAction } from '../../coordinator/types';
+export type CatalogFooterMode = 'add' | 'replace';
+export interface CatalogState {
+    mode: CatalogFooterMode;
+    selectedTileId: string | null;
+    description: string | null;
+}
+export declare const CatalogStateContext: import('react').Context<CatalogState | null>;
+export declare function useCatalogState(): CatalogState | null;
+export interface CatalogFooterProps {
+    /**
+     * Override mode if needed (rare — usually the context's `mode` wins). PanelSlot
+     * passes mode explicitly for safety when no context Provider is mounted.
+     */
+    mode?: CatalogFooterMode;
+    dispatch: (action: PanelAction) => void;
+}
+export declare function CatalogFooter({ mode, dispatch }: CatalogFooterProps): import("react/jsx-runtime").JSX.Element | null;

package/lib/composites/panels/shells/internals/CatalogLensPicker.d.ts

@@ -0,0 +1,6 @@
+export interface CatalogLensPickerProps {
+    lenses: readonly string[];
+    activeLens: string;
+    onLensChange: (lens: string) => void;
+}
+export declare function CatalogLensPicker({ lenses, activeLens, onLensChange }: CatalogLensPickerProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/internals/CatalogTileGrid.d.ts

@@ -0,0 +1,17 @@
+import { CatalogTile } from './catalog-mocks';
+export interface CatalogTileGridProps {
+    tiles: readonly CatalogTile[];
+    selectedTileId: string | null;
+    onSelectTile: (id: string, desc: string) => void;
+}
+/**
+ * §6.2.8 — stack-tile value renderer. Splits a "LABEL N · LABEL N · LABEL N"
+ * (or "N today · N MTD · …") value string into per-segment React nodes.
+ * Each segment becomes `<span><strong>{num}</strong><small>{lbl}</small></span>`
+ * with the numeric token first (W2-G6 enforces strong+small+split present).
+ *
+ * The regex captures the leading numeric/currency/percent token; the remainder
+ * is the label. If the segment has no number, the whole text falls into <small>.
+ */
+export declare function renderStackValue(val: string): import("react/jsx-runtime").JSX.Element[];
+export declare function CatalogTileGrid({ tiles, selectedTileId, onSelectTile }: CatalogTileGridProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/internals/PageMgmtFooter.d.ts

@@ -0,0 +1,16 @@
+import { PageEntry } from './page-mgmt-mocks';
+export interface PageMgmtState {
+    pages: PageEntry[];
+    setPages: (updater: (prev: PageEntry[]) => PageEntry[]) => void;
+}
+export declare const PageMgmtStateContext: import('react').Context<PageMgmtState | null>;
+export declare function usePageMgmtState(): PageMgmtState | null;
+export interface PageMgmtFooterProps {
+    /**
+     * Optional dispatch — unused by footer per §6.4.6 (live-commit; no CLOSE_PANEL).
+     * Kept on the prop signature so PanelSlot can pass it uniformly with other
+     * footers without TS errors.
+     */
+    dispatch?: unknown;
+}
+export declare function PageMgmtFooter(_?: PageMgmtFooterProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/internals/PageMgmtRow.d.ts

@@ -0,0 +1,8 @@
+import { PageEntry } from './page-mgmt-mocks';
+export interface PageMgmtRowProps {
+    page: PageEntry;
+    onRename?: (id: string) => void;
+    onKebab?: (id: string) => void;
+    onDragStart?: (id: string) => void;
+}
+export declare function PageMgmtRow({ page, onRename, onKebab, onDragStart }: PageMgmtRowProps): import("react/jsx-runtime").JSX.Element;

package/lib/composites/panels/shells/internals/catalog-mocks.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Catalog panel mock data — Phase 11.5 P4 W2.
+ *
+ * Module-level constants; no fetch, no PII. Spike-verbatim §6.2.5 lens list +
+ * §6.2.7 tile model. Tiles per lens are illustrative (≥4 each; ≥1 stack under
+ * 'Order flow' to exercise `.span-2` + renderStackValue per §6.2.8).
+ *
+ * Real BFF binding will replace this seam in a future plan (P-N).
+ */
+export interface CatalogTile {
+    id: string;
+    label: string;
+    value: string;
+    stack?: boolean;
+    desc: string;
+    variants?: string[];
+}
+export declare const MOCK_LENSES: readonly string[];
+export declare const MOCK_DEFAULT_LENS = "Order flow";
+export declare const MOCK_TILES_BY_LENS: Readonly<Record<string, readonly CatalogTile[]>>;

package/lib/composites/panels/shells/internals/page-mgmt-mocks.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Page Mgmt mock data — Phase 11.5 P4 W4.
+ *
+ * Spike §6.4.3 verbatim: 4 entries with My Pipeline as the active page.
+ * Real BFF binding will replace this seam in a future plan (P-N).
+ */
+export interface PageEntry {
+    id: string;
+    name: string;
+    active: boolean;
+}
+export declare const MOCK_PAGES: readonly PageEntry[];

package/lib/composites/portal/BodyPortal.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode, RefObject } from 'react';
+import { PortalPlacement } from './usePortalAnchor';
+export interface BodyPortalProps {
+    anchorRef: RefObject<HTMLElement | null>;
+    placement: PortalPlacement;
+    gap?: number;
+    offset?: {
+        x?: number;
+        y?: number;
+    };
+    /** data-portal-host attribute value (UAT routing / DOM grep handle). */
+    dataHost: string;
+    /** Default true; pass false to detach without unmounting the host component. */
+    isOpen?: boolean;
+    className?: string;
+    children?: ReactNode;
+}
+export declare function BodyPortal(props: BodyPortalProps): import('react').ReactPortal | null;

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

@@ -0,0 +1,4 @@
+export { BodyPortal } from './BodyPortal';
+export type { BodyPortalProps } from './BodyPortal';
+export { usePortalAnchor } from './usePortalAnchor';
+export type { PortalPlacement, UsePortalAnchorArgs } from './usePortalAnchor';

package/lib/composites/portal/usePortalAnchor.d.ts

@@ -0,0 +1,17 @@
+import { CSSProperties, RefObject } from 'react';
+export type PortalPlacement = 'above-right' | 'above-left' | 'below-right' | 'below-left';
+export interface UsePortalAnchorArgs {
+    anchorRef: RefObject<HTMLElement | null>;
+    placement: PortalPlacement;
+    gap?: number;
+    offset?: {
+        x?: number;
+        y?: number;
+    };
+    isOpen?: boolean;
+}
+interface AnchorStyle {
+    style: CSSProperties;
+}
+export declare function usePortalAnchor(args: UsePortalAnchorArgs): AnchorStyle;
+export {};

package/package.json

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