feat: add ability to select runtimes

Author: twlite

package.json

@@ -100,7 +100,14 @@
       "lodash@>=4.0.0 <=4.17.23": ">=4.18.0",
       "lodash-es@<=4.17.23": ">=4.18.0",
       "lodash@<=4.17.23": ">=4.18.0",
-      "defu@<=6.1.4": ">=6.1.5"
+      "defu@<=6.1.4": ">=6.1.5",
+      "@nestjs/core@<=11.1.17": ">=11.1.18",
+      "vite@>=7.0.0 <=7.3.1": ">=7.3.2",
+      "vite@>=7.1.0 <=7.3.1": ">=7.3.2",
+      "hono@<4.12.12": ">=4.12.12",
+      "hono@>=4.0.0 <=4.12.11": ">=4.12.12",
+      "@hono/node-server@<1.19.13": ">=1.19.13",
+      "axios@<1.15.0": ">=1.15.0"
     }
   },
   "dependencies": {

packages/commandkit/src/cli/app-process.ts

@@ -3,6 +3,8 @@ import { DevEnv, ProdEnv } from './env';
 import { join } from 'node:path';
 import { existsSync } from 'node:fs';
 import { panic } from './common';
+import { ResolvedCommandKitConfig } from '../config/utils';
+import { CommandKitJsRuntime } from '../config/types';
 
 /**
  * @private
@@ -16,6 +18,40 @@ function getStdio(supportsCommands: boolean) {
   return ['pipe', 'pipe', 'pipe'];
 }
 
+const RuntimeLookup: [CommandKitJsRuntime, () => boolean][] = [
+  // @ts-ignore Bun types
+  ['bun', () => typeof Bun !== 'undefined' && typeof Bun.version === 'string'],
+  [
+    'deno',
+    () =>
+      // @ts-ignore Deno types
+      typeof Deno !== 'undefined' &&
+      // @ts-ignore Deno types
+      typeof Deno.version === 'object' &&
+      // @ts-ignore Deno types
+      typeof Deno.version.deno === 'string',
+  ],
+];
+
+function resolveRuntime(config: ResolvedCommandKitConfig): CommandKitJsRuntime {
+  const maybeRuntime = config?.experimental?.devServerRuntime;
+
+  // TODO: once stable enough, we should try 'auto' option here
+  if (!maybeRuntime) return 'node';
+
+  if (maybeRuntime === 'auto') {
+    for (const [runtime, check] of RuntimeLookup) {
+      if (check()) {
+        return runtime as CommandKitJsRuntime;
+      }
+    }
+
+    return 'node';
+  }
+
+  return maybeRuntime;
+}
+
 /**
  * @private
  * @internal
@@ -24,17 +60,22 @@ export function createAppProcess(
   fileName: string,
   cwd: string,
   isDev: boolean,
+  config: ResolvedCommandKitConfig,
 ) {
   if (!existsSync(join(cwd, fileName))) {
     panic(`Could not locate the entrypoint file: ${fileName}`);
   }
 
   const stdio = getStdio(isDev) as IOType[];
+  const targetRuntime = resolveRuntime(config);
 
-  const baseArgs = [
-    `--title="CommandKit ${isDev ? 'Development' : 'Production'}"`,
-    '--enable-source-maps',
-  ];
+  const baseArgs =
+    targetRuntime === 'node'
+      ? [
+          `--title="CommandKit ${isDev ? 'Development' : 'Production'}"`,
+          '--enable-source-maps',
+        ]
+      : [];
 
   const nodeOptions = process.env.CK_NODE_OPTIONS || process.env.NODE_OPTIONS;
   let nodeArgs = [...baseArgs];
@@ -58,7 +99,7 @@ export function createAppProcess(
 
   nodeArgs.push(fileName);
 
-  const ps = spawn('node', nodeArgs, {
+  const ps = spawn(targetRuntime, nodeArgs, {
     cwd,
     windowsHide: true,
     env: isDev ? DevEnv() : ProdEnv(),

packages/commandkit/src/cli/development.ts

@@ -29,7 +29,7 @@ async function buildAndStart(configPath: string, skipStart = false) {
 
   if (skipStart) return null as never;
 
-  const ps = createAppProcess(mainFile, configPath, true);
+  const ps = createAppProcess(mainFile, configPath, true, config);
 
   return ps;
 }
@@ -52,7 +52,15 @@ const isEventSource = (p: string) =>
  * @private
  * @internal
  */
-export async function bootstrapDevelopmentServer(configPath?: string) {
+export async function bootstrapDevelopmentServer(configPath?: string): Promise<{
+  watcher: ReturnType<typeof watch>;
+  isConfigUpdate: (path: string) => boolean;
+  performHMR: (path?: string) => Promise<boolean>;
+  hmrHandler: (path: string) => Promise<void>;
+  sendHmrEvent: (event: HMREventType, path?: string) => Promise<boolean>;
+  getProcess: () => ChildProcess | null;
+  buildAndStart: typeof buildAndStart;
+}> {
   process.env.COMMANDKIT_BOOTSTRAP_MODE = 'development';
   process.env.COMMANDKIT_INTERNAL_IS_CLI_PROCESS = 'true';
   const start = performance.now();

packages/commandkit/src/cli/production.ts

@@ -23,7 +23,7 @@ export async function bootstrapProductionServer(configPath?: string) {
     );
   }
 
-  return createAppProcess(mainFile, cwd, false);
+  return createAppProcess(mainFile, cwd, false, config);
 }
 
 /**

packages/commandkit/src/config/config.ts

@@ -80,6 +80,10 @@ export function defineConfig(
     jsxDefaultOptionalComponents:
       config.jsxDefaultOptionalComponents ??
       defaultConfig.jsxDefaultOptionalComponents,
+    experimental: {
+      ...defaultConfig.experimental,
+      ...config.experimental,
+    },
   };
 
   return defined;

packages/commandkit/src/config/default.ts

@@ -35,4 +35,7 @@ export const defaultConfig: ResolvedCommandKitConfig = {
     production: false,
   },
   jsxDefaultOptionalComponents: true,
+  experimental: {
+    devServerRuntime: null,
+  },
 };

packages/commandkit/src/config/types.ts

@@ -2,6 +2,11 @@ import { MaybeArray } from '../components';
 import { CommandKitPlugin } from '../plugins';
 import type { InlineConfig as TsDownOptions } from 'tsdown';
 
+/**
+ * The JavaScript runtime to use for the development server.
+ */
+export type CommandKitJsRuntime = 'node' | 'bun' | 'deno' | 'auto';
+
 export interface CommandKitCompilerOptions {
   /**
    * The macro compiler options to use with CommandKit.
@@ -119,4 +124,14 @@ export interface CommandKitConfig {
    * @default true
    */
   jsxDefaultOptionalComponents?: boolean;
+  /**
+   * Experimental features configuration. These features are not stable and may be removed or changed without a major version bump. Use with caution.
+   */
+  experimental?: {
+    /**
+     * The runtime to use for the development server. This is an experimental feature and may be removed or changed without a major version bump. Use with caution.
+     * @default null
+     */
+    devServerRuntime?: CommandKitJsRuntime | null;
+  };
 }