@devframes/plugin-code-server 0.9.8 → 0.9.10

package/dist/{types.d.mts → node/types.d.mts}

@@ -1,14 +1,14 @@
-//#region src/types.d.ts
+//#region src/node/types.d.ts
 /** Lifecycle state of the managed editor process. */
 type CodeServerStatus = 'stopped' | 'starting' | 'running' | 'error';
 /**
  * Which editor server binary the plugin launches in `mode: 'local'`:
  *
- * - `'code-server'` — Coder's open-source
+ * - `'code-server'`: Coder's open-source
  *   [code-server](https://github.com/coder/code-server) (`code-server …`). The
  *   plugin runs it with password auth and hands the client a session cookie, so
  *   the embedded editor opens already signed in.
- * - `'ms-code-serve-web'` — Microsoft's official
+ * - `'ms-code-serve-web'`: Microsoft's official
  *   [`code serve-web`](https://code.visualstudio.com/docs/remote/vscode-server)
  *   (ships with the `code` CLI). The plugin generates a connection token and
  *   hands it to the client as a `?tkn=` query parameter.
@@ -17,9 +17,9 @@ type CodeServerBackend = 'code-server' | 'ms-code-serve-web';
 /**
  * How the editor is served:
  *
- * - `'local'` — a local server ({@link CodeServerBackend}) embedded from this
+ * - `'local'`: a local server ({@link CodeServerBackend}) embedded from this
  *   machine's origin.
- * - `'tunnel'` — Microsoft's `code tunnel`, which registers a remote tunnel and
+ * - `'tunnel'`: Microsoft's `code tunnel`, which registers a remote tunnel and
  *   embeds the hosted `vscode.dev` editor. First launch prints a device-login
  *   prompt (surfaced as {@link CodeServerLogin}); authentication is handled by
  *   `vscode.dev` itself, not this plugin.
@@ -70,7 +70,7 @@ interface CodeServerServerInfo {
 }
 /**
  * The full shared-state payload broadcast to subscribed clients. Deliberately
- * carries no authentication material — see {@link CodeServerConnect}.
+ * carries no authentication material; see {@link CodeServerConnect}.
  */
 interface CodeServerSharedState {
   detection: CodeServerDetection;
@@ -79,7 +79,7 @@ interface CodeServerSharedState {
 /**
  * How the client reaches the running editor. May carry a secret (session
  * cookie or connection token), so it is returned only from the `start` /
- * `status` RPCs to the already-authorized client — never published to shared
+ * `status` RPCs to the already-authorized client, never published to shared
  * state.
  *
  * - `url` set → embed it verbatim (tunnel mode's `vscode.dev` URL).
@@ -98,11 +98,11 @@ interface CodeServerConnect {
     value: string;
   };
 }
-/** Result of the `status` query — shared state plus connect info when running. */
+/** Result of the `status` query: shared state plus connect info when running. */
 interface CodeServerStatusResult extends CodeServerSharedState {
   connect?: CodeServerConnect;
 }
-/** Result of the `start` action — identical shape to {@link CodeServerStatusResult}. */
+/** Result of the `start` action, identical shape to {@link CodeServerStatusResult}. */
 type CodeServerStartResult = CodeServerStatusResult;
 /** Wire payload for the `start` RPC. */
 interface CodeServerStartRequest {
@@ -169,7 +169,7 @@ interface CodeServerOptions {
   random?: boolean;
   /**
    * Require the trust handshake on the standalone launcher server. Enabled
-   * by default — `--open` embeds the current OTP in the opened URL, so the
+   * by default; `--open` embeds the current OTP in the opened URL, so the
    * tab authenticates automatically without extra prompts. Hosted adapters
    * manage their own auth and ignore this.
    */

package/dist/{vite.d.mts → node/vite.d.mts}

@@ -1,6 +1,6 @@
 import { CodeServerOptions } from "./types.mjs";
 import { DevframeViteBridgeOptions, DevframeVitePlugin } from "@devframes/vite/single";
-//#region src/vite.d.ts
+//#region src/node/vite.d.ts
 interface CodeServerViteOptions extends CodeServerOptions {
   /** Forwarded to the underlying `devframeViteBridge`/`devframeVitePlugin` (mount base, etc.). */
   vite?: DevframeViteBridgeOptions;

package/dist/{vite.mjs → node/vite.mjs}

@@ -1,6 +1,6 @@
-import { t as createCodeServerDevframe } from "./src-CNJYQ3UQ.mjs";
+import { t as createCodeServerDevframe } from "../node-C_wU5QYh.mjs";
 import { devframeViteBridge, devframeVitePlugin } from "@devframes/vite/single";
-//#region src/vite.ts
+//#region src/node/vite.ts
 /**
 * Mount the code-server launcher into an existing Vite dev server. Returns two
 * plugins: a bridge that starts the devframe RPC + WebSocket server (so the

package/dist/{src-CNJYQ3UQ.mjs → node-C_wU5QYh.mjs}

@@ -1,12 +1,12 @@
-import { PLUGIN_ID } from "./constants.mjs";
+import { PLUGIN_ID } from "./node/constants.mjs";
 import { defineDevframe } from "devframe";
 //#region package.json
 var name = "@devframes/plugin-code-server";
-var version = "0.9.8";
+var version = "0.9.10";
 var description = "Devframe plugin that runs VS Code in the browser as an embedded editor panel.";
 var homepage = "https://github.com/devframes/devframe#readme";
 //#endregion
-//#region src/index.ts
+//#region src/node/index.ts
 const remoteAssets = {
 	package: `${name}--assets`,
 	version
@@ -14,7 +14,7 @@ const remoteAssets = {
 /**
 * Build a {@link DevframeDefinition} for the code-server panel. The same
 * definition runs standalone (`createCac`), mounts into a Vite host
-* (`/vite`), or docks inside a hub — its `setup` only relies on the core
+* (`/vite`), or docks inside a hub, since its `setup` only relies on the core
 * devframe RPC + shared-state surface.
 *
 * @experimental This plugin is experimental and may change without a major
@@ -38,6 +38,16 @@ function createCodeServerDevframe(options = {}) {
 		homepage,
 		description,
 		icon: "ph:code-duotone",
+		/**
+		* The whole surface proxies a live `code-server` process, so a static
+		* build would only produce a dead shell of the tool: `createBuild`
+		* refuses and a hub static build skips this dock.
+		*/
+		capabilities: { build: false },
+		/**
+		* Leave undefined so `resolveBasePath` picks `/` standalone and
+		* `/__<id>/` when hosted. Authors override via `options.basePath`.
+		*/
 		basePath: options.basePath,
 		cli: {
 			command: options.command ?? "devframe-code-server",
@@ -45,10 +55,15 @@ function createCodeServerDevframe(options = {}) {
 			portRange: options.portRange,
 			random: options.random,
 			distDir: resolvedDist,
+			/**
+			* Gate the standalone launcher by default; `maybeOpenBrowser` folds the
+			* current OTP into the `--open` URL so the tab lands already trusted.
+			* Hosted adapters supply their own auth layer and ignore this.
+			*/
 			auth: options.auth ?? true
 		},
 		async setup(ctx) {
-			const { setupCodeServer } = await import("./node/index.mjs");
+			const { setupCodeServer } = await import("./node/setup.mjs");
 			await setupCodeServer(ctx, options);
 		}
 	});

package/dist/{rpc-EXj5vBYf.mjs → rpc-Df9IRgPd.mjs}

@@ -44,7 +44,7 @@ function getCodeServerSupervisor(ctx) {
 	return supervisor;
 }
 //#endregion
-//#region src/rpc/functions/detect.ts
+//#region src/node/rpc/functions/detect.ts
 const detect = defineRpcFunction({
 	name: "devframes:plugin:code-server:detect",
 	type: "query",
@@ -56,7 +56,7 @@ const detect = defineRpcFunction({
 	setup: (ctx) => ({ handler: () => getCodeServerSupervisor(ctx).detect() })
 });
 //#endregion
-//#region src/rpc/functions/start.ts
+//#region src/node/rpc/functions/start.ts
 const start = defineRpcFunction({
 	name: "devframes:plugin:code-server:start",
 	type: "action",
@@ -68,7 +68,7 @@ const start = defineRpcFunction({
 	setup: (ctx) => ({ handler: (req = {}) => getCodeServerSupervisor(ctx).start(req) })
 });
 //#endregion
-//#region src/rpc/index.ts
+//#region src/node/rpc/index.ts
 const serverFunctions = [
 	detect,
 	defineRpcFunction({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/plugin-code-server",
   "type": "module",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "description": "Devframe plugin that runs VS Code in the browser as an embedded editor panel.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -21,17 +21,16 @@
   ],
   "sideEffects": false,
   "exports": {
-    ".": "./dist/index.mjs",
-    "./client": "./dist/client/index.mjs",
-    "./cli": "./dist/cli.mjs",
-    "./constants": "./dist/constants.mjs",
-    "./node": "./dist/node/index.mjs",
-    "./rpc": "./dist/rpc/index.mjs",
-    "./types": "./dist/types.mjs",
-    "./vite": "./dist/vite.mjs",
+    ".": "./dist/node/index.mjs",
+    "./cli": "./dist/node/cli.mjs",
+    "./constants": "./dist/node/constants.mjs",
+    "./node": "./dist/node/setup.mjs",
+    "./rpc": "./dist/node/rpc/index.mjs",
+    "./types": "./dist/node/types.mjs",
+    "./vite": "./dist/node/vite.mjs",
     "./package.json": "./package.json"
   },
-  "types": "./dist/index.d.mts",
+  "types": "./dist/node/index.d.mts",
   "bin": {
     "devframe-code-server": "./bin.mjs"
   },
@@ -40,8 +39,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/plugin-code-server--assets": "0.9.8",
-    "devframe": "0.9.8",
+    "@devframes/plugin-code-server--assets": "0.9.10",
+    "devframe": "0.9.10",
     "vite": "^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -53,19 +52,21 @@
     }
   },
   "dependencies": {
-    "@devframes/vite": "0.9.8",
+    "@devframes/vite": "0.9.10",
     "cac": "^7.0.0"
   },
   "devDependencies": {
     "@antfu/design": "^0.4.0",
-    "@devframes/plugin-code-server--assets": "0.9.8",
+    "@devframes/plugin-code-server--assets": "0.9.10",
     "@iconify-json/ph": "^1.2.2",
     "@storybook/addon-docs": "^10.5.10",
     "@storybook/vue3-vite": "^10.5.10",
     "@types/node": "^26.4.0",
     "@vitejs/plugin-vue": "^6.0.8",
     "colorjs.io": "^0.7.1",
-    "devframe": "0.9.8",
+    "devframe": "0.9.10",
+    "h3": "^2.0.1-rc.29",
+    "pathe": "^2.0.3",
     "storybook": "^10.5.10",
     "tsdown": "^0.22.14",
     "unocss": "^66.8.1",
@@ -74,12 +75,15 @@
     "vue": "^3.5.42"
   },
   "scripts": {
-    "build": "tsdown && vite build --config src/spa/vite.config.ts",
+    "build": "tsdown && vite build --config app/vite.config.ts",
+    "build:app": "vite build --config app/vite.config.ts",
     "watch": "tsdown --watch",
-    "typecheck": "tsc --noEmit",
-    "dev": "vite --config src/spa/vite.config.ts",
+    "dev": "vite --config app/vite.config.ts --host",
+    "play": "pnpm run build && node playgrounds/server.mjs",
     "storybook": "storybook dev -p 6013",
     "build-storybook": "storybook build",
+    "cli:build": "node bin.mjs build --out-dir dist/static",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run"
   }
 }

package/dist/client/index.d.mts

@@ -1,13 +0,0 @@
-import { CodeServerBackend, CodeServerConnect, CodeServerDetection, CodeServerLogin, CodeServerMode, CodeServerServerInfo, CodeServerSharedState, CodeServerStartResult, CodeServerStatus, CodeServerStatusResult } from "../types.mjs";
-import { o as STATE_KEY } from "../constants-DtQz38ex.mjs";
-import { DevframeConnectionStatus, DevframeRpcClient, DevframeRpcClientOptions } from "devframe/client";
-import { ConnectionMeta } from "devframe/types";
-//#region src/client/index.d.ts
-/**
- * Connect to the code-server plugin's devframe backend. A thin, typed wrapper
- * around devframe's {@link connectDevframe}; the SPA derives its base from
- * `document.baseURI`, so no options are required in the common case.
- */
-declare function connectCodeServer(options?: DevframeRpcClientOptions): Promise<DevframeRpcClient>;
-//#endregion
-export { type CodeServerBackend, type CodeServerConnect, type CodeServerDetection, type CodeServerLogin, type CodeServerMode, type CodeServerServerInfo, type CodeServerSharedState, type CodeServerStartResult, type CodeServerStatus, type CodeServerStatusResult, type ConnectionMeta, type DevframeConnectionStatus, type DevframeRpcClient, STATE_KEY, connectCodeServer };

package/dist/client/index.mjs

@@ -1,21 +0,0 @@
-import { connectDevframe } from "devframe/client";
-//#region src/constants.ts
-/**
-* Shared-state key holding the serializable, secret-free server status and
-* detection result. Authentication material is never published here — it is
-* returned only from the `start` / `status` RPCs to the already-authorized
-* client (see {@link import('./types').CodeServerConnect}).
-*/
-const STATE_KEY = "devframes:plugin:code-server:state";
-//#endregion
-//#region src/client/index.ts
-/**
-* Connect to the code-server plugin's devframe backend. A thin, typed wrapper
-* around devframe's {@link connectDevframe}; the SPA derives its base from
-* `document.baseURI`, so no options are required in the common case.
-*/
-function connectCodeServer(options) {
-	return connectDevframe(options);
-}
-//#endregion
-export { STATE_KEY, connectCodeServer };

package/dist/index.d.mts

@@ -1,23 +0,0 @@
-import { CodeServerBackend, CodeServerConnect, CodeServerDetection, CodeServerLogin, CodeServerMode, CodeServerOptions, CodeServerServerInfo, CodeServerSharedState, CodeServerStartRequest, CodeServerStartResult, CodeServerStatus, CodeServerStatusResult, CodeServerTunnelOptions } from "./types.mjs";
-import { i as PLUGIN_ID, l as getCookieSessionName, n as DEFAULT_PORT, o as STATE_KEY, t as DEFAULT_CODE_SERVER_PORT } from "./constants-DtQz38ex.mjs";
-import { DevframeDefinition } from "devframe";
-//#region src/index.d.ts
-/**
- * Build a {@link DevframeDefinition} for the code-server panel. The same
- * definition runs standalone (`createCac`), mounts into a Vite host
- * (`/vite`), or docks inside a hub — its `setup` only relies on the core
- * devframe RPC + shared-state surface.
- *
- * @experimental This plugin is experimental and may change without a major
- * version bump until it stabilizes.
- *
- * @example
- * ```ts
- * import { createCodeServerDevframe } from '@devframes/plugin-code-server'
- *
- * export default createCodeServerDevframe({ serverPort: 8080 })
- * ```
- */
-declare function createCodeServerDevframe(options?: CodeServerOptions): DevframeDefinition;
-//#endregion
-export { type CodeServerBackend, type CodeServerConnect, type CodeServerDetection, type CodeServerLogin, type CodeServerMode, type CodeServerOptions, type CodeServerServerInfo, type CodeServerSharedState, type CodeServerStartRequest, type CodeServerStartResult, type CodeServerStatus, type CodeServerStatusResult, type CodeServerTunnelOptions, DEFAULT_CODE_SERVER_PORT, DEFAULT_PORT, PLUGIN_ID, STATE_KEY, createCodeServerDevframe, createCodeServerDevframe as default, getCookieSessionName };

package/dist/index.mjs

@@ -1,3 +0,0 @@
-import { t as createCodeServerDevframe } from "./src-CNJYQ3UQ.mjs";
-import { DEFAULT_CODE_SERVER_PORT, DEFAULT_PORT, PLUGIN_ID, STATE_KEY, getCookieSessionName } from "./constants.mjs";
-export { DEFAULT_CODE_SERVER_PORT, DEFAULT_PORT, PLUGIN_ID, STATE_KEY, createCodeServerDevframe, createCodeServerDevframe as default, getCookieSessionName };

package/dist/rpc/index.mjs

@@ -1,2 +0,0 @@
-import { t as serverFunctions } from "../rpc-EXj5vBYf.mjs";
-export { serverFunctions };