@ai-matrx/meet 0.7.83 → 0.7.85

package/dist/react.d.ts

@@ -1,51 +1,13 @@
-import { ReactNode, SVGProps } from 'react';
+import { ReactNode } from 'react';
 import { MessagingSupabaseClient } from '@ai-matrx/messaging';
-import { MeetStore, RoomEngine, CallCenter, MeetingSession, InRoomClient, RecordingController, DeviceManager, MeetRepository, TokenClient, MeetAi, MeetApi, MeetIdentity, AccessTokenSource, RoomDriverFactory, CallInvite, DeviceSnapshot, UserId, MeetSnapshot, ParticipantRole, ParticipantIdentity, TranscriptSource, CallMode, GuestRecordAccessSetting, GuestRecordAccessResolution, MeetParticipant, ModerationRequest, ModerationResult, LobbyEntry, RoomName, MediaEffects, NoteTakerStatus, MeetingNote, WrapUpAnnouncement, MeetAnswerCoverage, MeetingRecordBundle, MeetingRecord, JoinRequest, StageLayout, MeetingRecordCache, LocalMediaState, MeetingId, OrganizationId, ModerationNotice, Stage as Stage$1, CallablePerson, CollabPanel, CollabSnapshot, CollabRequest } from './index.js';
-export { ATTENDANCE_CSV_HEADER, AdmissionState, AnnounceResult, ApplyRoomEventArgs, AskArgs, AttendanceKind, AttendanceRow, AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CAPTION_LANGUAGES, CONSENT_NOTICE_ATTRIBUTE, CallCenterOptions, CallId, CallInviteHandlerOptions, CallInvitePayload, CallState, CollabAction, CollabResult, ConnectionQuality, CreateCallInviteInput, CreateMeetingInput, DATA_TOPICS, DEFAULT_EFFECTS, DEFAULT_PAGE_SIZE, DataTopic, DeviceKind, DeviceManagerOptions, DeviceStorage, DriverConnectionState, DriverParticipant, DriverTrackKind, DriverTranscription, EMPTY_COLLAB, END_MEETING_NOT_SERVED, EffectsStorage, EndMeetingResult, FILE_SESSION_PATH, FollowUpDraft, FollowUpRecipient, FollowUpSendResult, GUEST_RECORD_ACCESS_CHOICES, GUEST_RECORD_ACCESS_LEVELS, GUEST_RECORD_ACCESS_METADATA_KEY, GUEST_RECORD_NOT_SHARED, GuestRecordAccess, IDLE_MEDIA, IDLE_TRACK, InRoomClientOptions, InviteeInput, InviteeRole, JsonObject, JsonValue, LISTEN_ONLY_NOTICE, LibraryRecording, LiveKitDriverOptions, LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEETING_RECORD_GRACE_MS, MEET_ANSWER_CONTEXT_EVENT, MEET_ANSWER_EVENTS, MEET_EVENTS, MEET_ROUTES, MEET_SCHEMA, MODERATION_ACTIONS, MediaDevicesLike, MediaUnavailable, MeetAiAnswer, MeetAiOptions, MeetApiOptions, MeetApiRequest, MeetBreakoutBroadcast, MeetBreakoutPlan, MeetBreakoutRoom, MeetCollabSettings, MeetDevice, MeetError, MeetErrorCode, MeetEvent, MeetFileMedia, MeetGrants, MeetPoll, MeetPollOption, MeetPollState, MeetQuestion, MeetQuestionState, MeetRoomDriver, MeetStroke, MeetingActivities, MeetingAttendee, MeetingChanges, MeetingChatHistory, MeetingInviteHandlerOptions, MeetingInvitePayload, MeetingInvitee, MeetingKind, MeetingNoteKind, MeetingOccurrence, MeetingRecordAnswer, MeetingRecordChange, MeetingRecordFailure, MeetingRecordParts, MeetingRecordRestriction, MeetingRecordRestrictionNotice, MeetingRecordState, MeetingSearchHit, MeetingSearchSource, MeetingSessionOptions, MeetingSettings, ModerationAction, NOTE_TAKER_IDENTITY_PREFIX, NOTE_TAKER_METADATA_KEY, NO_GRANTS, NameBook, NoteTakerDispatch, NoteTakerRefusal, NoteTakerState, ORGANIZATION_HEADER, OccurrenceOverride, OccurrenceState, PARTICIPANT_CAN_RECORD_ATTRIBUTE, PARTICIPANT_ROLE_ATTRIBUTE, REACTION_TTL_MS, REFUSED_ABSENCE, ROLE_RANK, ROOM_EVENTS, ROOM_EVENT_PREFIX, ROOM_TOKEN_HEADER, RPCS, RecordingControllerOptions, RecordingPolicy, RecordingRecord, RecordingState, RepositoryOptions, RoomChatMessage, RoomDriverHandlers, RoomEngineOptions, RoomEventOutcome, RoomEventTopic, RoomPhase, RoomReaction, RoomToken, RoomTokenStorage, RsvpAnswer, RsvpInvitation, RsvpState, ScheduleMeetingInput, StageArgs, TABLES, TRANSCRIPTION_ATTRIBUTES, TRANSCRIPTION_TOPIC, TokenClientOptions, TokenRequest, TranscriptBlock, TranscriptFormat, TranscriptMatch, TranscriptSegment, UpcomingOccurrence, VideoEffect, WrapUpStatus, absenceSentence, activeWrapUpSummary, announceMeeting, applyCollabPacket, applyRoomEvent, asCallId, asMeetingId, asOrganizationId, asParticipantIdentity, asRoomName, asUserId, assembleMeetingRecord, assignedRoom, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, autoAssign, breakoutRemainingMs, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, clockPosition, collabFromState, computeStage, countLabel, createCallCenter, createCallInviteHandler, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetApi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingRecordCache, createMeetingSession, createMemoryDeviceStorage, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebRoomTokenStorage, defaultCaptionLanguage, displayNameFor, fileDownloadPath, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, invalidResponse, isGuest, isGuestIdentity, isHostRole, isListenOnly, isNoteTaker, isRealName, isRoomEventTopic, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingActivities, loadMeetingChat, loadMeetingRecord, loadMeetingRecordParts, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeRecord, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, orderParticipants, parseRoomToken, participantSummary, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, recordingLabel, recordingNotice, recordingOffsetMs, roleOf, roomTopic, searchTranscript, sendFollowUp, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, summarizeMeetingRecordRestrictions, transcriptDocument, unavailableFrom, uniqueAttendees, userTopic, wasRefused, withItem, wrapUpStatus } from './index.js';
+import { MeetStore, RoomEngine, CallCenter, MeetingSession, InRoomClient, RecordingController, DeviceManager, MeetRepository, TokenClient, MeetAi, RoomDriverFactory, DeviceSnapshot, MeetSnapshot, ObservedPhase, MeetObservation, GuestRecordAccessSetting, GuestRecordAccessResolution, ModerationRequest, ModerationResult, MediaEffects, NoteTakerStatus, MeetAnswerCoverage, MeetingRecordBundle, JoinRequest, MeetingRecordCache, LocalMediaState, ModerationNotice, Stage, CollabRequest } from './core.js';
+export { ATTENDANCE_CSV_HEADER, AnnounceResult, ApplyRoomEventArgs, AskArgs, AttendanceKind, AttendanceRow, AudioProcessing, CALL_INVITE_KIND, CALL_INVITE_VERSION, CONSENT_NOTICE_ATTRIBUTE, CallCenterOptions, CallInviteHandlerOptions, CallInvitePayload, CollabAction, CollabResult, CollabRuntime, CollabStoreLike, CreateCallInviteInput, CreateMeetingInput, DATA_TOPICS, DEFAULT_EFFECTS, DEFAULT_PAGE_SIZE, DataTopic, DeviceKind, DeviceManagerOptions, DeviceStorage, DriverConnectionState, DriverParticipant, DriverTrackKind, DriverTranscription, END_MEETING_NOT_SERVED, EffectsStorage, EndMeetingResult, FollowUpDraft, FollowUpRecipient, FollowUpSendResult, GUEST_RECORD_ACCESS_CHOICES, GUEST_RECORD_ACCESS_LEVELS, GUEST_RECORD_ACCESS_METADATA_KEY, GUEST_RECORD_NOT_SHARED, GuestRecordAccess, IDLE_MEDIA, IDLE_TRACK, InRoomClientOptions, LISTEN_ONLY_NOTICE, LibraryRecording, LiveKitDriverOptions, LocalTrackState, MEETING_INVITE_KIND, MEETING_INVITE_VERSION, MEETING_RECORD_GRACE_MS, MEET_ANSWER_CONTEXT_EVENT, MEET_ANSWER_EVENTS, MEET_EVENTS, MEET_REACTIONS, MEET_ROUTES, MEET_SCHEMA, MODERATION_ACTIONS, MediaDevicesLike, MediaUnavailable, MeetAiAnswer, MeetAiOptions, MeetDevice, MeetError, MeetErrorCode, MeetEvent, MeetGrants, MeetRoomDriver, MeetingChatHistory, MeetingInviteHandlerOptions, MeetingInvitePayload, MeetingRecordAnswer, MeetingRecordChange, MeetingRecordFailure, MeetingRecordParts, MeetingRecordRestriction, MeetingRecordRestrictionNotice, MeetingRecordState, MeetingSearchHit, MeetingSearchSource, MeetingSessionOptions, ModerationAction, NOTE_TAKER_IDENTITY_PREFIX, NOTE_TAKER_METADATA_KEY, NO_GRANTS, NameBook, NoteTakerDispatch, NoteTakerRefusal, ObserveInput, ObservedConnection, PARTICIPANT_CAN_RECORD_ATTRIBUTE, PARTICIPANT_ROLE_ATTRIBUTE, REACTION_TTL_MS, REFUSED_ABSENCE, ROOM_EVENTS, ROOM_EVENT_PREFIX, ROOM_TOKEN_HEADER, RPCS, RecordingControllerOptions, RepositoryOptions, RoomChatMessage, RoomDriverHandlers, RoomEngineOptions, RoomEventOutcome, RoomEventTopic, RoomReaction, RoomToken, RoomTokenStorage, ScheduleMeetingInput, StageArgs, TABLES, TRANSCRIPTION_ATTRIBUTES, TRANSCRIPTION_TOPIC, TokenClientOptions, TokenRequest, TranscriptBlock, TranscriptFormat, TranscriptMatch, VideoEffect, WrapUpStatus, absenceSentence, activeWrapUpSummary, activityAttention, announceMeeting, applyRoomEvent, assembleMeetingRecord, attendanceCsv, attendanceReport, attendanceTotals, attendeeKey, availableActivities, callInviteAction, callInviteText, callStateLabel, canModerate, canModerateParticipant, canTransition, captionSegment, changesPatch, clockPosition, computeStage, countLabel, createCallCenter, createCallInviteHandler, createDeviceManager, createInRoomClient, createLiveKitDriver, createMeetAi, createMeetRepository, createMeetStore, createMeetingInviteHandler, createMeetingRecordCache, createMeetingSession, createMemoryDeviceStorage, createRecordingController, createRoomEngine, createTokenClient, createWebDeviceStorage, createWebEffectsStorage, createWebRoomTokenStorage, displayNameFor, gridColumns, groupTranscript, guestRecordAccessExplanation, guestRecordAccessLabel, guestRecordAccessSetting, hasEnded, hostUserIds, invalidResponse, isGuestIdentity, isListenOnly, isNoteTaker, isRealName, isRoomEventTopic, learnName, learnNames, listenOnlyNotice, loadFollowUpDraft, loadGuestMeetingRecord, loadMeetingChat, loadMeetingRecord, loadMeetingRecordParts, mapConnectionState, mapQuality, meetingInviteAction, meetingLength, meetingLink, meetingPath, meetingSlug, meetingTopic, meetingWhen, mergeCaption, mergeRecord, microphoneNoticeCode, moveToRoom, nextTranslationBatch, normalizeDeviceError, normalizeMeetError, normalizeSpoken, noteTakerIdentity, noteTakerLabel, noteTakerParticipant, noteTakerStatus, notesDocument, observeMeeting, observedDevice, observedPhase, observedQuality, orderParticipants, parseRoomToken, participantAttributes, participantSummary, performCollab, playableRecordingFileId, projectInvitee, projectLibraryRecording, projectNote, projectOccurrence, projectOverride, projectParticipant, projectRsvpInvitation, projectSearchHit, projectSegment, projectUpcoming, pushMeetingToGoogleCalendar, readServerRefusal, readableTranscript, recordingLabel, recordingNotice, recordingOffsetMs, roleOf, roomTopic, rootAttributes, searchTranscript, sendFollowUp, setCaptionLanguage, setGuestRecordAccess, settingsPatch, snapshotParticipant, snippetRuns, staticObservation, summarizeMeetingRecordRestrictions, takeMoveRequest, takePanelRequest, transcriptDocument, unavailableFrom, uniqueAttendees, untranslatedLines, userTopic, wasRefused, wrapUpStatus } from './core.js';
+import { b as MeetApi, c as MeetIdentity, A as AccessTokenSource, d as CallInvite, U as UserId, e as ParticipantRole, M as MeetingRecord, P as ParticipantIdentity, T as TranscriptSource, f as CallMode, a as MeetParticipant, L as LobbyEntry, R as RoomName, g as MeetingNote, W as WrapUpAnnouncement, S as StageLayout, h as MeetingId, O as OrganizationId, i as CollabSnapshot, C as CollabPanel } from './collab-Bss-_Jfp.js';
+export { j as AdmissionState, k as CAPTION_LANGUAGES, l as CallId, m as CallState, n as CallablePerson, o as ConnectionQuality, E as EMPTY_COLLAB, F as FILE_SESSION_PATH, I as InviteeInput, p as InviteeRole, J as JsonObject, q as JsonValue, r as MeetApiOptions, s as MeetApiRequest, t as MeetBreakoutBroadcast, u as MeetBreakoutPlan, v as MeetBreakoutRoom, w as MeetCollabSettings, x as MeetFileMedia, y as MeetPoll, z as MeetPollOption, B as MeetPollState, D as MeetQuestion, G as MeetQuestionState, H as MeetStroke, K as MeetingActivities, N as MeetingAttendee, Q as MeetingChanges, V as MeetingInvitee, X as MeetingKind, Y as MeetingNoteKind, Z as MeetingOccurrence, _ as MeetingSettings, $ as NoteTakerState, a0 as ORGANIZATION_HEADER, a1 as OccurrenceOverride, a2 as OccurrenceState, a3 as ROLE_RANK, a4 as RecordingPolicy, a5 as RecordingRecord, a6 as RecordingState, a7 as RoomPhase, a8 as RsvpAnswer, a9 as RsvpInvitation, aa as RsvpState, ab as TranscriptSegment, ac as UpcomingOccurrence, ad as applyCollabPacket, ae as asCallId, af as asMeetingId, ag as asOrganizationId, ah as asParticipantIdentity, ai as asRoomName, aj as asUserId, ak as assignedRoom, al as autoAssign, am as breakoutRemainingMs, an as collabFromState, ao as createMeetApi, ap as defaultCaptionLanguage, aq as fileDownloadPath, ar as isGuest, as as isHostRole, at as loadMeetingActivities, au as withItem } from './collab-Bss-_Jfp.js';
+export { G as GuestRecordAccessControl } from './components-BmgstFx_.js';
 import '@ai-matrx/realtime';
 import 'livekit-client';
 
