@emeryld/manager 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,33 @@
+# @emeryld/manager
+
+Interactive release helper for pnpm monorepos. Install it as a local dev dependency, then run `pnpm manager-cli` (or call a `scripts.manager-cli` alias) from your workspace root to walk through selecting packages, running updates/tests/builds, and publishing.
+
+## Installation
+
+1. Ensure your workspace has a `packages/` directory (or configure one via `packages.mjs`).
+2. Add the manager to your dev dependencies so its CLI and helpers are hoisted into the consuming repo:
+   ```sh
+   pnpm add -D @emeryld/manager
+   ```
+3. Include a script in your `package.json` so you can invoke it consistently:
+   ```json
+   {
+     "scripts": {
+       "manager-cli": "manager-cli"
+     }
+   }
+   ```
+4. Run `pnpm install` to fetch `ts-node`, `semver`, and other runtime deps.
+
+## Running the CLI
+
+- Always run `pnpm manager-cli` (or `pnpm run manager-cli`) from the **workspace root** where your `packages/` folder lives. The manager operates against the workspace you are in, not the package that ships the tool.
+- Each TypeScript helper script registers the bundled `ts-node/esm` loader with the exact script path, so the CLI works even from pnpm workspaces that hoist dependencies.
+- To avoid the warning/error you saw earlier, make sure:
+  - the workspace has `packages/` (or a configured manifest) so `loadPackages()` can find targets,
+  - `pnpm install` has already written `ts-node` into `node_modules`,
+  - you execute the CLI from the workspace that owns those packages.
+
+## Testing the loader registration
+
+Run `pnpm test` to ensure the helper CLI always generates a `--import data:text...` snippet that registers `ts-node/esm.mjs` with **the actual script file path**. This guards against regressions that would make Node reject the loader and crash before the interactive menu appears.

package/bin/manager-cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { spawnSync } from 'node:child_process'
 import path from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { fileURLToPath, pathToFileURL } from 'node:url'
 import { createRequire } from 'node:module'
 
 const __filename = fileURLToPath(import.meta.url)
@@ -12,8 +12,16 @@ const entryPoint = path.join(packageRoot, 'src', 'publish.ts')
 
 const require = createRequire(import.meta.url)
 const tsNodeLoader = require.resolve('ts-node/esm.mjs')
+const registerCode = [
+  'import { register } from "node:module";',
+  'import { pathToFileURL } from "node:url";',
+  `register(${JSON.stringify(
+    tsNodeLoader,
+  )}, pathToFileURL(${JSON.stringify(entryPoint)}));`,
+].join(' ')
+const registerImport = `data:text/javascript,${encodeURIComponent(registerCode)}`
 
-const nodeArgs = ['--loader', tsNodeLoader, entryPoint, ...process.argv.slice(2)]
+const nodeArgs = ['--import', registerImport, entryPoint, ...process.argv.slice(2)]
 const execOptions = {
   env: { ...process.env, TS_NODE_PROJECT: tsconfigPath },
   stdio: 'inherit',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/manager",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Interactive manager for pnpm monorepos (update/test/build/publish).",
   "license": "MIT",
   "type": "module",
@@ -27,6 +27,11 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.3.0"
   },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "@types/semver": "^7.7.1",
+    "cross-env": "^7.0.3"
+  },
   "ts-node": {
     "esm": true,
     "project": "tsconfig.base.json",
@@ -35,6 +40,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.base.json",
-    "typecheck": "tsc -p tsconfig.base.json --noEmit"
+    "typecheck": "tsc -p tsconfig.base.json --noEmit",
+    "test": "cross-env TS_NODE_PROJECT=tsconfig.base.json node --loader ts-node/esm test/helper-cli.test.ts"
   }
 }

package/src/git.ts

@@ -1,8 +1,8 @@
-// src/git.ts
+// src/git.js
 import { spawn } from 'node:child_process'
