@linxin666/dsh-remote-web-ui 0.1.1 → 0.1.3

package/lib/types/client/FooterRemoteEntry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Sidebar footer-seat wrapper for the remote-control entry.
+ *
+ * Current dsh web shells declare `sidebar.footer.action` (the seat beside the
+ * settings trigger) instead of the legacy `sidebar.remote` seat this plugin
+ * was written against. The footer seat supplies `{ wide }` but not the
+ * `useWorkspaces` projection hook, so this wrapper substitutes a
+ * workspace-agnostic selector: pairing without a deep-linked workspace is
+ * fully supported by the host `/api/pair` routes.
+ */
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+/** Entry props: the footer seat's column state + the standard locale seat. */
+export type FooterRemoteEntryProps = PropsLocale<'remote'> & {
+    wide: boolean;
+};
+/**
+ * Render the remote-control trigger + pairing panel from the footer seat.
+ * @param props - composed slot props (footer seat subset).
+ * @returns the entry element tree.
+ */
+export declare function FooterRemoteEntry(props: FooterRemoteEntryProps): import("react").JSX.Element;
+//# sourceMappingURL=FooterRemoteEntry.d.ts.map

package/lib/types/client/FooterRemoteEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FooterRemoteEntry.d.ts","sourceRoot":"","sources":["../../../src/client/FooterRemoteEntry.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAGnE,8EAA8E;AAC9E,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAE9E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,+BAS9D"}

package/lib/types/client/FooterRemoteEntry.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { RemoteEntry } from "./RemoteEntry.js";
+/**
+ * Render the remote-control trigger + pairing panel from the footer seat.
+ * @param props - composed slot props (footer seat subset).
+ * @returns the entry element tree.
+ */
+export function FooterRemoteEntry(props) {
+    return (_jsx(RemoteEntry, { wide: props.wide, useWorkspaces: () => undefined, useSessions: () => undefined, t: props.t }));
+}

package/lib/types/client/PairFailedNotice.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * One-time failed-pairing notice: a fixed toast rendered on the phone after
+ * a QR accept failed (invalid/used token or a network error). Mounted by
+ * the client apply with a plain React root — no slot machinery for a
+ * transient diagnostic.
+ */
+import { useEffect, useState } from 'react';
+import css from './remote.module.css';
+/**
+ * Render the failed-pair toast (auto-dismisses).
+ * @param props - localized copy.
+ * @returns the toast element.
+ */
+export function PairFailedNotice({ t }) {
+    const [visible, setVisible] = useState(true);
+    useEffect(() => {
+        const timer = window.setTimeout(() => { setVisible(false); }, 8000);
+        return () => { window.clearTimeout(timer); };
+    }, []);
+    if (!visible)
+        return null;
+    return (_jsxs("div", { className: css.notice, role: "alert", children: [_jsx("p", { className: css.noticeTitle, children: t('pair.failed.title') }), _jsx("p", { className: css.noticeDetail, children: t('pair.failed.detail') })] }));
+}

package/lib/types/client/PairFailedNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PairFailedNotice.js","sourceRoot":"","sources":["../../../src/client/PairFailedNotice.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,GAAG,MAAM,qBAAqB,CAAA;AAOrC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,CAAC,EAAyB;IAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC5G,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAClE,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,CAAA;IAC7C,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,OAAO,CACL,eAAK,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAC,OAAO,aACtC,YAAG,SAAS,EAAE,GAAG,CAAC,WAAW,YAAG,CAAC,CAAC,mBAAmB,CAAC,GAAK,EAC3D,YAAG,SAAS,EAAE,GAAG,CAAC,YAAY,YAAG,CAAC,CAAC,oBAAoB,CAAC,GAAK,IACzD,CACP,CAAA;AACH,CAAC"}

package/lib/types/client/PhoneIcon.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Render the phone icon.
+ * @param props - size and optional class.
+ * @returns the svg element.
+ */
+export function PhoneIcon({ size = 16, className }) {
+    return (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: _jsx("path", { d: "M4.2 1.8h2.4l.9 2.4-1.5 1.1a7.4 7.4 0 0 0 4.7 4.7l1.1-1.5 2.4.9v2.4a.9.9 0 0 1-1 .9A11.4 11.4 0 0 1 3.3 2.8a.9.9 0 0 1 .9-1Z", stroke: "currentColor", strokeWidth: "1.3", strokeLinejoin: "round" }) }));
+}

package/lib/types/client/PhoneIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneIcon.js","sourceRoot":"","sources":["../../../src/client/PhoneIcon.tsx"],"names":[],"mappings":";AAcA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS,EAAkB;IAChE,OAAO,CACL,cAAK,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,MAAM,iBAAa,MAAM,YACtG,eACE,CAAC,EAAC,8HAA8H,EAChI,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,KAAK,EACjB,cAAc,EAAC,OAAO,GACtB,GACE,CACP,CAAA;AACH,CAAC"}

