@nextsparkjs/core 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/bin/wizard/presets.ts

@@ -0,0 +1,274 @@
+/**
+ * NextSpark Wizard Presets
+ *
+ * Pre-configured project templates for common use cases.
+ * Presets pre-fill all configuration values but still allow customization.
+ */
+
+import type {
+  WizardConfig,
+  PresetName,
+  TeamMode,
+  BillingModel,
+  FeatureFlags,
+  ContentFeaturesConfig,
+  AuthConfig,
+  DashboardConfig,
+  DevConfig,
+} from './types.js'
+
+/**
+ * Partial preset configuration (projectName, projectSlug, projectDescription
+ * are always prompted even with presets)
+ */
+export interface PresetConfig {
+  teamMode: TeamMode
+  teamRoles: string[]
+  defaultLocale: string
+  supportedLocales: string[]
+  billingModel: BillingModel
+  currency: string
+  features: FeatureFlags
+  contentFeatures: ContentFeaturesConfig
+  auth: AuthConfig
+  dashboard: DashboardConfig
+  dev: DevConfig
+}
+
+/**
+ * SaaS Preset
+ *
+ * Multi-tenant SaaS application with freemium billing,
+ * team management, and authentication options.
+ */
+const SAAS_PRESET: PresetConfig = {
+  teamMode: 'multi-tenant',
+  teamRoles: ['owner', 'admin', 'member', 'viewer'],
+  defaultLocale: 'en',
+  supportedLocales: ['en'],
+  billingModel: 'freemium',
+  currency: 'usd',
+  features: {
+    analytics: true,
+    teams: true,
+    billing: true,
+    api: true,
+    docs: false,
+  },
+  contentFeatures: {
+    pages: false,
+    blog: false,
+  },
+  auth: {
+    emailPassword: true,
+    googleOAuth: true,
+    emailVerification: true,
+  },
+  dashboard: {
+    search: true,
+    notifications: true,
+    themeToggle: true,
+    support: true,
+    quickCreate: true,
+    superadminAccess: true,
+    devtoolsAccess: true,
+    sidebarCollapsed: false,
+  },
+  dev: {
+    devKeyring: true,
+    debugMode: false,
+  },
+}
+
+/**
+ * Blog Preset
+ *
+ * Single-user blog or content site with no billing,
+ * minimal authentication, and simple dashboard.
+ */
+const BLOG_PRESET: PresetConfig = {
+  teamMode: 'single-user',
+  teamRoles: ['owner'],
+  defaultLocale: 'en',
+  supportedLocales: ['en'],
+  billingModel: 'free',
+  currency: 'usd',
+  features: {
+    analytics: true,
+    teams: false,
+    billing: false,
+    api: false,
+    docs: true,
+  },
+  contentFeatures: {
+    pages: false,
+    blog: true,
+  },
+  auth: {
+    emailPassword: true,
+    googleOAuth: false,
+    emailVerification: false,
+  },
+  dashboard: {
+    search: false,
+    notifications: false,
+    themeToggle: true,
+    support: true,
+    quickCreate: false,
+    superadminAccess: true,
+    devtoolsAccess: true,
+    sidebarCollapsed: false,
+  },
+  dev: {
+    devKeyring: true,
+    debugMode: false,
+  },
+}
+
+/**
+ * CRM Preset
+ *
+ * Single-tenant CRM or internal tool with paid subscription,
+ * team roles, and full dashboard features.
+ */
+const CRM_PRESET: PresetConfig = {
+  teamMode: 'single-tenant',
+  teamRoles: ['owner', 'admin', 'member'],
+  defaultLocale: 'en',
+  supportedLocales: ['en'],
+  billingModel: 'paid',
+  currency: 'usd',
+  features: {
+    analytics: true,
+    teams: true,
+    billing: true,
+    api: true,
+    docs: false,
+  },
+  contentFeatures: {
+    pages: true,
+    blog: false,
+  },
+  auth: {
+    emailPassword: true,
+    googleOAuth: true,
+    emailVerification: true,
+  },
+  dashboard: {
+    search: true,
+    notifications: true,
+    themeToggle: true,
+    support: true,
+    quickCreate: true,
+    superadminAccess: true,
+    devtoolsAccess: true,
+    sidebarCollapsed: false,
+  },
+  dev: {
+    devKeyring: true,
+    debugMode: false,
+  },
+}
+
+/**
+ * All available presets
+ */
+export const PRESETS: Record<PresetName, PresetConfig> = {
+  saas: SAAS_PRESET,
+  blog: BLOG_PRESET,
+  crm: CRM_PRESET,
+}
+
+/**
+ * Preset descriptions for display
+ */
+export const PRESET_DESCRIPTIONS: Record<PresetName, string> = {
+  saas: 'Multi-tenant SaaS with freemium billing and team management',
+  blog: 'Single-user blog or content site with minimal features',
+  crm: 'Single-tenant CRM or internal tool with paid subscription',
+}
+
+/**
+ * Get a preset configuration by name
+ */
+export function getPreset(name: PresetName): PresetConfig {
+  const preset = PRESETS[name]
+  if (!preset) {
+    throw new Error(`Unknown preset: ${name}. Available presets: ${Object.keys(PRESETS).join(', ')}`)
+  }
+  return preset
+}
+
+/**
+ * Check if a preset name is valid
+ */
+export function isValidPreset(name: string): name is PresetName {
+  return name in PRESETS
+}
+
+/**
+ * Get all available preset names
+ */
+export function getAvailablePresets(): PresetName[] {
+  return Object.keys(PRESETS) as PresetName[]
+}
+
+/**
+ * Apply preset to partial config
+ * (merges project info with preset defaults)
+ */
+export function applyPreset(
+  projectInfo: Pick<WizardConfig, 'projectName' | 'projectSlug' | 'projectDescription'>,
+  presetName: PresetName
+): WizardConfig {
+  const preset = getPreset(presetName)
+  return {
+    ...projectInfo,
+    ...preset,
+  }
+}
+
+/**
+ * Get default configuration (used when no preset is specified)
+ * This provides sensible defaults for all fields.
+ */
+export function getDefaultConfig(): PresetConfig {
+  return {
+    teamMode: 'multi-tenant',
+    teamRoles: ['owner', 'admin', 'member', 'viewer'],
+    defaultLocale: 'en',
+    supportedLocales: ['en'],
+    billingModel: 'freemium',
+    currency: 'usd',
+    features: {
+      analytics: true,
+      teams: true,
+      billing: true,
+      api: true,
+      docs: false,
+    },
+    contentFeatures: {
+      pages: false,
+      blog: false,
+    },
+    auth: {
+      emailPassword: true,
+      googleOAuth: false,
+      emailVerification: true,
+    },
+    dashboard: {
+      search: true,
+      notifications: true,
+      themeToggle: true,
+      support: true,
+      quickCreate: true,
+      superadminAccess: true,
+      devtoolsAccess: true,
+      sidebarCollapsed: false,
+    },
+    dev: {
+      devKeyring: true,
+      debugMode: false,
+    },
+  }
+}