-import { run } from './utils/run.ts'
-import { logGlobal, colors } from './utils/log.ts'
-import { rootDir } from './utils/run.ts'
+import { run } from './utils/run.js'
+import { logGlobal, colors } from './utils/log.js'
+import { rootDir } from './utils/run.js'
 
 export async function collectGitStatus(): Promise<string[]> {
   return new Promise<string[]>((resolve, reject) => {

package/src/helper-cli.ts

@@ -16,6 +16,18 @@ function getTsNodeLoaderPath() {
   return tsNodeLoaderPath
 }
 
+export function buildTsNodeRegisterImport(scriptPath: string) {
+  const loader = getTsNodeLoaderPath()
+  const code = [
+    'import { register } from "node:module";',
+    'import { pathToFileURL } from "node:url";',
+    `register(${JSON.stringify(
+      loader,
+    )}, pathToFileURL(${JSON.stringify(scriptPath)}));`,
+  ].join(' ')
+  return `data:text/javascript,${encodeURIComponent(code)}`
+}
+
 const ansi = (code: number) => (text: string) => `\x1b[${code}m${text}\x1b[0m`
 const colors = {
   cyan: ansi(36),
@@ -312,10 +324,15 @@ function runEntry(entry: ResolvedScriptEntry, forwardedArgs: string[]) {
   const scriptPath = entry.absoluteScript
   const tsConfigPath = path.join(rootDir, 'tsconfig.base.json')
   const extension = path.extname(scriptPath).toLowerCase()
-  const isTypeScript = extension === '.ts' || extension === '.mts' || extension === '.cts'
+  const isTypeScript = extension === '.js' || extension === '.mts' || extension === '.cts'
   const command = process.execPath
   const execArgs = isTypeScript
-    ? ['--loader', getTsNodeLoaderPath(), scriptPath, ...forwardedArgs]
+    ? [
+        '--import',
+        buildTsNodeRegisterImport(scriptPath),
+        scriptPath,
+        ...forwardedArgs,
+      ]
     : [scriptPath, ...forwardedArgs]
   return new Promise<void>((resolve, reject) => {
     const child = spawn(command, execArgs, {

package/src/menu.ts

@@ -1,19 +1,19 @@
-// src/menu.ts
-import type { HelperScriptEntry } from './helper-cli.ts'
-import type { LoadedPackage } from './utils/log.ts'
-import { colors, globalEmoji } from './utils/log.ts'
+// src/menu.js
+import type { HelperScriptEntry } from './helper-cli.js'
+import type { LoadedPackage } from './utils/log.js'
+import { colors, globalEmoji } from './utils/log.js'
 import {
   updateDependencies,
   testAll,
   testSingle,
   buildAll,
   buildSingle,
-} from './workspace.ts'
+} from './workspace.js'
 
-import { releaseMultiple, releaseSingle } from './release.ts'
-import { getOrderedPackages } from './packages.ts'
-import { runHelperCli } from './helper-cli.ts'
-import { ensureWorkingTreeCommitted } from './preflight.ts'
+import { releaseMultiple, releaseSingle } from './release.js'
+import { getOrderedPackages } from './packages.js'
+import { runHelperCli } from './helper-cli.js'
+import { ensureWorkingTreeCommitted } from './preflight.js'
 
 export type StepKey = 'update' | 'test' | 'build' | 'publish' | 'full' | 'back'
 

package/src/packages.ts

@@ -1,8 +1,8 @@
-// src/packages.ts
+// src/packages.js
 import path from 'node:path'
 import { pathToFileURL } from 'node:url'
 import { readdir, readFile } from 'node:fs/promises'
-import type { PackageColor, LoadedPackage } from './utils/log.ts'
+import type { PackageColor, LoadedPackage } from './utils/log.js'
 
 const rootDir = process.cwd()
 export const packagesDir = path.join(rootDir, 'packages')
@@ -123,7 +123,7 @@ function mergeManifestEntries(
       const name = override.name || baseEntry.name
       const color = override.color ?? baseEntry.color ?? colorFromSeed(name)
       const substitute =
-        override.substitute ?? baseEntry.substitute ?? deriveSubstitute(name) || name
+        override.substitute ?? baseEntry.substitute ?? deriveSubstitute(name) ?? name
       merged.push({ name, path: normalized, color, substitute })
     } else {
       merged.push({ ...baseEntry, path: normalized })
@@ -133,7 +133,7 @@ function mergeManifestEntries(
   normalizedOverrides.forEach((entry) => {
     const name = entry.name || path.basename(entry.path) || 'package'
     const color = entry.color ?? colorFromSeed(name)
-    const substitute = entry.substitute ?? deriveSubstitute(name) || name
+    const substitute = entry.substitute ?? deriveSubstitute(name) ?? name
     merged.push({ name, path: entry.path, color, substitute })
   })
 
@@ -176,7 +176,7 @@ export async function loadPackages(): Promise<LoadedPackage[]> {
         byPath.get(relativePath.toLowerCase()) ??
         byName.get(pkgName.toLowerCase())
       const substitute =
-        meta?.substitute ?? deriveSubstitute(pkgName) || entry.name
+        meta?.substitute ?? deriveSubstitute(pkgName) ?? entry.name
       const color = meta?.color ?? colorFromSeed(pkgName)
       packages.push({
         dirName: entry.name,

package/src/preflight.ts

@@ -1,10 +1,10 @@
-// src/preflight.ts
-import { collectGitStatus } from './git.ts'
+// src/preflight.js
+import { collectGitStatus } from './git.js'
 
-import { colors, logGlobal } from './utils/log.ts'
-import { run } from './utils/run.ts'
-import { gitAdd, gitCommit } from './git.ts'
-import { askLine } from './prompts.ts'
+import { colors, logGlobal } from './utils/log.js'
+import { run } from './utils/run.js'
+import { gitAdd, gitCommit } from './git.js'
+import { askLine } from './prompts.js'
 
 export async function ensureWorkingTreeCommitted() {
   const changes = await collectGitStatus()

package/src/prompts.ts

@@ -1,7 +1,7 @@
-// src/prompts.ts
+// src/prompts.js
 import readline from 'node:readline/promises'
 import { stdin as input, stdout as output } from 'node:process'
-import { colors } from './utils/log.ts'
+import { colors } from './utils/log.js'
 
 export type YesNoAll = 'yes' | 'no' | 'all'
 

package/src/publish.ts

@@ -1,14 +1,14 @@
-// src/publish.ts
-import { runHelperCli } from './helper-cli.ts'
-import { buildPackageSelectionMenu, runStepLoop, type StepKey } from './menu.ts'
-import { getOrderedPackages, loadPackages, resolvePackage } from './packages.ts'
+// src/publish.js
+import { runHelperCli } from './helper-cli.js'
+import { buildPackageSelectionMenu, runStepLoop, type StepKey } from './menu.js'
+import { getOrderedPackages, loadPackages, resolvePackage } from './packages.js'
 import {
   releaseMultiple,
   releaseSingle,
   type PublishOptions,
-} from './release.ts'
-import { ensureWorkingTreeCommitted } from './preflight.ts'
-import { publishCliState } from './prompts.ts'
+} from './release.js'
+import { ensureWorkingTreeCommitted } from './preflight.js'
+import { publishCliState } from './prompts.js'
 
 type Parsed = {
   selectionArg?: string

package/src/release.ts

@@ -1,14 +1,14 @@
-// src/release.ts
+// src/release.js
 import { readFile, writeFile } from 'node:fs/promises'
 import path from 'node:path'
-import { stageCommitPush } from './git.ts'
-import { askLine, promptSingleKey, promptYesNoAll } from './prompts.ts'
-import { bumpVersion, isSemver, type BumpType } from './semver.ts'
-import type { LoadedPackage } from './utils/log.ts'
-import { colors, formatPkgName, logGlobal, logPkg } from './utils/log.ts'
-import { run } from './utils/run.ts'
-
-// in release.ts
+import { stageCommitPush } from './git.js'
+import { askLine, promptSingleKey, promptYesNoAll } from './prompts.js'
+import { bumpVersion, isSemver, type BumpType } from './semver.js'
+import type { LoadedPackage } from './utils/log.js'
+import { colors, formatPkgName, logGlobal, logPkg } from './utils/log.js'
+import { run } from './utils/run.js'
+
+// in release.js
 
 type VersionStrategy =
   | { mode: 'bump'; bumpType: BumpType; preid?: string }

package/src/semver.ts

@@ -1,5 +1,5 @@
-// src/semver.ts
-import { inc, valid } from 'semver'
+// src/semver.js
+import { inc, valid,  } from 'semver'
 
 export type BumpType =
   | 'patch'

package/src/utils/colors.ts

@@ -1,4 +1,4 @@
-// src/utils/colors.ts
+// src/utils/colors.js
 const ansi = (code: number) => (text: string) => `\x1b[${code}m${text}\x1b[0m`
 export const colors = {
   cyan: ansi(36),

package/src/utils/log.ts

@@ -1,5 +1,5 @@
-// src/utils/log.ts
-import { colors } from './colors.ts'
+// src/utils/log.js
+import { colors } from './colors.js'
 
 export type PackageColor = 'cyan' | 'green' | 'yellow' | 'magenta' | 'red'
 export const defaultPackageColor: PackageColor = 'cyan'

package/src/utils/run.ts

@@ -1,4 +1,4 @@
-// src/utils/run.ts
+// src/utils/run.js
 import { spawn, type SpawnOptions } from 'node:child_process'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'

package/src/workspace.ts

@@ -1,10 +1,11 @@
-// src/workspace.ts
+// src/workspace.js
 import { spawnSync } from 'node:child_process'
-import { run, rootDir } from './utils/run.ts'
-import type { LoadedPackage } from './utils/log.ts'
-import { logGlobal, logPkg, colors } from './utils/log.ts'
-import { collectGitStatus, gitAdd, gitCommit } from './git.ts'
-import { askLine, promptSingleKey } from './prompts.ts'
+import { run, rootDir } from './utils/run.js'
+import type { LoadedPackage } from './utils/log.js'
+import { logGlobal, logPkg, colors } from './utils/log.js'
+import { collectGitStatus, gitAdd, gitCommit } from './git.js'
+import { askLine, promptSingleKey } from './prompts.js'
+
 
 const dependencyFiles = new Set([
   'package.json',

package/tsconfig.base.json

@@ -3,6 +3,7 @@
     "target": "ES2022",
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
+    "allowImportingTsExtensions": true,
     "rootDir": "src",
     "outDir": "dist",
     "lib": ["ES2022"],