@linxin666/dsh-remote-web-ui 0.1.1

package/lib/invariant.js

@@ -0,0 +1,21 @@
+//#region src/invariant.ts
+const PACKAGE_NAME = "@linxin666/dsh-remote-web-ui";
+/** Cordis companion plugin name. */
+const name = "remote-web-ui-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this package owns no durable package-local event
+* stream; its route-table and device-session relationships are asserted by
+* the package's own specs (route register/dispose symmetry via the
+* webServer disposer contract, token/revocation semantics on the service).
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,12 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+/** Notice props: localized copy. */
+export interface PairFailedNoticeProps {
+    t: TranslateNS<'remote'>;
+}
+/**
+ * Render the failed-pair toast (auto-dismisses).
+ * @param props - localized copy.
+ * @returns the toast element.
+ */
+export declare function PairFailedNotice({ t }: PairFailedNoticeProps): import("react").JSX.Element | null;
+//# sourceMappingURL=PairFailedNotice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PairFailedNotice.d.ts","sourceRoot":"","sources":["../../../src/client/PairFailedNotice.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAGnE,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;CACzB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,qBAAqB,sCAY5D"}

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

@@ -0,0 +1,19 @@
+/**
+ * Phone glyph for the sidebar remote-control trigger. Not part of the
+ * shared icon set (ui-primitives has no phone icon); matches the outline
+ * style with currentColor strokes.
+ */
+/** Icon props mirroring ui-primitives' IconProps. */
+export interface PhoneIconProps {
+    /** Glyph size in px (default 16). */
+    size?: number;
+    /** Extra class for layout placement. */
+    className?: string;
+}
+/**
+ * Render the phone icon.
+ * @param props - size and optional class.
+ * @returns the svg element.
+ */
+export declare function PhoneIcon({ size, className }: PhoneIconProps): import("react").JSX.Element;
+//# sourceMappingURL=PhoneIcon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneIcon.d.ts","sourceRoot":"","sources":["../../../src/client/PhoneIcon.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,SAAS,EAAE,EAAE,cAAc,+BAWjE"}

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

