@tribe-nest/media-client 0.1.0

package/build/core/state.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initialRoomState = void 0;
+exports.reduceRoomState = reduceRoomState;
+exports.reduceRoomStateAll = reduceRoomStateAll;
+exports.producerById = producerById;
+exports.producersOf = producersOf;
+exports.activeProducers = activeProducers;
+exports.visibleProducers = visibleProducers;
+const media_protocol_1 = require("@tribe-nest/media-protocol");
+exports.initialRoomState = {
+    phase: "idle",
+    identity: null,
+    room: null,
+    peers: [],
+    producers: [],
+    activeSpeakers: [],
+    recording: false,
+    subscribeRule: null,
+    draining: null,
+    closedReason: null,
+};
+/**
+ * Apply one event frame.
+ *
+ * Never throws and never mutates. An event it does not recognise returns the
+ * SAME reference, so a caller can use identity to skip a re-render.
+ */
+function reduceRoomState(state, frame) {
+    switch (frame.event) {
+        case "joined":
+            // A wholesale replace, not a merge. `joined` also arrives after a
+            // reconnect, and merging would leave peers who left while we were away
+            // on screen for the rest of the call.
+            return {
+                phase: "joined",
+                identity: frame.identity,
+                room: frame.room,
+                peers: frame.peers,
+                producers: frame.producers.map((p) => ({ ...p, paused: false })),
+                activeSpeakers: [],
+                recording: frame.recording,
+                subscribeRule: null,
+                draining: null,
+                closedReason: null,
+            };
+        case "peerJoined": {
+            const without = state.peers.filter((p) => p.identity !== frame.peer.identity);
+            return { ...state, peers: [...without, frame.peer] };
+        }
+        case "peerLeft": {
+            if (!state.peers.some((p) => p.identity === frame.identity) &&
+                !state.producers.some((p) => p.identity === frame.identity)) {
+                return state;
+            }
+            // Their producers go with them. A `producerClosed` for each is NOT
+            // guaranteed when a peer's socket simply dies, and a producer left behind
+            // is a tile that never clears.
+            const producers = state.producers.filter((p) => p.identity !== frame.identity);
+            return {
+                ...state,
+                peers: state.peers.filter((p) => p.identity !== frame.identity),
+                producers,
+                activeSpeakers: pruneSpeakers(state.activeSpeakers, producers),
+            };
+        }
+        case "producerAppeared": {
+            if (state.producers.some((p) => p.producerId === frame.producerId))
+                return state;
+            return {
+                ...state,
+                producers: [
+                    ...state.producers,
+                    { producerId: frame.producerId, identity: frame.identity, kind: frame.kind, paused: false },
+                ],
+            };
+        }
+        case "producerClosed": {
+            if (!state.producers.some((p) => p.producerId === frame.producerId))
+                return state;
+            const producers = state.producers.filter((p) => p.producerId !== frame.producerId);
+            return { ...state, producers, activeSpeakers: pruneSpeakers(state.activeSpeakers, producers) };
+        }
+        case "producerPaused": {
+            let changed = false;
+            const producers = state.producers.map((p) => {
+                if (p.producerId !== frame.producerId || p.paused === frame.paused)
+                    return p;
+                changed = true;
+                return { ...p, paused: frame.paused };
+            });
+            return changed ? { ...state, producers } : state;
+        }
+        case "activeSpeakers":
+            // Stored as sent, INCLUDING ids we have not seen a `producerAppeared` for
+            // yet. The node decides the active set; dropping an id because our view
+            // is a frame behind would silently discard a stream we were told to take.
+            return { ...state, activeSpeakers: frame.producerIds };
+        case "recordingChanged":
+            return state.recording === frame.recording ? state : { ...state, recording: frame.recording };
+        case "draining":
+            return { ...state, draining: { reconnectAfterMs: frame.reconnectAfterMs } };
+        case "roomClosed":
+            // Producers and speakers are gone for good; peers are kept so a caller can
+            // still say who was in the room on the "call ended" screen.
+            return { ...state, phase: "closed", closedReason: frame.reason, producers: [], activeSpeakers: [] };
+        case "subscribeRuleChanged":
+            /**
+             * A rule that only applied at join would not apply to anyone already in
+             * the room, which is why the node pushes it.
+             *
+             * The rule is STORED and visibility is DERIVED, never pruned. Filtering
+             * `producers` here loses them permanently: the wire carries any
+             * `SubscribeRule`, `{ mode: "all" }` included, so a node WIDENING a
+             * barrier mid-call could never restore what a narrowing had deleted -
+             * there is no `producerAppeared` replay to bring them back.
+             *
+             * Active speakers are still pruned, because that set is the node's
+             * instruction about what to consume RIGHT NOW rather than a record of
+             * what exists.
+             */
+            return {
+                ...state,
+                subscribeRule: frame.subscribe,
+                activeSpeakers: pruneSpeakers(state.activeSpeakers, visibleUnder(frame.subscribe, state.identity, state.producers)),
+            };
+        default:
+            return state;
+    }
+}
+/** Convenience for a caller feeding a stream of frames, e.g. `signal.onAny`. */
+function reduceRoomStateAll(state, frames) {
+    return frames.reduce(reduceRoomState, state);
+}
+function producerById(state, producerId) {
+    return state.producers.find((p) => p.producerId === producerId);
+}
+function producersOf(state, identity) {
+    return state.producers.filter((p) => p.identity === identity);
+}
+/** The active set intersected with what we actually know about, in the node's order. */
+function activeProducers(state) {
+    const entries = [];
+    for (const id of state.activeSpeakers) {
+        const found = producerById(state, id);
+        if (found)
+            entries.push(found);
+    }
+    return entries;
+}
+/** Producers permitted under `rule`. Pure. */
+function visibleUnder(rule, self, producers) {
+    if (self === null || rule === null)
+        return producers;
+    return producers.filter((p) => permits(rule, self, p.identity));
+}
+/**
+ * What this participant may actually receive.
+ *
+ * Derived rather than stored, so a barrier that narrows and later widens is
+ * reversible. The reducer keeps every producer it has been told about; this is
+ * what a UI should render and what a client should consume from.
+ */
+function visibleProducers(state) {
+    return visibleUnder(state.subscribeRule, state.identity, state.producers);
+}
+function pruneSpeakers(speakers, producers) {
+    const live = new Set(producers.map((p) => p.producerId));
+    const kept = speakers.filter((id) => live.has(id));
+    return kept.length === speakers.length ? speakers : kept;
+}
+/**
+ * Asks the CONTRACT's decision function rather than reading the rule here.
+ *
+ * Re-implementing "deny wins, an absent rule means everyone" locally is how the
+ * client and the node end up disagreeing about who is visible, and the client's
+ * version is the one a user sees. The producer half (`visibleTo`) is enforced by
+ * the node from the owner's stored grants and is not knowable here, so this
+ * applies our half only.
+ */
+function permits(rule, selfIdentity, producerIdentity) {
+    if (selfIdentity === producerIdentity)
+        return true;
+    const consumerGrants = {
+        canPublish: false,
+        canSubscribe: true,
+        canPublishData: false,
+        subscribe: rule,
+    };
+    const ownerGrants = { canPublish: true, canSubscribe: false, canPublishData: false };
+    return (0, media_protocol_1.maySubscribe)({ consumerIdentity: selfIdentity, consumerGrants, producerIdentity, ownerGrants });
+}
+//# sourceMappingURL=state.js.map

