@signalcore/ui 0.1.0 → 1.0.0-beta.0

package/dist/host.d.ts

@@ -1,124 +0,0 @@
-import type { ComponentType, ReactNode } from "react";
-import type { VoiceState } from "./voice/voice.js";
-/**
- * What the user did on a component, before the surface adds its own id (see `SurfaceAction`):
- * the name of the action, its data, and what the user said in words ("Good fit: Calle Mayor 3"),
- * which is how it shows in the conversation.
- */
-export interface HostAction {
-    name: string;
-    data: Record<string, unknown>;
-    label: string;
-}
-/**
- * What a host's component is given when it draws a catalog component's name (`SlotPicker`): the
- * properties the agent filled, with bindings to the surface's data already resolved. They are
- * the agent's words, not checked against anything: read them loosely. A container also gets its
- * `children`, drawn, and a component that asks the user for something reports it with
- * `onAction`, which is missing when the surface takes no actions (an older one).
- *
- * A component the host registered under a name of its own is drawn for a `host` node instead,
- * and is given what is described at `HostComponents`.
- */
-export type HostProps = Record<string, unknown> & {
-    children?: ReactNode;
-    onAction?: ((action: HostAction) => void) | undefined;
-};
-export interface ButtonProps {
-    children: ReactNode;
-    variant?: "primary" | "secondary" | "ghost" | undefined;
-    size?: "sm" | "md" | undefined;
-    type?: "button" | "submit" | undefined;
-    disabled?: boolean | undefined;
-    onClick?: (() => void) | undefined;
-}
-/** A box with a title: what a surface's `Card` is drawn with. */
-export interface CardProps {
-    title?: string | undefined;
-    subtitle?: string | undefined;
-    children?: ReactNode;
-}
-/** Rows of records; every cell is already text. */
-export interface TableProps {
-    columns: {
-        key: string;
-        label: string;
-    }[];
-    rows: Record<string, string>[];
-}
-/** The control of a text, number or date field; the label around it is the form's. */
-export interface InputProps {
-    name: string;
-    type: "text" | "number" | "date";
-    required?: boolean | undefined;
-    onChange: (value: string) => void;
-}
-/** The control of a field with options; `""` is nothing picked yet. */
-export interface SelectProps {
-    name: string;
-    options: {
-        id: string;
-        label: string;
-    }[];
-    required?: boolean | undefined;
-    onChange: (value: string) => void;
-}
-/**
- * The orb of the voice window: a shape that shows where the conversation stands and how loud it
- * is. Nothing here is the agent's words; a host replaces it with its own artwork.
- */
-export interface OrbProps {
-    /** Where the conversation stands. The orb looks different in each. */
-    state: VoiceState;
-    /**
-     * How loud the microphone (while `listening`) or the voice (while `speaking`) is right now, from
-     * 0 to 1, already smoothed: it can drive an animation as it is. 0 in the other states.
-     */
-    level: number;
-    /** The diameter in pixels. Default: the orb's own. */
-    size?: number | undefined;
-    /** What the orb is, for those who cannot see it: set it as the `aria-label`. */
-    label: string;
-    className?: string | undefined;
-}
-export interface Primitives {
-    Button: ComponentType<ButtonProps>;
-    Card: ComponentType<CardProps>;
-    Table: ComponentType<TableProps>;
-    Input: ComponentType<InputProps>;
-    Select: ComponentType<SelectProps>;
-    /**
-     * Only the voice window draws it (`@signalcore/ui/voice`, whose default is the one built on the
-     * `orb-ui` library, so a host that never speaks does not load it). Ours stands still under
-     * `prefers-reduced-motion`; a replacement should too.
-     */
-    Orb: ComponentType<OrbProps>;
-}
-/**
- * The host's components, by name. Three kinds of name:
- *
- * - A name of the host's own (`PropertyCard`), registered with the API too (in the SDKs,
- *   `client.ui.components.put`) with a schema for its props and a text twin. An agent uses it
- *   with a node `{ id, type: "host", component: "PropertyCard", props: { … } }`, and the host's
- *   component is drawn with:
- *   - the node's `props`, exactly as given: the API validated them against the registered
- *     schema before the surface was sent, so the component can rely on their shape. They are
- *     values: a binding (`{ path }`) is not looked up in them;
- *   - `onAction({ name, data, label })`, to report what the user does (a "Good fit" button):
- *     it goes back through the surface's action path as `Action` (with the surface's id), like
- *     a pick on a list. It is missing when the surface takes no actions (a record), and the
- *     node's props cannot replace it;
- *   - no `children`.
- *
- *   The component's text twin is already part of the surface's `fallback_text`, so a surface
- *   whose component this page has not registered, or whose component throws, shows the whole
- *   surface in words instead (and a development build tells the developer which name is missing).
- * - The catalog's (`SlotPicker`, `DataTable`…): a surface that uses the name is drawn with the
- *   host's component, given `HostProps`. Typed loosely so a component can declare the
- *   properties it expects.
- * - The primitives (`Button`, `Card`, `Table`, `Input`, `Select`): every surface is built from
- *   the host's, with the typed props above. They add nothing to the catalog: a surface cannot
- *   name them, as a catalog component or as a `host` node. `Orb` is one too, though no surface
- *   uses it: the voice window does.
- */
-export type HostComponents = Partial<Primitives> & Record<string, ComponentType<never>>;