package/dist/bin/wizard/preview.ts

@@ -0,0 +1,220 @@
+/**
+ * NextSpark Interactive Theme Preview
+ *
+ * Provides visual preview of files that will be generated based on wizard configuration.
+ */
+
+import chalk from 'chalk'
+import type { WizardConfig } from './types.js'
+
+/**
+ * Box drawing characters for tree visualization
+ */
+const BOX = {
+  vertical: '\u2502',      // |
+  horizontal: '\u2500',    // -
+  corner: '\u2514',        // L
+  tee: '\u251C',           // |-
+  topLeft: '\u250C',       // top-left corner
+  topRight: '\u2510',      // top-right corner
+  bottomLeft: '\u2514',    // bottom-left corner
+  bottomRight: '\u2518',   // bottom-right corner
+} as const
+
+/**
+ * Get the list of files that will be created based on configuration
+ */
+export function getFileTree(config: WizardConfig): string[] {
+  const files: string[] = []
+  const themeDir = `contents/themes/${config.projectSlug}`
+
+  // Config files
+  files.push(`${themeDir}/config/app.config.ts`)
+  files.push(`${themeDir}/config/billing.config.ts`)
+  files.push(`${themeDir}/config/dashboard.config.ts`)
+  files.push(`${themeDir}/config/dev.config.ts`)
+  files.push(`${themeDir}/config/permissions.config.ts`)
+  files.push(`${themeDir}/config/theme.config.ts`)
+  files.push(`${themeDir}/config/auth.config.ts`)
+  files.push(`${themeDir}/config/dashboard-ui.config.ts`)
+  files.push(`${themeDir}/config/dev-tools.config.ts`)
+
+  // Entity files (tasks example entity)
+  files.push(`${themeDir}/entities/tasks/entity.ts`)
+  files.push(`${themeDir}/entities/tasks/schema.ts`)
+  files.push(`${themeDir}/entities/tasks/permissions.ts`)
+
+  // Block files (hero example block)
+  files.push(`${themeDir}/blocks/hero/block.tsx`)
+  files.push(`${themeDir}/blocks/hero/schema.ts`)
+  files.push(`${themeDir}/blocks/hero/styles.ts`)
+
+  // Messages files - only for supported locales
+  for (const locale of config.supportedLocales) {
+    files.push(`${themeDir}/messages/${locale}/common.json`)
+    files.push(`${themeDir}/messages/${locale}/auth.json`)
+    files.push(`${themeDir}/messages/${locale}/dashboard.json`)
+    files.push(`${themeDir}/messages/${locale}/errors.json`)
+  }
+
+  // Migration files
+  files.push(`${themeDir}/migrations/0001_initial_schema.sql`)
+  files.push(`${themeDir}/migrations/0002_auth_tables.sql`)
+  files.push(`${themeDir}/migrations/0003_tasks_entity.sql`)
+
+  // Style files
+  files.push(`${themeDir}/styles/globals.css`)
+  files.push(`${themeDir}/styles/theme.css`)
+  files.push(`${themeDir}/styles/components.css`)
+
+  // Test files
+  files.push(`${themeDir}/tests/cypress.config.ts`)
+  files.push(`${themeDir}/tests/jest/jest.config.ts`)
+  files.push(`${themeDir}/tests/cypress/e2e/auth.cy.ts`)
+  files.push(`${themeDir}/tests/cypress/e2e/dashboard.cy.ts`)
+  files.push(`${themeDir}/tests/jest/components/hero.test.tsx`)
+
+  return files
+}
+
+/**
+ * Group files by category for display
+ */
+function groupFilesByCategory(files: string[]): Record<string, string[]> {
+  const groups: Record<string, string[]> = {
+    config: [],
+    entities: [],
+    blocks: [],
+    messages: [],
+    migrations: [],
+    styles: [],
+    tests: [],
+  }
+
+  for (const file of files) {
+    if (file.includes('/config/')) {
+      groups.config.push(file)
+    } else if (file.includes('/entities/')) {
+      groups.entities.push(file)
+    } else if (file.includes('/blocks/')) {
+      groups.blocks.push(file)
+    } else if (file.includes('/messages/')) {
+      groups.messages.push(file)
+    } else if (file.includes('/migrations/')) {
+      groups.migrations.push(file)
+    } else if (file.includes('/styles/')) {
+      groups.styles.push(file)
+    } else if (file.includes('/tests/')) {
+      groups.tests.push(file)
+    }
+  }
+
+  return groups
+}
+
+/**
+ * Format file path for display (extract relative part after theme dir)
+ */
+function formatFilePath(file: string, themeDir: string): string {
+  return file.replace(`${themeDir}/`, '')
+}
+
+/**
+ * Display configuration preview with visual tree
+ */
+export function showConfigPreview(config: WizardConfig): void {
+  const files = getFileTree(config)
+  const groups = groupFilesByCategory(files)
+  const themeDir = `contents/themes/${config.projectSlug}`
+
+  console.log('')
+  console.log(chalk.cyan.bold('  Theme Preview'))
+  console.log(chalk.gray('  ' + '='.repeat(50)))
+  console.log('')
+
+  // Display theme directory header
+  console.log(chalk.white.bold(`  ${BOX.topLeft}${'─'.repeat(48)}${BOX.topRight}`))
+  console.log(chalk.white.bold(`  ${BOX.vertical}`) + chalk.cyan(` ${themeDir}/`) + ' '.repeat(48 - themeDir.length - 2) + chalk.white.bold(BOX.vertical))
+  console.log(chalk.white.bold(`  ${BOX.vertical}${'─'.repeat(48)}${BOX.vertical}`))
+
+  // Display each category
+  const categoryLabels: Record<string, string> = {
+    config: 'Configuration',
+    entities: 'Entities',
+    blocks: 'Blocks',
+    messages: 'Messages (i18n)',
+    migrations: 'Migrations',
+    styles: 'Styles',
+    tests: 'Tests',
+  }
+
+  const categoryIcons: Record<string, string> = {
+    config: '*',
+    entities: '@',
+    blocks: '#',
+    messages: '%',
+    migrations: '~',
+    styles: '&',
+    tests: '!',
+  }
+
+  const categoryOrder = ['config', 'entities', 'blocks', 'messages', 'migrations', 'styles', 'tests']
+
+  for (const category of categoryOrder) {
+    const categoryFiles = groups[category]
+    if (categoryFiles.length === 0) continue
+
+    const label = categoryLabels[category]
+    const icon = categoryIcons[category]
+
+    console.log(chalk.white.bold(`  ${BOX.vertical}  `) + chalk.yellow(`[${icon}] ${label}`) + chalk.gray(` (${categoryFiles.length} files)`))
+
+    for (let i = 0; i < categoryFiles.length; i++) {
+      const file = categoryFiles[i]
+      const isLast = i === categoryFiles.length - 1
+      const prefix = isLast ? BOX.corner : BOX.tee
+      const formattedPath = formatFilePath(file, themeDir)
+
+      console.log(chalk.white.bold(`  ${BOX.vertical}  `) + chalk.gray(`    ${prefix}${BOX.horizontal} `) + chalk.white(formattedPath))
+    }
+
+    console.log(chalk.white.bold(`  ${BOX.vertical}`))
+  }
+
+  console.log(chalk.white.bold(`  ${BOX.bottomLeft}${'─'.repeat(48)}${BOX.bottomRight}`))
+  console.log('')
+
+  // Display summary
+  console.log(chalk.cyan.bold('  Summary'))
+  console.log(chalk.gray('  ' + '-'.repeat(30)))
+  console.log('')
+
+  const totalFiles = files.length
+  const estimatedSize = '~350KB'
+
+  console.log(chalk.white(`    Total files:      `) + chalk.green.bold(totalFiles.toString()))
+  console.log(chalk.white(`    Estimated size:   `) + chalk.green.bold(estimatedSize))
+  console.log('')
+
+  // Category breakdown
+  console.log(chalk.gray('    By category:'))
+  for (const category of categoryOrder) {
+    const count = groups[category].length
+    if (count > 0) {
+      const label = categoryLabels[category].padEnd(16)
+      console.log(chalk.gray(`      ${label}`) + chalk.white(count.toString().padStart(3)) + chalk.gray(' files'))
+    }
+  }
+
+  console.log('')
+
+  // Locale information
+  console.log(chalk.gray('    Locales configured:'))
+  for (const locale of config.supportedLocales) {
+    const isDefault = locale === config.defaultLocale
+    const suffix = isDefault ? chalk.cyan(' (default)') : ''
+    console.log(chalk.gray(`      - `) + chalk.white(locale) + suffix)
+  }
+
+  console.log('')
+}

