feat: add tinker

wip

Author: chrisbbreuer

.stacks/core/actions/src/tinker.ts

@@ -0,0 +1,9 @@
+import { parseArgs, runCommands } from '@stacksjs/cli'
+
+const options = parseArgs()
+
+console.log('options are:', options)
+
+// await runCommands([
+//   'npx tinker',
+// ], { verbose: true })

.stacks/core/buddy/src/commands/index.ts

@@ -21,6 +21,7 @@ export * from './seed'
 export * from './setting'
 export * from './setup'
 export * from './test'
+export * from './tinker'
 export * from './types'
 export * from './upgrade'
 export * from './version'

.stacks/core/buddy/src/commands/tinker.ts

@@ -0,0 +1,29 @@
+import type { CLI, TinkerOptions } from '@stacksjs/types'
+import { runAction } from '@stacksjs/actions'
+import { intro, outro } from '@stacksjs/cli'
+import { Action, ExitCode } from '@stacksjs/types'
+
+async function tinker(buddy: CLI) {
+  const descriptions = {
+    tinker: 'Tinker with your code',
+    verbose: 'Enable verbose output',
+  }
+
+  buddy
+    .command('tinker', descriptions.tinker)
+    .option('--verbose', descriptions.verbose, { default: false })
+    .action(async (options: TinkerOptions) => {
+      const perf = await intro('buddy tinker')
+      const result = await runAction(Action.Tinker, options)
+
+      if (result.isErr()) {
+        outro('While running the tinker command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error || undefined)
+        process.exit()
+      }
+
+      outro('Tinker mode exited.', { startTime: perf, useSeconds: true })
+      process.exit(ExitCode.Success)
+    })
+}
+
+export { tinker }

.stacks/core/tinker/README.md

@@ -0,0 +1,61 @@
+# Stacks Tinker
+
+A powerful TypeScript REPL, powered by TSX.
+
+## ☘️ Features
+
+- Blazing fast on-demand TypeScript & ESM compilation
+- Works in both [CommonJS and ESM packages](https://nodejs.org/api/packages.html#type)
+- Supports next-gen TypeScript extensions (`.cts` & `.mts`)
+- Supports `node:` import prefixes
+- Hides experimental feature warnings
+- TypeScript REPL
+- Resolves `tsconfig.json` [`paths`](https://www.typescriptlang.org/tsconfig#paths)
+- Tested on Linux & Windows with Node.js v12~18
+
+## 🤖 Usage
+
+```bash
+pnpm i -D @stacksjs/tinker
+```
+
+Now, you can easily access it in your project:
+
+```bash
+npx tinker
+```
+
+To learn more, visit [`tsx`](https://github.com/esbuild-kit/tsx).
+
+## 📈 Changelog
+
+Please see our [releases](https://github.com/stacksjs/stacks/releases) page for more information on what has changed recently.
+
+## 🚜 Contributing
+
+Please review the [Contributing Guide](https://github.com/stacksjs/contributing) for details.
+
+## 🏝 Community
+
+For help, discussion about best practices, or any other conversation that would benefit from being searchable:
+
+[Discussions on GitHub](https://github.com/stacksjs/stacks/discussions)
+
+For casual chit-chat with others using this package:
+
+[Join the Stacks Discord Server](https://discord.ow3.org)
+
+## 🙏🏼 Credits
+
+Many thanks to the following core technologies & people who have contributed to this package:
+
+- [tsx](https://github.com/esbuild-kit/tsx)
+- [esno](https://github.com/esbuild-kit/esno)
+- [Chris Breuer](https://github.com/chrisbbreuer)
+- [All Contributors](../../contributors)
+
+## 📄 License
+
+The MIT License (MIT). Please see [LICENSE](https://github.com/stacksjs/stacks/tree/main/LICENSE.md) for more information.
+
+Made with ❤️

.stacks/core/tinker/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@stacksjs/tinker",
+  "type": "module",
+  "version": "0.51.0",
+  "packageManager": "pnpm@8.3.1",
+  "description": "The Stacks way to tinker.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/tinker#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/tinker"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "tinker",
+    "repl",
+    "typescript",
+    "tsx",
+    "zero-config",
+    "stacks"
+  ],
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "bin": {
+    "tinker": "tinker.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "prepublishOnly": "pnpm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "tsx": "^3.12.7"
+  },
+  "devDependencies": {
+    "@stacksjs/development": "workspace:*"
+  }
+}

.stacks/core/tinker/tinker.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('tsx/cli')

.stacks/core/types/src/cli.ts

@@ -181,6 +181,7 @@ export interface InspireOptions extends CliOptions {}
 export interface ReleaseOptions extends CliOptions {}
 export interface PreinstallOptions extends CliOptions {}
 export interface PrepublishOptions extends CliOptions {}
+export interface TinkerOptions extends CliOptions {}
 export interface TypesOptions extends CliOptions {}
 
 export type LibEntryType = 'vue-components' | 'web-components' | 'functions' | 'all'
@@ -269,6 +270,7 @@ export const enum Action {
   TestUnit = 'test-unit', // wip
   TestFeature = 'test-feature', // wip
   TestCoverage = 'test-coverage', // wip
+  Tinker = 'tinker',
   Typecheck = 'typecheck', // wip
   Upgrade = 'upgrade/index', // wip
   UpgradeNode = 'upgrade/node', // wip