@joewinke/jatui 0.2.19 → 0.2.21

package/dist/meet/livekit.js

@@ -0,0 +1,56 @@
+/**
+ * livekit-client optional-peer loader.
+ *
+ * `livekit-client` is an OPTIONAL peer dependency (peerDependenciesMeta), so a
+ * consumer that never touches `@joewinke/jatui/meet` need not install it. To
+ * keep that promise we NEVER import runtime values from the package at module
+ * scope — a static `import { Room } from 'livekit-client'` would make the whole
+ * subpath fail to resolve at import time in a consumer without the peer (the
+ * d3 lesson: the missing module resolves to `undefined` / a bundler stub and
+ * `Room` is `(void 0)` → "is not a constructor"). Instead every runtime value
+ * comes through `loadLiveKit()`, a cached lazy `import()` that throws a clear,
+ * actionable error when the peer is absent.
+ *
+ * Types are safe to import statically with `import type` — they are fully
+ * erased at compile time and never emit a runtime `require`/`import`.
+ */
+/** Thrown when a `jatui/meet` component needs `livekit-client` but it isn't installed. */
+export class LiveKitNotInstalledError extends Error {
+    constructor(cause) {
+        super("livekit-client is not installed. `@joewinke/jatui/meet` needs it as a peer " +
+            'dependency — run `npm install livekit-client` in the consuming app. ' +
+            '(It is an OPTIONAL peer so apps that never render meeting UI can skip it.)');
+        this.name = 'LiveKitNotInstalledError';
+        if (cause !== undefined)
+            this.cause = cause;
+    }
+}
+let cached = null;
+/**
+ * Lazily load `livekit-client`. Cached after the first call so repeated mounts
+ * share one module instance. Rejects with {@link LiveKitNotInstalledError} when
+ * the peer is missing, so callers can render a graceful fallback instead of a
+ * hard page crash.
+ */
+export function loadLiveKit() {
+    if (cached)
+        return cached;
+    cached = import('livekit-client')
+        .then((mod) => mod)
+        .catch((err) => {
+        // Reset so a later call (e.g. after the dep is added in dev) can retry.
+        cached = null;
+        throw new LiveKitNotInstalledError(err);
+    });
+    return cached;
+}
+/** True if `livekit-client` can be loaded in this environment. Never throws. */
+export async function isLiveKitAvailable() {
+    try {
+        await loadLiveKit();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/meet/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * View-model types for the `jatui/meet` component suite.
+ *
+ * These are deliberately independent of `livekit-client`'s own types so that
+ * the presentational components (VideoTile, ControlBar, ParticipantList,
+ * RecordingBadge) can be driven by plain objects — and therefore rendered in
+ * docs demos with a mocked participant, no LiveKit server required. The
+ * container components (MeetingRoom, PreJoinLobby) adapt real LiveKit
+ * `Participant`/`Track` objects into these shapes.
+ */
+/** A participant's role in the room — governs which host controls appear. */
+export type MeetRole = 'host' | 'participant' | 'observer';
+/** Connection quality bucket, mirrors livekit-client's ConnectionQuality. */
+export type MeetConnectionQuality = 'excellent' | 'good' | 'poor' | 'unknown';
+/**
+ * A participant as the UI sees it. `videoTrack`/`audioTrack` are opaque Media
+ * stream sources: either a real `MediaStreamTrack` (from LiveKit) or, in demos,
+ * a track obtained from `getUserMedia`/`null`. VideoTile only needs to attach
+ * the track to a `<video>` element, so it accepts `MediaStreamTrack | null`.
+ */
+export interface MeetParticipant {
+    /** Stable identity — LiveKit `Participant.identity`. */
+    id: string;
+    /** Display name shown on the tile and in the roster. */
+    name: string;
+    /** Role — drives host-control affordances. */
+    role: MeetRole;
+    /** Whether the mic is currently muted. */
+    micMuted: boolean;
+    /** Whether the camera is off (no video track publishing). */
+    cameraOff: boolean;
+    /** Whether this participant is the local user. */
+    isLocal?: boolean;
+    /** Whether this participant is currently sharing their screen. */
+    isScreenSharing?: boolean;
+    /** Whether audio activity was detected recently (drives the speaking ring). */
+    isSpeaking?: boolean;
+    /** Connection quality indicator. */
+    connectionQuality?: MeetConnectionQuality;
+    /** Avatar image URL for the camera-off placeholder. */
+    avatarUrl?: string;
+    /**
+     * The video MediaStreamTrack to render, or null when the camera is off /
+     * not yet resolved. VideoTile builds a MediaStream from it and attaches it
+     * to a muted, autoplaying <video>.
+     */
+    videoTrack?: MediaStreamTrack | null;
+    /**
+     * The screen-share MediaStreamTrack, rendered instead of the camera track
+     * when present and `isScreenSharing` is true.
+     */
+    screenTrack?: MediaStreamTrack | null;
+}
+/** The set of host actions ControlBar can surface against a participant. */
+export interface MeetHostActions {
+    /** Mute a remote participant's mic (host only). */
+    onMuteParticipant?: (participantId: string) => void;
+    /** Remove a participant from the room (host only). */
+    onRemoveParticipant?: (participantId: string) => void;
+    /** Toggle whether new participants can join (room lock). */
+    onToggleLock?: (locked: boolean) => void;
+    /** Start or stop server-side recording. */
+    onToggleRecording?: (recording: boolean) => void;
+    /** End the meeting for everyone. */
+    onEndForAll?: () => void;
+}
+/** Local-control callbacks fired by ControlBar for the local participant. */
+export interface MeetLocalControls {
+    /** Toggle the local mic. Receives the desired muted state. */
+    onToggleMic?: (muted: boolean) => void;
+    /** Toggle the local camera. Receives the desired off state. */
+    onToggleCamera?: (off: boolean) => void;
+    /** Toggle screen share. Receives the desired sharing state. */
+    onToggleScreenShare?: (sharing: boolean) => void;
+    /** Leave the meeting (local participant only). */
+    onLeave?: () => void;
+}
+/** Result of the pre-join device check, handed to the join handler. */
+export interface PreJoinResult {
+    /** Confirmed display name. */
+    displayName: string;
+    /** Whether the user wants to join with the camera enabled. */
+    cameraEnabled: boolean;
+    /** Whether the user wants to join with the mic enabled. */
+    micEnabled: boolean;
+    /** Selected camera deviceId, if the user picked one. */
+    videoDeviceId?: string;
+    /** Selected microphone deviceId, if the user picked one. */
+    audioDeviceId?: string;
+    /** Whether the consent checkbox was ticked (only relevant when required). */
+    consentGiven: boolean;
+}
+/** Room-level status the UI reflects (badge, lock icon, etc.). */
+export interface MeetRoomState {
+    /** Whether the room is currently being recorded. */
+    recording?: boolean;
+    /** Whether the room is locked to new joiners. */
+    locked?: boolean;
+    /** Connection lifecycle state for the local participant. */
+    connectionState?: 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
+}
+/** Layout mode for the meeting grid. */
+export type MeetLayout = 'grid' | 'focus';

package/dist/meet/types.js

@@ -0,0 +1,11 @@
+/**
+ * View-model types for the `jatui/meet` component suite.
+ *
+ * These are deliberately independent of `livekit-client`'s own types so that
+ * the presentational components (VideoTile, ControlBar, ParticipantList,
+ * RecordingBadge) can be driven by plain objects — and therefore rendered in
+ * docs demos with a mocked participant, no LiveKit server required. The
+ * container components (MeetingRoom, PreJoinLobby) adapt real LiveKit
+ * `Participant`/`Track` objects into these shapes.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joewinke/jatui",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",
@@ -54,6 +54,11 @@
       "types": "./dist/showcase/scroll/index.d.ts",
       "svelte": "./dist/showcase/scroll/index.js",
       "default": "./dist/showcase/scroll/index.js"
+    },
+    "./meet": {
+      "types": "./dist/meet/index.d.ts",
+      "svelte": "./dist/meet/index.js",
+      "default": "./dist/meet/index.js"
     }
   },
   "files": [
@@ -78,17 +83,18 @@
     "@atlaskit/pragmatic-drag-and-drop-auto-scroll": "~3.0.0",
     "@atlaskit/pragmatic-drag-and-drop-hitbox": "~2.0.0",
     "@atlaskit/pragmatic-drag-and-drop-live-region": "~2.0.0",
-    "d3": "^7.0.0",
-    "daisyui": "^5.0.0",
-    "svelte": "^5.0.0",
-    "tailwindcss": "^4.0.0",
+    "@paper-design/shaders": ">=0.0.50",
     "@tanstack/table-core": "^8.0.0",
     "@xyflow/svelte": "^1.0.0",
     "cobe": "^2.0.0",
-    "@paper-design/shaders": ">=0.0.50",
-    "motion": "^12.0.0",
+    "d3": "^7.0.0",
+    "daisyui": "^5.0.0",
+    "embla-carousel-svelte": "^8.0.0",
     "lenis": "^1.0.0",
-    "embla-carousel-svelte": "^8.0.0"
+    "livekit-client": "^2.0.0",
+    "motion": "^12.0.0",
+    "svelte": "^5.0.0",
+    "tailwindcss": "^4.0.0"
   },
   "peerDependenciesMeta": {
     "@atlaskit/pragmatic-drag-and-drop": {
@@ -132,6 +138,9 @@
     },
     "embla-carousel-svelte": {
       "optional": true
+    },
+    "livekit-client": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -155,6 +164,7 @@
     "daisyui": "^5.0.0",
     "embla-carousel-svelte": "^8.6.0",
     "lenis": "^1.3.25",
+    "livekit-client": "^2.20.1",
     "motion": "^12.42.2",
     "svelte": "^5.0.0",
     "tailwindcss": "^4.0.0",
@@ -162,11 +172,11 @@
     "vite": "^6.0.0"
   },
   "dependencies": {
+    "@floating-ui/dom": "^1.6.0",
     "diff": "^9.0.0",
     "libphonenumber-js": "^1.12.41",
     "pdfjs-dist": "^5.6.205",
-    "svelte-dnd-action": "^0.9.69",
-    "@floating-ui/dom": "^1.6.0"
+    "svelte-dnd-action": "^0.9.69"
   },
   "license": "MIT"
 }