package/dist/bin/wizard/prompts/auth-config.ts

@@ -0,0 +1,93 @@
+/**
+ * Authentication Configuration Prompts (Step 6)
+ *
+ * Collects authentication method preferences and security settings.
+ * Currently supports: Email/Password and Google OAuth
+ */
+
+import { checkbox } from '@inquirer/prompts'
+import { showSection, showInfo } from '../banner.js'
+import type { WizardConfig, AuthConfig, WizardMode } from '../types.js'
+
+/**
+ * Authentication method options
+ * Note: Only email/password and Google OAuth are currently implemented
+ */
+const AUTH_METHOD_OPTIONS = [
+  {
+    name: 'Email & Password',
+    value: 'emailPassword',
+    description: 'Traditional email and password authentication',
+    checked: true,
+  },
+  {
+    name: 'Google OAuth',
+    value: 'googleOAuth',
+    description: 'Sign in with Google accounts',
+    checked: false,
+  },
+]
+
+/**
+ * Security feature options
+ */
+const SECURITY_OPTIONS = [
+  {
+    name: 'Email Verification',
+    value: 'emailVerification',
+    description: 'Require users to verify their email address',
+    checked: true,
+  },
+]
+
+/**
+ * Get default auth configuration
+ */
+export function getDefaultAuthConfig(): AuthConfig {
+  return {
+    emailPassword: true,
+    googleOAuth: false,
+    emailVerification: true,
+  }
+}
+
+/**
+ * Run authentication configuration prompts
+ */
+export async function promptAuthConfig(
+  mode: WizardMode = 'interactive',
+  totalSteps: number = 8
+): Promise<Pick<WizardConfig, 'auth'>> {
+  showSection('Authentication', 6, totalSteps)
+
+  showInfo('Configure how users will authenticate to your application.')
+  console.log('')
+
+  // Select authentication methods
+  const selectedMethods = await checkbox({
+    message: 'Which authentication methods do you want to enable?',
+    choices: AUTH_METHOD_OPTIONS,
+  })
+
+  // In expert mode, also ask about security features
+  let selectedSecurity: string[] = ['emailVerification']
+
+  if (mode === 'expert') {
+    console.log('')
+    showInfo('Configure additional security features.')
+    console.log('')
+
+    selectedSecurity = await checkbox({
+      message: 'Which security features do you want to enable?',
+      choices: SECURITY_OPTIONS,
+    })
+  }
+
+  const auth: AuthConfig = {
+    emailPassword: selectedMethods.includes('emailPassword'),
+    googleOAuth: selectedMethods.includes('googleOAuth'),
+    emailVerification: selectedSecurity.includes('emailVerification'),
+  }
+
+  return { auth }
+}