package/build/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -0,0 +1,29 @@
+import { MediaRoom, type MediaRoomOptions } from "./room/room";
+/**
+ * `@tribe-nest/media-client` - the browser SDK.
+ *
+ * This is the entry point that KNOWS about the browser, and the only one that
+ * pulls in `mediasoup-client`. Importing it from a Node process works right up
+ * until a transport is created, which is why the harness, the egress client and
+ * the SIP gateway import `./core` instead.
+ *
+ * Three subpaths, three audiences:
+ *
+ *   `.`          browsers. Room, publish, subscribe, tracks.
+ *   `./react`    the same, as hooks.
+ *   `./core`     anything that is not a browser. No DOM, no mediasoup-client.
+ *   `./protocol` the wire types, for whoever only needs to speak it.
+ */
+export * from "./room/room";
+export { type IceServer, type MediaConsumerHandle, type MediaDevice, type MediaDeviceFactory, type MediaProducerHandle, type MediaTransport, type TransportDescription, type TransportHandlers, } from "./room/device";
+export { createBrowserDevice } from "./room/browserDevice";
+export { type DisconnectCause, type MediaCoreCredentials, type ProducerEntry, type RoomState, type SignalLogLevel, } from "./core";
+/**
+ * Connect to a room in a browser.
+ *
+ * The device is defaulted HERE rather than inside `room.ts`, so that the room
+ * logic never imports `mediasoup-client` and stays testable without a browser.
+ * Pass `device` explicitly to substitute one.
+ */
+export declare function connectToRoom(options: Omit<MediaRoomOptions, "device"> & Partial<Pick<MediaRoomOptions, "device">>): Promise<MediaRoom>;
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,QAAQ,CAAC;AAEhB;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,GACpF,OAAO,CAAC,SAAS,CAAC,CAIpB"}