@@ -0,0 +1,78 @@
+/**
+ * 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 { type ReactNode } from 'react';
+import type { CardShell } from './settings-form.ts';
+import type { SettingsCardKey } from './locales.ts';
+/** Card chrome shared by every plugin settings card. */
+export interface PluginSettingsCardProps {
+    /** Locale reader for this card's copy. */
+    t: (key: SettingsCardKey) => string;
+    /** Locale key of the plugin's name. */
+    titleKey: SettingsCardKey;
+    /** Locale key of the line describing what this plugin's settings govern. */
+    descriptionKey: SettingsCardKey;
+    /** The card's form state: availability, writability, and what a save would do. */
+    state: CardShell;
+    /** Write every staged edit. */
+    onSave: () => void;
+    /** Drop every staged edit. */
+    onDiscard: () => void;
+    /** The plugin's controls. */
+    children: ReactNode;
+}
+/**
+ * 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 declare function PluginSettingsCard(props: PluginSettingsCardProps): import("react").JSX.Element | null;
+/** Props every field control needs regardless of its value type. */
+export interface FieldProps {
+    /** Stable id associating the label with its control. */
+    id: string;
+    /** Visible label. */
+    label: string;
+    /** One-line explanation rendered under the control. */
+    hint: string;
+    /** Draft text this control renders. */
+    text: string;
+    /** True when saving would leave a user-layer entry for this field. */
+    overridden: boolean;
+    /** True when the draft is not a value this field accepts. */
+    invalid: boolean;
+    /** Copy for the overridden badge. */
+    overriddenLabel: string;
+    /** Copy for the reset control. */
+    resetLabel: string;
+    /** Copy shown in place of the hint while the draft is invalid. */
+    invalidLabel: string;
+    /** Disables every control (read-only document, or an unavailable namespace). */
+    disabled: boolean;
+    /** Stage draft text. */
+    onEdit: (text: string) => void;
+    /** Stage a clear so the field re-inherits the composition layer. */
+    onReset: () => void;
+}
+/** A staged value field. `numeric` only hints the keypad: which drafts a field accepts is decided by its spec. */
+export declare function ValueField(props: FieldProps & {
+    /** Hints a numeric keypad without narrowing what the control accepts. */
+    numeric?: boolean;
+    /** Placeholder shown while the draft is empty. */
+    placeholder?: string;
+}): import("react").JSX.Element;
+/** A staged boolean field: 继承 / 开 / 关. */
+export declare function BooleanField(props: FieldProps & {
+    /** Copy for the inherit option. */
+    inheritLabel: string;
+    /** Copy for the on option. */
+    onLabel: string;
+    /** Copy for the off option. */
+    offLabel: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=PluginSettingsCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/PluginSettingsCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAGnD,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAAA;IACnC,uCAAuC;IACvC,QAAQ,EAAE,eAAe,CAAA;IACzB,4EAA4E;IAC5E,cAAc,EAAE,eAAe,CAAA;IAC/B,kFAAkF;IAClF,KAAK,EAAE,SAAS,CAAA;IAChB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,sCAmDhE;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAA;IACV,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAA;IACnB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAA;IACjB,wBAAwB;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,oEAAoE;IACpE,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,kHAAkH;AAClH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG;IAC7C,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,+BAqCA;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG;IAC/C,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;CACjB,+BAmCA"}

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

@@ -0,0 +1,10 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Entry props: the sidebar column state + the standard locale seat. */
+export type RemoteEntryProps = PropsRuntime<'sidebar.remote'> & PropsLocale<'remote'>;
+/**
+ * Render the remote-control trigger and panel.
+ * @param props - composed slot props (contract in this package).
+ * @returns the entry element tree.
+ */
+export declare function RemoteEntry({ wide, useWorkspaces, t }: RemoteEntryProps): import("react").JSX.Element;
+//# sourceMappingURL=RemoteEntry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteEntry.d.ts","sourceRoot":"","sources":["../../../src/client/RemoteEntry.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAOjF,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;AAcrF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,gBAAgB,+BAoJvE"}

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

@@ -0,0 +1,50 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PairingPhase } from '../pairing.ts';
+import { type TunnelStatusFrame } from './pair-api.ts';
+/** The panel's view state, owned by the entry component. */
+export type PanelState = {
+    kind: 'lan-required';
+} | {
+    kind: 'loopback-required';
+} | {
+    kind: 'unreachable';
+} | {
+    kind: 'ready';
+    url: string;
+    expiresAt: number;
+    expired: boolean;
+    phase: PairingPhase;
+    deviceCount: number;
+    onlineCount: number;
+    /** The LAN literal the current QR was built from. */
+    address: string;
+    /** Every constructible LAN literal (interface order). */
+    lanAddresses: string[];
+    /** Whether this QR is built on the configured public (tunneled) base. */
+    public: boolean;
+    /** The configured public (tunneled) base URL, when present. */
+    publicBaseUrl?: string;
+    /** Auto-tunnel status, while the auto-tunnel feature is active. */
+    tunnel?: TunnelStatusFrame;
+};
+/** Full panel props: copy + view state + actions. */
+export interface RemotePanelProps {
+    t: TranslateNS<'remote'>;
+    state: PanelState;
+    copied: boolean;
+    onClose(): void;
+    onStop(): void;
+    onRefresh(): void;
+    onCopy(): void;
+    /** Re-mint the QR against a different LAN address. */
+    onPickAddress(address: string): void;
+    /** Re-mint the QR against the configured public (tunneled) base. */
+    onPickPublic(): void;
+}
+/**
+ * Render the pairing panel.
+ * @param props - copy, state, and actions.
+ * @returns the panel element tree.
+ */
+export declare function RemotePanel({ t, state, copied, onClose, onStop, onRefresh, onCopy, onPickAddress, onPickPublic }: RemotePanelProps): import("react").JSX.Element;
+//# sourceMappingURL=RemotePanel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RemotePanel.d.ts","sourceRoot":"","sources":["../../../src/client/RemotePanel.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGnE,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IACE,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,YAAY,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAA;IACf,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mEAAmE;IACnE,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B,CAAA;AAEL,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IACxB,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,IAAI,CAAA;IACd,SAAS,IAAI,IAAI,CAAA;IACjB,MAAM,IAAI,IAAI,CAAA;IACd,sDAAsD;IACtD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,oEAAoE;IACpE,YAAY,IAAI,IAAI,CAAA;CACrB;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,EAAE,gBAAgB,+BA8GlI"}

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

@@ -0,0 +1,75 @@
+/**
+ * The remote-control settings card: pairing security and device limits.
+ * Registers into the `settings.plugin.item` slot the plugin-configuration
+ * section renders, bound to the `remote-web-ui` settings namespace.
+ */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SettingsScope, SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import { type CardActions, type CardShell, type FieldState as CardFieldState } from './settings-form.ts';
+/** The remote-control fields this card edits (the namespace's full schema). */
+export interface RemoteSettings {
+    /** Master switch for the plugin. */
+    enabled?: boolean;
+    /** Token lifetime in ms; the QR link dies after this. */
+    tokenTtlMs?: number;
+    /** A device is "online" while its lastSeenAt is newer than this (ms). */
+    offlineAfterMs?: number;
+    /** Hard cap on paired device sessions (oldest evicted when full). */
+    maxDevices?: number;
+    /** Cookie name carrying the paired device id. */
+    cookieName?: string;
+    /** Fence flag: whether non-loopback /api requests must carry a live paired-device cookie. */
+    requirePairingForLan?: boolean;
+    /** Public (tunneled) base URL the QR link is built from when set. */
+    publicBaseUrl?: string;
+    /** When on, the plugin runs its own Cloudflare quick tunnel automatically. */
+    autoTunnel?: boolean;
+}
+/** What the remote-control card renders. */
+export interface RemoteSettingsCardState extends CardShell {
+    /** Master switch. */
+    enabled: CardFieldState;
+    /** Token lifetime. */
+    tokenTtlMs: CardFieldState;
+    /** Device offline threshold. */
+    offlineAfterMs: CardFieldState;
+    /** Paired-device cap. */
+    maxDevices: CardFieldState;
+    /** Device cookie name. */
+    cookieName: CardFieldState;
+    /** LAN fence flag. */
+    requirePairingForLan: CardFieldState;
+    /** Public (tunneled) base URL. */
+    publicBaseUrl: CardFieldState;
+    /** Auto public tunnel switch. */
+    autoTunnel: CardFieldState;
+}
+/** The registration-side face the card's slot entry injects. */
+export interface RemoteSettingsCardFace extends CardActions {
+    hooks: {
+        /** Card snapshot bound by the renderer as useRemoteSettingsCard. */
+        remoteSettingsCard: SnapshotStore<RemoteSettingsCardState>;
+    };
+}
+/** Bridges the `remote-web-ui` scope onto the card's staged form. */
+export declare class RemoteSettingsCardController {
+    private readonly form;
+    private readonly store;
+    /** @param scope - the bound settings scope for the `remote-web-ui` namespace. */
+    constructor(scope: SettingsScope<RemoteSettings>);
+    private projection;
+    /**
+     * Build the face the card's slot registration injects.
+     * @returns the card's snapshot and its form actions.
+     */
+    inject(): RemoteSettingsCardFace;
+}
+/** Props the renderer binds for the remote-control card. */
+export type RemoteSettingsCardProps = PropsRuntime<'web-ui.plugin.item'> & PropsLocale<'remote'> & InjectFace<RemoteSettingsCardFace>;
+/**
+ * Render the remote-control card.
+ * @param props - locale copy, the card snapshot, and its form actions.
+ * @returns the card.
+ */
+export declare function RemoteSettingsCard(props: RemoteSettingsCardProps): import("react").JSX.Element;
+//# sourceMappingURL=RemoteSettingsCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteSettingsCard.d.ts","sourceRoot":"","sources":["../../../src/client/RemoteSettingsCard.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAE1F,OAAO,EAAkD,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExJ,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6FAA6F;IAC7F,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAwB,SAAQ,SAAS;IACxD,qBAAqB;IACrB,OAAO,EAAE,cAAc,CAAA;IACvB,sBAAsB;IACtB,UAAU,EAAE,cAAc,CAAA;IAC1B,gCAAgC;IAChC,cAAc,EAAE,cAAc,CAAA;IAC9B,yBAAyB;IACzB,UAAU,EAAE,cAAc,CAAA;IAC1B,0BAA0B;IAC1B,UAAU,EAAE,cAAc,CAAA;IAC1B,sBAAsB;IACtB,oBAAoB,EAAE,cAAc,CAAA;IACpC,kCAAkC;IAClC,aAAa,EAAE,cAAc,CAAA;IAC7B,iCAAiC;IACjC,UAAU,EAAE,cAAc,CAAA;CAC3B;AAED,gEAAgE;AAChE,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,KAAK,EAAE;QACL,oEAAoE;QACpE,kBAAkB,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAA;KAC3D,CAAA;CACF;AAED,qEAAqE;AACrE,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwC;IAE9D,iFAAiF;gBACrE,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC;IAchD,OAAO,CAAC,UAAU;IAclB;;;OAGG;IACH,MAAM,IAAI,sBAAsB;CAGjC;AAED,4DAA4D;AAC5D,MAAM,MAAM,uBAAuB,GACjC,YAAY,CAAC,oBAAoB,CAAC,GAChC,WAAW,CAAC,QAAQ,CAAC,GACrB,UAAU,CAAC,sBAAsB,CAAC,CAAA;AAEtC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,+BA0GhE"}

package/lib/types/client/deep-link.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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 type { Context } from '@deepseek-ai/cordis';
+/** sessionStorage key for the failed-pair notice. */
+export declare const PAIR_FAILED_MARKER = "dsh-remote-pair-failed";
+/**
+ * The page-navigation surface the boot flow drives. Browser pages use the
+ * default (window.location/history); tests inject a fake.
+ */
+export interface PageSurface {
+    /** The current page URL (read fresh on each access). */
+    href: string;
+    /** Replace the URL without reloading. */
+    replaceState(url: string): void;
+    /** Navigate to a URL (a fresh page load). */
+    navigate(url: string): void;
+    /** Reload the page. */
+    reload(): void;
+}
+/** The browser implementation of {@link PageSurface}. */
+export declare const browserPage: PageSurface;
+/** Whether this browser looks like a phone/tablet (the simplified mobile surface). */
+export declare function isMobileSurface(): boolean;
+/**
+ * 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 declare function runPairBootFlow(ctx: Context, search: string, page?: PageSurface): void;
+//# sourceMappingURL=deep-link.d.ts.map

package/lib/types/client/deep-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-link.d.ts","sourceRoot":"","sources":["../../../src/client/deep-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAK1D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,uBAAuB;IACvB,MAAM,IAAI,IAAI,CAAA;CACf;AAED,yDAAyD;AACzD,eAAO,MAAM,WAAW,EAAE,WAazB,CAAA;AAED,sFAAsF;AACtF,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,WAAyB,GAAG,IAAI,CASnG"}

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

@@ -0,0 +1,54 @@
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type RemoteKey } from './locales.ts';
+export type { RemoteEntryProps } from './RemoteEntry.tsx';
+export type { PanelState, RemotePanelProps } from './RemotePanel.tsx';
+export type { PairFailedNoticeProps } from './PairFailedNotice.tsx';
+export type { RemoteKey } from './locales.ts';
+export type { RemoteSettingsCardFace, RemoteSettingsCardState } from './RemoteSettingsCard.tsx';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Mobile remote-control surface copy. */
+        remote: RemoteKey;
+    }
+    interface SlotMap {
+        /**
+         * The sidebar foot seat beside the settings trigger, declared by the
+         * sidebar shell on deployments that carry the feature seat; the shell
+         * passes only its column display state.
+         */
+        'sidebar.remote': {
+            kind: 'single';
+            scope: 'root';
+            owner: SidebarRemoteOwnerProps;
+        };
+        /**
+         * The child slot the Web UI plugin group declares; this card registers
+         * into the group instead of the top-level `settings.plugin.item` list.
+         * Spelled here with the same shape so this package can register without
+         * depending on the sibling UI package.
+         */
+        'web-ui.plugin.item': {
+            kind: 'list';
+            scope: 'root';
+            owner: SettingsPluginItemOwnerProps;
+        };
+    }
+}
+/** Owner share of the sidebar remote-control seat: the column display state the trigger renders against. */
+export interface SidebarRemoteOwnerProps {
+    /** Whether the sidebar renders wide content (false = 56px rail). */
+    wide: boolean;
+}
+/** Owner share of a plugin card (the section supplies nothing). */
+export interface SettingsPluginItemOwnerProps {
+    /** Marker field: card owner props are intentionally empty. */
+    children?: never;
+}
+/** Services required by this plugin. */
+export declare const inject: string[];
+/**
+ * Register the remote-control surface.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,144 @@
+/** `remote` namespace dictionaries: the mobile remote-control surface copy. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'entry.label': string;
+    title: string;
+    subtitle: string;
+    'card.title': string;
+    'public.badge': string;
+    'status.waiting': string;
+    'status.connected': string;
+    'status.disconnected': string;
+    'status.stopped': string;
+    'status.lanRequired': string;
+    'status.lanRequiredHint': string;
+    'status.loopbackRequired': string;
+    'status.loopbackRequiredHint': string;
+    'status.unreachable': string;
+    'status.unreachableHint': string;
+    'pair.hint': string;
+    'pair.publicHint': string;
+    'address.label': string;
+    'address.public': string;
+    'address.lan': string;
+    'address.hint': string;
+    'pair.expires': string;
+    'pair.expired': string;
+    'pair.failed.title': string;
+    'pair.failed.detail': string;
+    'action.stop': string;
+    'action.refresh': string;
+    'action.copy': string;
+    'action.copied': string;
+    'stopped.hint': string;
+    'tunnel.starting': string;
+    'tunnel.failed': string;
+    'tunnel.unknownError': string;
+    'close.label': string;
+    'settings.title': string;
+    'settings.description': string;
+    'settings.enabled': string;
+    'settings.enabledHint': string;
+    'settings.tokenTtlMs': string;
+    'settings.tokenTtlMsHint': string;
+    'settings.offlineAfterMs': string;
+    'settings.offlineAfterMsHint': string;
+    'settings.maxDevices': string;
+    'settings.maxDevicesHint': string;
+    'settings.cookieName': string;
+    'settings.cookieNameHint': string;
+    'settings.requirePairingForLan': string;
+    'settings.requirePairingForLanHint': string;
+    'settings.publicBaseUrl': string;
+    'settings.publicBaseUrlHint': string;
+    'settings.autoTunnel': string;
+    'settings.autoTunnelHint': string;
+    'settings.inherit': string;
+    'settings.on': string;
+    'settings.off': string;
+    'settings.overridden': string;
+    'settings.reset': string;
+    'settings.readOnly': string;
+    'settings.expand': string;
+    'settings.collapse': string;
+    'settings.save': string;
+    'settings.saving': string;
+    'settings.discard': string;
+    'settings.unsaved': string;
+    'settings.saveFailed': string;
+    'settings.invalidNumber': string;
+};
+/** The remote namespace key union. */
+export type RemoteKey = keyof typeof zh;
+/** The settings-card slice of the remote dictionary. */
+export type SettingsCardKey = RemoteKey;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'entry.label': string;
+    title: string;
+    subtitle: string;
+    'card.title': string;
+    'public.badge': string;
+    'status.waiting': string;
+    'status.connected': string;
+    'status.disconnected': string;
+    'status.stopped': string;
+    'status.lanRequired': string;
+    'status.lanRequiredHint': string;
+    'status.loopbackRequired': string;
+    'status.loopbackRequiredHint': string;
+    'status.unreachable': string;
+    'status.unreachableHint': string;
+    'pair.hint': string;
+    'pair.publicHint': string;
+    'address.label': string;
+    'address.public': string;
+    'address.lan': string;
+    'address.hint': string;
+    'pair.expires': string;
+    'pair.expired': string;
+    'pair.failed.title': string;
+    'pair.failed.detail': string;
+    'action.stop': string;
+    'action.refresh': string;
+    'action.copy': string;
+    'action.copied': string;
+    'stopped.hint': string;
+    'tunnel.starting': string;
+    'tunnel.failed': string;
+    'tunnel.unknownError': string;
+    'close.label': string;
+    'settings.title': string;
+    'settings.description': string;
+    'settings.enabled': string;
+    'settings.enabledHint': string;
+    'settings.tokenTtlMs': string;
+    'settings.tokenTtlMsHint': string;
+    'settings.offlineAfterMs': string;
+    'settings.offlineAfterMsHint': string;
+    'settings.maxDevices': string;
+    'settings.maxDevicesHint': string;
+    'settings.cookieName': string;
+    'settings.cookieNameHint': string;
+    'settings.requirePairingForLan': string;
+    'settings.requirePairingForLanHint': string;
+    'settings.publicBaseUrl': string;
+    'settings.publicBaseUrlHint': string;
+    'settings.autoTunnel': string;
+    'settings.autoTunnelHint': string;
+    'settings.inherit': string;
+    'settings.on': string;
+    'settings.off': string;
+    'settings.overridden': string;
+    'settings.reset': string;
+    'settings.readOnly': string;
+    'settings.expand': string;
+    'settings.collapse': string;
+    'settings.save': string;
+    'settings.saving': string;
+    'settings.discard': string;
+    'settings.unsaved': string;
+    'settings.saveFailed': string;
+    'settings.invalidNumber': string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEmB,CAAA;AAElC,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,EAAE,CAAA;AAEvC,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA;AAEvC,mEAAmE;AACnE,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEsB,CAAA"}

