@devframes/plugin-code-server 0.9.11 → 0.9.15

package/dist/node/cli.d.mts

@@ -6,6 +6,5 @@ import { CacHandle, CreateCacOptions } from "devframe/adapters/cac";
  * `mcp` subcommands, backed by {@link createCodeServerDevframe}. Used by the package
  * `bin` (`devframe-code-server`).
  */
-declare function createCodeServerCli(options?: CodeServerOptions, cliOptions?: CreateCacOptions): CacHandle;
-//#endregion
-export { createCodeServerCli };
+export declare function createCodeServerCli(options?: CodeServerOptions, cliOptions?: CreateCacOptions): CacHandle;
+//#endregion

package/dist/node/cli.mjs

@@ -1,4 +1,4 @@
-import { t as createCodeServerDevframe } from "../node-DTJ1PTi5.mjs";
+import { t as createCodeServerDevframe } from "../node-BSnbBCzY.mjs";
 import { createCac } from "devframe/adapters/cac";
 //#region src/node/cli.ts
 /**

package/dist/node/index.d.mts

@@ -18,6 +18,6 @@ import { DevframeDefinition } from "devframe";
  * export default createCodeServerDevframe({ serverPort: 8080 })
  * ```
  */
-declare function createCodeServerDevframe(options?: CodeServerOptions): DevframeDefinition;
+export 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 };
+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 as default, getCookieSessionName };

package/dist/node/index.mjs

@@ -1,3 +1,3 @@
-import { t as createCodeServerDevframe } from "../node-DTJ1PTi5.mjs";
+import { t as createCodeServerDevframe } from "../node-BSnbBCzY.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/node/rpc/index.d.mts