package/dist/host.js

@@ -1 +0,0 @@
-export {};

package/dist/live/LiveView.d.ts

@@ -1,28 +0,0 @@
-import type { LiveStatus } from "./follow.js";
-export interface LiveViewProps {
-    /** The stream to watch (`liv_...`), from a `live` surface or a browser session. */
-    streamId: string;
-    /** The shape of the picture as "16:9", held until the stream says its real size. */
-    aspect?: string | undefined;
-    /**
-     * Whether the person may act on the stream: the pointer, the wheel and (with the focus on it)
-     * the keys are then sent to it. Whether it is their turn is for the stream's producer to say.
-     */
-    input?: boolean | undefined;
-    /** Told each time the view's state changes; `unavailable` means it cannot be watched from here. */
-    onStatus?: ((status: LiveStatus) => void) | undefined;
-    /** What the picture is, for those who cannot see it. */
-    label?: string | undefined;
-    className?: string | undefined;
-}
-/**
- * A live stream, watched: the pictures it sends drawn on a canvas as they arrive (the newest,
- * never a queue), sized by the stream, and a quiet word for how the connection is. A dropped
- * connection is opened again, a little later each time; one that ended or was refused is not.
- * It needs a client that can `live.connect` (the SDK's does).
- *
- * With `input`, the view takes the pointer and the keyboard once the stream says it takes input:
- * clicks, drags, the wheel and keys go to the stream in its own pixels. The canvas is then
- * reachable by the keyboard, and keys go to the stream only while it has the focus (Tab leaves).
- */
-export declare function LiveView(props: LiveViewProps): import("react").JSX.Element;

package/dist/live/LiveView.js

@@ -1,55 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useRef } from "react";
-import { Scoped, useMessages, useParts } from "../SignalcoreProvider.js";
-import { capture } from "./capture.js";
-import { painterOn } from "./paint.js";
-import { useLiveStream } from "./useLiveStream.js";
-const SHAPE = /^\d{1,3}:\d{1,3}$/;
-const DEFAULT_SHAPE = "16 / 9";
-/**
- * A live stream, watched: the pictures it sends drawn on a canvas as they arrive (the newest,
- * never a queue), sized by the stream, and a quiet word for how the connection is. A dropped
- * connection is opened again, a little later each time; one that ended or was refused is not.
- * It needs a client that can `live.connect` (the SDK's does).
- *
- * With `input`, the view takes the pointer and the keyboard once the stream says it takes input:
- * clicks, drags, the wheel and keys go to the stream in its own pixels. The canvas is then
- * reachable by the keyboard, and keys go to the stream only while it has the focus (Tab leaves).
- */
-export function LiveView(props) {
-    return (_jsx(Scoped, { children: _jsx(Viewer, { ...props }) }));
-}
-function Viewer({ streamId, aspect = "16:9", input = false, onStatus, label, className, }) {
-    const part = useParts();
-    const messages = useMessages();
-    const shape = SHAPE.test(aspect) ? aspect.replace(":", " / ") : DEFAULT_SHAPE;
-    const canvas = useRef(null);
-    const painter = useRef(undefined);
-    const reported = useRef(onStatus);
-    useEffect(() => {
-        if (!canvas.current)
-            return undefined;
-        const drawing = painterOn(canvas.current);
-        painter.current = drawing;
-        return () => {
-            drawing.dispose();
-            painter.current = undefined;
-        };
-    }, []);
-    const { status, info, send } = useLiveStream(streamId, (frame) => {
-        painter.current?.paint(frame.bytes);
-    });
-    const interactive = input && info?.input === true;
-    useEffect(() => {
-        if (!canvas.current || !info || !interactive)
-            return undefined;
-        return capture(canvas.current, info, send);
-    }, [info, interactive, send]);
-    useEffect(() => {
-        reported.current = onStatus;
-    });
-    useEffect(() => {
-        reported.current?.(status);
-    }, [status]);
-    return (_jsxs("div", { ...part("live", [status, interactive && "input"], className), children: [_jsx("canvas", { ref: canvas, role: "img", "aria-label": label ?? messages.liveView, tabIndex: interactive ? 0 : undefined, width: info?.width, height: info?.height, style: info ? undefined : { aspectRatio: shape }, ...part("live__canvas") }), _jsxs("p", { role: "status", ...part("live__status"), children: [_jsx("span", { "aria-hidden": true, ...part("live__dot") }), messages.liveStatus[status]] })] }));
-}

