feat: add @hot-hook/runner

Author: Julien-R44

.gitignore

@@ -12,3 +12,4 @@ dist
 yarn.lock
 shrinkwrap.yaml
 package-lock.json
+.todo.md

examples/hono/bin/start.ts

@@ -0,0 +1,9 @@
+import { hot } from 'hot-hook'
+import { join } from 'node:path'
+
+await hot.init({
+  projectRoot: join(import.meta.dirname, '..'),
+  reload: ['src/index.tsx'],
+})
+
+await import('../src/index.js')

examples/hono/package.json

@@ -1,11 +1,12 @@
 {
   "type": "module",
   "scripts": {
-    "dev": "tsx watch --ignore=./src/views src/index.tsx"
+    "dev": "hot-runner --node-args=\"--import=tsx\" bin/start.ts"
   },
   "devDependencies": {
     "@types/node": "^20.11.17",
     "hot-hook": "workspace:*",
+    "@hot-hook/runner": "workspace:*",
     "tsx": "^3.12.2"
   },
   "dependencies": {

examples/hono/src/index.tsx

@@ -1,10 +1,7 @@
 import { Hono } from 'hono'
-import { hot } from 'hot-hook'
 import { serve } from '@hono/node-server'
 import { setTimeout } from 'node:timers/promises'
 
-await hot.init({})
-
 /**
  * Let's imagine we have a complex initialization step that takes
  * a while to complete. This is pretty common in real-world application

packages/hot_hook/package.json

@@ -7,9 +7,6 @@
   "files": [
     "build"
   ],
-  "bin": {
-    "hot-runner": "./build/src/runner.js"
-  },
   "exports": {
     ".": "./build/src/hot.js",
     "./loader": "./build/src/loader.js",

packages/hot_hook/src/loader.ts

@@ -42,7 +42,6 @@ const watcher = chokidar
 
     debug('Changed %s', realFilePath)
     if (isReloadPath(realFilePath)) {
-      console.log('isReloadPath', realFilePath)
       options.messagePort?.postMessage({ type: 'hot-hook:full-reload', path: realFilePath })
       return
     }

packages/runner/bin/run.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { kernel } from '../index.js'
+
+kernel.handle(['serve', ...process.argv.slice(2)]).catch(console.error)

packages/runner/index.ts

@@ -0,0 +1,17 @@
+import { HelpCommand, Kernel } from '@adonisjs/ace'
+import { Serve } from './src/serve.js'
+
+Kernel.defaultCommand = Serve
+
+export const kernel = Kernel.create()
+
+kernel.defineFlag('help', {
+  type: 'boolean',
+  description: HelpCommand.description,
+})
+
+kernel.on('help', async (command, $kernel, parsed) => {
+  parsed.args.unshift(command.commandName)
+  await new HelpCommand($kernel, parsed, kernel.ui, kernel.prompt).exec()
+  return $kernel.shortcircuit()
+})

packages/runner/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@hot-hook/runner",
+  "description": "Runner for applications that use hot-hook",
+  "version": "0.0.0",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "hot-runner": "build/bin/run.js"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@adonisjs/ace": "^13.0.0",
+    "execa": "^8.0.1"
+  },
+  "author": "Julien Ripouteau <[email protected]>",
+  "license": "ISC",
+  "keywords": []
+}

packages/runner/src/helpers.ts

@@ -0,0 +1,25 @@
+import { execaNode } from 'execa'
+import { RunOptions } from './types.js'
+
+const DEFAULT_NODE_ARGS = ['--enable-source-maps']
+
+/**
+ * Runs a Node.js script as a child process and inherits the stdio streams
+ */
+export function runNode(cwd: string | URL, options: RunOptions) {
+  const childProcess = execaNode(options.script, options.scriptArgs, {
+    nodeOptions: DEFAULT_NODE_ARGS.concat(options.nodeArgs),
+    preferLocal: true,
+    windowsHide: false,
+    localDir: cwd,
+    cwd,
+    buffer: false,
+    stdio: options.stdio || 'inherit',
+    env: {
+      ...(options.stdio === 'pipe' ? { FORCE_COLOR: 'true' } : {}),
+      ...options.env,
+    },
+  })
+
+  return childProcess
+}