package/lib/types/client/PluginSettingsCard.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Shared chrome for the plugin settings card: a disclosure header naming the
+ * plugin and what its settings govern, the controls inside, and the save that
+ * writes them. Renders nothing while the namespace is unavailable — a
+ * deployment that does not compose the owning plugin should show no trace of
+ * it. Mirrors the official ui-plugin-config PluginCard in a self-contained
+ * slice (this package must not depend on a sibling UI package).
+ */
+import { useState } from 'react';
+import css from './settings-card.module.css';
+/**
+ * Render one plugin settings card.
+ * @param props - the plugin's copy keys, its form state, and its controls.
+ * @returns the card, or nothing when the namespace is unavailable.
+ */
+export function PluginSettingsCard(props) {
+    const [open, setOpen] = useState(false);
+    const { state } = props;
+    if (!state.available)
+        return null;
+    const title = props.t(props.titleKey);
+    const blocked = !state.dirty || state.invalid || state.saving;
+    return (_jsxs("li", { className: css.card, children: [_jsxs("button", { type: "button", className: css.header, "aria-expanded": open, "aria-label": `${props.t(open ? 'settings.collapse' : 'settings.expand')}: ${title}`, onClick: () => { setOpen(!open); }, children: [_jsxs("span", { className: css.headText, children: [_jsx("span", { className: css.name, children: title }), _jsx("span", { className: css.description, children: props.t(props.descriptionKey) })] }), state.dirty ? _jsx("span", { className: css.pending, children: props.t('settings.unsaved') }) : null, _jsx("span", { className: open ? css.chevronOpen : css.chevron, children: "\u25BE" })] }), open
+                ? (_jsxs("div", { className: css.body, children: [!state.writable ? _jsx("p", { className: css.readOnly, role: "status", children: props.t('settings.readOnly') }) : null, props.children, _jsxs("div", { className: css.footer, children: [state.failed ? _jsx("p", { className: css.failed, role: "status", children: props.t('settings.saveFailed') }) : null, _jsx("button", { type: "button", className: css.discard, disabled: !state.dirty || state.saving, onClick: props.onDiscard, children: props.t('settings.discard') }), _jsx("button", { type: "button", className: css.save, disabled: blocked, onClick: props.onSave, children: props.t(!state.saving ? 'settings.save' : 'settings.saving') })] })] }))
+                : null] }));
+}
+/** A staged value field. `numeric` only hints the keypad: which drafts a field accepts is decided by its spec. */
+export function ValueField(props) {
+    return (_jsxs("div", { className: css.field, children: [_jsxs("div", { className: css.head, children: [_jsx("label", { className: css.label, htmlFor: props.id, children: props.label }), props.overridden
+                        ? (_jsxs("span", { className: css.badges, children: [_jsx("span", { className: css.badge, children: props.overriddenLabel }), _jsx("button", { type: "button", className: css.reset, disabled: props.disabled, onClick: props.onReset, children: props.resetLabel })] }))
+                        : null] }), _jsx("input", { id: props.id, className: props.invalid ? css.inputInvalid : css.input, type: "text", ...props.numeric === true ? { inputMode: 'numeric' } : {}, ...props.invalid ? { 'aria-invalid': true } : {}, value: props.text, placeholder: props.placeholder ?? '', disabled: props.disabled, onChange: (event) => { props.onEdit(event.target.value); } }), _jsx("p", { className: props.invalid ? css.invalid : css.hint, children: props.invalid ? props.invalidLabel : props.hint })] }));
+}
+/** A staged boolean field: 继承 / 开 / 关. */
+export function BooleanField(props) {
+    return (_jsxs("div", { className: css.field, children: [_jsxs("div", { className: css.head, children: [_jsx("label", { className: css.label, htmlFor: props.id, children: props.label }), props.overridden
+                        ? (_jsxs("span", { className: css.badges, children: [_jsx("span", { className: css.badge, children: props.overriddenLabel }), _jsx("button", { type: "button", className: css.reset, disabled: props.disabled, onClick: props.onReset, children: props.resetLabel })] }))
+                        : null] }), _jsxs("select", { id: props.id, className: css.select, value: props.text, disabled: props.disabled, onChange: (event) => { props.onEdit(event.target.value); }, children: [_jsx("option", { value: "", children: props.inheritLabel }), _jsx("option", { value: "true", children: props.onLabel }), _jsx("option", { value: "false", children: props.offLabel })] }), _jsx("p", { className: css.hint, children: props.hint })] }));
+}

