@vue-skuilder/cli 0.1.3

package/dist/utils/template.js

@@ -0,0 +1,170 @@
+import { promises as fs } from 'fs';
+import { existsSync } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Find the standalone-ui package in node_modules
+ */
+export async function findStandaloneUiPath() {
+    // Start from CLI package root and work upward
+    let currentDir = path.join(__dirname, '..', '..');
+    while (currentDir !== path.dirname(currentDir)) {
+        const nodeModulesPath = path.join(currentDir, 'node_modules', '@vue-skuilder', 'standalone-ui');
+        if (existsSync(nodeModulesPath)) {
+            return nodeModulesPath;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    throw new Error('Could not find @vue-skuilder/standalone-ui package. Please ensure it is installed.');
+}
+/**
+ * Copy directory recursively, excluding certain files/directories
+ */
+export async function copyDirectory(source, destination, excludePatterns = ['node_modules', 'dist', '.git', 'cypress']) {
+    const entries = await fs.readdir(source, { withFileTypes: true });
+    await fs.mkdir(destination, { recursive: true });
+    for (const entry of entries) {
+        const sourcePath = path.join(source, entry.name);
+        const destPath = path.join(destination, entry.name);
+        // Skip excluded patterns
+        if (excludePatterns.some(pattern => entry.name.includes(pattern))) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            await copyDirectory(sourcePath, destPath, excludePatterns);
+        }
+        else {
+            await fs.copyFile(sourcePath, destPath);
+        }
+    }
+}
+/**
+ * Transform package.json to use published dependencies instead of workspace references
+ */
+export async function transformPackageJson(packageJsonPath, projectName, cliVersion) {
+    const content = await fs.readFile(packageJsonPath, 'utf-8');
+    const packageJson = JSON.parse(content);
+    // Update basic project info
+    packageJson.name = projectName;
+    packageJson.description = `Skuilder course application: ${projectName}`;
+    packageJson.version = '1.0.0';
+    // Transform workspace dependencies to published versions
+    if (packageJson.dependencies) {
+        for (const [depName, version] of Object.entries(packageJson.dependencies)) {
+            if (typeof version === 'string' && version.startsWith('workspace:')) {
+                // Replace workspace references with CLI's version
+                packageJson.dependencies[depName] = `^${cliVersion}`;
+            }
+        }
+    }
+    // Remove CLI-specific fields that don't belong in generated projects
+    delete packageJson.publishConfig;
+    await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2));
+}
+/**
+ * Generate skuilder.config.json based on project configuration
+ */
+export async function generateSkuilderConfig(configPath, config) {
+    const skuilderConfig = {
+        title: config.title,
+        dataLayerType: config.dataLayerType
+    };
+    if (config.course) {
+        skuilderConfig.course = config.course;
+    }
+    if (config.couchdbUrl) {
+        skuilderConfig.couchdbUrl = config.couchdbUrl;
+    }
+    if (config.theme) {
+        skuilderConfig.theme = config.theme;
+    }
+    await fs.writeFile(configPath, JSON.stringify(skuilderConfig, null, 2));
+}
+/**
+ * Generate project README.md
+ */
+export async function generateReadme(readmePath, config) {
+    const dataLayerInfo = config.dataLayerType === 'static'
+        ? 'This project uses a static data layer with JSON files.'
+        : `This project connects to CouchDB at: ${config.couchdbUrl || '[URL not specified]'}`;
+    const readme = `# ${config.title}
+
+A Skuilder course application built with Vue 3, Vuetify, and Pinia.
+
+## Data Layer
+
+${dataLayerInfo}
+
+## Development
+
+Install dependencies:
+\`\`\`bash
+npm install
+\`\`\`
+
+Start the development server:
+\`\`\`bash
+npm run dev
+\`\`\`
+
+Build for production:
+\`\`\`bash
+npm run build
+\`\`\`
+
+## Configuration
+
+Course configuration is managed in \`skuilder.config.json\`. You can modify:
+- Course title
+- Data layer settings
+- Theme customization
+- Database connection details (for dynamic data layer)
+
+## Theme
+
+Current theme: **${config.theme.name}**
+- Primary: ${config.theme.colors.primary}
+- Secondary: ${config.theme.colors.secondary}  
+- Accent: ${config.theme.colors.accent}
+
+## Testing
+
+Run end-to-end tests:
+\`\`\`bash
+npm run test:e2e
+\`\`\`
+
+Run tests in headless mode:
+\`\`\`bash
+npm run test:e2e:headless
+\`\`\`
+
+## Learn More
+
+Visit the [Skuilder documentation](https://github.com/NiloCK/vue-skuilder) for more information about building course applications.
+`;
+    await fs.writeFile(readmePath, readme);
+}
+/**
+ * Copy and transform the standalone-ui template to create a new project
+ */
+export async function processTemplate(projectPath, config, cliVersion) {
+    console.log(chalk.blue('📦 Locating standalone-ui template...'));
+    const templatePath = await findStandaloneUiPath();
+    console.log(chalk.blue('📂 Copying project files...'));
+    await copyDirectory(templatePath, projectPath);
+    console.log(chalk.blue('⚙️  Configuring package.json...'));
+    const packageJsonPath = path.join(projectPath, 'package.json');
+    await transformPackageJson(packageJsonPath, config.projectName, cliVersion);
+    console.log(chalk.blue('🔧 Generating configuration...'));
+    const configPath = path.join(projectPath, 'skuilder.config.json');
+    await generateSkuilderConfig(configPath, config);
+    console.log(chalk.blue('📝 Creating README...'));
+    const readmePath = path.join(projectPath, 'README.md');
+    await generateReadme(readmePath, config);
+    console.log(chalk.green('✅ Template processing complete!'));
+}
+//# sourceMappingURL=template.js.map