package/dist/live/capture.d.ts

@@ -1,20 +0,0 @@
-/**
- * A person's pointer, wheel and keys on a canvas, as the input a stream takes (`LiveInput`).
- * Coordinates are the stream's pixels: the canvas is shown at whatever size the page gives it.
- */
-import type { LiveInput } from "@signalcore/sdk";
-export interface Size {
-    width: number;
-    height: number;
-}
-type Send = (input: LiveInput) => void;
-/**
- * Starts sending what the person does on `canvas` to `send`; the returned function stops it.
- *
- * The pointer goes as `down`, `move` and `up` (so drags and double clicks work as they do on the
- * page), the wheel as `wheel` (the page behind the canvas does not scroll), and keys as `down` and
- * `up` while the canvas has the focus. Tab is left alone so that the focus can leave, and a key
- * still held when the focus goes is let go. The context menu is the page's, not ours.
- */
-export declare function capture(canvas: HTMLCanvasElement, size: Size, send: Send): () => void;
-export {};

package/dist/live/capture.js

@@ -1,100 +0,0 @@
-/**
- * A person's pointer, wheel and keys on a canvas, as the input a stream takes (`LiveInput`).
- * Coordinates are the stream's pixels: the canvas is shown at whatever size the page gives it.
- */
-const BUTTONS = { 0: "left", 1: "middle", 2: "right" };
-const MOVE_EVERY_MS = 40; // a move is a hint of where the pointer is: 25 a second is plenty
-const LINE_PX = 16; // what a wheel that scrolls by lines means in pixels
-const MAX_DELTA = 10_000; // what the stream takes
-/** Where `event` is on the stream: scaled from the canvas as shown, and kept inside it. */
-function pointOf(event, canvas, size) {
-    const box = canvas.getBoundingClientRect();
-    const along = (at, from, shown, real) => shown > 0 ? Math.round(Math.min(Math.max((at - from) / shown, 0), 1) * real) : 0;
-    return {
-        x: along(event.clientX, box.left, box.width, size.width),
-        y: along(event.clientY, box.top, box.height, size.height),
-    };
-}
-const clamp = (value, limit) => Math.min(Math.max(value, -limit), limit);
-/**
- * Starts sending what the person does on `canvas` to `send`; the returned function stops it.
- *
- * The pointer goes as `down`, `move` and `up` (so drags and double clicks work as they do on the
- * page), the wheel as `wheel` (the page behind the canvas does not scroll), and keys as `down` and
- * `up` while the canvas has the focus. Tab is left alone so that the focus can leave, and a key
- * still held when the focus goes is let go. The context menu is the page's, not ours.
- */
-export function capture(canvas, size, send) {
-    const held = new Set();
-    let lastMove = Number.NEGATIVE_INFINITY;
-    let clicks = 1; // of the press the button is coming up from
-    const release = (event) => {
-        const button = BUTTONS[event.button];
-        if (button)
-            send({ type: "mouse", action: "up", ...pointOf(event, canvas, size), button, clicks });
-    };
-    const press = (event) => {
-        const button = BUTTONS[event.button];
-        if (!button)
-            return;
-        event.preventDefault(); // the page would select the canvas and keep the focus where it was
-        clicks = Math.min(Math.max(event.detail, 1), 3);
-        send({ type: "mouse", action: "down", ...pointOf(event, canvas, size), button, clicks });
-        canvas.focus({ preventScroll: true }); // a click does not move the page under the pointer
-        // The button may come up outside the canvas, in the middle of a drag.
-        window.addEventListener("mouseup", release, { once: true });
-    };
-    const move = (event) => {
-        if (event.timeStamp - lastMove < MOVE_EVERY_MS)
-            return;
-        lastMove = event.timeStamp;
-        send({ type: "mouse", action: "move", ...pointOf(event, canvas, size) });
-    };
-    const wheel = (event) => {
-        event.preventDefault();
-        const unit = event.deltaMode === 1 ? LINE_PX : event.deltaMode === 2 ? size.height : 1;
-        send({
-            type: "wheel",
-            ...pointOf(event, canvas, size),
-            deltaX: clamp(event.deltaX * unit, MAX_DELTA),
-            deltaY: clamp(event.deltaY * unit, MAX_DELTA),
-        });
-    };
-    const keyed = (action) => (event) => {
-        if (event.key === "Tab" || event.isComposing)
-            return;
-        event.preventDefault();
-        if (action === "down")
-            held.add(event.key);
-        else
-            held.delete(event.key);
-        send({ type: "key", action, key: event.key });
-    };
-    const letGo = () => {
-        for (const key of held)
-            send({ type: "key", action: "up", key });
-        held.clear();
-    };
-    const keyDown = keyed("down");
-    const keyUp = keyed("up");
-    const noMenu = (event) => {
-        event.preventDefault();
-    };
-    canvas.addEventListener("mousedown", press);
-    canvas.addEventListener("mousemove", move);
-    canvas.addEventListener("wheel", wheel, { passive: false });
-    canvas.addEventListener("contextmenu", noMenu);
-    canvas.addEventListener("keydown", keyDown);
-    canvas.addEventListener("keyup", keyUp);
-    canvas.addEventListener("blur", letGo);
-    return () => {
-        canvas.removeEventListener("mousedown", press);
-        canvas.removeEventListener("mousemove", move);
-        canvas.removeEventListener("wheel", wheel);
-        canvas.removeEventListener("contextmenu", noMenu);
-        canvas.removeEventListener("keydown", keyDown);
-        canvas.removeEventListener("keyup", keyUp);
-        canvas.removeEventListener("blur", letGo);
-        window.removeEventListener("mouseup", release);
-    };
-}

