@plugjs/plug 0.3.5 → 0.4.1

package/extra/tsrun.mts

@@ -1,127 +0,0 @@
-#!/usr/bin/env node
-/* eslint-disable no-console */
-
-import _path from 'node:path'
-import _repl from 'node:repl'
-import _module from 'node:module'
-
-import _yargs from 'yargs-parser'
-
-import { $blu, $gry, $rst, $und, $wht, main } from './utils.js'
-
-/** Version injected by esbuild */
-declare const __version: string
-
-/** Our minimalistic help */
-function help(): never {
-  console.log(`${$blu}${$und}Usage:${$rst}
-
-  ${$wht}tsrun${$rst} ${$gry}[${$rst}--options${$gry}] script.ts [...${$rst}script args${$gry}]${$rst}
-
-  ${$blu}${$und}Options:${$rst}
-
-      ${$wht}-h --help     ${$rst}  Help! You're reading it now!
-      ${$wht}-v --version  ${$rst}  Version! This one: ${__version}!
-      ${$wht}-e --eval     ${$rst}  Evaluate the script
-      ${$wht}-p --print    ${$rst}  Evaluate the script and print the result
-      ${$wht}   --force-esm${$rst}  Force transpilation of ".ts" files to EcmaScript modules
-      ${$wht}   --force-cjs${$rst}  Force transpilation of ".ts" files to CommonJS modules
-
-  ${$blu}${$und}Description:${$rst}
-
-      ${$wht}tsrun${$rst} is a minimalistic TypeScript loader, using "esbuild" to transpile TS
-      code to JavaScript, and running it. Being extremely un-sofisticated, it's
-      not meant to to be in any way a replacement for more complete alternatives
-      like "ts-node".
-`)
-
-  process.exit(1)
-}
-
-/** Process the command line */
-main((args: string[]): void => {
-  let _script: string | undefined
-  let _scriptArgs: string[] = []
-  let _print: boolean = false
-  let _eval: boolean = false
-
-  /* Yargs-parse our arguments */
-  const parsed = _yargs(args, {
-    configuration: {
-      'camel-case-expansion': false,
-      'strip-aliased': true,
-      'strip-dashed': true,
-    },
-
-    alias: {
-      'version': [ 'v' ],
-      'help': [ 'h' ],
-      'eval': [ 'e' ],
-      'print': [ 'p' ],
-    },
-
-    boolean: [ 'help', 'eval', 'print', 'force-esm', 'version', 'force-cjs' ],
-  })
-
-  // Parse options, leaving script and scriptArgs with our code to run
-  for (const [ key, value ] of Object.entries(parsed)) {
-    switch (key) {
-      case '_': // extra arguments
-        [ _script, ..._scriptArgs ] = value
-        break
-      case 'help': // help screen
-        help()
-        break
-      case 'version': // version dump
-        console.log(`v${__version}`)
-        process.exit(0)
-        break
-      case 'eval': // eval script
-        _eval = value
-        break
-      case 'print': // eval script and print return value
-        _print = true
-        _eval = true
-        break
-    }
-  }
-
-  // Start the repl or run the script?
-  if (! _script) {
-    // No script? Then repl
-    console.log(`Welcome to Node.js ${process.version} (tsrun v${__version}).`)
-    console.log('Type ".help" for more information.')
-    _repl.start()
-  } else if (_eval) {
-    // If we are evaluating a script, we need to use some node internals to do
-    // all the tricks to run this... We a fake script running the code to
-    // evaluate, instrumenting "globalThis" with all required vars and modules
-    const script = `
-      globalThis.module = module;
-      globalThis.require = require;
-      globalThis.exports = exports;
-      globalThis.__dirname = __dirname;
-      globalThis.__filename = __filename;
-
-      for (const module of require('repl').builtinModules) {
-        if (module.indexOf('/') >= 0) continue;
-        if (Object.hasOwn(globalThis, module)) continue;
-        Object.defineProperty(globalThis, module, { get: () => require(module) });
-      }
-
-      return require('node:vm').runInThisContext(${JSON.stringify(_script)}, '[eval]')
-    `
-
-    // Use the Node internal "Module._compile" to compile and run our script
-    const result = (new _module('[eval]') as any)._compile(script, '[eval]')
-
-    // If we need to print, then let's do it!
-    if (_print) console.log(result)
-  } else {
-    // Resolve the _full_ path of the script, and tweak our process.argv
-    // arguments, them simply import the script and let Node do its thing...
-    _script = _path.resolve(process.cwd(), _script)
-    process.argv = [ process.argv0, _script, ..._scriptArgs ]
-    import(_script)
-  }
-})

package/extra/utils.ts