package/build/index.js

@@ -0,0 +1,51 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBrowserDevice = void 0;
+exports.connectToRoom = connectToRoom;
+const browserDevice_1 = require("./room/browserDevice");
+const room_1 = require("./room/room");
+/**
+ * `@tribe-nest/media-client` - the browser SDK.
+ *
+ * This is the entry point that KNOWS about the browser, and the only one that
+ * pulls in `mediasoup-client`. Importing it from a Node process works right up
+ * until a transport is created, which is why the harness, the egress client and
+ * the SIP gateway import `./core` instead.
+ *
+ * Three subpaths, three audiences:
+ *
+ *   `.`          browsers. Room, publish, subscribe, tracks.
+ *   `./react`    the same, as hooks.
+ *   `./core`     anything that is not a browser. No DOM, no mediasoup-client.
+ *   `./protocol` the wire types, for whoever only needs to speak it.
+ */
+__exportStar(require("./room/room"), exports);
+var browserDevice_2 = require("./room/browserDevice");
+Object.defineProperty(exports, "createBrowserDevice", { enumerable: true, get: function () { return browserDevice_2.createBrowserDevice; } });
+/**
+ * Connect to a room in a browser.
+ *
+ * The device is defaulted HERE rather than inside `room.ts`, so that the room
+ * logic never imports `mediasoup-client` and stays testable without a browser.
+ * Pass `device` explicitly to substitute one.
+ */
+async function connectToRoom(options) {
+    const room = new room_1.MediaRoom({ ...options, device: options.device ?? browserDevice_1.createBrowserDevice });
+    await room.connect();
+    return room;
+}
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA+CA,sCAMC;AArDD,wDAA2D;AAC3D,sCAA+D;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,8CAA4B;AAW5B,sDAA2D;AAAlD,oHAAA,mBAAmB,OAAA;AAU5B;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,OAAqF;IAErF,MAAM,IAAI,GAAG,IAAI,gBAAS,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,mCAAmB,EAAE,CAAC,CAAC;IAC1F,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/build/protocol.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `@tribe-nest/media-client/protocol` is a re-export of the frozen contract and
+ * nothing else.
+ *
+ * It exists so an SDK consumer needs one dependency rather than two, and so
+ * there is a visible place that would have to be edited if anyone ever tried to
+ * "extend" a frame locally. Nothing is added here. Ever.
+ */
+export * from "@tribe-nest/media-protocol";
+//# sourceMappingURL=protocol.d.ts.map

package/build/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,4BAA4B,CAAC"}

package/build/protocol.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * `@tribe-nest/media-client/protocol` is a re-export of the frozen contract and
+ * nothing else.
+ *
+ * It exists so an SDK consumer needs one dependency rather than two, and so
+ * there is a visible place that would have to be edited if anyone ever tried to
+ * "extend" a frame locally. Nothing is added here. Ever.
+ */
+__exportStar(require("@tribe-nest/media-protocol"), exports);
+//# sourceMappingURL=protocol.js.map