package/dist/live/follow.d.ts

@@ -1,26 +0,0 @@
-import { type LiveFrame, type LiveInfo } from "@signalcore/sdk";
-import type { UiClient, WatchedStream } from "../client.js";
-/**
- * Where a followed stream stands. `unavailable`: it cannot be watched from here (refused, not
- * there, or a connection that never worked), which is when something else should show the page.
- */
-export type LiveStatus = "connecting" | "live" | "reconnecting" | "ended" | "unavailable";
-/** Who is told what the followed stream does. */
-export interface Watcher {
-    status: (status: LiveStatus) => void;
-    info: (info: LiveInfo) => void;
-    frame: (frame: LiveFrame) => void;
-    /** The connection input goes to; undefined between connections. */
-    stream: (stream: WatchedStream | undefined) => void;
-}
-type Connector = NonNullable<UiClient["live"]>;
-/**
- * The whole life of watching a stream: connect, show what comes, and connect again when the
- * connection drops, waiting a little longer each time that no picture came in between. It ends
- * when the stream does, when the server refuses (`SignalcoreError`: not signed in, not allowed,
- * no such stream), or when `signal` stops it. A stream that has answered once exists, so its
- * drops are retried for as long as it takes; one that never answered is given up on after
- * `GIVE_UP_AFTER` tries.
- */
-export declare function follow(live: Connector, streamId: string, signal: AbortSignal, watcher: Watcher): Promise<void>;
-export {};

package/dist/live/follow.js