package/dist/utils/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"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"}

package/eslint.config.mjs

@@ -0,0 +1,21 @@
+import backendConfig from '../../eslint.config.backend.mjs';
+
+export default [
+  ...backendConfig,
+  {
+    ignores: ['node_modules/**', 'dist/**', 'eslint.config.mjs', 'tsconfig.json'],
+  },
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      // CLI-specific rules - CLI tools need console output
+      'no-console': 'off',
+      '@typescript-eslint/no-console': 'off',
+    },
+  },
+];

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@vue-skuilder/cli",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.3",
+  "type": "module",
+  "description": "CLI scaffolding tool for vue-skuilder projects",
+  "bin": {
+    "skuilder": "./dist/cli.js"
+  },
+  "main": "dist/cli.js",
+  "types": "dist/cli.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "dev": "tsc --watch",
+    "lint": "npx eslint .",
+    "lint:fix": "npx eslint . --fix",
+    "lint:check": "npx eslint . --max-warnings 0"
+  },
+  "keywords": [
+    "cli",
+    "scaffolding",
+    "vue",
+    "skuilder",
+    "education",
+    "course"
+  ],
+  "dependencies": {
+    "@vue-skuilder/standalone-ui": "^0.1.3",
+    "chalk": "^5.3.0",
+    "commander": "^11.0.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.0",
+    "@types/inquirer": "^9.0.0",
+    "@types/node": "^20.0.0",
+    "typescript": "~5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "packageManager": "yarn@4.6.0"
+}

package/src/cli.ts

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { initCommand } from './commands/init.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Read package.json to get version
+const packagePath = join(__dirname, '..', 'package.json');
+const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+
+const program = new Command();
+
+program
+  .name('skuilder')
+  .description('CLI tool for scaffolding Skuilder course applications')
+  .version(packageJson.version);
+
+program
+  .command('init')
+  .argument('<project-name>', 'name of the project to create')
+  .description('create a new Skuilder course application')
+  .option('--data-layer <type>', 'data layer type (static|dynamic)', 'dynamic')
+  .option('--theme <name>', 'theme name (default|medical|educational|corporate)', 'default')
+  .option('--no-interactive', 'skip interactive prompts')
+  .option('--couchdb-url <url>', 'CouchDB server URL (for dynamic data layer)')
+  .option('--course-id <id>', 'course ID to import (for dynamic data layer)')
+  .action(initCommand);
+
+program.on('--help', () => {
+  console.log('');
+  console.log('Examples:');
+  console.log('  $ skuilder init my-anatomy-course');
+  console.log('  $ skuilder init biology-101 --data-layer=static --theme=medical');
+  console.log('  $ skuilder init physics --no-interactive --data-layer=dynamic');
+});
+
+program.parse();

package/src/commands/init.ts

