@q9labsai/chalk-react 5.1.0 → 5.2.1

package/dist/components/board/Board.d.ts

@@ -1,22 +1,3 @@
-import type { ChalkWhiteboardView } from "@q9labsai/chalk-client";
-import type { Participant } from "../participant-grid/ParticipantGrid";
-import type { WhiteboardViewProps } from "../whiteboard-view/WhiteboardView";
-import { type CallTheme } from "./board-model";
-export type BoardProps = {
-    readonly board: WhiteboardViewProps;
-    /** False for the Grid tile: the live drawing with no controls. */
-    readonly primary: boolean;
-    readonly visible: boolean;
-    readonly colorScheme: CallTheme;
-    readonly people: readonly Participant[];
-    readonly following: string | null;
-    readonly onFollow: (participantId: string | null) => void;
-    /** Absent, or answering false, when the board service does not share views. */
-    readonly sendView?: (view: ChalkWhiteboardView) => boolean;
-    readonly onClose?: () => void;
-};
-/**
- * Chalk's board: Excalidraw draws, and every control around it is the call's own. Each person picks their own
- * surface and island place; the drawing, the cursors and the views are shared.
- */
-export declare function Board({ board, primary, visible, colorScheme, people, following, onFollow, sendView, onClose }: BoardProps): import("react").JSX.Element;
+import { type BoardProps as SharedBoardProps } from "@q9labsai/chalk-whiteboard/react";
+export type BoardProps = Omit<SharedBoardProps, "isHost" | "connectionStatus" | "sceneId" | "sceneStatus" | "ownParticipantId" | "viewBounds" | "renderCursorAvatar" | "onExport" | "participantIds" | "whoCanDraw">;
+export declare function Board(props: BoardProps): import("react").JSX.Element;

package/dist/components/board/board-draw-policy.d.ts

@@ -0,0 +1,15 @@
+import type { ChalkWhiteboardDrawPolicy } from "@q9labsai/chalk-client";
+import type { BoardToast } from "@q9labsai/chalk-whiteboard/react";
+export type WhoCanDraw = {
+    readonly policy: ChalkWhiteboardDrawPolicy;
+    /** Everyone in the call who is not a host, because hosts can always draw under hosts only and picked people. */
+    readonly people: readonly {
+        readonly id: string;
+        readonly name: string;
+        readonly picked: boolean;
+    }[];
+    readonly onPolicy: (policy: ChalkWhiteboardDrawPolicy) => void;
+    readonly onPick: (id: string, picked: boolean) => void;
+};
+/** The host's call-wide drawing control. Undefined for people who aren't hosts and on Sync servers without draw_policy_v1. */
+export declare function useWhoCanDraw(toast: (toast: BoardToast) => void): WhoCanDraw | undefined;

package/dist/components/chalk/Chalk.d.ts

@@ -1,6 +1,7 @@
 import { type ChatUploadFile, type ClientEventMap, type GetAccess, type SpaceClient } from "@q9labsai/chalk-client";
 import type React from "react";
 import { type ChalkColorScheme, type ChalkTheme } from "../../theme";