@@ -1,72 +0,0 @@
-import { SignalcoreError } from "@signalcore/sdk";
-/** Connections in a row that never got as far as the stream's first frame, before giving up. */
-const GIVE_UP_AFTER = 3;
-const FIRST_DELAY_MS = 500;
-const LONGEST_DELAY_MS = 10_000;
-/**
- * The whole life of watching a stream: connect, show what comes, and connect again when the
- * connection drops, waiting a little longer each time that no picture came in between. It ends
- * when the stream does, when the server refuses (`SignalcoreError`: not signed in, not allowed,
- * no such stream), or when `signal` stops it. A stream that has answered once exists, so its
- * drops are retried for as long as it takes; one that never answered is given up on after
- * `GIVE_UP_AFTER` tries.
- */
-export async function follow(live, streamId, signal, watcher) {
-    let drops = 0; // connections lost since a picture last came: they pace the next try
-    let answered = false;
-    const stopped = () => signal.aborted; // read each time: it changes while we wait
-    watcher.status("connecting");
-    while (!stopped()) {
-        let stream;
-        const hangUp = () => {
-            stream?.close();
-        };
-        signal.addEventListener("abort", hangUp, { once: true });
-        try {
-            stream = live.connect(streamId, { signal });
-            watcher.stream(stream);
-            watcher.info(await stream.info);
-            answered = true;
-            watcher.status("live");
-            for await (const frame of stream) {
-                drops = 0;
-                watcher.frame(frame);
-            }
-            if (!stopped())
-                watcher.status("ended");
-            return;
-        }
-        catch (error) {
-            if (stopped())
-                return;
-            if (error instanceof SignalcoreError) {
-                watcher.status("unavailable");
-                return;
-            }
-        }
-        finally {
-            signal.removeEventListener("abort", hangUp);
-            watcher.stream(undefined);
-            stream?.close();
-        }
-        drops += 1;
-        if (!answered && drops >= GIVE_UP_AFTER) {
-            watcher.status("unavailable");
-            return;
-        }
-        watcher.status("reconnecting");
-        await pause(Math.min(LONGEST_DELAY_MS, FIRST_DELAY_MS * 2 ** (drops - 1)), signal);
-    }
-}
-/** Waits `ms`, or less when `signal` stops it. */
-function pause(ms, signal) {
-    return new Promise((resolve) => {
-        const done = () => {
-            clearTimeout(timer);
-            signal.removeEventListener("abort", done);
-            resolve();
-        };
-        const timer = setTimeout(done, ms);
-        signal.addEventListener("abort", done, { once: true });
-    });
-}

package/dist/live/paint.d.ts

@@ -1,13 +0,0 @@
-/** Drawing a stream's JPEGs on a canvas. */
-export interface Painter {
-    /** Draw this JPEG, unless a newer one comes while it is still being decoded. */
-    paint: (jpeg: Uint8Array) => void;
-    /** Stop drawing: what is being decoded is let go of. */
-    dispose: () => void;
-}
-/**
- * Draws pictures on `canvas`, stretched to its size, one at a time: a picture that arrives while
- * another is being decoded waits, and a newer one replaces it, so a slow device skips to the
- * present instead of falling behind. A picture that does not decode is skipped.
- */
-export declare function painterOn(canvas: HTMLCanvasElement): Painter;

package/dist/live/paint.js

@@ -1,77 +0,0 @@
-/** Drawing a stream's JPEGs on a canvas. */
-/** The picture in a JPEG, decoded off the main thread where the browser can (`createImageBitmap`). */
-async function decode(bytes) {
-    const blob = new Blob([bytes.slice()], { type: "image/jpeg" }); // a copy over a plain ArrayBuffer, which Blob takes
-    if (typeof createImageBitmap === "function") {
-        const bitmap = await createImageBitmap(blob);
-        return {
-            source: bitmap,
-            release: () => {
-                bitmap.close();
-            },
-        };
-    }
-    return await decodeInImage(blob);
-}
-/** For a browser without `createImageBitmap`: an `<img>` over an object URL. */
-function decodeInImage(blob) {
-    const url = URL.createObjectURL(blob);
-    const release = () => {
-        URL.revokeObjectURL(url);
-    };
-    return new Promise((resolve, reject) => {
-        const image = new Image();
-        image.onload = () => {
-            resolve({ source: image, release });
-        };
-        image.onerror = () => {
-            release();
-            reject(new Error("The picture could not be decoded"));
-        };
-        image.src = url;
-    });
-}
-/**
- * Draws pictures on `canvas`, stretched to its size, one at a time: a picture that arrives while
- * another is being decoded waits, and a newer one replaces it, so a slow device skips to the
- * present instead of falling behind. A picture that does not decode is skipped.
- */
-export function painterOn(canvas) {
-    let decoding = false;
-    let waiting;
-    let disposed = false;
-    const run = async (jpeg) => {
-        decoding = true;
-        try {
-            const picture = await decode(jpeg);
-            try {
-                if (!disposed) {
-                    canvas.getContext("2d")?.drawImage(picture.source, 0, 0, canvas.width, canvas.height);
-                }
-            }
-            finally {
-                picture.release();
-            }
-        }
-        catch {
-            // Damaged or cut off: the next picture replaces it.
-        }
-        decoding = false;
-        const next = waiting;
-        waiting = undefined;
-        if (next && !disposed)
-            await run(next);
-    };
-    return {
-        paint: (jpeg) => {
-            if (decoding)
-                waiting = jpeg;
-            else
-                void run(jpeg);
-        },
-        dispose: () => {
-            disposed = true;
-            waiting = undefined;
-        },
-    };
-}

