@devframes/plugin-code-server 0.7.5 → 0.7.7

package/README.md

@@ -4,28 +4,37 @@
 > This plugin is experimental and may change without a major version bump until
 > it stabilizes.
 
-Run [code-server](https://github.com/coder/code-server) (VS Code in the
-browser) as a devframe panel. The plugin detects a local `code-server`
-install, launches it on demand, and embeds the editor in an
-auto-authenticated `<iframe>`.
+Run VS Code in the browser as a devframe panel. The plugin detects a local
+editor binary, launches it on demand, and embeds the editor in an
+auto-authenticated `<iframe>`. The launcher is a **Vue** SPA built on the shared
+`@antfu/design` system.
 
 ## How it works
 
-- **Detection** — on startup it runs `code-server --version`. When the binary
-  is missing, the launcher renders install instructions and links instead of a
+- **Detection** — on startup it probes the resolved binary with `--version`.
+  When none is found, the launcher renders install instructions instead of a
   launch button.
-- **Launch** — the launcher's button starts code-server as a managed child
+- **Launch** — the launcher's button starts the editor as a managed child
   process bound to a free port, scoped to the workspace. Readiness is probed
-  via code-server's `/healthz` endpoint.
-- **Auto-auth** — code-server runs with password auth. The plugin generates a
-  random token, sets `HASHED_PASSWORD` to its SHA-256, and hands the matching
-  session cookie back to the already-authorized devframe client. The launcher
-  applies that cookie for the current host before loading the iframe, so the
-  editor opens already signed in — no code-server login page.
+  before the iframe loads.
+- **Auto-auth** — the plugin generates fresh auth material per launch and hands
+  it to the already-authorized devframe client, so the editor opens already
+  signed in. `code-server` uses a session cookie (`HASHED_PASSWORD`);
+  `code serve-web` uses a connection token on the URL (`?tkn=`).
 