@@ -0,0 +1,83 @@
+import { existsSync } from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { CliOptions } from '../types.js';
+import { gatherProjectConfig, confirmProjectCreation } from '../utils/prompts.js';
+import { processTemplate } from '../utils/template.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export async function initCommand(
+  projectName: string,
+  options: CliOptions
+): Promise<void> {
+  try {
+    // Validate project name
+    if (!isValidProjectName(projectName)) {
+      console.error(chalk.red('❌ Invalid project name. Use only letters, numbers, hyphens, and underscores.'));
+      process.exit(1);
+    }
+
+    // Check if directory already exists
+    const projectPath = path.resolve(process.cwd(), projectName);
+    if (existsSync(projectPath)) {
+      console.error(chalk.red(`❌ Directory "${projectName}" already exists.`));
+      process.exit(1);
+    }
+
+    // Get CLI version for dependency transformation
+    const packagePath = join(__dirname, '..', '..', 'package.json');
+    const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+    const cliVersion = packageJson.version;
+
+    // Gather project configuration
+    const config = await gatherProjectConfig(projectName, options);
+
+    // Confirm project creation (only in interactive mode)
+    if (options.interactive) {
+      const confirmed = await confirmProjectCreation(config, projectPath);
+      if (!confirmed) {
+        console.log(chalk.yellow('Project creation cancelled.'));
+        return;
+      }
+    }
+
+    console.log(chalk.cyan(`\n🛠️  Creating project "${projectName}"...\n`));
+
+    // Process template and create project
+    await processTemplate(projectPath, config, cliVersion);
+
+    // Success message
+    console.log(chalk.green('\n🎉 Project created successfully!\n'));
+    console.log(chalk.cyan('Next steps:'));
+    console.log(`  ${chalk.white('cd')} ${projectName}`);
+    console.log(`  ${chalk.white('npm install')}`);
+    console.log(`  ${chalk.white('npm run dev')}`);
+    console.log('');
+
+    if (config.dataLayerType === 'couch') {
+      console.log(chalk.yellow('📝 Note: Make sure your CouchDB server is running and accessible.'));
+      if (config.course) {
+        console.log(chalk.yellow(`📚 Course ID "${config.course}" will be loaded from the database.`));
+      }
+    } else {
+      console.log(chalk.yellow('📝 Note: This project uses static data. Sample course data has been included.'));
+    }
+
+  } catch (error) {
+    console.error(chalk.red('\n❌ Failed to create project:'));
+    console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    process.exit(1);
+  }
+}
+
+function isValidProjectName(name: string): boolean {
+  // Allow letters, numbers, hyphens, and underscores
+  // Must start with a letter or number
+  const validNameRegex = /^[a-zA-Z0-9][a-zA-Z0-9-_]*$/;
+  return validNameRegex.test(name) && name.length > 0 && name.length <= 214;
+}

package/src/types.ts

@@ -0,0 +1,72 @@
+export interface CliOptions {
+  dataLayer: 'static' | 'dynamic';
+  theme: 'default' | 'medical' | 'educational' | 'corporate';
+  interactive: boolean;
+  couchdbUrl?: string;
+  courseId?: string;
+}
+
+export interface ProjectConfig {
+  projectName: string;
+  title: string;
+  dataLayerType: 'static' | 'couch';
+  course?: string;
+  couchdbUrl?: string;
+  theme: ThemeConfig;
+}
+
+export interface ThemeConfig {
+  name: string;
+  colors: {
+    primary: string;
+    secondary: string;
+    accent: string;
+  };
+}
+
+export interface SkuilderConfig {
+  title: string;
+  course?: string;
+  dataLayerType: 'static' | 'couch';
+  couchdbUrl?: string;
+  theme?: ThemeConfig;
+}
+
+export interface InitCommandOptions extends CliOptions {
+  projectName: string;
+}
+
+export const PREDEFINED_THEMES: Record<string, ThemeConfig> = {
+  default: {
+    name: 'default',
+    colors: {
+      primary: '#1976D2',
+      secondary: '#424242',
+      accent: '#82B1FF'
+    }
+  },
+  medical: {
+    name: 'medical',
+    colors: {
+      primary: '#2E7D32',
+      secondary: '#558B2F',
+      accent: '#66BB6A'
+    }
+  },
+  educational: {
+    name: 'educational',
+    colors: {
+      primary: '#F57C00',
+      secondary: '#FF9800',
+      accent: '#FFB74D'
+    }
+  },
+  corporate: {
+    name: 'corporate',
+    colors: {
+      primary: '#37474F',
+      secondary: '#546E7A',
+      accent: '#78909C'
+    }
+  }
+};

package/src/utils/prompts.ts