package/dist/live/useLiveStream.d.ts

@@ -1,16 +0,0 @@
-import type { LiveFrame, LiveInfo, LiveInput } from "@signalcore/sdk";
-import { type LiveStatus } from "./follow.js";
-export interface LiveConnection {
-    status: LiveStatus;
-    /** What the stream said it is (its size, whether it takes input); nothing until it has. */
-    info: LiveInfo | undefined;
-    /** Act on the stream; nothing happens between connections. */
-    send: (input: LiveInput) => void;
-}
-/**
- * Watches a stream through the provider's client (`live.connect`), handing each picture to
- * `onFrame`, and connects again when the connection drops (see `follow`). Without a client that
- * can, or without a stream, it is `unavailable`. Stops when the component goes away or
- * `streamId` changes.
- */
-export declare function useLiveStream(streamId: string, onFrame: (frame: LiveFrame) => void): LiveConnection;

package/dist/live/useLiveStream.js

@@ -1,57 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from "react";
-import { useSignalcore } from "../SignalcoreProvider.js";
-import { follow } from "./follow.js";
-const begin = (streamId) => ({ streamId, status: "connecting", info: undefined });
-/**
- * Watches a stream through the provider's client (`live.connect`), handing each picture to
- * `onFrame`, and connects again when the connection drops (see `follow`). Without a client that
- * can, or without a stream, it is `unavailable`. Stops when the component goes away or
- * `streamId` changes.
- */
-export function useLiveStream(streamId, onFrame) {
-    const connector = useSignalcore().client?.live;
-    const [state, setState] = useState(() => begin(streamId));
-    const connection = useRef(undefined);
-    const frames = useRef(onFrame);
-    useEffect(() => {
-        frames.current = onFrame;
-    });
-    useEffect(() => {
-        if (!connector || streamId === "")
-            return undefined;
-        const stop = new AbortController();
-        const patch = (change) => {
-            if (stop.signal.aborted)
-                return;
-            setState((old) => ({ ...(old.streamId === streamId ? old : begin(streamId)), ...change }));
-        };
-        void follow(connector, streamId, stop.signal, {
-            status: (status) => {
-                patch({ status });
-            },
-            info: (info) => {
-                patch({ info });
-            },
-            frame: (frame) => {
-                if (!stop.signal.aborted)
-                    frames.current(frame);
-            },
-            stream: (stream) => {
-                // A follower that was stopped may still be letting go of its stream: not the new one's.
-                if (!stop.signal.aborted)
-                    connection.current = stream;
-            },
-        });
-        return () => {
-            stop.abort();
-            connection.current = undefined;
-        };
-    }, [connector, streamId]);
-    const send = useCallback((input) => {
-        connection.current?.send(input);
-    }, []);
-    // Until the effect has started over for a new stream, the state is still the old one's.
-    const current = state.streamId === streamId ? state : begin(streamId);
-    const usable = connector !== undefined && streamId !== "";
-    return { status: usable ? current.status : "unavailable", info: current.info, send };
-}

package/dist/look.d.ts