package/lib/types/client/PluginSettingsCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsCard.js","sourceRoot":"","sources":["../../../src/client/PluginSettingsCard.tsx"],"names":[],"mappings":";AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAGhD,OAAO,GAAG,MAAM,4BAA4B,CAAA;AAoB5C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IACvB,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO,IAAI,CAAA;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAA;IAC7D,OAAO,CACL,cAAI,SAAS,EAAE,GAAG,CAAC,IAAI,aACrB,kBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,mBACN,IAAI,gBACP,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,KAAK,EAAE,EAClF,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAA,CAAC,CAAC,aAEjC,gBAAM,SAAS,EAAE,GAAG,CAAC,QAAQ,aAC3B,eAAM,SAAS,EAAE,GAAG,CAAC,IAAI,YAAG,KAAK,GAAQ,EACzC,eAAM,SAAS,EAAE,GAAG,CAAC,WAAW,YAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,GAAQ,IACnE,EACN,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,eAAM,SAAS,EAAE,GAAG,CAAC,OAAO,YAAG,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAQ,CAAC,CAAC,CAAC,IAAI,EACxF,eAAM,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,uBAAU,IACxD,EACR,IAAI;gBACH,CAAC,CAAC,CACA,eAAK,SAAS,EAAE,GAAG,CAAC,IAAI,aACrB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAG,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAC,QAAQ,YAAE,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAK,CAAC,CAAC,CAAC,IAAI,EACrG,KAAK,CAAC,QAAQ,EACf,eAAK,SAAS,EAAE,GAAG,CAAC,MAAM,aACvB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAG,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAC,QAAQ,YAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,GAAK,CAAC,CAAC,CAAC,IAAI,EACnG,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,GAAG,CAAC,OAAO,EACtB,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,EACtC,OAAO,EAAE,KAAK,CAAC,SAAS,YAEvB,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,GACrB,EACT,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,GAAG,CAAC,IAAI,EACnB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,KAAK,CAAC,MAAM,YAEpB,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,GACtD,IACL,IACF,CACP;gBACD,CAAC,CAAC,IAAI,IACL,CACN,CAAA;AACH,CAAC;AA8BD,kHAAkH;AAClH,MAAM,UAAU,UAAU,CAAC,KAK1B;IACC,OAAO,CACL,eAAK,SAAS,EAAE,GAAG,CAAC,KAAK,aACvB,eAAK,SAAS,EAAE,GAAG,CAAC,IAAI,aACtB,gBAAO,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,YAAG,KAAK,CAAC,KAAK,GAAS,EACpE,KAAK,CAAC,UAAU;wBACf,CAAC,CAAC,CACA,gBAAM,SAAS,EAAE,GAAG,CAAC,MAAM,aACzB,eAAM,SAAS,EAAE,GAAG,CAAC,KAAK,YAAG,KAAK,CAAC,eAAe,GAAQ,EAC1D,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,GAAG,CAAC,KAAK,EACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,OAAO,EAAE,KAAK,CAAC,OAAO,YAErB,KAAK,CAAC,UAAU,GACV,IACJ,CACR;wBACD,CAAC,CAAC,IAAI,IACJ,EACN,gBACE,EAAE,EAAE,KAAK,CAAC,EAAE,EACZ,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EACvD,IAAI,EAAC,MAAM,KACP,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,KAC/D,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EACjD,KAAK,EAAE,KAAK,CAAC,IAAI,EACjB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE,EACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,GACzD,EACF,YAAG,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,YACjD,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAC9C,IACA,CACP,CAAA;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,YAAY,CAAC,KAO5B;IACC,OAAO,CACL,eAAK,SAAS,EAAE,GAAG,CAAC,KAAK,aACvB,eAAK,SAAS,EAAE,GAAG,CAAC,IAAI,aACtB,gBAAO,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,YAAG,KAAK,CAAC,KAAK,GAAS,EACpE,KAAK,CAAC,UAAU;wBACf,CAAC,CAAC,CACA,gBAAM,SAAS,EAAE,GAAG,CAAC,MAAM,aACzB,eAAM,SAAS,EAAE,GAAG,CAAC,KAAK,YAAG,KAAK,CAAC,eAAe,GAAQ,EAC1D,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,GAAG,CAAC,KAAK,EACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,OAAO,EAAE,KAAK,CAAC,OAAO,YAErB,KAAK,CAAC,UAAU,GACV,IACJ,CACR;wBACD,CAAC,CAAC,IAAI,IACJ,EACN,kBACE,EAAE,EAAE,KAAK,CAAC,EAAE,EACZ,SAAS,EAAE,GAAG,CAAC,MAAM,EACrB,KAAK,EAAE,KAAK,CAAC,IAAI,EACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC,aAEzD,iBAAQ,KAAK,EAAC,EAAE,YAAE,KAAK,CAAC,YAAY,GAAU,EAC9C,iBAAQ,KAAK,EAAC,MAAM,YAAE,KAAK,CAAC,OAAO,GAAU,EAC7C,iBAAQ,KAAK,EAAC,OAAO,YAAE,KAAK,CAAC,QAAQ,GAAU,IACxC,EACT,YAAG,SAAS,EAAE,GAAG,CAAC,IAAI,YAAG,KAAK,CAAC,IAAI,GAAK,IACpC,CACP,CAAA;AACH,CAAC"}

package/lib/types/client/RemoteEntry.js

