@vitejs/devtools-kit 0.0.0-alpha.20 → 0.0.0-alpha.21

package/dist/{index-DLPbKO1M.d.mts → index-FzXSK6np.d.mts}

@@ -1,9 +1,10 @@
-import { t as EventEmitter } from "./events-S6nCJ_5X.mjs";
+import { t as EventEmitter } from "./events-BrHMyEqJ.mjs";
 import { RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcFunctionsCollector, RpcFunctionsCollectorBase } from "birpc-x";
 import { Raw } from "vue";
+import { BirpcOptions, BirpcReturn } from "birpc";
+import { WebSocket } from "ws";
 import { Plugin, ResolvedConfig, ViteDevServer } from "vite";
 import { ChildProcess } from "node:child_process";
-import { BirpcOptions, BirpcReturn } from "birpc";
 
 //#region src/types/docks.d.ts
 interface DevToolsDockHost {
@@ -93,7 +94,7 @@ interface DevToolsViewCustomRender extends DevToolsDockEntryBase {
 }
 interface DevToolsViewBuiltin extends DevToolsDockEntryBase {
   type: '~builtin';
-  id: '~terminals' | '~logs';
+  id: '~terminals' | '~logs' | '~client-auth-notice';
 }
 type DevToolsDockUserEntry = DevToolsViewIframe | DevToolsViewAction | DevToolsViewCustomRender | DevToolsViewLauncher;
 type DevToolsDockEntry = DevToolsDockUserEntry | DevToolsViewBuiltin;
@@ -180,14 +181,47 @@ interface DevToolsPluginOptions {
   setup: (context: DevToolsNodeContext) => void | Promise<void>;
 }
 interface DevToolsNodeContext {
+  /**
+   * Workspace root directory of Vite DevTools
+   */
+  readonly workspaceRoot: string;
+  /**
+   * Current working directory of Vite DevTools
+   */
   readonly cwd: string;
+  /**
+   * Current mode of Vite DevTools
+   * - 'dev' - when Vite DevTools is running in dev mode
+   * - 'build' - when Vite DevTools is running in build mode (no server)
+   */
   readonly mode: 'dev' | 'build';
+  /**
+   * Resolved Vite configuration
+   */
   readonly viteConfig: ResolvedConfig;
+  /**
+   * Vite dev server instance (only available in dev mode)
+   */
   readonly viteServer?: ViteDevServer;
+  /**
+   * RPC functions host, for registering server-side RPC functions and calling client-side RPC functions
+   */
   rpc: RpcFunctionsHost;
+  /**
+   * Docks host, for registering dock entries
+   */
   docks: DevToolsDockHost;
+  /**
+   * Views host, for registering static views
+   */
   views: DevToolsViewHost;
+  /**
+   * Utils for the node context
+   */
   utils: DevToolsNodeUtils;
+  /**
+   * Terminals host, for registering terminal sessions and streaming terminal output
+   */
   terminals: DevToolsTerminalHost;
 }
 interface DevToolsNodeUtils {
@@ -205,8 +239,27 @@ interface ConnectionMeta {
 }
 //#endregion
 //#region src/types/rpc.d.ts
+interface DevToolsNodeRpcSessionMeta {
+  id: number;
+  ws?: WebSocket;
+  clientAuthId?: string;
+  isTrusted?: boolean;
+}
+interface DevToolsNodeRpcSession {
+  meta: DevToolsNodeRpcSessionMeta;
+  rpc: BirpcReturn<DevToolsRpcClientFunctions, DevToolsRpcServerFunctions, false>;
+}
 type RpcFunctionsHost = RpcFunctionsCollectorBase<DevToolsRpcServerFunctions, DevToolsNodeContext> & {
-  boardcast: <T extends keyof DevToolsRpcClientFunctions, Args extends Parameters<DevToolsRpcClientFunctions[T]>>(name: T, ...args: Args) => Promise<(Awaited<ReturnType<DevToolsRpcClientFunctions[T]>> | undefined)[]>;
+  /**
+   * Broadcast a message to all connected clients
+   */
+  broadcast: <T extends keyof DevToolsRpcClientFunctions, Args extends Parameters<DevToolsRpcClientFunctions[T]>>(name: T, ...args: Args) => Promise<(Awaited<ReturnType<DevToolsRpcClientFunctions[T]>> | undefined)[]>;
+  /**
+   * Get the current RPC client
+   *
+   * Available in RPC functions to get the current RPC client
+   */
+  getCurrentRpcSession: () => DevToolsNodeRpcSession | undefined;
 };
 //#endregion
 //#region src/types/utils.d.ts
@@ -223,6 +276,21 @@ declare module 'vite' {
   interface Plugin {
     devtools?: DevToolsPluginOptions;
   }
+  interface UserConfig {
+    devtools?: ViteConfigDevtoolsOptions;
+  }
+}
+interface ViteConfigDevtoolsOptions {
+  /**
+   * Disable client authentication.
+   *
+   * Beware that if you disable client authentication,
+   * any browsers can connect to the devtools and access to your server and filesystem.
+   * (including other devices, if you open server `host` option to LAN or WAN)
+   *
+   * @default true
+   */
+  clientAuth?: boolean;
 }
 interface PluginWithDevTools extends Plugin {
   devtools?: DevToolsPluginOptions;
@@ -240,6 +308,10 @@ interface WebSocketRpcClientOptions {
 interface DevToolsRpcClientOptions {
   connectionMeta?: ConnectionMeta;
   baseURL?: string[];
+  /**
+   * The auth id to use for the client
+   */
+  authId?: string;
   wsOptions?: Partial<WebSocketRpcClientOptions>;
   rpcOptions?: Partial<BirpcOptions<DevToolsRpcServerFunctions, DevToolsRpcClientFunctions, boolean>>;
 }
@@ -248,10 +320,26 @@ interface DevToolsRpcClient {
    * The events of the client
    */
   events: EventEmitter<RpcClientEvents>;
+  /**
+   * Whether the client is trusted
+   */
+  readonly isTrusted: boolean | null;
   /**
    * The connection meta
    */
   readonly connectionMeta: ConnectionMeta;
+  /**
+   * Return a promise that resolves when the client is trusted
+   *
+   * Rejects with an error if the timeout is reached
+   *
+   * @param timeout - The timeout in milliseconds, default to 60 seconds
+   */
+  ensureTrusted: (timeout?: number) => Promise<boolean>;
+  /**
+   * Request trust from the server
+   */
+  requestTrust: () => Promise<boolean>;
   /**
    * Call a RPC function on the server
    */
@@ -327,6 +415,12 @@ interface DocksEntriesContext {
    * @returns Whether the selection was changed successfully
    */
   switchEntry: (id?: string | null) => Promise<boolean>;
+  /**
+   * Toggle the selected dock entry
+   *
+   * @returns Whether the selection was changed successfully
+   */
+  toggleEntry: (id: string) => Promise<boolean>;
 }
 interface DockEntryState {
   entryMeta: DevToolsDockEntry;
@@ -344,7 +438,9 @@ interface DockEntryStateEvents {
   'dom:panel:mounted': (panel: HTMLDivElement) => void;
   'dom:iframe:mounted': (iframe: HTMLIFrameElement) => void;
 }
-interface RpcClientEvents {}
+interface RpcClientEvents {
+  'rpc:is-trusted:updated': (isTrusted: boolean) => void;
+}
 //#endregion
 //#region src/client/client-script.d.ts
 /**
@@ -357,4 +453,4 @@ interface DockClientScriptContext extends DocksContext {
   current: DockEntryState;
 }
 //#endregion
-export { DevToolsTerminalHost as A, DevToolsDockEntryCategory as B, DevToolsCapabilities as C, DevToolsViewHost as D, DevToolsPluginOptions as E, DevToolsRpcClientFunctions as F, DevToolsViewBuiltin as G, DevToolsDockHost as H, DevToolsRpcServerFunctions as I, DevToolsViewLauncher as J, DevToolsViewCustomRender as K, ClientScriptEntry as L, DevToolsTerminalSessionBase as M, DevToolsTerminalSessionStreamChunkEvent as N, DevToolsChildProcessExecuteOptions as O, DevToolsTerminalStatus as P, DevToolsDockEntry as R, ConnectionMeta as S, DevToolsNodeUtils as T, DevToolsDockUserEntry as U, DevToolsDockEntryIcon as V, DevToolsViewAction as W, DevToolsViewLauncherStatus as Y, PluginWithDevTools as _, DockEntryState as a, Thenable as b, DocksContext as c, RpcClientEvents as d, DevToolsRpcClient as f, RpcDefinitionsToFunctions as g, RpcDefinitionsFilter as h, DockClientType as i, DevToolsTerminalSession as j, DevToolsChildProcessTerminalSession as k, DocksEntriesContext as l, getDevToolsRpcClient as m, DevToolsClientContext as n, DockEntryStateEvents as o, DevToolsRpcClientOptions as p, DevToolsViewIframe as q, DevToolsClientRpcHost as r, DockPanelStorage as s, DockClientScriptContext as t, DocksPanelContext as u, EntriesToObject as v, DevToolsNodeContext as w, RpcFunctionsHost as x, PartialWithoutId as y, DevToolsDockEntryBase as z };
+export { DevToolsViewHost as A, ClientScriptEntry as B, DevToolsNodeRpcSessionMeta as C, DevToolsNodeContext as D, DevToolsCapabilities as E, DevToolsTerminalSessionBase as F, DevToolsDockHost as G, DevToolsDockEntryBase as H, DevToolsTerminalSessionStreamChunkEvent as I, DevToolsViewBuiltin as J, DevToolsDockUserEntry as K, DevToolsTerminalStatus as L, DevToolsChildProcessTerminalSession as M, DevToolsTerminalHost as N, DevToolsNodeUtils as O, DevToolsTerminalSession as P, DevToolsViewLauncherStatus as Q, DevToolsRpcClientFunctions as R, DevToolsNodeRpcSession as S, ConnectionMeta as T, DevToolsDockEntryCategory as U, DevToolsDockEntry as V, DevToolsDockEntryIcon as W, DevToolsViewIframe as X, DevToolsViewCustomRender as Y, DevToolsViewLauncher as Z, PluginWithDevTools as _, DockEntryState as a, PartialWithoutId as b, DocksContext as c, RpcClientEvents as d, DevToolsRpcClient as f, RpcDefinitionsToFunctions as g, RpcDefinitionsFilter as h, DockClientType as i, DevToolsChildProcessExecuteOptions as j, DevToolsPluginOptions as k, DocksEntriesContext as l, getDevToolsRpcClient as m, DevToolsClientContext as n, DockEntryStateEvents as o, DevToolsRpcClientOptions as p, DevToolsViewAction as q, DevToolsClientRpcHost as r, DockPanelStorage as s, DockClientScriptContext as t, DocksPanelContext as u, ViteConfigDevtoolsOptions as v, RpcFunctionsHost as w, Thenable as x, EntriesToObject as y, DevToolsRpcServerFunctions as z };

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { n as EventUnsubscribe, r as EventsMap, t as EventEmitter } from "./events-S6nCJ_5X.mjs";
-import { A as DevToolsTerminalHost, B as DevToolsDockEntryCategory, C as DevToolsCapabilities, D as DevToolsViewHost, E as DevToolsPluginOptions, F as DevToolsRpcClientFunctions, G as DevToolsViewBuiltin, H as DevToolsDockHost, I as DevToolsRpcServerFunctions, J as DevToolsViewLauncher, K as DevToolsViewCustomRender, L as ClientScriptEntry, M as DevToolsTerminalSessionBase, N as DevToolsTerminalSessionStreamChunkEvent, O as DevToolsChildProcessExecuteOptions, P as DevToolsTerminalStatus, R as DevToolsDockEntry, S as ConnectionMeta, T as DevToolsNodeUtils, U as DevToolsDockUserEntry, V as DevToolsDockEntryIcon, W as DevToolsViewAction, Y as DevToolsViewLauncherStatus, _ as PluginWithDevTools, b as Thenable, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, j as DevToolsTerminalSession, k as DevToolsChildProcessTerminalSession, q as DevToolsViewIframe, v as EntriesToObject, w as DevToolsNodeContext, x as RpcFunctionsHost, y as PartialWithoutId, z as DevToolsDockEntryBase } from "./index-DLPbKO1M.mjs";
+import { n as EventUnsubscribe, r as EventsMap, t as EventEmitter } from "./events-BrHMyEqJ.mjs";
+import { A as DevToolsViewHost, B as ClientScriptEntry, C as DevToolsNodeRpcSessionMeta, D as DevToolsNodeContext, E as DevToolsCapabilities, F as DevToolsTerminalSessionBase, G as DevToolsDockHost, H as DevToolsDockEntryBase, I as DevToolsTerminalSessionStreamChunkEvent, J as DevToolsViewBuiltin, K as DevToolsDockUserEntry, L as DevToolsTerminalStatus, M as DevToolsChildProcessTerminalSession, N as DevToolsTerminalHost, O as DevToolsNodeUtils, P as DevToolsTerminalSession, Q as DevToolsViewLauncherStatus, R as DevToolsRpcClientFunctions, S as DevToolsNodeRpcSession, T as ConnectionMeta, U as DevToolsDockEntryCategory, V as DevToolsDockEntry, W as DevToolsDockEntryIcon, X as DevToolsViewIframe, Y as DevToolsViewCustomRender, Z as DevToolsViewLauncher, _ as PluginWithDevTools, b as PartialWithoutId, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, j as DevToolsChildProcessExecuteOptions, k as DevToolsPluginOptions, q as DevToolsViewAction, v as ViteConfigDevtoolsOptions, w as RpcFunctionsHost, x as Thenable, y as EntriesToObject, z as DevToolsRpcServerFunctions } from "./index-FzXSK6np.mjs";
 import * as birpc_x0 from "birpc-x";
 
 //#region src/utils/define.d.ts
 declare const defineRpcFunction: <NAME extends string, TYPE extends birpc_x0.RpcFunctionType, ARGS$1 extends any[], RETURN$1 = void>(definition: birpc_x0.RpcFunctionDefinition<NAME, TYPE, ARGS$1, RETURN$1, DevToolsNodeContext>) => birpc_x0.RpcFunctionDefinition<NAME, TYPE, ARGS$1, RETURN$1, DevToolsNodeContext>;
 //#endregion
-export { ClientScriptEntry, ConnectionMeta, DevToolsCapabilities, DevToolsChildProcessExecuteOptions, DevToolsChildProcessTerminalSession, DevToolsDockEntry, DevToolsDockEntryBase, DevToolsDockEntryCategory, DevToolsDockEntryIcon, DevToolsDockHost, DevToolsDockUserEntry, DevToolsNodeContext, DevToolsNodeUtils, DevToolsPluginOptions, DevToolsRpcClientFunctions, DevToolsRpcServerFunctions, DevToolsTerminalHost, DevToolsTerminalSession, DevToolsTerminalSessionBase, DevToolsTerminalSessionStreamChunkEvent, DevToolsTerminalStatus, DevToolsViewAction, DevToolsViewBuiltin, DevToolsViewCustomRender, DevToolsViewHost, DevToolsViewIframe, DevToolsViewLauncher, DevToolsViewLauncherStatus, EntriesToObject, EventEmitter, EventUnsubscribe, EventsMap, PartialWithoutId, PluginWithDevTools, RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcFunctionsHost, Thenable, defineRpcFunction };
+export { ClientScriptEntry, ConnectionMeta, DevToolsCapabilities, DevToolsChildProcessExecuteOptions, DevToolsChildProcessTerminalSession, DevToolsDockEntry, DevToolsDockEntryBase, DevToolsDockEntryCategory, DevToolsDockEntryIcon, DevToolsDockHost, DevToolsDockUserEntry, DevToolsNodeContext, DevToolsNodeRpcSession, DevToolsNodeRpcSessionMeta, DevToolsNodeUtils, DevToolsPluginOptions, DevToolsRpcClientFunctions, DevToolsRpcServerFunctions, DevToolsTerminalHost, DevToolsTerminalSession, DevToolsTerminalSessionBase, DevToolsTerminalSessionStreamChunkEvent, DevToolsTerminalStatus, DevToolsViewAction, DevToolsViewBuiltin, DevToolsViewCustomRender, DevToolsViewHost, DevToolsViewIframe, DevToolsViewLauncher, DevToolsViewLauncherStatus, EntriesToObject, EventEmitter, EventUnsubscribe, EventsMap, PartialWithoutId, PluginWithDevTools, RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcFunctionsHost, Thenable, ViteConfigDevtoolsOptions, defineRpcFunction };

package/dist/nanoid-B0pJU5uW.mjs

@@ -0,0 +1,11 @@
+//#region src/utils/nanoid.ts
+const urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+function nanoid(size = 21) {
+	let id = "";
+	let i = size;
+	while (i--) id += urlAlphabet[Math.random() * 64 | 0];
+	return id;
+}
+
+//#endregion
+export { nanoid as t };

package/dist/utils/events.d.mts

@@ -1,4 +1,4 @@
-import { r as EventsMap, t as EventEmitter } from "../events-S6nCJ_5X.mjs";
+import { r as EventsMap, t as EventEmitter } from "../events-BrHMyEqJ.mjs";
 
 //#region src/utils/events.d.ts
 

package/dist/utils/events.mjs

@@ -1,3 +1,3 @@
-import { t as createEventEmitter } from "../events-AmnAXhnR.mjs";
+import { t as createEventEmitter } from "../events-CWYZG96x.mjs";
 
 export { createEventEmitter };

package/dist/utils/nanoid.mjs

@@ -1,11 +1,3 @@
-//#region src/utils/nanoid.ts
-const urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
-function nanoid(size = 21) {
-	let id = "";
-	let i = size;
-	while (i--) id += urlAlphabet[Math.random() * 64 | 0];
-	return id;
-}
+import { t as nanoid } from "../nanoid-B0pJU5uW.mjs";
 
-//#endregion
 export { nanoid };

package/dist/utils/shared-state.d.mts

@@ -0,0 +1,50 @@
+import { t as EventEmitter } from "../events-BrHMyEqJ.mjs";
+import { Objectish, Patch } from "immer";
+
+//#region src/utils/shared-state.d.ts
+type ImmutablePrimitive = undefined | null | boolean | string | number | Function;
+type Immutable<T> = T extends ImmutablePrimitive ? T : T extends Array<infer U> ? ImmutableArray<U> : T extends Map<infer K, infer V> ? ImmutableMap<K, V> : T extends Set<infer M> ? ImmutableSet<M> : ImmutableObject<T>;
+type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
+type ImmutableMap<K$1, V$1> = ReadonlyMap<Immutable<K$1>, Immutable<V$1>>;
+type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
+type ImmutableObject<T> = { readonly [K in keyof T]: Immutable<T[K]> };
+/**
+ * State host that is immutable by default with explicit mutate.
+ */
+interface SharedState<T> {
+  /**
+   * Get the current state. Immutable.
+   */
+  get: () => Immutable<T>;
+  /**
+   * Subscribe to state changes.
+   */
+  on: EventEmitter<SharedStateEvents<T>>['on'];
+  /**
+   * Mutate the state.
+   */
+  mutate: (fn: (state: T) => void) => void;
+  /**
+   * Apply patches to the state.
+   */
+  patch: (patches: Patch[]) => void;
+}
+interface SharedStateEvents<T> {
+  updated: (state: T) => void;
+  patches: (patches: Patch[]) => void;
+}
+interface SharedStateOptions<T> {
+  /**
+   * Initial state.
+   */
+  initialState: T;
+  /**
+   * Enable patches.
+   *
+   * @default false
+   */
+  enablePatches?: boolean;
+}
+declare function createSharedState<T extends Objectish>(options: SharedStateOptions<T>): SharedState<T>;
+//#endregion
+export { Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableSet, SharedState, SharedStateEvents, SharedStateOptions, createSharedState };

package/dist/utils/shared-state.mjs

@@ -0,0 +1,28 @@
+import { t as createEventEmitter } from "../events-CWYZG96x.mjs";
+import { applyPatches, produce, produceWithPatches } from "immer";
+
+//#region src/utils/shared-state.ts
+function createSharedState(options) {
+	const { enablePatches = false } = options;
+	const events = createEventEmitter();
+	let state = options.initialState;
+	return {
+		on: events.on,
+		get: () => state,
+		patch: (patches) => {
+			state = applyPatches(state, patches);
+			events.emit("updated", state);
+		},
+		mutate: (fn) => {
+			if (enablePatches) {
+				const [newState, patches] = produceWithPatches(state, fn);
+				state = newState;
+				events.emit("patches", patches);
+			} else state = produce(state, fn);
+			events.emit("updated", state);
+		}
+	};
+}
+
+//#endregion
+export { createSharedState };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vitejs/devtools-kit",
   "type": "module",
-  "version": "0.0.0-alpha.20",
+  "version": "0.0.0-alpha.21",
   "description": "Vite DevTools Kit",
   "author": "VoidZero Inc.",
   "license": "MIT",
@@ -23,6 +23,7 @@
     "./client": "./dist/client.mjs",
     "./utils/events": "./dist/utils/events.mjs",
     "./utils/nanoid": "./dist/utils/nanoid.mjs",
+    "./utils/shared-state": "./dist/utils/shared-state.mjs",
     "./package.json": "./package.json"
   },
   "main": "./dist/index.mjs",
@@ -37,12 +38,13 @@
   "dependencies": {
     "birpc": "^4.0.0",
     "birpc-x": "0.0.6",
-    "@vitejs/devtools-rpc": "0.0.0-alpha.20"
+    "immer": "^11.1.0",
+    "@vitejs/devtools-rpc": "0.0.0-alpha.21"
   },
   "devDependencies": {
     "my-ua-parser": "^2.0.4",
-    "tsdown": "^0.17.4",
-    "vite": "^8.0.0-beta.2"
+    "tsdown": "^0.18.2",
+    "vite": "^8.0.0-beta.3"
   },
   "scripts": {
     "build": "tsdown",