package/lib/types/client/pair-api.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Browser-side wire helpers for the /api/pair surface. Plain fetch over
+ * same-origin /api (like the connection client); JSON bodies, string
+ * responses for the error codes.
+ */
+/** issue() response. */
+export interface IssueResult {
+    ok: true;
+    url: string;
+    token: string;
+    expiresAt: number;
+    /** Every constructible LAN base address (interface order). */
+    lanAddresses: string[];
+    /** The configured public (tunneled) base URL, when present. */
+    publicBaseUrl?: string;
+}
+/** issue() refusal: the server is not LAN-reachable. */
+export interface IssueLanRequired {
+    ok: false;
+    code: 'lan-required';
+}
+/** issue() refusal: the requested LAN address is not constructible. */
+export interface IssueUnknownAddress {
+    ok: false;
+    code: 'unknown-address';
+}
+/** issue() refusal: the loopback-only fence rejected this origin. */
+export interface IssueLoopbackRequired {
+    ok: false;
+    code: 'forbidden';
+}
+export type IssueResponse = IssueResult | IssueLanRequired | IssueUnknownAddress | IssueLoopbackRequired;
+/** accept() refusal codes. */
+export type AcceptFailure = {
+    ok: false;
+    code: 'invalid' | 'used' | 'forbidden';
+};
+/** One auto-tunnel status frame (absent while the feature is off). */
+export interface TunnelStatusFrame {
+    state: 'starting' | 'running' | 'failed';
+    url?: string;
+    error?: string;
+}
+/** One /api/pair/events frame. */
+export interface PairStateFrame {
+    type: 'state';
+    phase: 'lan-required' | 'stopped' | 'waiting' | 'connected' | 'disconnected';
+    lanAvailable: boolean;
+    tokenId?: string;
+    tokenExpiresAt?: number;
+    deviceCount: number;
+    onlineCount: number;
+    /** Auto-tunnel status, while the auto-tunnel feature is active. */
+    tunnel?: TunnelStatusFrame;
+}
+/**
+ * Mint a fresh pairing token (one active token at a time — this invalidates
+ * any previous link).
+ * @param workspaceId - optional current workspace to deep-link the phone into.
+ * @param address - optional LAN IP literal the QR must be built from (the
+ * default is the first interface); unknown literals refuse with
+ * 'unknown-address'.
+ * @returns the issued link, the lan-required refusal (server never bound
+ * 0.0.0.0), or the forbidden refusal (the loopback-only fence rejected this
+ * origin — the panel is a desktop control endpoint).
+ */
+export declare function issuePair(workspaceId?: string, address?: string): Promise<IssueResponse>;
+/**
+ * Accept a pairing token (the phone's first open of the QR link). Success
+ * sets the device cookie; the page then reloads to boot with it.
+ * @param token - the token from the URL.
+ * @returns the wire result.
+ */
+export declare function acceptPair(token: string): Promise<{
+    ok: true;
+} | AcceptFailure>;
+/** Revoke mobile access (paired devices + the current token). */
+export declare function stopPair(): Promise<void>;
+/** Presence heartbeat from a paired phone (unpaired heartbeats 401 harmlessly). */
+export declare function sendHeartbeat(): Promise<void>;
+/** Whether the current page URL carries a pairing token / workspace target. */
+export declare function readPairParams(search: string): {
+    pair?: string;
+    workspace?: string;
+};
+/**
+ * Strip one query parameter from the current URL without reloading.
+ * @param name - the parameter to remove.
+ * @returns the new search string ('' when empty).
+ */
+export declare function stripParam(name: string): string; /** Human-readable expiry clock, e.g. "10:35". */
+export declare function formatClock(epochMs: number): string;
+/**
+ * Copy text to the clipboard with a fallback for insecure contexts
+ * (plain-HTTP LAN origins lack navigator.clipboard).
+ * @param text - the text to copy.
+ * @returns whether the copy succeeded.
+ */
+export declare function copyText(text: string): Promise<boolean>;
+//# sourceMappingURL=pair-api.d.ts.map