-The editor iframe points at code-server's own origin
-(`<protocol>//<host>:<port>/`), so WebSocket traffic flows directly without a
-reverse proxy.
+## Backends & modes
+
+`mode: 'local'` (default) embeds a server on this machine; `backend` selects it,
+or leave it unset to auto-detect (prefers `code-server`, then `code serve-web`).
+
+| `backend` | Binary | Auth |
+|-----------|--------|------|
+| `'code-server'` | Coder [`code-server`](https://github.com/coder/code-server) | password + session cookie |
+| `'ms-code-serve-web'` | Microsoft [`code serve-web`](https://code.visualstudio.com/docs/remote/vscode-server) | connection token (`?tkn=`) |
+
+`mode: 'tunnel'` runs Microsoft's `code tunnel` and embeds the hosted
+`vscode.dev` editor. The first launch surfaces a device-login prompt in the
+launcher; `vscode.dev` handles authentication.
 
 ## Usage
 
@@ -41,9 +50,12 @@ npx @devframes/plugin-code-server        # dev server + launcher
 import { createCodeServerDevframe } from '@devframes/plugin-code-server'
 
 export default createCodeServerDevframe({
-  // bin: 'code-server',     // binary to detect/launch (default: PATH)
-  // serverPort: 8080,       // force a port (default: free port near 8080)
-  // args: ['--disable-getting-started-override'],
+  // backend: 'code-server',    // 'code-server' | 'ms-code-serve-web' (default: auto)
+  // mode: 'local',             // 'local' | 'tunnel'
+  // serverPort: 8080,          // force a port (default: free port near 8080)
+  // startOnBoot: true,         // launch during setup instead of on demand
+  // reuseExistingServer: true, // adopt a server already answering on the port
+  // tunnel: { name: 'my-box' },
 })
 ```
 
@@ -61,24 +73,25 @@ export default {
 
 | Function | Type | Purpose |
 |----------|------|---------|
-| `devframes:plugin:code-server:detect` | query | Re-probe for the binary; returns `{ installed, version, bin }`. |
-| `devframes:plugin:code-server:status` | query | Current status + auth cookie when running. |
+| `devframes:plugin:code-server:detect` | query | Re-probe; returns `{ installed, version, bin, backend, mode }`. |
+| `devframes:plugin:code-server:status` | query | Current status + connect descriptor when running. |
 | `devframes:plugin:code-server:start` | action | Launch and wait for readiness. |
 | `devframes:plugin:code-server:stop` | action | Stop the process. |
 
-Status (minus the auth cookie) is mirrored into the
+Status (minus the connect descriptor) is mirrored into the
 `devframes:plugin:code-server:state` shared state for reactive UIs.
 
 ## UI
 
-The launcher UI is a pure, state-driven view (`src/client/view.ts`) decoupled
-from RPC, so every state renders in isolation. `mountCodeServer` wires the live
-connection to it. Each UI state has a Storybook story:
+The launcher is a Vue SPA (`src/spa`). `LauncherView.vue` is a pure,
+state-driven view decoupled from RPC — every phase renders in isolation and has
+a Storybook story; `App.vue` wires the live connection to it and mounts the
+editor in a full-bleed, auto-authenticated iframe (`EditorFrame.vue`).
 
 ```sh
 pnpm storybook         # dev
 pnpm build-storybook   # static build
 ```
 
-Stories: connecting, not-installed, launch, launch-error, starting, running
-(the running story mounts a mock editor instead of a live server).
+Stories: connecting, not-installed, launch, launch (serve-web), launch-error,
+starting, tunnel-login, and a running editor frame (mock editor).

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { n as createCodeServerDevframe } from "./src-CjjdHGFH.mjs";
+import { n as createCodeServerDevframe } from "./src-BrJNMY5c.mjs";
 import { createCac } from "devframe/adapters/cac";
 //#region src/cli.ts
 /**

package/dist/client/index.d.mts

@@ -1,74 +1,12 @@
-import { CodeServerAuth, CodeServerDetection, CodeServerServerInfo, CodeServerSharedState, CodeServerStatus } from "../types.mjs";
-import { o as STATE_KEY } from "../constants-DZKOXnxd.mjs";
-import { DevframeRpcClient } from "devframe/client";
-//#region src/client/view.d.ts
-/** The data the view renders from. Pure — no RPC, no process knowledge. */
-interface CodeServerViewState {
-  detection: CodeServerDetection;
-  server: CodeServerServerInfo;
-  /** Auth handoff; present only once the editor is reachable. */
-  auth?: CodeServerAuth;
-  /** A request (launch / re-check) is in flight. */
-  busy?: boolean;
-}
-/** User intents the view surfaces. */
-interface CodeServerViewActions {
-  launch: () => void;
-  recheck: () => void;
-}
-interface CodeServerViewOptions {
-  actions?: Partial<CodeServerViewActions>;
-  /**
-   * Build the editor iframe URL from the running port. Defaults to the
-   * current page host so the cookie set on this origin reaches the iframe.
-   */
-  resolveEditorUrl?: (port: number) => string;
-  /**
-   * Apply code-server's session cookie before the iframe loads. Defaults to
-   * `document.cookie`. Storybook overrides this to a no-op.
-   */
-  applyAuth?: (auth: CodeServerAuth) => void;
-}
-/** Discrete UI states, one per Storybook story. */
-type CodeServerPhase = 'connecting' | 'not-installed' | 'launch' | 'starting' | 'running';
-interface CodeServerViewHandle {
-  /** Re-render from a new state (cheap; reuses the live iframe when unchanged). */
-  update: (state: CodeServerViewState) => void;
-  dispose: () => void;
-}
-/** Map a state to its discrete UI phase. */
-declare function resolvePhase(state: CodeServerViewState): CodeServerPhase;
-/**
- * Create the code-server launcher view inside `container`. The view is a pure
- * function of {@link CodeServerViewState}: callers (the SPA via
- * `mountCodeServer`, or Storybook) push state with `update()` and wire intent
- * through `options.actions`. It performs no RPC and owns no process state, so
- * every UI phase can be rendered in isolation.
- */
-declare function createCodeServerView(container: HTMLElement, options?: CodeServerViewOptions): CodeServerViewHandle;
-//#endregion
+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";
 //#region src/client/index.d.ts
-interface MountCodeServerOptions {
-  /** Pre-connected client. When omitted, `connectDevframe()` is awaited. */
-  rpc?: DevframeRpcClient;
-}
-interface CodeServerHandle {
-  rpc: DevframeRpcClient;
-  /** Stop the code-server process (no UI control is rendered over the editor). */
-  stop: () => Promise<void>;
-  dispose: () => void;
-}
 /**
- * Mount the code-server launcher into `container`. Connects to the devframe
- * backend, then drives a {@link createCodeServerView} from the live
- * detection/server state: install instructions when the binary is missing, a
- * launch screen when stopped, a progress state while starting, and the editor
- * in a full-bleed, auto-authenticated iframe once running.
- *
- * The connection is assumed already authorized with devframe's auth, so the
- * server-issued session cookie is applied transparently before the iframe
- * loads — the user never sees code-server's login page.
+ * 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 mountCodeServer(container: HTMLElement, options?: MountCodeServerOptions): Promise<CodeServerHandle>;
+declare function connectCodeServer(options?: DevframeRpcClientOptions): Promise<DevframeRpcClient>;
 //#endregion
-export { CodeServerHandle, type CodeServerPhase, type CodeServerServerInfo, type CodeServerSharedState, type CodeServerStatus, type CodeServerViewActions, type CodeServerViewHandle, type CodeServerViewOptions, type CodeServerViewState, MountCodeServerOptions, STATE_KEY, createCodeServerView, mountCodeServer, resolvePhase };
+export { type CodeServerBackend, type CodeServerConnect, type CodeServerDetection, type CodeServerLogin, type CodeServerMode, type CodeServerServerInfo, type CodeServerSharedState, type CodeServerStartResult, type CodeServerStatus, type CodeServerStatusResult, type DevframeConnectionStatus, type DevframeRpcClient, STATE_KEY, connectCodeServer };

package/dist/client/index.mjs

@@ -1,445 +1,21 @@
 import { connectDevframe } from "devframe/client";
-import { createIframePanes } from "iframe-pane";
 //#region src/constants.ts
 /**
 * Shared-state key holding the serializable, secret-free server status and
-* detection result. The authentication cookie is never published here — it
-* is returned only from the `start` / `status` RPCs to the already-authorized
-* client (see {@link CodeServerAuth}).
+* 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/design.ts
-function cx(...parts) {
-	return parts.filter(Boolean).join(" ");
-}
-function button({ variant = "primary", size = "md", class: extra } = {}) {
-	const variantClass = {
-		primary: "btn-primary",
-		secondary: "btn-action",
-		outline: "btn-action",
-		ghost: "inline-flex items-center justify-center gap-1.5 rounded px2 py1 op75 hover:op100 hover:bg-active transition disabled:pointer-events-none disabled:op30!",
-		destructive: "btn-action text-error border-error/30!",
-		link: "inline-flex items-center gap-1.5 color-active hover:underline underline-offset-2"
-	};
-	const sizeClass = size === "sm" ? variant === "primary" ? "text-sm px-2.5! py-1!" : "text-sm" : size === "lg" ? "text-base px-4! py-2!" : "";
-	return cx(variantClass[variant], sizeClass, extra);
-}
-function link(extra) {
-	return cx("color-active hover:underline underline-offset-2", extra);
-}
-function spinner(extra) {
-	return cx("inline-block size-4 rounded-full border-2 border-current border-t-transparent animate-spin", extra);
-}
-//#endregion
-//#region src/client/connection-state.ts
-const COPY = {
-	connecting: {
-		icon: "i-ph-plugs-connected-duotone",
-		title: "Connecting…",
-		body: "Establishing a connection to the devframe server."
-	},
-	disconnected: {
-		icon: "i-ph-plugs-duotone",
-		title: "Disconnected",
-		body: "Lost the connection to the devframe server. Reload once it is back up."
-	},
-	unauthorized: {
-		icon: "i-ph-lock-key-duotone",
-		title: "Not authorized",
-		body: "Reopen the link printed by your dev server, then reload."
-	},
-	error: {
-		icon: "i-ph-warning-octagon-duotone",
-		title: "Connection failed",
-		body: "Could not reach the devframe server."
-	}
-};
-/**
-* A full-container connection state, shown whenever the devframe client isn't
-* `connected` so the launcher never sits on an unexplained blank while the
-* socket is down. Reload is the recovery path (no auto-reconnect).
-*/
-function createConnectionState(container) {
-	const root = document.createElement("div");
-	root.className = "absolute inset-0 flex flex-col items-center justify-center gap-4 bg-base color-base p-8 text-center z-nav";
-	root.hidden = true;
-	container.append(root);
-	function update(status, error) {
-		if (status === "connected") {
-			root.hidden = true;
-			root.replaceChildren();
-			return false;
-		}
-		const copy = COPY[status];
-		root.replaceChildren();
-		const glyph = document.createElement("div");
-		glyph.className = cx(copy.icon, "text-4xl color-active");
-		root.append(glyph);
-		const text = document.createElement("div");
-		text.className = "flex flex-col gap-1";
-		const title = document.createElement("p");
-		title.className = "text-lg font-medium";
-		title.textContent = copy.title;
-		const body = document.createElement("p");
-		body.className = "text-sm color-muted max-w-sm";
-		body.textContent = copy.body;
-		text.append(title, body);
-		if (error && status === "error") {
-			const code = document.createElement("code");
-			code.className = "mt-1 max-w-sm break-words font-mono text-xs color-faint";
-			code.textContent = error;
-			text.append(code);
-		}
-		root.append(text);
-		if (status !== "connecting") {
-			const reload = document.createElement("button");
-			reload.type = "button";
-			reload.className = button({
-				variant: "primary",
-				size: "sm"
-			});
-			reload.textContent = "Reload";
-			reload.addEventListener("click", () => location.reload());
-			root.append(reload);
-		}
-		root.hidden = false;
-		return true;
-	}
-	return {
-		update,
-		dispose() {
-			root.remove();
-		}
-	};
-}
-//#endregion
-//#region src/client/view.ts
-const DOCS_URL = "https://coder.com/docs/code-server/latest/install";
-const REPO_URL = "https://github.com/coder/code-server";
-const panes = createIframePanes();
-let paneCounter = 0;
-const INSTALL_COMMANDS = [
-	{
-		label: "Install script (Linux / macOS)",
-		command: "curl -fsSL https://code-server.dev/install.sh | sh"
-	},
-	{
-		label: "npm",
-		command: "npm install -g code-server"
-	},
-	{
-		label: "Homebrew",
-		command: "brew install code-server"
-	}
-];
-/** Map a state to its discrete UI phase. */
-function resolvePhase(state) {
-	const { detection, server, auth, busy } = state;
-	if (server.status === "running" && server.port != null) return auth ? "running" : "starting";
-	if (server.status === "starting" || busy && server.status !== "error") return "starting";
-	if (!detection.checked) return "connecting";
-	if (!detection.installed) return "not-installed";
-	return "launch";
-}
-function el(tag, className, text) {
-	const node = document.createElement(tag);
-	if (className) node.className = className;
-	if (text != null) node.textContent = text;
-	return node;
-}
-/** A Phosphor icon (UnoCSS presetIcons), matching the other devframe plugins. */
-function icon(name, cls = "") {
-	return el("span", cx(name, "shrink-0", cls));
-}
-/** The uppercase "code-server" eyebrow, prefixed with the brand icon. */
-function eyebrow() {
-	const p = el("p", "flex items-center gap-1.5 mb-2.5 text-xs tracking-wider uppercase color-muted");
-	p.append(icon("i-ph-code-duotone", "text-sm"), document.createTextNode("code-server"));
-	return p;
-}
-function defaultEditorUrl(port) {
-	return `${location.protocol}//${location.hostname}:${port}/`;
-}
-function defaultApplyAuth(auth) {
-	document.cookie = `${auth.cookieName}=${auth.cookieValue}; path=/; SameSite=Lax`;
-}
-/**
-* Create the code-server launcher view inside `container`. The view is a pure
-* function of {@link CodeServerViewState}: callers (the SPA via
-* `mountCodeServer`, or Storybook) push state with `update()` and wire intent
-* through `options.actions`. It performs no RPC and owns no process state, so
-* every UI phase can be rendered in isolation.
-*/
-function createCodeServerView(container, options = {}) {
-	const resolveEditorUrl = options.resolveEditorUrl ?? defaultEditorUrl;
-	const applyAuth = options.applyAuth ?? defaultApplyAuth;
-	const launch = () => options.actions?.launch?.();
-	const recheck = () => options.actions?.recheck?.();
-	const root = el("div", "absolute inset-0 flex flex-col of-hidden bg-base color-base font-sans");
-	container.append(root);
-	const paneId = `code-server-editor-${++paneCounter}`;
-	const editorTarget = el("div", "dcs-frame flex-1 w-full");
-	let editorUrl = null;
-	function shell(...children) {
-		panes.get(paneId)?.unmount();
-		editorUrl = null;
-		const center = el("div", "flex-1 flex items-center justify-center p-6");
-		const card = el("div", "w-full max-w-[560px]");
-		card.append(...children);
-		center.append(card);
-		root.replaceChildren(center);
-	}
-	function renderConnecting() {
-		const wrap = el("div", "flex items-center gap-2.5");
-		wrap.append(el("div", spinner("color-muted")), el("span", "text-sm color-muted", "Connecting to devframe…"));
-		shell(wrap);
-	}
-	function renderNotInstalled(busy) {
-		const nodes = [];
-		nodes.push(eyebrow());
-		nodes.push(el("h1", "mb-2 text-[1.35rem] font-semibold", "code-server is not installed"));
-		nodes.push(el("p", "mb-5 text-sm leading-relaxed color-muted", "Install code-server (VS Code in the browser) to open the editor here. Pick whichever fits your setup, then re-check."));
-		const install = el("div", "flex flex-col gap-3 mb-5");
-		for (const { label, command } of INSTALL_COMMANDS) {
-			const row = el("div");
-			row.append(el("label", "block mb-1 text-xs color-muted", label));
-			const cmd = el("div", "flex items-center gap-2 px-2.5 py-2 rounded-md border border-base bg-secondary");
-			cmd.append(el("code", "flex-1 of-x-auto whitespace-nowrap font-mono text-xs color-base", command));
-			const copy = el("button", button({
-				variant: "outline",
-				size: "sm",
-				class: "shrink-0 text-[11px]"
-			}), "Copy");
-			copy.onclick = () => {
-				navigator.clipboard?.writeText(command).then(() => {
-					copy.textContent = "Copied";
-					setTimeout(() => {
-						copy.textContent = "Copy";
-					}, 1200);
-				}).catch(() => {});
-			};
-			cmd.append(copy);
-			row.append(cmd);
-			install.append(row);
-		}
-		nodes.push(install);
-		const actions = el("div", "flex flex-wrap items-center gap-2.5");
-		const recheckBtn = el("button", button({ variant: "primary" }));
-		recheckBtn.append(icon("i-ph-arrows-clockwise", cx("size-4", busy && "animate-spin")), document.createTextNode(busy ? "Checking…" : "Re-check"));
-		recheckBtn.disabled = busy;
-		recheckBtn.onclick = recheck;
-		actions.append(recheckBtn);
-		actions.append(link$1("Installation docs", DOCS_URL));
-		actions.append(link$1("GitHub", REPO_URL));
-		nodes.push(actions);
-		shell(...nodes);
-	}
-	function renderLaunch(state) {
-		const { detection, server, busy } = state;
-		const nodes = [];
-		nodes.push(eyebrow());
-		nodes.push(el("h1", "mb-2 text-[1.35rem] font-semibold", "Launch the editor"));
-		nodes.push(el("p", "mb-5 text-sm leading-relaxed color-muted", "Start a code-server instance scoped to this workspace and open VS Code right here. The server runs with a generated password and the editor is signed in automatically."));
-		if (server.status === "error" && server.error) nodes.push(el("div", "mb-4 px-3 py-2.5 rounded-md border border-error/35 bg-error/10 text-error text-sm whitespace-pre-wrap break-words", server.error));
-		const meta = el("div", "flex flex-wrap gap-x-4 gap-y-1.5 mb-5 text-xs color-muted");
-		if (detection.version) {
-			const v = el("span");
-			v.append(document.createTextNode("version "), el("code", "font-mono color-base", detection.version));
-			meta.append(v);
-		}
-		const b = el("span");
-		b.append(document.createTextNode("binary "), el("code", "font-mono color-base", detection.bin));
-		meta.append(b);
-		nodes.push(meta);
-		const actions = el("div", "flex flex-wrap items-center gap-2.5");
-		const launchBtn = el("button", button({ variant: "primary" }));
-		if (busy) launchBtn.append(el("span", spinner()), document.createTextNode("Starting…"));
-		else launchBtn.append(icon("i-ph-rocket-launch-duotone", "size-4"), document.createTextNode("Launch code-server"));
-		launchBtn.disabled = busy ?? false;
-		launchBtn.onclick = launch;
-		actions.append(launchBtn);
-		nodes.push(actions);
-		shell(...nodes);
-	}
-	function renderStarting() {
-		const wrap = el("div", "flex items-center gap-2.5");
-		wrap.append(el("div", spinner("color-muted")), el("span", "text-sm color-muted", "Starting code-server…"));
-		shell(wrap);
-	}
-	function renderRunning(state) {
-		const url = resolveEditorUrl(state.server.port);
-		if (editorUrl !== url) {
-			if (state.auth) applyAuth(state.auth);
-			editorUrl = url;
-		}
-		const pane = panes.ensure(paneId, {
-			src: url,
-			attrs: { allow: "clipboard-read; clipboard-write; cross-origin-isolated" },
-			style: { border: "0" }
-		});
-		if (pane.iframe.src !== url) pane.iframe.src = url;
-		if (root.firstElementChild !== editorTarget) root.replaceChildren(editorTarget);
-		pane.mount(editorTarget);
-	}
-	function link$1(text, href) {
-		const a = el("a", link("inline-flex items-center gap-1 text-sm"));
-		a.append(document.createTextNode(text), icon("i-ph-arrow-square-out", "size-3.5"));
-		a.href = href;
-		a.target = "_blank";
-		a.rel = "noreferrer";
-		return a;
-	}
-	function update(state) {
-		switch (resolvePhase(state)) {
-			case "running":
-				renderRunning(state);
-				break;
-			case "starting":
-				renderStarting();
-				break;
-			case "connecting":
-				renderConnecting();
-				break;
-			case "not-installed":
-				renderNotInstalled(state.busy ?? false);
-				break;
-			case "launch":
-				renderLaunch(state);
-				break;
-		}
-	}
-	return {
-		update,
-		dispose() {
-			panes.get(paneId)?.dispose();
-			root.remove();
-		}
-	};
-}
-//#endregion
 //#region src/client/index.ts
 /**
-* Mount the code-server launcher into `container`. Connects to the devframe
-* backend, then drives a {@link createCodeServerView} from the live
-* detection/server state: install instructions when the binary is missing, a
-* launch screen when stopped, a progress state while starting, and the editor
-* in a full-bleed, auto-authenticated iframe once running.
-*
-* The connection is assumed already authorized with devframe's auth, so the
-* server-issued session cookie is applied transparently before the iframe
-* loads — the user never sees code-server's login page.
+* 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.
 */
-async function mountCodeServer(container, options = {}) {
-	const rpc = options.rpc ?? await connectDevframe();
-	if (rpc.connectionMeta.backend === "websocket") await rpc.ensureTrusted(5e3).catch(() => {});
-	if (!container.style.position) container.style.position = "relative";
-	const connectionState = createConnectionState(container);
-	const syncConnection = () => {
-		connectionState.update(rpc.status, rpc.connectionError?.message);
-	};
-	syncConnection();
-	const offConnection = rpc.events.on("connection:status", syncConnection);
-	let detection = {
-		checked: false,
-		installed: false,
-		bin: "code-server"
-	};
-	let server = { status: "stopped" };
-	let auth;
-	let busy = false;
-	let disposed = false;
-	const view = createCodeServerView(container, { actions: {
-		launch,
-		recheck
-	} });
-	function sync() {
-		if (disposed) return;
-		view.update({
-			detection,
-			server,
-			auth,
-			busy
-		});
-	}
-	function applyResult(result) {
-		detection = result.detection;
-		server = result.server;
-		if (result.auth) auth = result.auth;
-	}
-	async function call(method, ...args) {
-		try {
-			return await rpc.call(method, ...args);
-		} catch (error) {
-			server = {
-				status: "error",
-				error: error instanceof Error ? error.message : String(error)
-			};
-			return;
-		}
-	}
-	async function launch() {
-		if (busy) return;
-		busy = true;
-		sync();
-		const result = await call("devframes:plugin:code-server:start", {});
-		if (result) applyResult(result);
-		busy = false;
-		sync();
-	}
-	async function stop() {
-		if (busy) return;
-		busy = true;
-		sync();
-		const result = await call("devframes:plugin:code-server:stop");
-		if (result) applyResult(result);
-		auth = void 0;
-		busy = false;
-		sync();
-	}
-	async function recheck() {
-		if (busy) return;
-		busy = true;
-		sync();
-		await call("devframes:plugin:code-server:detect");
-		busy = false;
-		sync();
-	}
-	sync();
-	const initial = await call("devframes:plugin:code-server:status");
-	if (initial) applyResult(initial);
-	sync();
-	const state = await rpc.sharedState.get(STATE_KEY, { initialValue: {
-		detection,
-		server
-	} });
-	const current = state.value();
-	detection = current.detection ?? detection;
-	server = current.server ?? server;
-	const off = state.on("updated", (full) => {
-		detection = full.detection ?? detection;
-		server = full.server ?? server;
-		if (server.status === "running" && !auth) {
-			call("devframes:plugin:code-server:status").then((result) => {
-				if (result?.auth) auth = result.auth;
-				sync();
-			});
-			return;
-		}
-		sync();
-	});
-	sync();
-	return {
-		rpc,
-		stop,
-		dispose() {
-			disposed = true;
-			off?.();
-			offConnection?.();
-			connectionState.dispose();
-			view.dispose();
-		}
-	};
+function connectCodeServer(options) {
+	return connectDevframe(options);
 }
 //#endregion
-export { STATE_KEY, createCodeServerView, mountCodeServer, resolvePhase };
+export { STATE_KEY, connectCodeServer };

package/dist/{constants-DZKOXnxd.d.mts → constants-DtQz38ex.d.mts}

@@ -3,16 +3,16 @@
 declare const PLUGIN_ID = "devframes_plugin_code-server";
 /**
  * Shared-state key holding the serializable, secret-free server status and
- * detection result. The authentication cookie is never published here — it
- * is returned only from the `start` / `status` RPCs to the already-authorized
- * client (see {@link CodeServerAuth}).
+ * 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}).
  */
 declare const STATE_KEY = "devframes:plugin:code-server:state";
 /** Default dev-server port for the plugin's own launcher SPA (standalone CLI). */
 declare const DEFAULT_PORT = 9013;
-/** Preferred port for the spawned code-server process (falls back if taken). */
+/** Preferred port for the spawned editor process (falls back if taken). */
 declare const DEFAULT_CODE_SERVER_PORT = 8080;
-/** How long to wait for code-server to answer its `/healthz` probe. */
+/** How long to wait for the editor to answer its readiness probe. */
 declare const DEFAULT_START_TIMEOUT = 30000;
 /** code-server's session cookie base name (see `getCookieSessionName`). */
 declare const SESSION_COOKIE_BASE = "code-server-session";