create-pokit 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daniel Grant
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# create-pokit
+
+Project scaffolding CLI for pok.
+
+## Usage
+
+```bash
+bun create pokit my-project
+# or
+npx create-pokit my-project
+
+cd my-project
+pok
+```
+
+## What's Created
+
+```
+my-project/
+├── commands/
+│   ├── hello.ts
+│   └── build.ts
+├── pok
+├── package.json
+├── tsconfig.json
+└── .gitignore
+```
+
+## Documentation
+
+See the [full documentation](https://github.com/openpok/pok/blob/main/docs/packages/create.md).

package/bin/create.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env bun
+/**
+ * create-pokit - Scaffold a new pok project
+ *
+ * Usage:
+ *   bun create pokit my-project
+ *   npx create-pokit my-project
+ *   bunx create-pokit my-project
+ *
+ * This is a pok app itself, using @pokit/core for the CLI framework.
+ */
+
+import * as path from 'path';
+import { runCli } from '@pokit/core';
+
+const __dirname = path.dirname(new URL(import.meta.url).pathname);
+const packageRoot = path.resolve(__dirname, '..');
+const commandsDir = path.join(packageRoot, 'commands');
+
+runCli(process.argv.slice(2), {
+  projectRoot: packageRoot,
+  commandsDir,
+  appName: 'create-pokit',
+}).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/commands/init.ts

@@ -0,0 +1,201 @@
+/**
+ * Initialize/scaffold a new pok project
+ *
+ * This is the default command when running:
+ *   bun create pokit my-project
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawn } from 'bun';
+import { z } from 'zod';
+import { defineCommand, type SelectOption } from '@pokit/core';
+import {
+  generatePackageJson,
+  generateTsConfig,
+  generateExampleCommand,
+  generateBuildCommand,
+  generateGitignore,
+  TEMPLATES,
+  TEMPLATE_NAMES,
+  AVAILABLE_PLUGINS,
+  type TemplateName,
+} from '../src/templates';
+
+// =============================================================================
+// Install Options
+// =============================================================================
+
+const INSTALL_OPTIONS: SelectOption<'install' | 'skip'>[] = [
+  {
+    value: 'install',
+    label: 'Yes, install globally',
+    hint: 'bun add -g pokit',
+  },
+  {
+    value: 'skip',
+    label: 'No, skip for now',
+    hint: 'Use "bun pok" instead',
+  },
+];
+
+export const command = defineCommand({
+  label: 'Create a new pok project',
+  context: {
+    name: {
+      from: 'flag',
+      schema: z.string().min(1),
+      description: 'Project name',
+    },
+    template: {
+      from: 'flag',
+      schema: z.enum(TEMPLATE_NAMES).optional(),
+      description: 'Project template (starter, minimal, full, custom)',
+    },
+  },
+  run: async (r, ctx) => {
+    const projectName = ctx.context.name;
+    const projectPath = path.resolve(process.cwd(), projectName);
+
+    // Check if directory already exists
+    if (fs.existsSync(projectPath)) {
+      r.reporter.error(`Directory "${projectName}" already exists`);
+      process.exit(1);
+    }
+
+    // Determine plugins based on template selection
+    let selectedPlugins: string[];
+
+    if (ctx.context.template) {
+      // Template specified via flag - use it directly
+      const template = TEMPLATES.find((t) => t.name === ctx.context.template);
+      if (ctx.context.template === 'custom') {
+        // Custom template: still prompt for plugins
+        selectedPlugins = await r.prompter.multiselect({
+          message: 'Select plugins to install:',
+          options: AVAILABLE_PLUGINS,
+          initialValues: ['@pokit/prompter-clack', '@pokit/reporter-clack'],
+          required: false,
+        });
+      } else {
+        selectedPlugins = template?.plugins ?? [];
+      }
+    } else {
+      // Interactive template selection
+      const templateChoice = await r.prompter.select({
+        message: 'Choose a template:',
+        options: TEMPLATES.map((t) => ({
+          value: t.name as TemplateName,
+          label: t.label,
+          hint: t.hint,
+        })),
+        initialValue: 'starter' as TemplateName,
+      });
+
+      if (templateChoice === 'custom') {
+        // Custom template: prompt for individual plugins
+        selectedPlugins = await r.prompter.multiselect({
+          message: 'Select plugins to install:',
+          options: AVAILABLE_PLUGINS,
+          initialValues: ['@pokit/prompter-clack', '@pokit/reporter-clack'],
+          required: false,
+        });
+      } else {
+        const template = TEMPLATES.find((t) => t.name === templateChoice);
+        selectedPlugins = template?.plugins ?? [];
+      }
+    }
+
+    // Create project structure
+    await r.group('Creating project', { layout: 'sequence' }, async (grp) => {
+      // Create directory
+      await grp.activity('Create project directory', async () => {
+        fs.mkdirSync(projectPath, { recursive: true });
+        fs.mkdirSync(path.join(projectPath, 'commands'), { recursive: true });
+      });
+
+      // Generate files
+      await grp.activity('Generate project files', async () => {
+        const config = {
+          name: projectName,
+          plugins: selectedPlugins as string[],
+        };
+
+        // package.json
+        fs.writeFileSync(path.join(projectPath, 'package.json'), generatePackageJson(config));
+
+        // tsconfig.json
+        fs.writeFileSync(path.join(projectPath, 'tsconfig.json'), generateTsConfig());
+
+        // .gitignore
+        fs.writeFileSync(path.join(projectPath, '.gitignore'), generateGitignore());
+
+        // Example commands
+        fs.writeFileSync(path.join(projectPath, 'commands', 'hello.ts'), generateExampleCommand());
+
+        fs.writeFileSync(path.join(projectPath, 'commands', 'build.ts'), generateBuildCommand());
+      });
+
+      // Install dependencies
+      await grp.activity('Install dependencies', async () => {
+        const proc = spawn(['bun', 'install'], {
+          cwd: projectPath,
+          stdio: ['inherit', 'pipe', 'pipe'],
+        });
+        const exitCode = await proc.exited;
+        if (exitCode !== 0) {
+          throw new Error(`bun install failed with exit code ${exitCode}`);
+        }
+      });
+    });
+
+    // Check if pok command is available globally
+    let pokAvailable = false;
+    try {
+      const proc = spawn(['which', 'pok'], {
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+      const exitCode = await proc.exited;
+      pokAvailable = exitCode === 0;
+    } catch {
+      pokAvailable = false;
+    }
+
+    // If pok is not available globally, ask user if they want to install it
+    if (!pokAvailable) {
+      const installChoice = await r.prompter.select({
+        message: 'Install global pok command?',
+        options: INSTALL_OPTIONS,
+      });
+
+      if (installChoice === 'install') {
+        await r.group('Installing global CLI', { layout: 'sequence' }, async (grp) => {
+          await grp.activity('Install pokit globally', async () => {
+            const proc = spawn(['bun', 'add', '-g', 'pokit'], {
+              stdio: ['inherit', 'pipe', 'pipe'],
+            });
+            const exitCode = await proc.exited;
+            if (exitCode !== 0) {
+              throw new Error(`Global install failed with exit code ${exitCode}`);
+            }
+          });
+        });
+        pokAvailable = true;
+      }
+    }
+
+    // Show next steps
+    r.reporter.success(`Project "${projectName}" created successfully!`);
+    r.reporter.info('');
+    r.reporter.info('Next steps:');
+    r.reporter.step(`  cd ${projectName}`);
+    if (pokAvailable) {
+      r.reporter.step('  pok');
+    } else {
+      r.reporter.step('  bun pok');
+      r.reporter.info('');
+      r.reporter.info('To install the global pok command later:');
+      r.reporter.step('  bun add -g pokit');
+    }
+  },
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "create-pokit",
+  "version": "0.0.1",
+  "description": "Scaffold a new pok project",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/notation-dev/openpok.git",
+    "directory": "packages/create"
+  },
+  "homepage": "https://github.com/notation-dev/openpok#readme",
+  "bugs": {
+    "url": "https://github.com/notation-dev/openpok/issues"
+  },
+  "bin": {
+    "create-pokit": "./bin/create.ts"
+  },
+  "files": [
+    "bin",
+    "commands",
+    "templates",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "zod": "^4.0.0",
+    "@pokit/core": "0.0.1",
+    "@pokit/prompter-clack": "0.0.1",
+    "@pokit/reporter-clack": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "keywords": [
+    "cli",
+    "create",
+    "scaffold",
+    "pok",
+    "pokit"
+  ]
+}

package/src/templates.ts

@@ -0,0 +1,161 @@
+/**
+ * Template generators for scaffolding
+ */
+
+import type { MultiselectOption } from '@pokit/core';
+
+export type ProjectConfig = {
+  name: string;
+  plugins: string[];
+};
+
+// =============================================================================
+// Template Definitions
+// =============================================================================
+
+export type Template = {
+  name: string;
+  label: string;
+  hint: string;
+  plugins: string[];
+};
+
+export const TEMPLATE_NAMES = ['starter', 'minimal', 'full', 'custom'] as const;
+export type TemplateName = (typeof TEMPLATE_NAMES)[number];
+
+export const TEMPLATES: Template[] = [
+  {
+    name: 'starter',
+    label: 'Starter (recommended)',
+    hint: 'Interactive prompts + beautiful output',
+    plugins: ['@pokit/prompter-clack', '@pokit/reporter-clack'],
+  },
+  {
+    name: 'minimal',
+    label: 'Minimal',
+    hint: 'Core only - add adapters later',
+    plugins: [],
+  },
+  {
+    name: 'full',
+    label: 'Full',
+    hint: 'All plugins including tabbed UI',
+    plugins: ['@pokit/prompter-clack', '@pokit/reporter-clack', '@pokit/tabs-ink'],
+  },
+  {
+    name: 'custom',
+    label: 'Custom',
+    hint: 'Choose plugins individually',
+    plugins: [], // Will prompt separately
+  },
+];
+
+// =============================================================================
+// Plugin Options (for custom template)
+// =============================================================================
+
+export const AVAILABLE_PLUGINS: MultiselectOption<string>[] = [
+  {
+    value: '@pokit/prompter-clack',
+    label: 'Prompter (clack)',
+    hint: 'Interactive prompts for user input',
+  },
+  {
+    value: '@pokit/reporter-clack',
+    label: 'Reporter (clack)',
+    hint: 'Beautiful CLI output and spinners',
+  },
+  {
+    value: '@pokit/tabs-ink',
+    label: 'Tabs (ink)',
+    hint: 'Tabbed UI for parallel processes',
+  },
+];
+
+// =============================================================================
+// File Generators
+// =============================================================================
+
+export function generatePackageJson(config: ProjectConfig): string {
+  const deps: Record<string, string> = {
+    '@pokit/core': 'latest',
+  };
+
+  // Add selected plugins
+  for (const plugin of config.plugins) {
+    deps[plugin] = 'latest';
+  }
+
+  const pkg = {
+    name: config.name,
+    version: '0.0.1',
+    type: 'module',
+    scripts: {
+      pok: 'bun pok',
+    },
+    dependencies: deps,
+    devDependencies: {
+      '@types/bun': 'latest',
+    },
+  };
+
+  return JSON.stringify(pkg, null, 2) + '\n';
+}
+
+export function generateTsConfig(): string {
+  const config = {
+    compilerOptions: {
+      target: 'ESNext',
+      module: 'ESNext',
+      moduleResolution: 'bundler',
+      types: ['bun'],
+      strict: true,
+      skipLibCheck: true,
+      noEmit: true,
+    },
+    include: ['commands/**/*', 'src/**/*'],
+  };
+
+  return JSON.stringify(config, null, 2) + '\n';
+}
+
+export function generateExampleCommand(): string {
+  return `/**
+ * Example command
+ *
+ * Run with: pok hello
+ */
+
+import { defineCommand } from '@pokit/core';
+
+export const command = defineCommand({
+  label: 'Say hello',
+  run: async (r) => {
+    r.reporter.info('Hello from pok!');
+  },
+});
+`;
+}
+
+export function generateBuildCommand(): string {
+  return `/**
+ * Build command
+ */
+
+import { defineCommand } from '@pokit/core';
+
+export const command = defineCommand({
+  label: 'Build project',
+  run: async (r) => {
+    await r.exec('bun tsc --noEmit');
+  },
+});
+`;
+}
+
+export function generateGitignore(): string {
+  return `node_modules/
+dist/
+.DS_Store
+`;
+}