@@ -1,150 +0,0 @@
-/* eslint-disable no-console */
-import _childProcess from 'node:child_process'
-import _fs from 'node:fs'
-import _path from 'node:path'
-import _url from 'node:url'
-import _util from 'node:util'
-
-/* ========================================================================== *
- * PRETTY COLORS                                                              *
- * ========================================================================== */
-
-export const $rst = process.stdout.isTTY ? '\u001b[0m' : '' // reset all colors to default
-export const $und = process.stdout.isTTY ? '\u001b[4m' : '' // underline on
-export const $gry = process.stdout.isTTY ? '\u001b[38;5;240m' : '' // somewhat gray
-export const $blu = process.stdout.isTTY ? '\u001b[38;5;69m' : '' // brighter blue
-export const $wht = process.stdout.isTTY ? '\u001b[1;38;5;255m' : '' // full-bright white
-export const $tsk = process.stdout.isTTY ? '\u001b[38;5;141m' : '' // the color for tasks (purple)
-
-
-/* ========================================================================== *
- * TS LOADER FORCE TYPE                                                       *
- * ========================================================================== */
-
-function forceType(type: 'commonjs' | 'module'): void {
-  const debug = _util.debuglog('plug:cli')
-
-  const tsLoaderMarker = Symbol.for('plugjs:tsLoader')
-
-  if (!(tsLoaderMarker in globalThis)) {
-    throw new Error('TypeScript Loader not available')
-  }
-  debug(`Forcing type to "${type}"`)
-  ;(globalThis as any)[tsLoaderMarker] = type
-}
-
-
-/* ========================================================================== *
- * FILES UTILITIES                                                            *
- * ========================================================================== */
-
-/* Returns a boolean indicating whether the specified file exists or not */
-export function isFile(path: string): boolean {
-  try {
-    return _fs.statSync(path).isFile()
-  } catch (error) {
-    return false
-  }
-}
-
-/* Returns a boolean indicating whether the specified directory exists or not */
-export function isDirectory(path: string): boolean {
-  try {
-    return _fs.statSync(path).isDirectory()
-  } catch (error) {
-    return false
-  }
-}
-
-
-/* ========================================================================== *
- * MAIN ENTRY POINT                                                           *
- * ========================================================================== */
-export function main(callback: (args: string[]) => void | Promise<void>): void {
-  const debug = _util.debuglog('plug:cli')
-
-  /* Check for source maps and typescript support */
-  const sourceMapsEnabled = process.execArgv.indexOf('--enable-source-maps') >= 0
-
-  /* Check if our `ts-loader` loader is enabled */
-  const tsLoaderMarker = Symbol.for('plugjs:tsLoader')
-  const typeScriptEnabled = (globalThis as any)[tsLoaderMarker]
-
-  /* Some debugging if needed */
-  debug('SourceMaps enabled =', sourceMapsEnabled)
-  debug('TypeScript enabled =', typeScriptEnabled || false)
-
-  /* If both source maps and typescript are on, run! */
-  if (sourceMapsEnabled && typeScriptEnabled) {
-    const args = process.argv.slice(2).filter((arg: string): string | void => {
-      if (arg === '--force-esm') {
-        return forceType('module')
-      } else if (arg === '--force-cjs') {
-        return forceType('commonjs')
-      } else {
-        return arg
-      }
-    })
-
-
-    Promise.resolve().then(() => callback(args)).catch(console.error)
-  } else {
-    const script = _url.fileURLToPath(import.meta.url)
-
-    /* Fork out ourselves with new options */
-    const execArgv = [ ...process.execArgv ]
-
-    /* Enable source maps if not done already */
-    if (! sourceMapsEnabled) execArgv.push('--enable-source-maps')
-
-    /* Enable our ESM TypeScript loader if not done already */
-    if (! typeScriptEnabled) {
-      const directory = _path.dirname(script)
-      const extension = _path.extname(script) // .mts or .mjs
-      const loader = _path.resolve(directory, `ts-loader${extension}`)
-      execArgv.push(`--experimental-loader=${loader}`, '--no-warnings')
-    }
-
-    /*
-     * It seems that setting "type" as "module" in "package.json" creates some
-     * problems when the module is being imported from a "commonjs" one.
-     *
-     * TypeScript _incorrectly_ says (regardless of how we set up our conditional
-     * exports) that we must use dynamic imports:
-     *
-     *     Module '@plugjs/plug' cannot be imported using this construct. The
-     *     specifier only resolves to an ES module, which cannot be imported
-     *     synchronously. Use dynamic import instead.
-     *     TS(1471)
-     *
-     * So for now our only option is to leave "type" as "commonjs", and for those
-     * brave souls willing to force ESM irregardless of what's in "package.json",
-     * we allow the "--force-esm" option, and instruct `ts-loader` that the
-     * current directory (and subdirs) will transpile as ESM always.
-     */
-
-    /* Fork ourselves! */
-    const child = _childProcess.fork(script, [ ...process.argv.slice(2) ], {
-      stdio: [ 'inherit', 'inherit', 'inherit', 'ipc' ],
-      execArgv,
-    })
-
-    /* Monitor child process... */
-    child.on('error', (error) => {
-      console.log('Error respawning CLI', error)
-      process.exit(1)
-    })
-
-    child.on('exit', (code, signal) => {
-      if (signal) {
-        console.log(`CLI process exited with signal ${signal}`)
-        process.exit(1)
-      } else if (typeof code !== 'number') {
-        console.log('CLI process failed for an unknown reason')
-        process.exit(1)
-      } else {
-        process.exit(code)
-      }
-    })
-  }
-}

package/src/utils/types.ts

@@ -1,11 +0,0 @@
-/** A type adding the values `null` or `array` to the result of `typeof` */
-export type BasicType =
-  | 'string' | 'number' | 'bigint' | 'boolean' | 'symbol'
-  | 'undefined' | 'object' | 'function' | 'null' | 'array'
-
-/** Get the _real_ type of a value, including `null` or `array` */
-export function getTypeOf(what: unknown): BasicType {
-  if (Array.isArray(what)) return 'array'
-  if (what === null) return 'null'
-  return typeof what
-}