@@ -0,0 +1,204 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { CliOptions, ProjectConfig, PREDEFINED_THEMES, ThemeConfig } from '../types.js';
+
+export async function gatherProjectConfig(
+  projectName: string,
+  options: CliOptions
+): Promise<ProjectConfig> {
+  console.log(chalk.cyan('\n🚀 Creating a new Skuilder course application\n'));
+
+  let config: Partial<ProjectConfig> = {
+    projectName
+  };
+
+  if (options.interactive) {
+    const answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'title',
+        message: 'Course title:',
+        default: formatProjectName(projectName),
+        validate: (input: string) => input.trim().length > 0 || 'Course title is required'
+      },
+      {
+        type: 'list',
+        name: 'dataLayerType',
+        message: 'Data layer type:',
+        choices: [
+          {
+            name: 'Dynamic (Connect to CouchDB server)',
+            value: 'couch'
+          },
+          {
+            name: 'Static (Self-contained JSON files)',
+            value: 'static'
+          }
+        ],
+        default: options.dataLayer === 'dynamic' ? 'couch' : 'static'
+      },
+      {
+        type: 'input',
+        name: 'couchdbUrl',
+        message: 'CouchDB server URL:',
+        default: 'http://localhost:5984',
+        when: (answers) => answers.dataLayerType === 'couch',
+        validate: (input: string) => {
+          if (!input.trim()) return 'CouchDB URL is required for dynamic data layer';
+          try {
+            new URL(input);
+            return true;
+          } catch {
+            return 'Please enter a valid URL';
+          }
+        }
+      },
+      {
+        type: 'input',
+        name: 'courseId',
+        message: 'Course ID to import (optional):',
+        when: (answers) => answers.dataLayerType === 'couch'
+      },
+      {
+        type: 'list',
+        name: 'themeName',
+        message: 'Select theme:',
+        choices: [
+          {
+            name: 'Default (Material Blue)',
+            value: 'default'
+          },
+          {
+            name: 'Medical (Healthcare Green)',
+            value: 'medical'
+          },
+          {
+            name: 'Educational (Academic Orange)',
+            value: 'educational'
+          },
+          {
+            name: 'Corporate (Professional Gray)',
+            value: 'corporate'
+          }
+        ],
+        default: options.theme
+      }
+    ]);
+
+    config = {
+      ...config,
+      title: answers.title,
+      dataLayerType: answers.dataLayerType,
+      couchdbUrl: answers.couchdbUrl,
+      course: answers.courseId,
+      theme: PREDEFINED_THEMES[answers.themeName]
+    };
+  } else {
+    // Non-interactive mode: use provided options
+    config = {
+      projectName,
+      title: formatProjectName(projectName),
+      dataLayerType: options.dataLayer === 'dynamic' ? 'couch' : 'static',
+      couchdbUrl: options.couchdbUrl,
+      course: options.courseId,
+      theme: PREDEFINED_THEMES[options.theme]
+    };
+
+    // Validate required fields for non-interactive mode
+    if (config.dataLayerType === 'couch' && !config.couchdbUrl) {
+      throw new Error('CouchDB URL is required when using dynamic data layer. Use --couchdb-url option.');
+    }
+  }
+
+  return config as ProjectConfig;
+}
+
+export async function confirmProjectCreation(
+  config: ProjectConfig,
+  projectPath: string
+): Promise<boolean> {
+  console.log(chalk.yellow('\n📋 Project Configuration Summary:'));
+  console.log(`   Project Name: ${chalk.white(config.projectName)}`);
+  console.log(`   Course Title: ${chalk.white(config.title)}`);
+  console.log(`   Data Layer: ${chalk.white(config.dataLayerType)}`);
+  
+  if (config.couchdbUrl) {
+    console.log(`   CouchDB URL: ${chalk.white(config.couchdbUrl)}`);
+  }
+  
+  if (config.course) {
+    console.log(`   Course ID: ${chalk.white(config.course)}`);
+  }
+  
+  console.log(`   Theme: ${chalk.white(config.theme.name)}`);
+  console.log(`   Directory: ${chalk.white(projectPath)}`);
+
+  const { confirmed } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'confirmed',
+      message: 'Create project with these settings?',
+      default: true
+    }
+  ]);
+
+  return confirmed;
+}
+
+export async function promptForCustomTheme(): Promise<ThemeConfig> {
+  console.log(chalk.cyan('\n🎨 Custom Theme Configuration\n'));
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'name',
+      message: 'Theme name:',
+      validate: (input: string) => input.trim().length > 0 || 'Theme name is required'
+    },
+    {
+      type: 'input',
+      name: 'primary',
+      message: 'Primary color (hex):',
+      default: '#1976D2',
+      validate: validateHexColor
+    },
+    {
+      type: 'input',
+      name: 'secondary',
+      message: 'Secondary color (hex):',
+      default: '#424242',
+      validate: validateHexColor
+    },
+    {
+      type: 'input',
+      name: 'accent',
+      message: 'Accent color (hex):',
+      default: '#82B1FF',
+      validate: validateHexColor
+    }
+  ]);
+
+  return {
+    name: answers.name,
+    colors: {
+      primary: answers.primary,
+      secondary: answers.secondary,
+      accent: answers.accent
+    }
+  };
+}
+
+function formatProjectName(projectName: string): string {
+  return projectName
+    .split(/[-_\s]+/)
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+    .join(' ');
+}
+
+function validateHexColor(input: string): boolean | string {
+  const hexColorRegex = /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/;
+  if (!hexColorRegex.test(input)) {
+    return 'Please enter a valid hex color (e.g., #1976D2)';
+  }
+  return true;
+}