@nextsparkjs/core 0.1.0-beta.2 → 0.1.0-beta.4

package/dist/bin/wizard/presets.ts

@@ -1,274 +0,0 @@
-/**
- * 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

@@ -1,220 +0,0 @@
-/**
- * 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

@@ -1,93 +0,0 @@
-/**
- * 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

@@ -1,75 +0,0 @@
-/**
- * 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,
-  }
-}