@@ -2,7 +2,7 @@ import { CodeServerDetection, CodeServerSharedState, CodeServerStartRequest, Cod
 import "../index.mjs";
 import { RpcDefinitionsToFunctions } from "devframe/rpc";
 //#region src/node/rpc/index.d.ts
-declare const serverFunctions: readonly [{
+export declare const serverFunctions: readonly [{
   name: "devframes:plugin:code-server:detect";
   type?: "query" | undefined;
   cacheable?: boolean;
@@ -65,5 +65,4 @@ declare module 'devframe' {
     'devframes:plugin:code-server:state': CodeServerSharedState;
   }
 }
-//#endregion
-export { serverFunctions };
+//#endregion

package/dist/node/setup.d.mts

@@ -12,7 +12,7 @@ import { DevframeNodeContext } from "devframe";
  *
  * Depends only on the core devframe context (shared state), not on the hub.
  */
-declare class CodeServerSupervisor {
+export declare class CodeServerSupervisor {
   private readonly ctx;
   private readonly mode;
   private readonly explicitBackend?;
@@ -60,6 +60,13 @@ declare class CodeServerSupervisor {
   detect(): Promise<CodeServerDetection>;
   /** Current status (+ connect info when running) for the launcher UI. */
   status(): CodeServerStatusResult;
+  /**
+   * The server info projected to clients and shared state, tagged with the
+   * live hub terminal session id when one exists so the launcher can offer a
+   * "view in terminal" jump. Standalone runtimes hold no session and leave it
+   * undefined.
+   */
+  private serverInfo;
   /**
    * Launch the editor (if not already up) and resolve once it is reachable.
    * Idempotent while starting/running; returns the live status instead of
@@ -70,7 +77,11 @@ declare class CodeServerSupervisor {
   start(req?: CodeServerStartRequest): Promise<CodeServerStartResult>;
   /** Adopt an already-running local server on the target port, if one answers. */
   private tryAdopt;
-  /** Resolve the port to launch on: 0 for tunnels/dynamic, a forced port, or a free one. */
+  /**
+   * Resolve the port to launch on: 0 for tunnels/dynamic launches, otherwise a
+   * free port starting from the forced port (if any) or the default -
+   * verified free before it's ever handed to the editor binary's `--port`.
+   */
   private resolveInitialPort;
   /** The child's environment: inherited env, caller overrides, then profile shaping. */
   private buildLaunchEnv;
@@ -186,11 +197,11 @@ interface CodeServerProfile {
   }) => CodeServerConnect;
 }
 /** Resolve the launch profile for a mode + backend. */
-declare function resolveProfile(mode: CodeServerMode, backend: CodeServerBackend): CodeServerProfile;
+export declare function resolveProfile(mode: CodeServerMode, backend: CodeServerBackend): CodeServerProfile;
 //#endregion
 //#region src/node/context.d.ts
-declare function setCodeServerSupervisor(ctx: DevframeNodeContext, supervisor: CodeServerSupervisor): void;
-declare function getCodeServerSupervisor(ctx: DevframeNodeContext): CodeServerSupervisor;
+export declare function setCodeServerSupervisor(ctx: DevframeNodeContext, supervisor: CodeServerSupervisor): void;
+export declare function getCodeServerSupervisor(ctx: DevframeNodeContext): CodeServerSupervisor;
 //#endregion
 //#region src/node/detect.d.ts
 interface DetectCodeServerResult {
@@ -210,7 +221,7 @@ interface DetectCodeServerResult {
  * noise (e.g. an `i18next: …` initialization line printed before the version)
  * from leaking into the reported version.
  */
-declare function detectCodeServer(bin?: string, timeoutMs?: number): Promise<DetectCodeServerResult>;
+export declare function detectCodeServer(bin?: string, timeoutMs?: number): Promise<DetectCodeServerResult>;
 //#endregion
 //#region ../../node_modules/.pnpm/nostics@1.2.0/node_modules/nostics/dist/diagnostic-wduO7saY.d.mts
 //#region src/utils.d.ts
@@ -446,7 +457,7 @@ type ExtractReportersOptions<Reporters extends readonly any[]> = Reporters exten
  * `DP_CODE_SERVER_` prefix per the built-in plugin convention, keeping it
  * collision-free with devframe core (`DF`) and the hub (`DF8xxx`).
  */
-declare const diagnostics: Diagnostics<{
+export declare const diagnostics: Diagnostics<{
   readonly DP_CODE_SERVER_0001: {
     readonly why: (p: {
       bin: string;
@@ -496,6 +507,6 @@ declare const diagnostics: Diagnostics<{
  * Works in any devframe runtime (CLI, Vite, embedded, build), since it only relies
  * on the core `ctx.rpc` shared-state surface, not on the hub.
  */
-declare function setupCodeServer(ctx: DevframeNodeContext, options?: CodeServerOptions): Promise<CodeServerSupervisor>;
+export declare function setupCodeServer(ctx: DevframeNodeContext, options?: CodeServerOptions): Promise<CodeServerSupervisor>;
 //#endregion
-export { type CodeServerProfile, type CodeServerProfileKind, CodeServerSupervisor, detectCodeServer, diagnostics, getCodeServerSupervisor, resolveProfile, setCodeServerSupervisor, setupCodeServer };
+export type { CodeServerProfile, CodeServerProfileKind };

package/dist/node/setup.mjs

@@ -321,11 +321,23 @@ var CodeServerSupervisor = class {
 	status() {
 		return {
 			detection: { ...this.detection },
-			server: { ...this.server },
+			server: this.serverInfo(),
 			connect: this.connectInfo()
 		};
 	}
 	/**
+	* The server info projected to clients and shared state, tagged with the
+	* live hub terminal session id when one exists so the launcher can offer a
+	* "view in terminal" jump. Standalone runtimes hold no session and leave it
+	* undefined.
+	*/
+	serverInfo() {
+		return this.session ? {
+			...this.server,
+			terminalSessionId: this.sessionId
+		} : { ...this.server };
+	}
+	/**
 	* Launch the editor (if not already up) and resolve once it is reachable.
 	* Idempotent while starting/running; returns the live status instead of
 	* spawning a second process. In tunnel mode it resolves as soon as either
@@ -401,14 +413,16 @@ var CodeServerSupervisor = class {
 		this.publish();
 		return this.status();
 	}
-	/** Resolve the port to launch on: 0 for tunnels/dynamic, a forced port, or a free one. */
+	/**
+	* Resolve the port to launch on: 0 for tunnels/dynamic launches, otherwise a
+	* free port starting from the forced port (if any) or the default -
+	* verified free before it's ever handed to the editor binary's `--port`.
+	*/
 	async resolveInitialPort(isLocal) {
-		if (!isLocal) return 0;
-		if (this.forcedPort !== void 0 && this.forcedPort !== 0) return this.forcedPort;
-		if (this.forcedPort === 0) return 0;
+		if (!isLocal || this.forcedPort === 0) return 0;
 		return getPort({
 			host: "127.0.0.1",
-			port: DEFAULT_CODE_SERVER_PORT
+			port: this.forcedPort ?? 8080
 		});
 	}
 	/** The child's environment: inherited env, caller overrides, then profile shaping. */
@@ -731,7 +745,7 @@ var CodeServerSupervisor = class {
 	publish() {
 		this.state?.mutate((draft) => {
 			draft.detection = { ...this.detection };
-			draft.server = { ...this.server };
+			draft.server = this.serverInfo();
 		});
 	}
 	/**

package/dist/node/types.d.mts

@@ -1,6 +1,6 @@
 //#region src/node/types.d.ts
 /** Lifecycle state of the managed editor process. */
-type CodeServerStatus = 'stopped' | 'starting' | 'running' | 'error';
+export type CodeServerStatus = 'stopped' | 'starting' | 'running' | 'error';
 /**
  * Which editor server binary the plugin launches in `mode: 'local'`:
  *
@@ -13,7 +13,7 @@ type CodeServerStatus = 'stopped' | 'starting' | 'running' | 'error';
  *   (ships with the `code` CLI). The plugin generates a connection token and
  *   hands it to the client as a `?tkn=` query parameter.
  */
-type CodeServerBackend = 'code-server' | 'ms-code-serve-web';
+export type CodeServerBackend = 'code-server' | 'ms-code-serve-web';
 /**
  * How the editor is served:
  *
@@ -24,13 +24,13 @@ type CodeServerBackend = 'code-server' | 'ms-code-serve-web';
  *   prompt (surfaced as {@link CodeServerLogin}); authentication is handled by
  *   `vscode.dev` itself, not this plugin.
  */
-type CodeServerMode = 'local' | 'tunnel';
+export type CodeServerMode = 'local' | 'tunnel';
 /**
  * Result of probing the host for a usable editor binary. Drives the launcher
  * UI: when `installed` is false the SPA renders install instructions instead of
  * a launch button.
  */
-interface CodeServerDetection {
+export interface CodeServerDetection {
   /** Whether detection has run at least once on this context. */
   checked: boolean;
   /** Whether the resolved binary reported a version. */
@@ -48,14 +48,14 @@ interface CodeServerDetection {
  * A device-login prompt emitted by `code tunnel` on first launch. Surfaced to
  * the client so the user can complete authentication in their browser.
  */
-interface CodeServerLogin {
+export interface CodeServerLogin {
   /** The verification URL to open (e.g. `https://github.com/login/device`). */
   url: string;
   /** The one-time code to enter there. */
   code: string;
 }
 /** Serializable, secret-free description of the editor process. */
-interface CodeServerServerInfo {
+export interface CodeServerServerInfo {
   status: CodeServerStatus;
   /** Port the local server is bound to, when starting/running. */
   port?: number;
@@ -67,12 +67,20 @@ interface CodeServerServerInfo {
   error?: string;
   /** Device-login prompt while a tunnel is authenticating. */
   login?: CodeServerLogin;
+  /**
+   * Id of the hub terminal session mirroring this process, present only when
+   * the editor was launched through the hub's terminals subsystem
+   * (`ctx.terminals`). The launcher uses it to jump the user to that session
+   * in the terminals dock via `hub:docks:activate`; standalone runtimes have
+   * no hub session and leave it undefined.
+   */
+  terminalSessionId?: string;
 }
 /**
  * The full shared-state payload broadcast to subscribed clients. Deliberately
  * carries no authentication material; see {@link CodeServerConnect}.
  */
-interface CodeServerSharedState {
+export interface CodeServerSharedState {
   detection: CodeServerDetection;
   server: CodeServerServerInfo;
 }
@@ -87,7 +95,7 @@ interface CodeServerSharedState {
  *   `cookie` is present, sets it (cookies are port-agnostic, so a cookie set on
  *   the launcher's origin reaches the editor on its own port) before loading.
  */
-interface CodeServerConnect {
+export interface CodeServerConnect {
   /** Absolute URL to embed. When set, used verbatim (tunnel mode). */
   url?: string;
   /** Path + query to open relative to the editor origin (local mode). */
@@ -99,18 +107,18 @@ interface CodeServerConnect {
   };
 }
 /** Result of the `status` query: shared state plus connect info when running. */
-interface CodeServerStatusResult extends CodeServerSharedState {
+export interface CodeServerStatusResult extends CodeServerSharedState {
   connect?: CodeServerConnect;
 }
 /** Result of the `start` action, identical shape to {@link CodeServerStatusResult}. */
-type CodeServerStartResult = CodeServerStatusResult;
+export type CodeServerStartResult = CodeServerStatusResult;
 /** Wire payload for the `start` RPC. */
-interface CodeServerStartRequest {
+export interface CodeServerStartRequest {
   /** Workspace folder to open. Defaults to the configured / context cwd. */
   folder?: string;
 }
 /** Options accepted by {@link import('./index').createCodeServerDevframe}. */
-interface CodeServerOptions {
+export interface CodeServerOptions {
   /**
    * How the editor is served (default `'local'`). `'tunnel'` uses Microsoft's
    * `code tunnel` and embeds `vscode.dev`.
@@ -176,12 +184,11 @@ interface CodeServerOptions {
   auth?: boolean;
 }
 /** Options for `mode: 'tunnel'`. */
-interface CodeServerTunnelOptions {
+export interface CodeServerTunnelOptions {
   /**
    * The machine name registered with the tunnel service and used to build the
    * `vscode.dev/tunnel/<name>` URL. Defaults to the device hostname.
    */
   name?: string;
 }
-//#endregion
-export { CodeServerBackend, CodeServerConnect, CodeServerDetection, CodeServerLogin, CodeServerMode, CodeServerOptions, CodeServerServerInfo, CodeServerSharedState, CodeServerStartRequest, CodeServerStartResult, CodeServerStatus, CodeServerStatusResult, CodeServerTunnelOptions };
+//#endregion

package/dist/node/vite.d.mts

@@ -1,7 +1,7 @@
 import { CodeServerOptions } from "./types.mjs";
 import { DevframeViteBridgeOptions, DevframeVitePlugin } from "@devframes/vite/single";
 //#region src/node/vite.d.ts
-interface CodeServerViteOptions extends CodeServerOptions {
+export interface CodeServerViteOptions extends CodeServerOptions {
   /** Forwarded to the underlying `devframeViteBridge`/`devframeVitePlugin` (mount base, etc.). */
   vite?: DevframeViteBridgeOptions;
 }
@@ -12,6 +12,5 @@ interface CodeServerViteOptions extends CodeServerOptions {
  * the bundled SPA at the mount base. The bridge is listed first so its
  * `__connection.json` route is matched ahead of the SPA fallback.
  */
-declare function codeServerVite(options?: CodeServerViteOptions): DevframeVitePlugin[];
-//#endregion
-export { CodeServerViteOptions, codeServerVite };
+export declare function codeServerVite(options?: CodeServerViteOptions): DevframeVitePlugin[];
+//#endregion

package/dist/node/vite.mjs

@@ -1,4 +1,4 @@
-import { t as createCodeServerDevframe } from "../node-DTJ1PTi5.mjs";
+import { t as createCodeServerDevframe } from "../node-BSnbBCzY.mjs";
 import { devframeViteBridge, devframeVitePlugin } from "@devframes/vite/single";
 //#region src/node/vite.ts
 /**

package/dist/{node-DTJ1PTi5.mjs → node-BSnbBCzY.mjs}

@@ -2,7 +2,7 @@ import { PLUGIN_ID } from "./node/constants.mjs";
 import { defineDevframe } from "devframe";
 //#region package.json
 var name = "@devframes/plugin-code-server";
-var version = "0.9.11";
+var version = "0.9.15";
 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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/plugin-code-server",
   "type": "module",
-  "version": "0.9.11",
+  "version": "0.9.15",
   "description": "Devframe plugin that runs VS Code in the browser as an embedded editor panel.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -39,8 +39,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/plugin-code-server--assets": "0.9.11",
-    "devframe": "0.9.11",
+    "@devframes/plugin-code-server--assets": "0.9.15",
+    "devframe": "0.9.15",
     "vite": "^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -52,26 +52,26 @@
     }
   },
   "dependencies": {
-    "@devframes/vite": "0.9.11",
+    "@devframes/vite": "0.9.15",
     "cac": "^7.0.0"
   },
   "devDependencies": {
     "@antfu/design": "^0.4.0",
-    "@devframes/plugin-code-server--assets": "0.9.11",
+    "@devframes/plugin-code-server--assets": "0.9.15",
     "@iconify-json/ph": "^1.2.2",
-    "@storybook/addon-docs": "^10.5.10",
-    "@storybook/vue3-vite": "^10.5.10",
-    "@types/node": "^26.4.0",
+    "@storybook/addon-docs": "^10.6.0",
+    "@storybook/vue3-vite": "^10.6.0",
+    "@types/node": "^26.5.0",
     "@vitejs/plugin-vue": "^6.0.8",
     "colorjs.io": "^0.7.1",
-    "devframe": "0.9.11",
-    "h3": "^2.0.1-rc.29",
+    "devframe": "0.9.15",
+    "h3": "^2.0.1-rc.31",
     "pathe": "^2.0.3",
-    "storybook": "^10.5.10",
-    "tsdown": "^0.22.14",
-    "unocss": "^66.8.1",
+    "storybook": "^10.6.0",
+    "tsdown": "^0.23.0",
+    "unocss": "^66.10.0",
     "vite": "^8.2.2",
-    "vitest": "^4.1.11",
+    "vitest": "^5.0.0",
     "vue": "^3.5.42"
   },
   "scripts": {