@@ -1,33 +0,0 @@
-/**
- * Every element the package draws is a named slot. It carries the class `sc-<slot>` (BEM: a
- * block, `card`, or one of its elements, `card__title`), the attribute `data-sc="<slot>"`, and
- * `data-sc-mod="primary sm"` for its modifiers, which are also classes (`sc-button--primary`).
- * They are the stable hooks for a host's CSS, and the names `classNames` is keyed by. The same names
- * are the element's `part`s (`message message--person`), so a chat inside a shadow root, as the
- * widget is, is styled from outside with `::part(message)`.
- */
-export declare const SLOTS: readonly ["ui", "surface", "column", "row", "card", "card__title", "card__subtitle", "text", "callout", "image", "link", "pairs", "pairs__row", "pairs__label", "pairs__value", "table-wrap", "table", "table__row", "table__head", "table__cell", "chart", "chart__title", "chart__row", "chart__label", "chart__bar", "chart__value", "choices", "choice", "choice__label", "choice__description", "slots", "form", "form__actions", "field", "input", "select", "checkbox", "button", "icon-button", "icon", "spinner", "sr-only", "error", "browser", "browser__header", "browser__driver", "browser__dot", "browser__who", "browser__controls", "browser__site", "browser__site-name", "browser__screen", "browser__frame", "browser__shot", "browser__cover", "browser__caption", "browser__step", "browser__line", "browser__ended", "browser__ended-title", "browser__ended-summary", "live", "live__canvas", "live__status", "live__dot", "request", "request__heading", "request__icon", "request__body", "request__title", "request__details", "request__done", "request__check", "request__actions", "request__form", "request__hint", "request__name", "approval", "calls", "calls__item", "calls__label", "calls__summary", "preview-pairs", "preview-pairs__row", "preview-pairs__label", "preview-pairs__value", "preview-table", "preview-table__table", "preview-table__head", "preview-table__cell", "preview-table__more", "preview-json", "handover", "handover__side", "steps", "steps__item", "steps__number", "steps__text", "drop", "drop__icon", "app-button", "app-button__logo", "app-button__ping", "app-logo", "chat", "chat__scroll", "chat__content", "chat__note", "chat__status", "messages", "moment", "message", "message__text", "message__surface", "message__window", "message__open", "composer", "composer__context", "composer__box", "composer__input", "composer__bar", "composer__tools", "composer__send", "transcript", "reply", "reply__cursor", "activity", "activity__step", "activity__toggle", "activity__mark", "activity__verb", "activity__target", "activity__note", "activity__summary", "note", "changes", "changes__title", "changes__list", "changes__item", "changes__label", "changes__more", "status-line", "status-line__dot", "status-line__hint", "status", "status__dot", "automations", "automations__group", "automations__title", "automations__list", "automations__item", "automations__empty", "automation", "automation__wash", "automation__head", "automation__tile", "automation__glyph", "automation__text", "automation__line", "automation__title", "automation__status", "automation__tagline", "automation__meta", "automation__chevron", "automation__body", "automation__description", "automation__facts", "automation__fact", "automation__label", "automation__value", "automation__activity", "automation__tips", "automation__actions", "schedule", "schedule__days", "schedule__day", "schedule__time", "app-marks", "app-marks__item", "flow", "flow__empty", "flow__node", "flow__handle", "flow__mark", "flow__glyph", "flow__text", "flow__name", "flow__detail", "flow__trigger", "orb", "orb__ring", "orb__core", "voice", "voice__stage", "voice__state", "voice__captions", "voice__line", "voice__who", "voice__note", "voice__controls", "window", "window__bar", "window__mark", "window__title", "window__body", "window__twin", "captions", "captions__line", "space", "space__main", "space__stage", "strip", "strip__tab", "strip__mark", "strip__title", "strip__dot", "dock", "dock__status", "dock__voice"];
-export type Slot = (typeof SLOTS)[number];
-/**
- * Classes a host adds to the package's elements, by slot (`card`, `card__title`) or by slot and
- * modifier (`button--primary`). They are added to ours, so they work with the shipped stylesheet
- * (they come later in the cascade) and, with the provider's `unstyled`, instead of it.
- */
-export type ClassNames = {
-    [S in Slot]?: string;
-} & {
-    [variant: `${Slot}--${string}`]: string | undefined;
-};
-type Modifier = string | false | null | undefined;
-/** What to spread onto an element to make it the slot. */
-export interface PartProps {
-    className: string;
-    "data-sc": Slot;
-    "data-sc-mod": string | undefined;
-    /** The shadow part: the slot, and the slot with each modifier. Inert outside a shadow root. */
-    part: string;
-}
-/** The props of a slot, with the modifiers that apply and any class the caller adds. */
-export type Part = (slot: Slot, modifiers?: Modifier[], extra?: string) => PartProps;
-export declare function partsOf(classNames: ClassNames | undefined): Part;
-export {};