-/**
- * `<MeetProvider>` — the one place an app wires calls and meetings (R7).
- *
- * THE ONE-HOUR INTEGRATION CONTRACT is this component's job: a host passes a
- * Supabase client, who they are, their org, and aidream's base URL. Everything
- * else — the repository, the realtime manager and its three channels, the token
- * client, the room engine, the call center, the meeting session, the recording
- * controller, the device manager, the AI surface — is constructed and owned
- * here.
- *
- * What a host may inject is IDENTITY and app chrome: session source, a
- * navigator, a notification sink. It may NOT inject an agent id — as of 0.3.0
- * there is no prop for one, because which agent answers is a Mandate binding
- * the SERVER resolves (D2). What a host must NEVER have to inject is
- * behavior — if you find yourself catching a package error, retrying a package
- * call, or branching on a package quirk in host code, that logic belongs in
- * here (C22).
- *
- * 🚨 THE PROVIDER'S LIFETIME IS `client` + the SESSION'S user (or `guestName`)
- * + `organizationId` + `baseUrl`, AND NOTHING ELSE. Hosts pass fresh function
- * literals for `onDiagnostic` and `accessToken` on every render; keying the
- * runtime on those identities would tear down and rebuild every channel — and
- * drop the call in progress — on every parent re-render.
- *
- * 🚨 THERE IS NO `userId` PROP, AND THERE NEVER WILL BE AGAIN (DD-240, 0.6.0).
- * The acting user is read from `client`'s own session — the same client that
- * mints the JWT on every request — so the id in a `p_user_id` argument and the
- * id in the token cannot disagree. Through 0.5.x this was a prop, every host
- * filled it from a copy in its own state, and a rotated auth cookie left that
- * copy naming an account the tab could no longer prove it was:
- * `meet_pending_call_invites` refused it at 403 with "the acting user … is not
- * the authenticated user", 8.8 h and 32.9 h into two tabs' lives. The whole
- * story is in `../core/session-identity.ts`.
- *
- * 🚨 A GUEST IS A FIRST-CLASS IDENTITY (D6), not a degraded user. Pass
- * `guestName` and the provider builds a runtime with no calling surface and no
- * host powers, which is exactly what a link-follower needs — and, because a
- * guest has no account at all, the guest lane never reads the session. Nothing
- * downstream branches on "is this a real user".
- */
-
 interface MeetDiagnostic {
     readonly level: "info" | "warn" | "error";
     readonly message: string;
@@ -162,6 +124,37 @@ declare function useIsHost(): boolean;
 declare function useCanRecord(): boolean;
 declare function useLocalUserId(): UserId | null;
 
+/**
+ * THE OBSERVATION ROOT (CORE-DESIGN §5.6, step S0).
+ *
+ * Exactly one `[data-meet-root]` per tab on a meeting page, carrying the
+ * HARNESS-CONTRACT's attributes derived from the store (`core/observation.ts`).
+ * The package renders it once — `<MeetingRoom>` wraps every screen in it, and a
+ * consumer that draws its own screen around the room (link resolution, the
+ * guest-name step, a Board layout) wraps that screen in `<MeetRoot>` too, with
+ * a `phase` when there is no store yet.
+ *
+ * The wrapper is `display: contents`: it generates no box, so no layout, size
+ * or stacking changes; it exists only to carry the attributes. It also
+ * publishes `window.__matrxMeet` — diagnostics only, never a verdict.
+ */
+
+interface CoreRootOptions {
+    /** The row the consumer resolved (the guest lane has no other copy). */
+    readonly meeting?: MeetingRecord | null | undefined;
+    /** A screen the consumer renders before any store exists (resolving, a dead link). */
+    readonly phase?: ObservedPhase | undefined;
+    readonly reason?: string | null | undefined;
+}
+/** The observation for this tab, one stable object per change. */
+declare function useCoreObservation(options?: CoreRootOptions): MeetObservation;
+/** The root element's `data-meet-*` attributes. Spread onto ONE element per tab. */
+declare function useCoreRootProps(options?: CoreRootOptions): Record<string, string>;
+/** `<MeetRoot>` — the one observation root. Generates no box. */
+declare function MeetRoot({ children, ...options }: CoreRootOptions & {
+    children?: ReactNode;
+}): ReactNode;
+
 interface UseRoomResult {
     readonly phase: string;
     readonly participants: readonly MeetParticipant[];
@@ -188,7 +181,7 @@ interface UseRoomResult {
 }
 declare function useRoom(): UseRoomResult;
 /** The stage, recomputed only when the roster or the layout actually changes. */
-declare function useStage(pageSize?: number): Stage$1;
+declare function useStage(pageSize?: number): Stage;
 /**
  * Attach a participant's media to an element. The returned ref callback's
  * CLEANUP is the detach — there is nothing a consumer can forget to call.
@@ -486,170 +479,16 @@ interface UseGuestRecordAccessResult {
 declare function useGuestRecordAccess(meeting: MeetingRecord | null): UseGuestRecordAccessResult;
 
 /**
- * THE PRODUCT UI (R6/R7). Not a headless kernel with a note telling the host to
- * build the rest — the whole meeting surface ships here, because per THE
- * ALL-INCLUSIVE LAW a package that withholds its components withholds its
- * product.
- *
- * The bar: FaceTime and Zoom raised by Apple's design team. Concretely, and
- * every one of these is enforced by the stylesheet or the canary:
+ * `<MeetingSkinRoot>` — the meeting page's one entry (CORE-DESIGN §5.3, S1).
  *
- * - `dvh`, never `vh` — iOS Safari's `vh` includes the collapsing toolbar, so a
- *   `100vh` stage puts the control bar under the browser chrome.
- * - Safe-area insets on the control bar, so the hang-up button is not under the
- *   home indicator.
- * - 44px touch targets, and 16px input text (anything smaller zooms iOS Safari
- *   on focus, which in a meeting looks like the app broke).
- * - Semantic tokens only. There is not one hardcoded color in the package.
- * - Real loading states and no dead ends: a control the actor cannot use is
- *   ABSENT, never disabled-looking, and never a button that will be refused.
+ * Everything that is not a look lives here, once, for every skin: the inert
+ * guard, the observation root (S0), watching the room and the meeting's durable
+ * feed, seeding the store with the row the consumer resolved, and the ended
+ * meeting's record (a skin-external surface). It then renders the viewer's
+ * skin — only `meet` until S9 adds the switcher.
  */
 
-declare function Avatar({ name, url, size, }: {
-    name: string;
-    url?: string | null;
-    size?: number;
-}): ReactNode;
-declare function ControlButton({ label, active, danger, onClick, children, }: {
-    label: string;
-    active?: boolean;
-    danger?: boolean;
-    onClick: () => void;
-    children: ReactNode;
-}): ReactNode;
-/**
- * The recording indicator. Rendered for EVERY participant, guests included —
- * there is no prop that hides it (R5). Consent is a property of the package.
- */
-declare function RecordingIndicator(): ReactNode;
-declare function ConnectionDot({ quality }: {
-    quality: string;
-}): ReactNode;
-declare function ParticipantTile({ participant, featured, }: {
-    participant: MeetParticipant;
-    featured?: boolean;
-}): ReactNode;
-/**
- * CONNECTION QUALITY, always legible (Meet wave 2). Four bars, like every phone:
- * a stable good connection is quiet (the bars are there, faint), and a poor or
- * lost one is loud. `unknown` draws nothing — a guess is not a reading.
- */
-declare function QualityBars({ quality }: {
-    quality: string;
-}): ReactNode;
-declare function Stage({ pageSize }: {
-    pageSize?: number;
-}): ReactNode;
-/** Meet's own reaction set, in its order. */
-declare const MEET_REACTIONS: readonly string[];
-/**
- * THE CONTROL BAR — one row, the same in the package's room and in any host
- * layout that composes it (the Board). Everything a person does in a meeting is
- * reachable from here or from the panels it opens, and every keyboard shortcut
- * is bound here, so a layout that renders this bar has all of it.
- */
-declare function ControlBar({ onLeave }: {
-    onLeave?: () => void;
-}): ReactNode;
-/**
- * WHAT FLOATS OVER THE MEETING, in every layout (Meet wave 2): the reactions
- * everyone sends, and what a host just did to THIS person — "the host is asking
- * you to unmute" with the Unmute button right there, which is the whole point.
- */
-declare function MeetingOverlays(): ReactNode;
-/** Every shortcut, on one sheet. Opened by Shift+? or from More options. */
-declare function ShortcutsSheet({ onClose }: {
-    onClose: () => void;
-}): ReactNode;
-/**
- * IN-MEETING CHAT (Meet wave 2). A message to everyone is SAVED with the
- * meeting — a late joiner scrolls up and reads it, and it is part of the record.
- * A private message goes to one person only and is never saved; the composer
- * says which of the two you are about to send.
- */
-declare function ChatPanel({ onClose, to, onTo, }: {
-    onClose: () => void;
-    to?: ParticipantIdentity | null;
-    onTo?: (identity: ParticipantIdentity | null) => void;
-}): ReactNode;
-declare function PeoplePanel({ onClose, onMessage, }: {
-    onClose: () => void;
-    onMessage?: (identity: ParticipantIdentity) => void;
-}): ReactNode;
-/**
- * EVERYTHING YOU CAN DO ABOUT ONE PERSON (Meet wave 2), in one menu — on their
- * tile and on their People row. An item appears only when it would be honoured:
- * the rank ladder decides moderation (a co-host never sees "Remove" on the host),
- * only the host sees "Make host", and nobody sees a control that the server
- * would refuse. Removing someone and handing the meeting over NAME THEIR
- * CONSEQUENCE first, inline — never a browser dialog.
- */
-declare function PersonMenu({ participant, onClose, onMessage, placement, }: {
-    participant: MeetParticipant;
-    onClose: () => void;
-    onMessage?: (identity: ParticipantIdentity) => void;
-    placement?: "up" | "down";
-}): ReactNode;
-/**
- * AUDIO, VIDEO AND EFFECTS (Meet wave 2) — the devices in use, a live
- * microphone level, a speaker test, noise suppression and the camera
- * background. Every change applies to the live meeting at once and is
- * remembered in this browser.
- */
-declare function SettingsPanel({ onClose }: {
-    onClose: () => void;
-}): ReactNode;
-/** The waiting room. Rendered for hosts only — a participant sees nothing. */
-declare function LobbyPanel(): ReactNode;
-/**
- * THE MEETING ASSISTANT (R4). The note-taker's state, what the meeting has
- * decided so far, the wrap-up, and a question box whose answer arrives token by
- * token.
- *
- * Nothing on this panel is computed here: notes, decisions and action items are
- * durable rows delivered by Postgres Changes, and the answer is streamed from
- * `/intelligence/ask`, which builds it from those same rows. The captions this
- * client can see are never sent anywhere (D16).
- */
-declare function AiPanel({ onClose }: {
-    onClose: () => void;
-}): ReactNode;
-/**
- * LIVE CAPTIONS. The last few lines, over the stage, for anyone who reads
- * faster than they hear.
- *
- * They are HINTS (D16) — the durable segment replaces the line it captioned as
- * soon as the row lands — so an unsettled line renders differently from a
- * settled one and nothing downstream ever reads this list.
- */
-declare function Captions({ lines }: {
-    lines?: number;
-}): ReactNode;
-/**
- * CONSENT IS NOT A PROP (README rule 8, D10).
- *
- * Whenever an agent participant is in the room, EVERY participant sees this —
- * host, member and guest alike. There is no prop that hides it and no host code
- * involved: through 0.2.1 the first real consumer had to write this banner
- * itself by reading `isAgent` off the roster, which is exactly the massage C22
- * forbids.
- */
-declare function ConsentNotice(): ReactNode;
-/**
- * LISTEN-ONLY ATTENDANCE, said out loud. Shown whenever the local participant
- * is in the room publishing no microphone — whether they chose that or the
- * browser refused. When it was refused, the browser's own reason and the remedy
- * are shown too, because "others can't hear you" without "and here is why"
- * leaves someone clicking a mute button that cannot work.
- */
-declare function AttendanceNotice(): ReactNode;
-declare function PreJoin(props: {
-    roomName: RoomName;
-    meetingId?: string;
-    slug?: string;
-    onJoined?: () => void;
-}): ReactNode;
-declare function MeetingRoom(props: {
+interface MeetingSkinRootProps {
     roomName: RoomName;
     meetingId?: string;
     slug?: string;
@@ -660,48 +499,29 @@ declare function MeetingRoom(props: {
      * `meet_meeting_by_slug` is granted to `anon`; the `meet_meetings` TABLE is
      * not, so the durable-feed backfill — a table read — is refused for a
      * link-follower and `snapshot.meeting` stays null for them forever. A
-     * consumer that resolved the slug through the RPC (every consumer does, to
-     * get the room name) passes the row here, and the record renders for exactly
-     * the reader who has nothing else.
+     * consumer that resolved the slug through the RPC passes the row here, and
+     * the record renders for exactly the reader who has nothing else.
      */
     meeting?: MeetingRecord;
     onLeave?: () => void;
     /**
-     * A HOST-PROVIDED control for the in-meeting header — the host app's own
-     * affordances that belong to the meeting (matrx-frontend puts its
+     * A HOST-PROVIDED control for the in-meeting header (matrx-frontend puts its
      * Intelligence icon for the meeting's AI jobs here). Rendered in the header
-     * row of the live room only; the pre-join, lobby and record screens carry
-     * none. The package never inspects it, and styles nothing inside it.
+     * row of the live room only. The package never inspects it.
      */
     headerControls?: ReactNode;
-}): ReactNode;
-declare function HostMenu(): ReactNode;
-/** Drop this next to a person and calling works. That is the whole contract. */
-declare function CallButton({ person, mode, children, }: {
-    person: CallablePerson;
-    mode?: CallMode;
-    children?: ReactNode;
-}): ReactNode;
+}
+declare function MeetingSkinRoot(props: MeetingSkinRootProps): ReactNode;
+
 /**
- * Mount ONCE, high in the tree. Every incoming call rings here, on whatever
- * surface the user is on (R2).
+ * THE MEETING RECORD — a skin-EXTERNAL surface (CORE-DESIGN §5.3).
+ *
+ * What a meeting is once the room is gone: the record view, the recording
+ * player and the host's guest-access control. Outside the skin boundary — every
+ * skin links to the same record — so it lives in `@ai-matrx/meet/react`.
+ * It draws with the Meet skin's v0 primitives until the record gets its own
+ * look (S9 is the pixel pass).
  */
-declare function IncomingCallHost(): ReactNode;
-declare function IncomingCallCard({ invite }: {
-    invite: CallInvite;
-}): ReactNode;
-declare function ScheduleMeeting(props: {
-    /** Where meeting links point. `meetingLink` is the ONE link shape. */
-    appBaseUrl: string;
-    onScheduled?: (slug: string) => void;
-}): ReactNode;
-/** Reactions floating over the stage. Expired by the store, not by hope. */
-declare function ReactionOverlay({ reactions, }: {
-    reactions: readonly {
-        id: string;
-        emoji: string;
-    }[];
-}): ReactNode;
 
 /**
  * THE MEETING, AFTER THE MEETING (MRI-D2).
@@ -721,23 +541,6 @@ declare function ReactionOverlay({ reactions, }: {
  * rows server-side. A part the reader is not allowed to see says so IN WORDS —
  * an empty section is indistinguishable from a meeting where nothing happened.
  */
-/**
- * WHAT GUESTS MAY READ OF THIS MEETING — the host's control (MRF-1).
- *
- * 🚨 **HOST-ONLY, AND ABSENT FOR EVERYONE ELSE.** Not greyed out, not present
- * with a tooltip: a participant has no control here at all, because a control
- * that exists only to be refused is the dead-end class this package does not
- * ship (D11-style honesty, same posture as `PersonHostActions`).
- *
- * It is the third rung of the ladder Arman ruled on 2026-09-12 — the system's
- * default, the organization's setting, and this meeting's. "Use my
- * organization's setting" is shown WITH what that resolves to, because a label
- * that does not say what the organization chose makes the host guess about
- * other people's words.
- */
-declare function GuestRecordAccessControl({ meeting, }: {
-    meeting: MeetingRecord;
-}): ReactNode;
 declare function MeetingRecordView({ meeting, onRejoin, }: {
     meeting: MeetingRecord;
     /** Optional: a recurring link can be re-opened. Absent for a one-off. */
@@ -746,85 +549,11 @@ declare function MeetingRecordView({ meeting, onRejoin, }: {
 declare function RecordingPlayer(props: {
     fileId: string;
 }): ReactNode;
-/**
- * THE MEETINGS LIST — live meetings AND the records of finished ones (MRI-D2).
- *
- * A finished meeting is not gone: it is the summary, the decisions, the action
- * items and the transcript behind the same durable link (R3). A list that
- * silently dropped ended meetings is what made every wrap-up unreachable from
- * the product, so an ended row is a first-class row here and its action says
- * what it opens.
- */
-declare function MeetingList({ baseUrl }: {
-    baseUrl?: string;
-}): ReactNode;
-
-/**
- * INLINED SVGs — no icon-library dependency, ever (C19).
- *
- * The tap-target precedent: ~60 buttons, all inlined, a fraction of a percent
- * of bloat and zero version-skew risk. These are Lucide-shaped paths, adapted;
- * they inherit `currentColor` so the token contract, not an icon prop, decides
- * every color.
- */
-
-type IconProps = SVGProps<SVGSVGElement>;
-declare function MicIcon(props: IconProps): React.ReactElement;
-declare function MicOffIcon(props: IconProps): React.ReactElement;
-declare function CameraIcon(props: IconProps): React.ReactElement;
-declare function CameraOffIcon(props: IconProps): React.ReactElement;
-declare function ScreenShareIcon(props: IconProps): React.ReactElement;
-declare function PhoneIcon(props: IconProps): React.ReactElement;
-/**
- * "Call end" — the downward handset on the red leave button (the glyph Meet
- * users recognise). A FILLED shape, so it overrides the line-icon defaults.
- */
-declare function PhoneOffIcon(props: IconProps): React.ReactElement;
-declare function HandIcon(props: IconProps): React.ReactElement;
-declare function ChatIcon(props: IconProps): React.ReactElement;
-declare function PeopleIcon(props: IconProps): React.ReactElement;
-declare function RecordIcon(props: IconProps): React.ReactElement;
-declare function SparklesIcon(props: IconProps): React.ReactElement;
-declare function LockIcon(props: IconProps): React.ReactElement;
-declare function LayoutIcon(props: IconProps): React.ReactElement;
-declare function SettingsIcon(props: IconProps): React.ReactElement;
-declare function CheckIcon(props: IconProps): React.ReactElement;
-declare function CloseIcon(props: IconProps): React.ReactElement;
-declare function PinIcon(props: IconProps): React.ReactElement;
-declare function WifiLowIcon(props: IconProps): React.ReactElement;
-declare function SmileIcon(props: IconProps): React.ReactElement;
-declare function MoreIcon(props: IconProps): React.ReactElement;
-declare function SearchIcon(props: IconProps): React.ReactElement;
-declare function KeyboardIcon(props: IconProps): React.ReactElement;
-declare function SpotlightIcon(props: IconProps): React.ReactElement;
-declare function SignalIcon({ bars, ...props }: IconProps & {
-    bars: 0 | 1 | 2 | 3;
-}): React.ReactElement;
-declare function SpeakerIcon(props: IconProps): React.ReactElement;
-declare function FlagIcon(props: IconProps): React.ReactElement;
-declare function PencilIcon(props: IconProps): React.ReactElement;
-/** Lucide `shapes` — the Activities menu (polls, Q&A, whiteboard, breakout rooms). */
-declare function ActivitiesIcon(props: IconProps): React.ReactElement;
-/** Lucide `chart-no-axes-column` — polls. */
-declare function PollIcon(props: IconProps): React.ReactElement;
-/** Lucide `message-circle-question` — Q&A. */
-declare function QuestionIcon(props: IconProps): React.ReactElement;
-/** Lucide `presentation` — the shared whiteboard. */
-declare function WhiteboardIcon(props: IconProps): React.ReactElement;
-/** Lucide `layout-panel-left`-like split — breakout rooms. */
-declare function BreakoutIcon(props: IconProps): React.ReactElement;
 
 /**
- * POLLS, Q&A, THE SHARED WHITEBOARD AND BREAKOUT ROOMS — the in-room surfaces (Meet wave 5).
- *
- * Every act goes to the server (`host.inRoom.collab`), which decides who may do it and
- * what each person sees; these components render what the store holds and say the
- * server's sentence when it refuses. A control exists only when the organization's knob
- * turns it on (`collab.settings`) — absent, never dead.
- *
- * The champions: Google Meet's Activities panel (one door to polls, Q&A, whiteboard and
- * breakouts) and Zoom's breakout-room controls (automatic / manual / let people choose,
- * timer, broadcast, move, bring everyone back).
+ * THE COLLAB AND CAPTION HOOKS — thin selectors over the core (CORE-DESIGN
+ * §5.3, step S1). The logic lives in `core/collab-state.ts`; these only bind it
+ * to the provider's store so every skin gets the same answers.
  */
 
 interface UseCollabResult {
@@ -847,35 +576,8 @@ interface UseCollabResult {
 declare function useCollab(): UseCollabResult;
 /** The activities this person has, in the order Meet lists them. */
 declare function useAvailableActivities(): CollabPanel[];
-declare function ActivitiesControl({ active, onOpen, }: {
-    active: CollabPanel | null;
-    onOpen: (panel: CollabPanel) => void;
-}): ReactNode;
-declare function PollsPanel({ onClose }: {
-    onClose: () => void;
-}): ReactNode;
-declare function QaPanel({ onClose }: {
-    onClose: () => void;
-}): ReactNode;
-/**
- * THE SHARED WHITEBOARD — one board per meeting, everyone draws, it is saved with the
- * meeting (every stroke is a room item). Replaces the stage while open, the way Zoom's
- * whiteboard does; the control bar stays.
- */
-declare function WhiteboardPanel({ onClose }: {
-    onClose: () => void;
-}): ReactNode;
-declare function BreakoutsPanel({ onClose }: {
-    onClose: () => void;
-}): ReactNode;
-/**
- * WHAT A PERSON IN A MEETING WITH BREAKOUTS SEES WITHOUT OPENING ANYTHING: the room they
- * were assigned to (with Join), the room they are in and its countdown (with Return),
- * a host's broadcast — and the moves: a host moving them, and everyone coming back.
- * Also asks the server to close the plan when the countdown reaches zero (the server's
- * clock decides; no schedule).
- */
-declare function BreakoutBanner(): ReactNode;
+/** Something worth a dot on the Activities button. */
+declare function useActivityAttention(): boolean;
 /**
  * The viewer's caption-translation choice and the translator's work queue. Finished
  * lines without a translation are sent in small batches; each line is translated once
@@ -890,9 +592,50 @@ declare function useCaptionTranslation(lines: readonly {
     translations: Readonly<Record<string, string>>;
     error: string | null;
 };
-/** The Settings panel's captions section: translate captions into a language, or not. */
-declare function CaptionLanguageSettings(): ReactNode;
 /** Which collab panel the bar should open, asked by something else (a poll launched). */
 declare function useCollabPanelRequest(onRequest: (panel: CollabPanel) => void): void;
 
-export { AccessTokenSource, ActivitiesControl, ActivitiesIcon, AiPanel, AttendanceNotice, Avatar, BreakoutBanner, BreakoutIcon, BreakoutsPanel, CallButton, CallCenter, CallInvite, CallMode, CallablePerson, CameraIcon, CameraOffIcon, CaptionLanguageSettings, Captions, ChatIcon, ChatPanel, CheckIcon, CloseIcon, CollabPanel, CollabRequest, CollabSnapshot, ConnectionDot, ConsentNotice, ControlBar, ControlButton, DeviceManager, DeviceSnapshot, FlagIcon, GuestRecordAccessControl, GuestRecordAccessResolution, GuestRecordAccessSetting, HandIcon, HostMenu, InRoomClient, IncomingCallCard, IncomingCallHost, JoinRequest, KeyboardIcon, LayoutIcon, LobbyEntry, LobbyPanel, LocalMediaState, LockIcon, MEET_REACTIONS, MEET_SHORTCUTS, MediaEffects, MeetAi, MeetAnswerCoverage, MeetApi, type MeetDiagnostic, type MeetHost, MeetIdentity, MeetParticipant, MeetProvider, type MeetProviderProps, MeetRepository, MeetSnapshot, MeetStore, MeetingId, MeetingList, MeetingNote, MeetingOverlays, MeetingRecord, MeetingRecordBundle, MeetingRecordCache, MeetingRecordView, MeetingRoom, MeetingSession, MicIcon, MicOffIcon, ModerationNotice, ModerationRequest, ModerationResult, MoreIcon, NoteTakerStatus, OrganizationId, ParticipantIdentity, ParticipantRole, ParticipantTile, PencilIcon, PeopleIcon, PeoplePanel, PersonMenu, PhoneIcon, PhoneOffIcon, PinIcon, PollIcon, PollsPanel, PreJoin, QaPanel, QualityBars, QuestionIcon, ReactionOverlay, RecordIcon, RecordingController, RecordingIndicator, RecordingPlayer, RoomDriverFactory, RoomEngine, RoomName, ScheduleMeeting, ScreenShareIcon, SearchIcon, SettingsIcon, SettingsPanel, ShortcutsSheet, SignalIcon, SmileIcon, SparklesIcon, SpeakerIcon, SpotlightIcon, Stage, StageLayout, TokenClient, type TranscriptLine, TranscriptSource, type UseCallsResult, type UseCollabResult, type UseEndMeetingResult, type UseGuestRecordAccessResult, type UseHostControlsResult, type UseLobbyResult, type UseMediaEffectsResult, type UseMeetAiResult, type UseMeetingRecordResult, type UseMeetingsResult, type UseRecordingResult, type UseRoomResult, UserId, WhiteboardIcon, WhiteboardPanel, WifiLowIcon, WrapUpAnnouncement, meetingRecordCache, useAudioLevel, useAvailableActivities, useCalls, useCanModerate, useCanRecord, useCaptionTranslation, useCollab, useCollabPanelRequest, useConsentNotice, useDeviceSnapshot, useElapsed, useEndMeeting, useGuestRecordAccess, useHandQueue, useHostControls, useIsHost, useListenOnlyNotice, useLobby, useLocalMedia, useLocalUserId, useMediaEffects, useMeetAi, useMeetHost, useMeetShortcuts, useMeetSnapshot, useMeeting, useMeetingId, useMeetingRecord, useMeetings, useModerationNotice, useReactions, useRecording, useRequiredMeetHost, useRole, useRoom, useStage, useTrack };
+/**
+ * THE SKIN FACADE — the ONLY module a skin may import (CORE-DESIGN §5.1, §5.4;
+ * step S1). Guard: `scripts/check-skin-imports.mjs` (in `check:package` and
+ * `pnpm test`): a file under `src/skins/` may import React, the design system,
+ * files inside its own skin folder, and THIS module — nothing else.
+ *
+ * `useMeetCore()` is the facade over today's store: the runtime, the room
+ * snapshot, devices, the server's role and the observation-contract reading,
+ * as one object that changes only when one of them does. The re-exports below
+ * are the headless hooks, pure helpers and types Meet skin v0 (today's in-call
+ * UI, moved here unchanged) reads. Later steps (S6a+) replace the re-exports
+ * with the `CoreSnapshot` slices and typed actions; a skin then reads
+ * `useMeetCore()` alone.
+ */
+
+interface MeetCore {
+    /** The runtime, or null while auth/organization resolve (render nothing). */
+    readonly host: MeetHost | null;
+    readonly snapshot: MeetSnapshot | null;
+    readonly devices: DeviceSnapshot | null;
+    /** The server's word on this person's role (both carriers, MRI-A11). */
+    readonly role: ParticipantRole;
+    readonly isHost: boolean;
+    /** What the observation contract reads for this tab (S0). */
+    readonly observation: MeetObservation;
+}
+/** The one headless read a skin starts from. Stable until something moves. */
+declare function useMeetCore(): MeetCore;
+
+/**
+ * THE RINGING SURFACE — skin-EXTERNAL (CORE-DESIGN §5.3): an incoming call
+ * rings on whatever page the person is on, outside any meeting skin.
+ */
+
+/**
+ * Mount ONCE, high in the tree. Every incoming call rings here, on whatever
+ * surface the user is on (R2).
+ */
+declare function IncomingCallHost(): ReactNode;
+declare function IncomingCallCard({ invite }: {
+    invite: CallInvite;
+}): ReactNode;
+
+export { AccessTokenSource, CallCenter, CallInvite, CallMode, CollabPanel, CollabRequest, CollabSnapshot, type CoreRootOptions, DeviceManager, DeviceSnapshot, GuestRecordAccessResolution, GuestRecordAccessSetting, InRoomClient, IncomingCallCard, IncomingCallHost, JoinRequest, LobbyEntry, LocalMediaState, MEET_SHORTCUTS, MediaEffects, MeetAi, MeetAnswerCoverage, MeetApi, type MeetCore, type MeetDiagnostic, type MeetHost, MeetIdentity, MeetObservation, MeetParticipant, MeetProvider, type MeetProviderProps, MeetRepository, MeetRoot, MeetSnapshot, MeetStore, MeetingId, MeetingNote, MeetingRecord, MeetingRecordBundle, MeetingRecordCache, MeetingRecordView, MeetingSession, MeetingSkinRoot, type MeetingSkinRootProps, ModerationNotice, ModerationRequest, ModerationResult, NoteTakerStatus, ObservedPhase, OrganizationId, ParticipantIdentity, ParticipantRole, RecordingController, RecordingPlayer, RoomDriverFactory, RoomEngine, RoomName, Stage, StageLayout, TokenClient, type TranscriptLine, TranscriptSource, type UseCallsResult, type UseCollabResult, type UseEndMeetingResult, type UseGuestRecordAccessResult, type UseHostControlsResult, type UseLobbyResult, type UseMediaEffectsResult, type UseMeetAiResult, type UseMeetingRecordResult, type UseMeetingsResult, type UseRecordingResult, type UseRoomResult, UserId, WrapUpAnnouncement, meetingRecordCache, useActivityAttention, useAudioLevel, useAvailableActivities, useCalls, useCanModerate, useCanRecord, useCaptionTranslation, useCollab, useCollabPanelRequest, useConsentNotice, useCoreObservation, useCoreRootProps, useDeviceSnapshot, useElapsed, useEndMeeting, useGuestRecordAccess, useHandQueue, useHostControls, useIsHost, useListenOnlyNotice, useLobby, useLocalMedia, useLocalUserId, useMediaEffects, useMeetAi, useMeetCore, useMeetHost, useMeetShortcuts, useMeetSnapshot, useMeeting, useMeetingId, useMeetingRecord, useMeetings, useModerationNotice, useReactions, useRecording, useRequiredMeetHost, useRole, useRoom, useStage, useTrack };