@@ -0,0 +1,162 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The sidebar remote-control seat: the phone-icon trigger beside the
+ * settings button plus the pairing panel modal. Owns the panel behavior —
+ * token minting on open, the status SSE subscription, stop/refresh/copy —
+ * and renders the pure {@link RemotePanel} body. Component-local state per
+ * the client stack rules: nothing here survives remounts or crosses
+ * entries.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { createPortal } from 'react-dom';
+import { RemotePanel } from "./RemotePanel.js";
+import { copyText, issuePair, stopPair } from "./pair-api.js";
+import { PhoneIcon } from "./PhoneIcon.js";
+import css from './remote.module.css';
+/** Apply one status frame onto the current ready state. */
+function mergeFrame(state, frame) {
+    if (state.kind !== 'ready')
+        return state;
+    return {
+        ...state,
+        phase: frame.phase,
+        deviceCount: frame.deviceCount,
+        onlineCount: frame.onlineCount,
+        ...(frame.tunnel !== undefined ? { tunnel: frame.tunnel } : {}),
+    };
+}
+/**
+ * Render the remote-control trigger and panel.
+ * @param props - composed slot props (contract in this package).
+ * @returns the entry element tree.
+ */
+export function RemoteEntry({ wide, useWorkspaces, t }) {
+    const [open, setOpen] = useState(false);
+    const [state, setState] = useState({ kind: 'lan-required' });
+    const [copied, setCopied] = useState(false);
+    const eventSource = useRef(undefined);
+    // The current workspace (the recent-workspace projection the shell's New
+    // Session flow targets) — the deep-link target for the phone.
+    const workspaceId = useWorkspaces(s => s.recentWorkspaceId);
+    const closeEventSource = useCallback(() => {
+        eventSource.current?.close();
+        eventSource.current = undefined;
+    }, []);
+    const mint = useCallback(async (address) => {
+        let result;
+        try {
+            result = await issuePair(workspaceId, address);
+        }
+        catch {
+            // Fetch/network failure: show an explicit state instead of silently
+            // leaving the panel on its initial banner.
+            return { kind: 'unreachable' };
+        }
+        if (!result.ok) {
+            // 403 is the loopback-only fence refusing a LAN origin (the panel is a
+            // desktop control endpoint); 409 means the server never bound 0.0.0.0;
+            // 400 means the requested LAN literal is no longer constructible.
+            if (result.code === 'forbidden')
+                return { kind: 'loopback-required' };
+            if (result.code === 'unknown-address')
+                return { kind: 'unreachable' };
+            return { kind: 'lan-required' };
+        }
+        const publicBaseUrl = result.publicBaseUrl;
+        return {
+            kind: 'ready',
+            url: result.url,
+            expiresAt: result.expiresAt,
+            expired: Date.now() > result.expiresAt,
+            phase: 'waiting',
+            deviceCount: 0,
+            onlineCount: 0,
+            // Whether this QR is built on the configured public (tunneled) base.
+            public: publicBaseUrl !== undefined && result.url.startsWith(publicBaseUrl),
+            ...(publicBaseUrl !== undefined ? { publicBaseUrl } : {}),
+            // The issued URL names the requested (or default first) literal; the
+            // public link has no LAN literal, so no radio row is selected then.
+            address: address ?? result.lanAddresses[0] ?? '',
+            lanAddresses: result.lanAddresses,
+        };
+    }, [workspaceId]);
+    const openPanel = useCallback(async () => {
+        setOpen(true);
+        const next = await mint();
+        setState(next);
+        // Live status: the desktop panel mirrors the pairing service state. The
+        // stream only makes sense in the ready state — on a failure banner the
+        // events endpoint is unreachable too (loopback fence), so opening it
+        // would just start a doomed reconnect loop.
+        if (next.kind !== 'ready')
+            return;
+        const source = new EventSource('/api/pair/events');
+        eventSource.current = source;
+        source.onmessage = (event) => {
+            try {
+                const frame = JSON.parse(event.data);
+                if (frame.type !== 'state')
+                    return;
+                setState(previous => mergeFrame(previous, frame));
+            }
+            catch {
+                // Malformed frames are dropped; the snapshot on open is authoritative.
+            }
+        };
+    }, [mint]);
+    const closePanel = useCallback(() => {
+        closeEventSource();
+        setOpen(false);
+    }, [closeEventSource]);
+    // Expiry flip: one timeout per token lifetime (reset by refresh).
+    useEffect(() => {
+        if (state.kind !== 'ready')
+            return;
+        if (state.expired)
+            return;
+        const delay = state.expiresAt - Date.now();
+        if (delay <= 0) {
+            setState(previous => previous.kind === 'ready' ? { ...previous, expired: true } : previous);
+            return;
+        }
+        const timer = window.setTimeout(() => {
+            setState(previous => previous.kind === 'ready' ? { ...previous, expired: true } : previous);
+        }, delay);
+        return () => { window.clearTimeout(timer); };
+    }, [state]);
+    // Unmount safety: never leave the stream open.
+    useEffect(() => closeEventSource, [closeEventSource]);
+    const handleStop = useCallback(() => {
+        // A failed stop request is harmless: the optimistic phase flip below
+        // keeps the UI honest, and the status stream confirms the stopped phase.
+        void stopPair().catch(() => { });
+        // Optimistic fallback; the status stream confirms with the stopped phase.
+        setState(previous => previous.kind === 'ready' ? { ...previous, phase: 'stopped' } : previous);
+    }, []);
+    const handleRefresh = useCallback(() => {
+        void mint().then(setState);
+    }, [mint]);
+    /** Re-mint against another LAN literal (multi-homed machines). */
+    const handlePickAddress = useCallback((address) => {
+        void mint(address).then(setState);
+    }, [mint]);
+    /** Re-mint against the configured public (tunneled) base. */
+    const handlePickPublic = useCallback(() => {
+        void mint().then(setState);
+    }, [mint]);
+    const handleCopy = useCallback(() => {
+        if (state.kind !== 'ready')
+            return;
+        void copyText(state.url).then((ok) => {
+            if (!ok)
+                return;
+            setCopied(true);
+            window.setTimeout(() => { setCopied(false); }, 1500);
+        });
+    }, [state]);
+    return (_jsxs(_Fragment, { children: [_jsx(TooltipAnchor, { wide: wide, label: t('entry.label'), onClick: openPanel }), open && createPortal((_jsxs("div", { className: css.overlay, role: "presentation", children: [_jsx("div", { className: css.mask, "aria-hidden": "true", onClick: closePanel }), _jsx(RemotePanel, { t: t, state: state, copied: copied, onClose: closePanel, onStop: handleStop, onRefresh: handleRefresh, onCopy: handleCopy, onPickAddress: handlePickAddress, onPickPublic: handlePickPublic })] })), document.body)] }));
+}
+/** The trigger: an icon button matching the settings rail/row geometry. */
+function TooltipAnchor({ wide, label, onClick }) {
+    return (_jsx("button", { type: "button", className: css.trigger, "data-wide": wide ? undefined : 'rail', "aria-label": label, title: label, onClick: onClick, children: _jsx(PhoneIcon, { size: wide ? 16 : 18 }) }));
+}