package/build/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;GAOG;AACH,6DAA2C"}

package/build/react/index.d.ts

@@ -0,0 +1,147 @@
+import { type ReactNode } from "react";
+import type { MediaGrants, Peer } from "@tribe-nest/media-protocol";
+import { MediaRoom, type ConnectionState, type LocalPublication, type MediaRoomOptions, type MediaTrack } from "../room/room";
+import type { DisconnectCause, ProducerEntry, RoomState } from "../core";
+/**
+ * The React surface.
+ *
+ * ## Why `useSyncExternalStore` rather than state in the provider
+ *
+ * The room is an external mutable object with its own event loop, which is
+ * precisely the case React 18 added that hook for. The alternative - mirroring
+ * room state into `useState` on every event - tears: a component reading
+ * `room.tracks` directly during a render sees a newer value than the mirrored
+ * copy it was rendered from, and the bug shows up as a tile that is one event
+ * behind exactly when the room is busiest.
+ *
+ * ## Why every hook takes NO arguments
+ *
+ * `useMediaRoom()` reads the provider. A hook that took credentials would let
+ * two components mount two rooms against one call, and the second would take
+ * the identity from the first and be refused with `duplicate_identity`. One
+ * room per provider, and the provider owns its lifetime.
+ */
+type MediaRoomContextValue = {
+    room: MediaRoom | null;
+    connectionState: ConnectionState;
+    error: DisconnectCause | undefined;
+    /**
+     * Is the SDK actually coming back on its own?
+     *
+     * `connectionState` is `reconnecting` both while an attempt is booked and
+     * after the policy has given up, so a screen reading only that spins for ever
+     * over a call that is finished. This is the half that says which, and it is
+     * what a UI turns "wait" against "press something" on.
+     */
+    recovering: boolean;
+    retry: () => void;
+};
+export type MediaRoomProviderProps = Omit<MediaRoomOptions, "device"> & Partial<Pick<MediaRoomOptions, "device">> & {
+    children: ReactNode;
+    /** Rendered while the first connection is in flight. */
+    fallback?: ReactNode;
+};
+export declare function MediaRoomProvider({ children, fallback, device, ...options }: MediaRoomProviderProps): ReactNode;
+export declare function useMediaRoom(): MediaRoomContextValue;
+export declare function useRoomState(): RoomState;
+export declare function useParticipants(): readonly Peer[];
+export declare function useActiveSpeakers(): readonly string[];
+/**
+ * The producers this participant may actually receive. What a UI renders.
+ *
+ * NOT `useRoomState().producers`, and the difference is the subscribe barrier.
+ * The reducer keeps every producer the node has ever announced, deliberately,
+ * so that a rule which narrows mid-call and later widens is reversible - there
+ * is no `producerAppeared` replay to bring back a producer it had deleted. The
+ * price of keeping them is that the raw list contains people this seat has been
+ * barred from, and on a sealed consultation room the mere PRESENCE of the other
+ * party is most of what the barrier was hiding. A UI mapping over the raw list
+ * therefore draws a tile carrying their identity and mounts an `<audio>` for
+ * them, and the node's own filtering does not save it: `revokeNewlyForbidden`
+ * only closes producers this session had a live consumer for, so one that was
+ * announced and never consumed stays in the list for the rest of the call.
+ *
+ * Memoised on the state OBJECT rather than used as a store selector: the filter
+ * builds a new array per call, and `useSyncExternalStore` compares snapshots
+ * with `Object.is`, so reading it through `useRoomSnapshot` would re-render for
+ * ever. The reducer returns the same state object when nothing changed, which
+ * is what makes this settle.
+ */
+export declare function useVisibleProducers(): readonly ProducerEntry[];
+/**
+ * What THIS participant is publishing right now, with the live tracks.
+ *
+ * `useLocalMedia()` answers "is the camera on" and that is enough for a button,
+ * but a local preview needs the `MediaStreamTrack` itself, and reading
+ * `room.localPublications` from `useMediaRoom()` is not reactive: the preview
+ * would stay black until something else happened to re-render it.
+ *
+ * The snapshot is the room's cached array, rebuilt only when a publication
+ * changed, which is what keeps this out of the `getSnapshot` loop.
+ */
+export declare function useLocalPublications(): readonly LocalPublication[];
+/** What the NODE says this token may do. For rendering, never for a decision:
+ * the node enforces independently and is the only side that counts. */
+export declare function useGrants(): MediaGrants | undefined;
+/** True while any egress participant is present. A consent signal. */
+export declare function useRecording(): boolean;
+/**
+ * One remote track, and a ref callback that attaches it.
+ *
+ * `attach` exists because `srcObject` cannot be set through JSX: it takes a
+ * `MediaStream` object, not a string, so every consumer of this hook would
+ * otherwise write the same `useEffect`.
+ *
+ * ## Why it is keyed on the TRACK
+ *
+ * A ref callback runs when the element mounts and again only when the callback
+ * IDENTITY changes. The track almost never exists at mount: a producer reaches
+ * `state.producers` the moment the node announces it, and the consume round
+ * trip that produces the track finishes some milliseconds later. So a callback
+ * memoised on `[room, producerId]` - both stable - ran exactly once, against no
+ * track, set `srcObject` to `null` and was never called again. An element that
+ * is only ever mounted once therefore stayed silent for the whole call, which
+ * is what happened to remote AUDIO: a `<video>` escapes it because a tile
+ * renders one only after the track arrives, and every remote `<video>` is
+ * `muted`, so a call had picture and no sound in either direction.
+ *
+ * Depending on `track` is what makes React re-run it: the identity changes when
+ * the track appears, React calls the old callback with `null` and the new one
+ * with the element. `MediaTrack` objects are created once per consumer and the
+ * room's snapshot array is rebuilt only when a track changes, so this settles
+ * rather than churning.
+ */
+export declare function useRemoteTrack(producerId: string): {
+    track: MediaTrack | undefined;
+    attach: (element: HTMLMediaElement | null) => void;
+};
+export type LocalSource = "camera" | "microphone" | "screen";
+export type LocalMediaControls = {
+    publishCamera: () => Promise<void>;
+    publishMicrophone: () => Promise<void>;
+    publishScreen: () => Promise<void>;
+    unpublish: (source: LocalSource) => Promise<void>;
+    isCameraEnabled: boolean;
+    isMicrophoneEnabled: boolean;
+    screenSharing: boolean;
+    /**
+     * A capture or a publish is in flight for this source.
+     *
+     * Exposed so a control can be disabled rather than silently ignoring the
+     * second press: a permission prompt takes seconds, during which every flag
+     * above still reads `false`, and a button that looks unchanged is a button
+     * people press again.
+     */
+    pending: Record<LocalSource, boolean>;
+    error: Error | undefined;
+};
+/**
+ * Capture and publish.
+ *
+ * `getUserMedia` lives here rather than in the room because permission is a
+ * BROWSER concern with a UI consequence - a denied prompt is something a person
+ * has to be told about - and the room has no way to say so.
+ */
+export declare function useLocalMedia(): LocalMediaControls;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EACL,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,KAAK,qBAAqB,GAAG;IAC3B,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC;;;;;;;OAOG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAIF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,GACnE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,GAAG;IAC1C,QAAQ,EAAE,SAAS,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEJ,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB,GAAG,SAAS,CAsD/G;AAQD,wBAAgB,YAAY,IAAI,qBAAqB,CAEpD;AAiCD,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,wBAAgB,eAAe,IAAI,SAAS,IAAI,EAAE,CAEjD;AAED,wBAAgB,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAErD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,aAAa,EAAE,CAG9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,gBAAgB,EAAE,CAElE;AAED;uEACuE;AACvE,wBAAgB,SAAS,IAAI,WAAW,GAAG,SAAS,CAGnD;AAED,sEAAsE;AACtE,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAC;CACpD,CAaA;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACtC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1B,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,kBAAkB,CAkHlD"}