package/dist/bin/wizard/prompts/billing-config.ts

@@ -0,0 +1,75 @@
+/**
+ * Billing Configuration Prompts (Step 4)
+ *
+ * Collects billing model and payment configuration.
+ */
+
+import { select } from '@inquirer/prompts'
+import { showSection, showInfo } from '../banner.js'
+import type { WizardConfig, BillingModel } from '../types.js'
+import { CURRENCIES } from '../types.js'
+
+/**
+ * Billing model options with descriptions
+ */
+const BILLING_MODEL_OPTIONS = [
+  {
+    name: 'Free (No payments)',
+    value: 'free' as BillingModel,
+    description: 'All features are free. No payment processing needed.',
+  },
+  {
+    name: 'Freemium (Free + Paid tiers)',
+    value: 'freemium' as BillingModel,
+    description: 'Free tier with optional paid upgrades (Free + Pro plans).',
+  },
+  {
+    name: 'Paid (Subscription required)',
+    value: 'paid' as BillingModel,
+    description: 'Subscription-based access with optional trial period.',
+  },
+]
+
+/**
+ * Run billing configuration prompts
+ */
+export async function promptBillingConfig(): Promise<Pick<WizardConfig, 'billingModel' | 'currency'>> {
+  showSection('Billing Configuration', 4, 5)
+
+  // Select billing model
+  const billingModel = await select({
+    message: 'What billing model do you want to use?',
+    choices: BILLING_MODEL_OPTIONS,
+    default: 'freemium',
+  })
+
+  // Show info about selected model
+  const selectedOption = BILLING_MODEL_OPTIONS.find(o => o.value === billingModel)
+  if (selectedOption) {
+    showInfo(selectedOption.description)
+  }
+
+  // Only ask for currency if not free
+  let currency = 'usd'
+
+  if (billingModel !== 'free') {
+    console.log('')
+    currency = await select({
+      message: 'What currency will you use?',
+      choices: CURRENCIES.map(c => ({
+        name: c.label,
+        value: c.value,
+      })),
+      default: 'usd',
+    })
+  }
+
+  // Show info about customizing plans
+  console.log('')
+  showInfo('You can customize plans and pricing in billing.config.ts')
+
+  return {
+    billingModel,
+    currency,
+  }
+}