package/lib/types/client/RemoteEntry.js.map

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

package/lib/types/client/RemotePanel.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The mobile remote-control panel body: status card (state text + badge),
+ * the QR code, the open-on-phone hint with the link text, and the three
+ * actions (stop / refresh / copy). Pure presentation — all state and
+ * actions arrive through props from the entry's behavior component.
+ */
+import clsx from 'clsx';
+import { QRCodeSVG } from 'qrcode.react';
+import { IconCloseOutline16, IconCopyOutline16, IconLinkOutline16, IconRefreshOutline16, IconStopFill16, } from '@deepseek-ai/dsh-client-ui-primitives';
+import { formatClock } from "./pair-api.js";
+import css from './remote.module.css';
+/** Badge text + tone per phase (ready states only). */
+function statusOf(t, state) {
+    switch (state.phase) {
+        case 'connected': return { text: t('status.connected', { n: state.onlineCount }), tone: 'connected' };
+        case 'disconnected': return { text: t('status.disconnected'), tone: 'disconnected' };
+        case 'stopped': return { text: t('status.stopped'), tone: 'stopped' };
+        case 'lan-required': return { text: t('status.lanRequired'), tone: 'stopped' };
+        case 'waiting': return { text: t('status.waiting'), tone: 'waiting' };
+    }
+}
+/**
+ * Render the pairing panel.
+ * @param props - copy, state, and actions.
+ * @returns the panel element tree.
+ */
+export function RemotePanel({ t, state, copied, onClose, onStop, onRefresh, onCopy, onPickAddress, onPickPublic }) {
+    return (_jsxs("div", { className: css.panel, role: "dialog", "aria-modal": "true", "aria-label": t('title'), children: [_jsxs("div", { className: css.header, children: [_jsxs("div", { className: css.heading, children: [_jsx("h2", { className: css.title, children: t('title') }), _jsx("p", { className: css.subtitle, children: t('subtitle') })] }), _jsx("button", { type: "button", className: css.close, "aria-label": t('close.label'), onClick: onClose, children: _jsx(IconCloseOutline16, { size: 14 }) })] }), state.kind === 'lan-required' ? (_jsxs("div", { className: css.banner, role: "alert", children: [_jsx("p", { className: css.bannerTitle, children: t('status.lanRequired') }), _jsx("p", { className: css.bannerHint, children: t('status.lanRequiredHint') })] })) : state.kind === 'loopback-required' ? (_jsxs("div", { className: css.banner, role: "alert", children: [_jsx("p", { className: css.bannerTitle, children: t('status.loopbackRequired') }), _jsx("p", { className: css.bannerHint, children: t('status.loopbackRequiredHint') })] })) : state.kind === 'unreachable' ? (_jsxs("div", { className: css.banner, role: "alert", children: [_jsx("p", { className: css.bannerTitle, children: t('status.unreachable') }), _jsx("p", { className: css.bannerHint, children: t('status.unreachableHint') })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.card, children: [_jsxs("div", { className: css.cardHeader, children: [_jsx("span", { className: css.cardTitle, children: t('card.title') }), _jsxs("span", { className: css.badges, children: [state.public && _jsx("span", { className: clsx(css.badge, css.badgePublic), children: t('public.badge') }), _jsx("span", { className: clsx(css.badge, css[`badge-${statusOf(t, state).tone}`]), children: statusOf(t, state).text })] })] }), _jsx("div", { className: css.qrWrap, "data-testid": "remote-qr", children: _jsx(QRCodeSVG, { value: state.url, size: 184, level: "M", marginSize: 1, className: css.qr }) }), state.expired
+                                ? _jsx("p", { className: css.expired, children: t('pair.expired') })
+                                : _jsx("p", { className: css.expiry, children: t('pair.expires', { time: formatClock(state.expiresAt) }) })] }), _jsx("p", { className: css.hint, children: state.public ? t('pair.publicHint') : t('pair.hint') }), _jsx("p", { className: css.link, title: state.url, children: state.url }), state.phase === 'stopped' && _jsx("p", { className: css.stoppedHint, children: t('stopped.hint') }), state.tunnel !== undefined && state.tunnel.state !== 'running' && (_jsx("p", { className: state.tunnel.state === 'failed' ? css.tunnelFailed : css.tunnelNote, role: "status", children: state.tunnel.state === 'failed'
+                            ? t('tunnel.failed', { error: state.tunnel.error ?? t('tunnel.unknownError') })
+                            : t('tunnel.starting') })), (state.publicBaseUrl !== undefined || state.lanAddresses.length > 1) && (_jsxs("fieldset", { className: css.addresses, children: [_jsx("legend", { children: t('address.label') }), state.publicBaseUrl !== undefined && (_jsxs("label", { className: css.address, children: [_jsx("input", { type: "radio", name: "lan-address", "aria-label": t('address.public'), checked: state.public, onChange: onPickPublic }), _jsx("span", { children: t('address.public') }), _jsx("code", { className: css.addressValue, children: state.publicBaseUrl })] }, "public")), state.lanAddresses.map(address => (_jsxs("label", { className: css.address, children: [_jsx("input", { type: "radio", name: "lan-address", "aria-label": address, checked: !state.public && address === state.address, onChange: () => onPickAddress(address) }), _jsx("span", { children: t('address.lan') }), _jsx("code", { className: css.addressValue, children: address })] }, address))), _jsx("p", { className: css.addressHint, children: t('address.hint') })] })), _jsxs("div", { className: css.actions, children: [_jsxs("button", { type: "button", className: css.action, onClick: onStop, children: [_jsx(IconStopFill16, { size: 14 }), t('action.stop')] }), _jsxs("button", { type: "button", className: css.action, onClick: onRefresh, children: [_jsx(IconRefreshOutline16, { size: 14 }), t('action.refresh')] }), _jsxs("button", { type: "button", className: css.action, onClick: onCopy, children: [copied ? _jsx(IconCopyOutline16, { size: 14 }) : _jsx(IconLinkOutline16, { size: 14 }), copied ? t('action.copied') : t('action.copy')] })] })] }))] }));
+}