+import { type SpaceViewProps } from "../space-view/SpaceView";
 export type SpaceLayout = "focus" | "grid";
 export type ChalkFeatures = {
     readonly chat?: boolean;
@@ -43,6 +44,10 @@ export type ChalkProps = SpaceIntegration & SpaceEventCallbacks & {
     readonly theme?: ChalkTheme;
     readonly shareUrl?: string;
     readonly onReportProblem?: import("../space-header/SpaceHeader").SpaceHeaderProps["onReportProblem"];
+    /** Opens an app-owned dialog that can outlive this call view. */
+    readonly onOpenReportProblem?: () => void;
+    /** Hides new report actions and disables Send without discarding an open report. */
+    readonly reportUnavailableReason?: string;
     readonly onColorSchemeChange?: (colorScheme: ChalkColorScheme) => void;
     readonly pickChatFiles?: () => Promise<readonly ChatUploadFile[]>;
     readonly spaceName?: string;
@@ -54,6 +59,13 @@ export type ChalkProps = SpaceIntegration & SpaceEventCallbacks & {
     readonly onRejoin?: () => void;
     /** Home on the pages shown after the call. Without it the page has no Home action. */
     readonly onHome?: () => void;
+    /** App-owned warning copy and actions for a call's duration limit. */
+    readonly timeLimit?: SpaceViewProps["timeLimit"] & {
+        readonly endAction?: {
+            readonly label: string;
+            readonly onClick: () => void;
+        };
+    };
     /** Host-provided terminal reason when the transport cannot distinguish it. */
     readonly terminalState?: "removed" | "full" | "elsewhere";
 };

package/dist/components/chalk/ReportProblemDialog.d.ts

@@ -0,0 +1,12 @@
+import type { RefObject } from "react";
+import type { ChalkProps } from "./Chalk";
+/** The call report form for app-owned terminal screens outside Chalk. */
+export declare function ReportProblemDialog({ open, onClose, onReportProblem, colorScheme, focusScope, diagnostics, unavailableReason, }: {
+    readonly diagnostics?: string;
+    readonly unavailableReason?: string;
+    readonly open: boolean;
+    readonly onClose: () => void;
+    readonly onReportProblem: NonNullable<ChalkProps["onReportProblem"]>;
+    readonly colorScheme: "light" | "dark";
+    readonly focusScope: RefObject<HTMLElement | null>;
+}): import("react").JSX.Element;

package/dist/components/chalk/StatusSurface.d.ts

@@ -1,12 +1,18 @@
 import type React from "react";
-import type { ErrorCode } from "@q9labsai/chalk-client";
+import { type ClientFailure, type ErrorCode } from "@q9labsai/chalk-client";
 import { type ChalkTheme } from "../../theme";
 export type StatusSurfacePhase = "entering" | "left" | "episode-ended" | "failed" | "removed" | "full" | "elsewhere";
 export interface StatusSurfaceProps {
     readonly phase: StatusSurfacePhase;
     readonly callName?: string;
     readonly reason?: string;
+    readonly episodeEndReason?: string;
+    readonly endAction?: {
+        readonly label: string;
+        readonly onClick: () => void;
+    };
     readonly errorCode?: ErrorCode;
+    readonly sync?: ClientFailure["sync"];
     readonly theme?: ChalkTheme;
     readonly onRejoin?: () => void;
     readonly onHome?: () => void;
@@ -16,4 +22,4 @@ export interface StatusSurfaceProps {
     readonly retryPending?: boolean;
 }
 /** All terminal call states share the same quiet page and host-owned navigation. */
-export declare function StatusSurface({ phase, callName, reason, errorCode, theme, onRejoin, onHome, onRetry, onReportProblem, rejoinDisabled, retryPending }: StatusSurfaceProps): React.JSX.Element;
+export declare function StatusSurface({ phase, callName, reason, episodeEndReason, endAction, errorCode, sync, theme, onRejoin, onHome, onRetry, onReportProblem, rejoinDisabled, retryPending }: StatusSurfaceProps): React.JSX.Element;

package/dist/components/chalk-ui/ChalkSheet.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from "react";
 export interface ChalkSheetProps {
-    readonly variant?: "default" | "details" | "panel" | "ready";
+    readonly variant?: "default" | "details" | "panel" | "ready" | "stage";
     readonly open: boolean;
     readonly onOpenChange: (open: boolean) => void;
     readonly title: string;

package/dist/components/chalk-ui/ChalkToast.d.ts

@@ -1,6 +1,10 @@
 import { type ReactNode } from "react";
 export interface ChalkToastProps {
     readonly message: ReactNode;
+    /** Stable semantic identity for rich message content. Change it when the message changes. */
+    readonly announcementKey?: string;
+    /** Plain speech text for custom message components. Literal text and markup are read without mounting them. */
+    readonly announcementText?: string;
     readonly icon?: ReactNode;
     readonly type?: "info" | "success" | "warning" | "error";
     readonly duration?: number;
@@ -8,6 +12,8 @@ export interface ChalkToastProps {
         readonly label: string;
         readonly onClick: () => void;
     };
+    /** Enables live announcements. Pass false for an already-announced notice; a replacement message can enable the same mounted toast later. */
+    readonly announce?: boolean;
     readonly onDismiss: () => void;
 }
-export declare function ChalkToast({ message, type, duration, action, icon, onDismiss }: ChalkToastProps): import("react").JSX.Element;
+export declare function ChalkToast({ message, announcementKey, announcementText, type, duration, action, icon, announce, onDismiss }: ChalkToastProps): import("react").JSX.Element;

package/dist/components/chalk-ui/index.d.ts

@@ -18,8 +18,8 @@ export { ChalkDialogPanel } from "./ChalkDialogPanel";
 export type { ChalkDialogPanelProps } from "./ChalkDialogPanel";
 export { ChalkBackdrop } from "./ChalkBackdrop";
 export type { ChalkBackdropProps } from "./ChalkBackdrop";
-export { ChalkMenu, ChalkMenuItem } from "./ChalkMenu";
-export type { ChalkMenuItemProps, ChalkMenuProps } from "./ChalkMenu";
+export { ChalkMenu, ChalkMenuItem } from "@q9labsai/chalk-whiteboard/react";
+export type { ChalkMenuItemProps, ChalkMenuProps } from "@q9labsai/chalk-whiteboard/react";
 export { ChalkAlert } from "./ChalkAlert";
 export type { ChalkAlertProps } from "./ChalkAlert";
 export { ChalkEmptyState } from "./ChalkEmptyState";
@@ -27,10 +27,11 @@ export type { ChalkEmptyStateProps } from "./ChalkEmptyState";
 export { ChalkSpinner } from "./ChalkSpinner";
 export type { ChalkSpinnerProps } from "./ChalkSpinner";
 export type { ChalkButtonVariant, ChalkTone } from "./common";
-export { ChalkMenuLabel } from "./ChalkMenu";
-export { ChalkPopover } from "./ChalkPopover";
+export { ChalkMenuLabel } from "@q9labsai/chalk-whiteboard/react";
+export { ChalkPopover } from "@q9labsai/chalk-whiteboard/react";
 export { ChalkSegmentedControl } from "./ChalkSegmentedControl";
 export { ChalkCopyButton } from "./ChalkCopyButton";
 export { ChalkSheet, type ChalkSheetProps } from "./ChalkSheet";
 export { ChalkToast, type ChalkToastProps } from "./ChalkToast";
-export { ChalkTooltip } from "./ChalkTooltip";
+export { ChalkTooltip } from "@q9labsai/chalk-whiteboard/react";
+export { ChalkMenuPrimitive, ChalkPopoverPrimitive } from "@q9labsai/chalk-whiteboard/react";

package/dist/components/control-bar/command-failure.d.ts

@@ -1,2 +1,106 @@
-import { type ClientFailure } from "@q9labsai/chalk-client";
+import { type ClientFailure, type MediaSource } from "@q9labsai/chalk-client";
+export type MediaCommandSource = MediaSource | "speaker";
+export type MediaCommandAction = "start" | "stop" | "select" | "test" | "request";
+type Operation = MediaCommandAction | "change";
+type Context = {
+    readonly source?: MediaCommandSource;
+    readonly recoverable: boolean;
+};
+type Copy = (context: Context) => string;
+type Rule = {
+    readonly copy: Readonly<Record<Operation, Copy>>;
+    readonly retry: boolean;
+};
 export declare function commandFailure(cause: unknown): ClientFailure;
+/** Every client code has a media-context policy. Non-media commands are preserved at the boundary below. */
+export declare const MEDIA_FAILURE_POLICY: {
+    "access.invalid": Rule;
+    "access.unavailable": Rule;
+    "chat.cursor_reset_required": Rule;
+    "chat.payload_invalid": Rule;
+    "client.internal_error": Rule;
+    "collaboration.unavailable": Rule;
+    "command.rate_limited": Rule;
+    "command.rejected": Rule;
+    "connection.invalid_state": {
+        copy: {
+            test: (context: Context) => string;
+            request: (context: Context) => string;
+            start: (context: Context) => string;
+            stop: (context: Context) => string;
+            select: (context: Context) => string;
+            change: (context: Context) => string;
+        };
+        retry: true;
+    };
+    "connection.join_cleanup_unconfirmed": Rule;
+    "connection.leave_unconfirmed": Rule;
+    "connection.media_recovery_exhausted": Rule;
+    "connection.media_start_failed": Rule;
+    "connection.state_digest_recovery_failed": Rule;
+    "connection.sync_recovery_exhausted": Rule;
+    "connection.sync_start_failed": Rule;
+    "connection.sync_hello_timeout": Rule;
+    "environment.unsupported": {
+        copy: {
+            stop: (context: Context) => string;
+            start: () => string;
+            request: () => string;
+            select: (context: Context) => "Media capture is unavailable in this environment. Use a supported browser over HTTPS or the native app." | "This browser can’t change your speaker. Use your system sound settings to choose an output device.";
+            test: () => string;
+            change: (context: Context) => "Media capture is unavailable in this environment. Use a supported browser over HTTPS or the native app." | "This browser can’t change your speaker. Use your system sound settings to choose an output device.";
+        };
+        retry: false;
+    };
+    "episode.ended": {
+        copy: {
+            start: () => string;
+            stop: () => string;
+            select: () => string;
+            test: () => string;
+            request: () => string;
+            change: () => string;
+        };
+        retry: false;
+    };
+    "media.permission_denied": Rule;
+    "media.device_not_found": Rule;
+    "media.device_busy": {
+        copy: Readonly<Record<Operation, Copy>>;
+        retry: true;
+    };
+    "media.device_constraint_invalid": Rule;
+    "media.capture_failed": {
+        copy: {
+            stop: (context: Context) => string;
+            select: (context: Context) => string;
+            test: (context: Context) => string;
+            start: Copy;
+            request: Copy;
+            change: (context: Context) => string;
+        };
+        retry: true;
+    };
+    "media.request_invalid": {
+        copy: {
+            test: () => string;
+            request: () => string;
+            select: (context: Context) => string;
+            start: () => string;
+            stop: () => string;
+            change: () => string;
+        };
+        retry: false;
+    };
+    "media.timeout": Rule;
+    "offline.discarded": Rule;
+    "participant.invalid": Rule;
+    "reaction.invalid": Rule;
+    "whiteboard.unavailable": Rule;
+};
+export declare function commandFailurePresentation(failure: ClientFailure, source?: MediaCommandSource, operation?: Operation, hasExactRetry?: boolean): {
+    readonly message: string;
+    readonly retry: boolean;
+};
+export declare function commandFailureMessage(failure: ClientFailure, source?: MediaCommandSource, operation?: MediaCommandAction): string;
+export {};

package/dist/components/control-bar/control-bar-behavior.d.ts

@@ -1,4 +1,5 @@
 import type React from "react";
+import { type MediaCommandSource, type MediaCommandAction } from "./command-failure";
 import type { CameraPreview, ClientFailure, MediaSource, ScreenShareOptions } from "@q9labsai/chalk-client";
 import { type ParticipantGradientPreference } from "../../utils/colorGenerator";
 export interface MediaDevice {
@@ -93,7 +94,8 @@ export interface ControlBarProps {
     /** Set for hosts: the leave button opens a menu with Leave call and End call for everyone. */
     readonly onEndForEveryone?: () => void;
     readonly onLeft?: () => void;
-    readonly onCommandError?: (failure: ClientFailure | null, source?: MediaSource) => void;
+    /** The second argument retains the published MediaSource contract; the third also identifies speaker commands. */
+    readonly onCommandError?: (failure: ClientFailure | null, source?: MediaSource, commandSource?: MediaCommandSource, action?: MediaCommandAction, retryCommand?: () => Promise<unknown>) => void;
     readonly participantColorSeed?: string;
     readonly participantGradientPreference?: ParticipantGradientPreference;
     readonly className?: string;
@@ -124,6 +126,8 @@ export declare function useControlBarSurfaceBehavior({ density, buttons, audioIn
 interface ConnectedControlBarBehavior {
     readonly surfaceProps: ControlBarSurfaceProps;
     readonly commandError: ClientFailure | null;
+    readonly commandSource?: MediaCommandSource;
+    readonly commandAction?: MediaCommandAction;
 }
 export declare function useConnectedControlBarBehavior(props: ControlBarProps): ConnectedControlBarBehavior;
 export {};

package/dist/components/index.js

@@ -5,7 +5,7 @@ import {
   RecordingHistoryPanel,
   RecordingSpaceView,
   RecordingWhiteboardView
-} from "../chunk-QDEKMRH2.js";
+} from "../chunk-53ZA776J.js";
 import {
   loadRecordingWhiteboardFiles,
   parseRecordingWhiteboardStateV1,
@@ -29,8 +29,10 @@ import {
   ChalkMenu,
   ChalkMenuItem,
   ChalkMenuLabel,
+  ChalkMenuPrimitive,
   ChalkPanel,
   ChalkPopover,
+  ChalkPopoverPrimitive,
   ChalkSegmentedControl,
   ChalkSheet,
   ChalkSpinner,
@@ -45,10 +47,10 @@ import {
   ReactionsOverlay,
   ScreenShareView,
   Stage
-} from "../chunk-XOHNIYSR.js";
+} from "../chunk-RQXFFDOS.js";
 import {
   buildStageItems
-} from "../chunk-ZFWIMKUC.js";
+} from "../chunk-HWQLW4JR.js";
 import "../chunk-4U7QZC72.js";
 export {
   AdmissionPanel,
@@ -67,8 +69,10 @@ export {
   ChalkMenu,
   ChalkMenuItem,
   ChalkMenuLabel,
+  ChalkMenuPrimitive,
   ChalkPanel,
   ChalkPopover,
+  ChalkPopoverPrimitive,
   ChalkSegmentedControl,
   ChalkSheet,
   ChalkSpinner,

package/dist/components/offline-actions/OfflineActions.d.ts

@@ -3,6 +3,7 @@ import React from "react";
 export declare const RECONNECTING_GRACE_MS = 2000;
 export declare function offlineNoticeText(pendingCount: number, online: boolean): string;
 /** Keep queued actions automatic while preserving the reconnecting notice. */
-export declare function OfflineActions({ reconnecting: requestedReconnecting }?: {
+export declare function OfflineActions({ reconnecting: requestedReconnecting, hasNotice }?: {
     readonly reconnecting?: boolean;
+    readonly hasNotice?: boolean;
 }): React.JSX.Element | null;

package/dist/components/space-header/CallDetails.d.ts

@@ -1,13 +1,15 @@
 import { type RefObject } from "react";
 import type { SpaceHeaderProps } from "./space-header-contract";
 export declare const CALL_SHORTCUTS: readonly [readonly ["Mute or unmute", "⌘ D"], readonly ["Turn camera on or off", "⌘ E"], readonly ["Raise or lower hand", "⌃ ⌘ H"], readonly ["Open or close chat", "⌃ ⌘ C"], readonly ["Open or close people", "⌃ ⌘ P"], readonly ["Switch layout", "⌃ ⌘ L"], readonly ["Talk while muted", "Hold Space"], readonly ["Show shortcuts", "?"], readonly ["Close a menu or panel", "Esc"]];
-export declare function CallDialog({ kind, open, onClose, onReportProblem, diagnostics, returnFocus, }: {
+export declare function CallDialog({ kind, open, onClose, onReportProblem, diagnostics, returnFocus, focusScope, unavailableReason, }: {
     readonly kind: "shortcuts" | "report";
     readonly open: boolean;
     readonly onClose: () => void;
     readonly onReportProblem?: SpaceHeaderProps["onReportProblem"];
     readonly diagnostics: string;
-    readonly returnFocus: RefObject<HTMLButtonElement | null>;
+    readonly returnFocus?: RefObject<HTMLButtonElement | null>;
+    readonly focusScope: RefObject<HTMLElement | null>;
+    readonly unavailableReason?: string;
 }): import("react").JSX.Element;
 export declare function CallDetails({ shareUrl, spaceName, onClose, diagnostics, colorScheme, onColorSchemeChange, sounds, onSoundsChange, onDialog, onReportProblem, }: Pick<SpaceHeaderProps, "spaceName" | "shareUrl" | "diagnostics" | "colorScheme" | "onColorSchemeChange" | "onReportProblem"> & {
     readonly onClose: () => void;

package/dist/components/space-header/space-header-contract.d.ts

@@ -1,3 +1,4 @@
+import type { ReactNode } from "react";
 export interface SpaceHeaderProps {
     spaceName: string;
     people?: readonly {
@@ -18,6 +19,8 @@ export interface SpaceHeaderProps {
         readonly description: string;
         readonly diagnostics?: string;
     }) => void | Promise<void>;
+    reportUnavailableReason?: string;
+    onOpenReportProblem?: () => void;
     shortcuts?: {
         readonly isMuted?: boolean;
         readonly onToggleMute?: () => void;
@@ -32,10 +35,13 @@ export interface SpaceHeaderProps {
     colorScheme?: "light" | "dark";
     onColorSchemeChange?: (colorScheme: "light" | "dark") => void;
     duration?: number;
+    timeLeft?: number | null;
     isRecording?: boolean;
     isTranscribing?: boolean;
     layout?: "grid" | "focus";
     onLayoutChange?: (layout: "grid" | "focus") => void;
+    /** A control for notices that have no room on the stage, placed at the header's end, before the people button. */
+    notices?: ReactNode;
     className?: string;
 }
 export declare function formatDuration(seconds: number): string;

package/dist/components/space-view/SpaceView.d.ts

@@ -1,4 +1,5 @@
-import { type ChalkWhiteboardView } from "@q9labsai/chalk-client";
+import { type MediaCommandSource, type MediaCommandAction } from "../control-bar/command-failure";
+import { type ChalkWhiteboardView, type ClientFailure } from "@q9labsai/chalk-client";
 import React from "react";
 import type { ChatUploadFile } from "@q9labsai/chalk-client";
 import { type ReconnectingOverlayProps } from "../reconnecting-overlay/ReconnectingOverlay";
@@ -23,6 +24,13 @@ export interface SpaceViewWhiteboard {
     readonly sendView?: (view: ChalkWhiteboardView) => boolean;
 }
 export interface SpaceViewProps {
+    readonly timeLimit?: {
+        readonly message: string;
+        readonly action?: {
+            readonly label: string;
+            readonly onClick: () => void;
+        };
+    };
     readonly colorScheme?: "light" | "dark";
     readonly onColorSchemeChange?: (colorScheme: "light" | "dark") => void;
     readonly spaceName: string;
@@ -30,6 +38,8 @@ export interface SpaceViewProps {
     readonly callLinkOpen?: boolean;
     readonly onCallLinkToggle?: () => void;
     readonly onReportProblem?: import("../space-header/SpaceHeader").SpaceHeaderProps["onReportProblem"];
+    readonly reportUnavailableReason?: string;
+    readonly onOpenReportProblem?: () => void;
     readonly inviteLink?: string;
     readonly pickChatFiles?: () => Promise<readonly ChatUploadFile[]>;
     readonly stageBackground?: boolean;
@@ -39,7 +49,9 @@ export interface SpaceViewProps {
     readonly initialPanel?: SpacePanel | null;
     readonly features?: SpaceViewFeatures;
     readonly generatedAvatars?: boolean;
-    readonly commandError?: string;
+    readonly commandError?: string | ClientFailure;
+    readonly commandSource?: MediaCommandSource;
+    readonly commandAction?: MediaCommandAction;
     readonly onDismissCommandError?: () => void;
     readonly onToggleWhiteboard?: () => void;
     readonly whiteboard?: SpaceViewWhiteboard;
@@ -51,4 +63,4 @@ export interface SpaceViewProps {
     readonly onEndEpisode?: () => void | Promise<void>;
     readonly className?: string;
 }
-export declare function SpaceView({ colorScheme, onColorSchemeChange, spaceName, shareUrl, callLinkOpen, onCallLinkToggle, onReportProblem, inviteLink, pickChatFiles, stageBackground, layout: controlledLayout, onLayoutChange, initialPanel, features, generatedAvatars, commandError: externalCommandError, onDismissCommandError, onToggleWhiteboard, whiteboard, reconnecting, overlay, onLeft, onEndEpisode, className, }: SpaceViewProps): React.JSX.Element;
+export declare function SpaceView({ timeLimit, colorScheme, onColorSchemeChange, spaceName, shareUrl, callLinkOpen, onCallLinkToggle, onReportProblem, reportUnavailableReason, onOpenReportProblem, inviteLink, pickChatFiles, stageBackground, layout: controlledLayout, onLayoutChange, initialPanel, features, generatedAvatars, commandError: externalCommandError, commandSource: externalCommandSource, commandAction: externalCommandAction, onDismissCommandError, onToggleWhiteboard, whiteboard, reconnecting, overlay, onLeft, onEndEpisode, className, }: SpaceViewProps): React.JSX.Element;

package/dist/components/space-view/countdown.d.ts

@@ -0,0 +1,5 @@
+/** The latest warning only: joining late or resuming a hidden tab never queues old warnings. */
+export declare function callCountdown(deadline: string | null | undefined, now: number, previousSeconds?: number | null): {
+    seconds: number | null;
+    warning: 10 | 5 | 1 | null;
+};

package/dist/components/stage/Stage.d.ts

@@ -24,7 +24,7 @@ export interface StageProps {
     readonly followingId?: string | null;
     readonly onFollowChange?: (id: string) => void;
     readonly clickAction?: "pin" | "follow";
-    /** Upper bound of visible tiles; the rest fold into a +N People tile. */
+    /** Upper bound of grid tiles, or secondary tiles in spotlight; overflow includes shared content. */
     readonly maxPerPage?: number;
     /** Tiles narrower than this fold the rest into overflow. */
     readonly minTileWidth?: number;

package/dist/components/stage/stage-items.d.ts

@@ -28,5 +28,9 @@ export interface PrimaryContext {
 }
 /** A pin wins; otherwise the first live share, board, then active speaker leads Spotlight. */
 export declare function choosePrimary(items: readonly StageItem[], context: PrimaryContext): StageItem | null;
+/** Who is speaking now: the active speaker before anyone else speaking. */
+export declare function speakingParticipantId(items: readonly StageItem[], accept?: (participant: Participant) => boolean): string | undefined;
+/** The remote person whose face leads the floating column: whoever is speaking now, else the last remote speaker. */
+export declare function floatingSpeakerId(items: readonly StageItem[], lastRemoteSpeakerId: string | null): string | null;
 /** Grid order: pinned item first, everything else in stable order. */
 export declare function gridOrder(items: readonly StageItem[], pinnedId: string | null): StageItem[];

package/dist/components/stage/stage-layout.d.ts

@@ -3,7 +3,7 @@ export interface StageBox {
     readonly width: number;
     readonly height: number;
 }
-export type StageRole = "primary" | "strip" | "grid";
+export type StageRole = "primary" | "strip" | "grid" | "float";
 export interface StageFrame {
     readonly id: string;
     readonly role: StageRole;
@@ -37,8 +37,12 @@ export interface SpotlightFitOptions {
     readonly content?: boolean;
     readonly wideIds?: readonly string[];
     readonly maxPerPage?: number;
-    /** On a phone the board keeps the people to one slim row, so the drawing gets the screen. */
+    /** @deprecated Prefer floatingPhonePeople for boards. Preserves the 52px phone strip. */
     readonly slimPhoneStrip?: boolean;
+    /** On a phone the board keeps the whole stage, and people float in a short column at its right edge. */
+    readonly floatingPhonePeople?: boolean;
+    readonly speakerId?: string | null;
+    readonly localId?: string | null;
 }
 export declare const WIDESCREEN: number;
 export declare const MORE_TILE_ID = "stage:more";

package/dist/components/toast-stack/CallEventIcon.d.ts

@@ -1,4 +1,4 @@
 export declare function CallEventIcon({ kind, error }: {
-    readonly kind: "microphone" | "microphone-on" | "camera" | "screen" | "recording" | "hand" | "host";
+    readonly kind: "speaker" | "microphone" | "microphone-on" | "camera" | "screen" | "recording" | "hand" | "host";
     readonly error?: boolean;
 }): import("react").JSX.Element;

package/dist/components/toast-stack/NoticeButton.d.ts

@@ -0,0 +1,7 @@
+import type { Toast } from "./ToastStack";
+export interface NoticeButtonProps {
+    readonly toasts: readonly Toast[];
+    readonly onDismiss: (id: string) => void;
+}
+/** The header's way into notices that have no room on the stage, such as on a short screen with the board's tools open. */
+export declare function NoticeButton({ toasts, onDismiss }: NoticeButtonProps): import("react").JSX.Element | null;

package/dist/components/toast-stack/ToastStack.d.ts

@@ -1,5 +1,5 @@
 import { type ChalkToastProps } from "../chalk-ui/ChalkToast";
-export interface Toast extends Omit<ChalkToastProps, "onDismiss"> {
+export interface Toast extends Omit<ChalkToastProps, "onDismiss" | "announce"> {
     readonly id: string;
 }
 export interface ToastStackProps {
@@ -7,5 +7,16 @@ export interface ToastStackProps {
     readonly onDismiss: (id: string) => void;
     readonly maxVisible?: number;
     readonly className?: string;
+    /**
+     * Called with the ids of the notices the stage has no room for, so the host can offer them elsewhere, such as from the header.
+     * With it, a call shorter than `FOLD_BELOW_PX` folds every notice. Taller calls fold notices past `maxVisible` or outside the available band, announcing each folded message once.
+     */
+    readonly onFold?: (folded: readonly string[]) => void;
 }
-export declare const ToastStack: import("react").MemoExoticComponent<({ toasts, onDismiss, maxVisible, className }: ToastStackProps) => import("react").JSX.Element>;
+/**
+ * Calls shorter than this fold every notice. It is the height the mockup's three-notice stack needs at its tallest, on a phone with
+ * the board open: 108px for the header and the board's menu, an 8px gap, three camera errors wrapped to three lines (79px each, with
+ * 8px gaps), and the 242px the open drawing tools lift notices by, 611px in all.
+ */
+export declare const FOLD_BELOW_PX = 620;
+export declare const ToastStack: import("react").MemoExoticComponent<({ toasts, onDismiss, maxVisible, className, onFold }: ToastStackProps) => import("react").JSX.Element>;

package/dist/components/toast-stack/call-events.d.ts

@@ -1,5 +1,6 @@
+import { type MediaCommandSource, type MediaCommandAction } from "../control-bar/command-failure";
 import type { ClientFailure, SpaceSnapshot } from "@q9labsai/chalk-client";
 import type { Toast } from "./ToastStack";
-export declare function mediaFailureToast(failure: ClientFailure | null, source?: "microphone" | "camera" | "screen"): Omit<Toast, "id"> | null;
+export declare function mediaFailureToast(failure: ClientFailure | null, source?: MediaCommandSource, action?: MediaCommandAction, onRetry?: () => void): Omit<Toast, "id"> | null;
 /** Snapshot changes, not initial history, are events for the person already in the call. */
 export declare function callEventToasts(previous: SpaceSnapshot, next: SpaceSnapshot): Omit<Toast, "id">[];

package/dist/components/toast-stack/notice-announcement.d.ts

@@ -0,0 +1,4 @@
+import type { ChalkToastProps } from "../chalk-ui/ChalkToast";
+export declare function noticeAnnouncement(toast: Pick<ChalkToastProps, "message" | "announcementText">): string;
+/** Semantic speech/lifetime revision, independent of JSX and layout chrome. */
+export declare function noticeIdentity(toast: Pick<ChalkToastProps, "message" | "announcementText" | "announcementKey" | "type">): string;

package/dist/components/toast-stack/toast-layout-snapshot.d.ts

@@ -0,0 +1,4 @@
+/** A layout-only DOM snapshot: never instantiate React callers, custom elements, or media resources. */
+export declare function captureToastLayout(toast: HTMLElement): HTMLDivElement;
+/** Reflow cached markup at the current band's width without mounting the folded caller tree. */
+export declare function measureToastLayout(stack: HTMLElement, snapshot: HTMLDivElement): number;

package/dist/components/toast-stack/useToastCapacity.d.ts

@@ -0,0 +1,7 @@
+import { type RefObject } from "react";
+import type { Toast } from "./ToastStack";
+/** Remember measured sizes when notices fold: resizing must not remount them to measure again. */
+export declare function useToastCapacity(stack: RefObject<HTMLDivElement | null>, candidates: readonly Toast[], enabled: boolean, ownedIds: readonly string[]): {
+    readonly count: number;
+    readonly ready: boolean;
+};

package/dist/headless.js

@@ -13,7 +13,7 @@ import {
   fitSpotlight,
   gridOrder,
   screenShareItemId
-} from "./chunk-ZFWIMKUC.js";
+} from "./chunk-HWQLW4JR.js";
 export {
   DEFAULT_GRID_OPTIONS,
   DEFAULT_SPOTLIGHT_OPTIONS,

package/dist/index.d.ts

@@ -31,3 +31,4 @@ export { SpaceHeader } from "./components/space-header/SpaceHeader";
 export type { SpaceHeaderProps } from "./components/space-header/SpaceHeader";
 export { CallReady, type CallReadyProps } from "./components/call-limbo/CallReady";
 export { StatusSurface, type StatusSurfaceProps, type StatusSurfacePhase } from "./components/chalk/StatusSurface";
+export { ReportProblemDialog } from "./components/chalk/ReportProblemDialog";