package/lib/types/client/RemotePanel.js.map

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

package/lib/types/client/RemoteSettingsCard.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PluginSettingsCard, ValueField, BooleanField } from "./PluginSettingsCard.js";
+import { CardForm, booleanField, numberField, textField } from "./settings-form.js";
+/** Bridges the `remote-web-ui` scope onto the card's staged form. */
+export class RemoteSettingsCardController {
+    form;
+    store;
+    /** @param scope - the bound settings scope for the `remote-web-ui` namespace. */
+    constructor(scope) {
+        this.form = new CardForm(scope, [
+            booleanField('enabled'),
+            numberField('tokenTtlMs'),
+            numberField('offlineAfterMs'),
+            numberField('maxDevices'),
+            textField('cookieName'),
+            booleanField('requirePairingForLan'),
+            textField('publicBaseUrl'),
+            booleanField('autoTunnel'),
+        ]);
+        this.store = this.form.bind(() => this.projection());
+    }
+    projection() {
+        return {
+            ...this.form.shell(),
+            enabled: this.form.field('enabled'),
+            tokenTtlMs: this.form.field('tokenTtlMs'),
+            offlineAfterMs: this.form.field('offlineAfterMs'),
+            maxDevices: this.form.field('maxDevices'),
+            cookieName: this.form.field('cookieName'),
+            requirePairingForLan: this.form.field('requirePairingForLan'),
+            publicBaseUrl: this.form.field('publicBaseUrl'),
+            autoTunnel: this.form.field('autoTunnel'),
+        };
+    }
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject() {
+        return { hooks: { remoteSettingsCard: this.store }, ...this.form.actions() };
+    }
+}
+/**
+ * Render the remote-control card.
+ * @param props - locale copy, the card snapshot, and its form actions.
+ * @returns the card.
+ */
+export function RemoteSettingsCard(props) {
+    const { t } = props;
+    const state = props.useRemoteSettingsCard(snapshot => snapshot);
+    const disabled = !state.writable;
+    const fieldProps = {
+        overriddenLabel: t('settings.overridden'),
+        resetLabel: t('settings.reset'),
+        invalidLabel: t('settings.invalidNumber'),
+        disabled,
+    };
+    return (_jsxs(PluginSettingsCard, { t: t, titleKey: "settings.title", descriptionKey: "settings.description", state: state, onSave: props.save, onDiscard: props.discard, children: [_jsx(BooleanField, { id: "settings-remote-enabled", label: t('settings.enabled'), hint: t('settings.enabledHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.enabled, onEdit: (text) => { props.edit('enabled', text); }, onReset: () => { props.resetField('enabled'); } }), _jsx(ValueField, { id: "settings-remote-token-ttl", label: t('settings.tokenTtlMs'), hint: t('settings.tokenTtlMsHint'), numeric: true, ...fieldProps, ...state.tokenTtlMs, onEdit: (text) => { props.edit('tokenTtlMs', text); }, onReset: () => { props.resetField('tokenTtlMs'); } }), _jsx(ValueField, { id: "settings-remote-offline", label: t('settings.offlineAfterMs'), hint: t('settings.offlineAfterMsHint'), numeric: true, ...fieldProps, ...state.offlineAfterMs, onEdit: (text) => { props.edit('offlineAfterMs', text); }, onReset: () => { props.resetField('offlineAfterMs'); } }), _jsx(ValueField, { id: "settings-remote-max-devices", label: t('settings.maxDevices'), hint: t('settings.maxDevicesHint'), numeric: true, ...fieldProps, ...state.maxDevices, onEdit: (text) => { props.edit('maxDevices', text); }, onReset: () => { props.resetField('maxDevices'); } }), _jsx(ValueField, { id: "settings-remote-cookie", label: t('settings.cookieName'), hint: t('settings.cookieNameHint'), ...fieldProps, ...state.cookieName, onEdit: (text) => { props.edit('cookieName', text); }, onReset: () => { props.resetField('cookieName'); } }), _jsx(BooleanField, { id: "settings-remote-fence", label: t('settings.requirePairingForLan'), hint: t('settings.requirePairingForLanHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.requirePairingForLan, onEdit: (text) => { props.edit('requirePairingForLan', text); }, onReset: () => { props.resetField('requirePairingForLan'); } }), _jsx(ValueField, { id: "settings-remote-public-base", label: t('settings.publicBaseUrl'), hint: t('settings.publicBaseUrlHint'), placeholder: "https://example.trycloudflare.com", ...fieldProps, ...state.publicBaseUrl, onEdit: (text) => { props.edit('publicBaseUrl', text); }, onReset: () => { props.resetField('publicBaseUrl'); } }), _jsx(BooleanField, { id: "settings-remote-auto-tunnel", label: t('settings.autoTunnel'), hint: t('settings.autoTunnelHint'), inheritLabel: t('settings.inherit'), onLabel: t('settings.on'), offLabel: t('settings.off'), ...fieldProps, ...state.autoTunnel, onEdit: (text) => { props.edit('autoTunnel', text); }, onReset: () => { props.resetField('autoTunnel'); } })] }));
+}

package/lib/types/client/RemoteSettingsCard.js.map

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

package/lib/types/client/deep-link.js

@@ -0,0 +1,118 @@
+/**
+ * Phone-side boot flow: the QR link's `pair` + `workspace` parameters.
+ * Runs from the client apply on every page load, on any device:
+ * - `pair` present → accept the token, then reload so the whole SPA boots
+ *   with the device cookie (the accept endpoint is exempt from the pairing
+ *   gate; every other /api request needs the cookie).
+ * - `workspace` present (and paired) → deep-link: connect that workspace's
+ *   session and open it, then strip the parameter.
+ * Failure of accept leaves a sessionStorage marker the entry renders as a
+ * one-time notice.
+ */
+import { acceptPair, readPairParams } from "./pair-api.js";
+/** sessionStorage key for the failed-pair notice. */
+export const PAIR_FAILED_MARKER = 'dsh-remote-pair-failed';
+/** Poll budget for the runtime services (activation order is unconstrained). */
+const SERVICE_WAIT_MS = 10_000;
+/** The browser implementation of {@link PageSurface}. */
+export const browserPage = {
+    get href() {
+        return window.location.href;
+    },
+    replaceState(url) {
+        window.history.replaceState(null, '', url);
+    },
+    navigate(url) {
+        window.location.assign(url);
+    },
+    reload() {
+        window.location.reload();
+    },
+};
+/** Whether this browser looks like a phone/tablet (the simplified mobile surface). */
+export function isMobileSurface() {
+    if (typeof navigator === 'undefined')
+        return false;
+    return /Android|iPhone|iPad|iPod|Mobile|mobile/i.test(navigator.userAgent);
+}
+/**
+ * Run the pair/workspace boot flow for this page load.
+ * @param ctx - client root context (workspaces/sessions read at need time).
+ * @param search - the current location.search.
+ * @param page - the page surface (defaults to the browser).
+ */
+export function runPairBootFlow(ctx, search, page = browserPage) {
+    const params = readPairParams(search);
+    if (params.pair !== undefined) {
+        void runAccept(params.pair, page);
+        return;
+    }
+    if (params.workspace !== undefined) {
+        void runDeepLink(ctx, params.workspace, page);
+    }
+}
+/** Accept the token, then reload (the workspace param survives the reload). */
+async function runAccept(token, page) {
+    let ok = false;
+    try {
+        const result = await acceptPair(token);
+        ok = result.ok;
+        if (!ok)
+            sessionStorage.setItem(PAIR_FAILED_MARKER, 'failed');
+    }
+    catch {
+        sessionStorage.setItem(PAIR_FAILED_MARKER, 'failed');
+    }
+    // Drop the token from the URL either way: an accepted token is consumed
+    // (a re-scan would 409), and a failed one must not loop.
+    const url = new URL(page.href);
+    url.searchParams.delete('pair');
+    page.replaceState(`${url.pathname}${url.search}${url.hash}`);
+    if (ok) {
+        // Phones land on the standalone simplified surface (the full desktop UI
+        // is not built for small screens); desktops stay on the full UI.
+        if (isMobileSurface())
+            page.navigate('/m');
+        else
+            page.reload();
+    }
+}
+/**
+ * Connect the deep-linked workspace and open its session. Waits for the
+ * runtime services AND for the target workspace to appear in the workspace
+ * list (both are asynchronous after boot), then connects and opens; gives
+ * up silently within the budget — the workspace param is stripped either
+ * way, so a late failure cannot loop.
+ * @param ctx - client root context.
+ * @param workspaceId - the target workspace.
+ * @param page - the page surface.
+ */
+async function runDeepLink(ctx, workspaceId, page) {
+    const target = workspaceId;
+    const deadline = Date.now() + SERVICE_WAIT_MS;
+    while (Date.now() < deadline) {
+        const workspaces = ctx.get('workspaces');
+        const sessions = ctx.get('sessions');
+        if (workspaces !== undefined && sessions !== undefined) {
+            const items = workspaces.list.getSnapshot().items;
+            if (items.some(item => item.workspaceId === target)) {
+                try {
+                    // Open unconditionally: a host-side "current" session may already
+                    // exist (multi-client mirroring), but the QR's workspace target is
+                    // explicit user intent and must win.
+                    const sessionId = await workspaces.connectWorkspace(target);
+                    sessions.open(sessionId);
+                }
+                catch {
+                    // Unknown workspace or a failed connect: fall through to the
+                    // runtime's own default initial selection.
+                }
+                break;
+            }
+        }
+        await new Promise(resolve => setTimeout(resolve, 200));
+    }
+    const url = new URL(page.href);
+    url.searchParams.delete('workspace');
+    page.replaceState(`${url.pathname}${url.search}${url.hash}`);
+}

package/lib/types/client/deep-link.js.map

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

package/lib/types/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAY3E,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AAIrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACrE,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAE/F,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,0CAA0C;QAC1C,MAAM,EAAE,SAAS,CAAA;KAClB;IAED,UAAU,OAAO;QACf;;;;WAIG;QACH,gBAAgB,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,uBAAuB,CAAA;SAAE,CAAA;QACnF;;;;;WAKG;QACH,oBAAoB,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,4BAA4B,CAAA;SAAE,CAAA;KAC3F;CACF;AAED,4GAA4G;AAC5G,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAA;CACd;AAED,mEAAmE;AACnE,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB;AAWD,wCAAwC;AACxC,eAAO,MAAM,MAAM,UAA+D,CAAA;AAElF;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAmF9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAa3E,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AAIrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACrE,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAE/F,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,0CAA0C;QAC1C,MAAM,EAAE,SAAS,CAAA;KAClB;IAED,UAAU,OAAO;QACf;;;;WAIG;QACH,gBAAgB,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,uBAAuB,CAAA;SAAE,CAAA;QACnF;;;;;WAKG;QACH,oBAAoB,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,4BAA4B,CAAA;SAAE,CAAA;KAC3F;CACF;AAED,4GAA4G;AAC5G,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAA;CACd;AAED,mEAAmE;AACnE,MAAM,WAAW,4BAA4B;IAC3C,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB;AAWD,wCAAwC;AACxC,eAAO,MAAM,MAAM,UAA+D,CAAA;AAElF;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAyG9C"}