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

package/dist/bin/wizard/prompts/content-features-config.ts

@@ -0,0 +1,70 @@
+/**
+ * Content Features Configuration Prompts (Step 6)
+ *
+ * Collects optional content features: Pages with Page Builder and Blog.
+ */
+
+import { checkbox } from '@inquirer/prompts'
+import { showSection, showInfo } from '../banner.js'
+import type { WizardConfig, ContentFeaturesConfig, WizardMode } from '../types.js'
+
+/**
+ * Content feature options with descriptions
+ */
+const CONTENT_FEATURE_OPTIONS = [
+  {
+    name: 'Pages with Page Builder',
+    value: 'pages',
+    description: "Adds the 'page' entity with full page builder support. Build custom pages using blocks.",
+    checked: false,
+  },
+  {
+    name: 'Blog',
+    value: 'blog',
+    description: "Adds the 'post' entity for blog articles with the Post Content block for rich editorial content.",
+    checked: false,
+  },
+]
+
+/**
+ * Get default content features configuration
+ */
+export function getDefaultContentFeaturesConfig(): ContentFeaturesConfig {
+  return {
+    pages: false,
+    blog: false,
+  }
+}
+
+/**
+ * Run content features configuration prompts
+ */
+export async function promptContentFeaturesConfig(
+  mode: WizardMode = 'interactive',
+  totalSteps: number = 9
+): Promise<Pick<WizardConfig, 'contentFeatures'>> {
+  showSection('Content Features', 6, totalSteps)
+
+  showInfo('Enable optional content features for your project.')
+  showInfo('These features add entities and blocks for building pages and blog posts.')
+  console.log('')
+
+  // Select content features
+  const selectedFeatures = await checkbox({
+    message: 'Which content features do you want to enable?',
+    choices: CONTENT_FEATURE_OPTIONS,
+  })
+
+  console.log('')
+  showInfo('You can add more blocks later in contents/themes/[your-theme]/blocks/')
+
+  // Convert to content features config object
+  const contentFeatures: ContentFeaturesConfig = {
+    pages: selectedFeatures.includes('pages'),
+    blog: selectedFeatures.includes('blog'),
+  }
+
+  return {
+    contentFeatures,
+  }
+}

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

@@ -0,0 +1,117 @@
+/**
+ * Dashboard Configuration Prompts (Step 7)
+ *
+ * Collects dashboard UI preferences and layout options.
+ */
+
+import { checkbox, confirm } from '@inquirer/prompts'
+import { showSection, showInfo } from '../banner.js'
+import type { WizardConfig, DashboardConfig, WizardMode } from '../types.js'
+
+/**
+ * Dashboard feature options
+ */
+const DASHBOARD_FEATURE_OPTIONS = [
+  {
+    name: 'Global Search',
+    value: 'search',
+    description: 'Search across your application from the dashboard',
+    checked: false,
+  },
+  {
+    name: 'Notifications',
+    value: 'notifications',
+    description: 'In-app notification system with bell icon',
+    checked: false,
+  },
+  {
+    name: 'Theme Toggle',
+    value: 'themeToggle',
+    description: 'Allow users to switch between light and dark themes',
+    checked: true,
+  },
+  {
+    name: 'Support/Help Menu',
+    value: 'support',
+    description: 'Help dropdown with documentation and support links',
+    checked: true,
+  },
+  {
+    name: 'Quick Create',
+    value: 'quickCreate',
+    description: 'Quick create button for creating new entities',
+    checked: true,
+  },
+  {
+    name: 'Superadmin Access',
+    value: 'superadminAccess',
+    description: 'Button to access superadmin area (only visible to superadmins)',
+    checked: true,
+  },
+  {
+    name: 'DevTools Access',
+    value: 'devtoolsAccess',
+    description: 'Button to access developer tools (only visible to developers)',
+    checked: true,
+  },
+]
+
+/**
+ * Get default dashboard configuration
+ */
+export function getDefaultDashboardConfig(): DashboardConfig {
+  return {
+    search: false,
+    notifications: false,
+    themeToggle: true,
+    support: true,
+    quickCreate: true,
+    superadminAccess: true,
+    devtoolsAccess: true,
+    sidebarCollapsed: false,
+  }
+}
+
+/**
+ * Run dashboard configuration prompts
+ */
+export async function promptDashboardConfig(
+  mode: WizardMode = 'interactive',
+  totalSteps: number = 8
+): Promise<Pick<WizardConfig, 'dashboard'>> {
+  showSection('Dashboard', 7, totalSteps)
+
+  showInfo('Configure your dashboard user interface.')
+  showInfo('These settings can be changed later in your theme config.')
+  console.log('')
+
+  // Select dashboard features
+  const selectedFeatures = await checkbox({
+    message: 'Which dashboard features do you want to enable?',
+    choices: DASHBOARD_FEATURE_OPTIONS,
+  })
+
+  // In expert mode, ask about sidebar default state
+  let sidebarCollapsed = false
+
+  if (mode === 'expert') {
+    console.log('')
+    sidebarCollapsed = await confirm({
+      message: 'Start with sidebar collapsed by default?',
+      default: false,
+    })
+  }
+
+  const dashboard: DashboardConfig = {
+    search: selectedFeatures.includes('search'),
+    notifications: selectedFeatures.includes('notifications'),
+    themeToggle: selectedFeatures.includes('themeToggle'),
+    support: selectedFeatures.includes('support'),
+    quickCreate: selectedFeatures.includes('quickCreate'),
+    superadminAccess: selectedFeatures.includes('superadminAccess'),
+    devtoolsAccess: selectedFeatures.includes('devtoolsAccess'),
+    sidebarCollapsed,
+  }
+
+  return { dashboard }
+}

package/dist/bin/wizard/prompts/demo-install.ts

@@ -0,0 +1,45 @@
+/**
+ * Demo Theme Installation Prompt
+ *
+ * Asks the user if they want to install a demo theme before completing the wizard.
+ * This allows users to explore NextSpark functionality with a fully-featured theme.
+ */
+
+import { select } from '@inquirer/prompts'
+import chalk from 'chalk'
+
+/**
+ * Prompt the user to install a demo theme
+ *
+ * Explains that the demo is for demonstration purposes only
+ * and that the wizard must still be completed afterwards.
+ */
+export async function promptDemoInstall(): Promise<boolean> {
+  console.log('')
+  console.log(chalk.cyan('  Demo Theme Installation'))
+  console.log(chalk.gray('  ' + '-'.repeat(40)))
+  console.log('')
+  console.log(chalk.gray('  A demo theme lets you explore NextSpark features immediately.'))
+  console.log(chalk.gray('  ' + chalk.yellow('Note:') + ' This is for demonstration only.'))
+  console.log(chalk.gray('  You will still need to complete the wizard to create your project.'))
+  console.log('')
+
+  const installDemo = await select({
+    message: 'Would you like to install a demo theme first?',
+    choices: [
+      {
+        name: 'No, continue with wizard',
+        value: false,
+        description: 'Proceed directly to project configuration',
+      },
+      {
+        name: 'Yes, install demo theme',
+        value: true,
+        description: 'Install the default demo theme to explore features',
+      },
+    ],
+    default: false,
+  })
+
+  return installDemo
+}

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

@@ -0,0 +1,78 @@
+/**
+ * Development Tools Configuration Prompts (Step 8)
+ *
+ * Collects development and debugging preferences.
+ */
+
+import { checkbox, confirm } from '@inquirer/prompts'
+import { showSection, showInfo, showWarning } from '../banner.js'
+import type { WizardConfig, DevConfig, WizardMode } from '../types.js'
+
+/**
+ * Development tool options
+ */
+const DEV_TOOL_OPTIONS = [
+  {
+    name: 'Dev Keyring',
+    value: 'devKeyring',
+    description: 'Quick login as different users during development',
+    checked: true,
+  },
+  {
+    name: 'Debug Mode',
+    value: 'debugMode',
+    description: 'Enable verbose logging and debugging tools',
+    checked: false,
+  },
+]
+
+/**
+ * Get default dev configuration
+ */
+export function getDefaultDevConfig(): DevConfig {
+  return {
+    devKeyring: true,
+    debugMode: false,
+  }
+}
+
+/**
+ * Run development tools configuration prompts
+ */
+export async function promptDevConfig(
+  mode: WizardMode = 'interactive',
+  totalSteps: number = 8
+): Promise<Pick<WizardConfig, 'dev'>> {
+  showSection('Development Tools', 8, totalSteps)
+
+  showInfo('Configure development and debugging tools.')
+  showWarning('These tools are disabled in production builds.')
+  console.log('')
+
+  let devKeyring = true
+  let debugMode = false
+
+  if (mode === 'expert') {
+    // Expert mode: show all options
+    const selectedTools = await checkbox({
+      message: 'Which development tools do you want to enable?',
+      choices: DEV_TOOL_OPTIONS,
+    })
+
+    devKeyring = selectedTools.includes('devKeyring')
+    debugMode = selectedTools.includes('debugMode')
+  } else {
+    // Interactive mode: just ask about dev keyring
+    devKeyring = await confirm({
+      message: 'Enable dev keyring for quick user switching during development?',
+      default: true,
+    })
+  }
+
+  const dev: DevConfig = {
+    devKeyring,
+    debugMode,
+  }
+
+  return { dev }
+}

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

@@ -0,0 +1,83 @@
+/**
+ * Environment Configuration Prompts
+ *
+ * Collects environment setup preferences for the project.
+ */
+
+import { confirm, input } from '@inquirer/prompts'
+import { showSection, showInfo } from '../banner.js'
+
+/**
+ * Environment setup answers from prompts
+ */
+export interface EnvSetupAnswers {
+  setupEnv: boolean
+  generateSecrets: boolean
+  databaseUrl?: string
+}
+
+/**
+ * Get default environment setup answers
+ */
+export function getDefaultEnvSetupAnswers(): EnvSetupAnswers {
+  return {
+    setupEnv: true,
+    generateSecrets: true,
+    databaseUrl: undefined,
+  }
+}
+
+/**
+ * Run environment configuration prompts
+ */
+export async function promptEnvSetup(): Promise<EnvSetupAnswers> {
+  showSection('Environment Setup', 9, 9)
+
+  showInfo('Configure your environment variables.')
+  showInfo('This will create a .env file based on .env.example.')
+  console.log('')
+
+  // Ask if user wants to set up .env
+  const setupEnv = await confirm({
+    message: 'Would you like to configure .env file?',
+    default: true,
+  })
+
+  if (!setupEnv) {
+    return {
+      setupEnv: false,
+      generateSecrets: false,
+      databaseUrl: undefined,
+    }
+  }
+
+  console.log('')
+
+  // Ask if user wants to generate secrets
+  const generateSecrets = await confirm({
+    message: 'Generate secure AUTH_SECRET and ENCRYPTION_KEY automatically?',
+    default: true,
+  })
+
+  console.log('')
+
+  // Ask for database URL (optional)
+  const databaseUrl = await input({
+    message: 'Enter DATABASE_URL (leave empty to use default):',
+    default: '',
+    validate: (value) => {
+      if (value === '') return true
+      // Basic validation for postgres URL format
+      if (value.startsWith('postgresql://') || value.startsWith('postgres://')) {
+        return true
+      }
+      return 'Please enter a valid PostgreSQL connection string (postgresql://...)'
+    },
+  })
+
+  return {
+    setupEnv,
+    generateSecrets,
+    databaseUrl: databaseUrl || undefined,
+  }
+}

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

@@ -0,0 +1,75 @@
+/**
+ * Features Configuration Prompts (Step 5)
+ *
+ * Collects feature flags and optional modules.
+ */
+
+import { checkbox } from '@inquirer/prompts'
+import { showSection, showInfo } from '../banner.js'
+import type { WizardConfig, FeatureFlags } from '../types.js'
+
+/**
+ * Feature options with descriptions
+ */
+const FEATURE_OPTIONS = [
+  {
+    name: 'Analytics Dashboard',
+    value: 'analytics',
+    description: 'Built-in analytics and metrics dashboard',
+    checked: true,
+  },
+  {
+    name: 'Team Management',
+    value: 'teams',
+    description: 'Team invitations, roles, and member management',
+    checked: true,
+  },
+  {
+    name: 'Billing & Subscriptions',
+    value: 'billing',
+    description: 'Stripe integration for payments and subscriptions',
+    checked: true,
+  },
+  {
+    name: 'API Access',
+    value: 'api',
+    description: 'REST API endpoints with authentication',
+    checked: true,
+  },
+  {
+    name: 'Documentation Site',
+    value: 'docs',
+    description: 'Built-in documentation system with markdown support',
+    checked: false,
+  },
+]
+
+/**
+ * Run features configuration prompts
+ */
+export async function promptFeaturesConfig(): Promise<Pick<WizardConfig, 'features'>> {
+  showSection('Features', 5, 5)
+
+  showInfo('Select the features you want to include in your project.')
+  showInfo('You can add or remove features later by editing your config files.')
+  console.log('')
+
+  // Select features
+  const selectedFeatures = await checkbox({
+    message: 'Which features do you want to enable?',
+    choices: FEATURE_OPTIONS,
+  })
+
+  // Convert to feature flags object
+  const features: FeatureFlags = {
+    analytics: selectedFeatures.includes('analytics'),
+    teams: selectedFeatures.includes('teams'),
+    billing: selectedFeatures.includes('billing'),
+    api: selectedFeatures.includes('api'),
+    docs: selectedFeatures.includes('docs'),
+  }
+
+  return {
+    features,
+  }
+}

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

@@ -0,0 +1,90 @@
+/**
+ * Git Configuration Prompts
+ *
+ * Collects Git initialization and commit preferences.
+ */
+
+import { confirm, input } from '@inquirer/prompts'
+import { showSection } from '../banner.js'
+
+/**
+ * Git setup answers from user prompts
+ */
+export interface GitSetupAnswers {
+  initGit: boolean
+  createCommit: boolean
+  commitMessage?: string
+}
+
+/**
+ * Validate commit message
+ */
+function validateCommitMessage(message: string): string | true {
+  if (!message || message.trim().length === 0) {
+    return 'Commit message is required'
+  }
+  if (message.trim().length < 5) {
+    return 'Commit message must be at least 5 characters'
+  }
+  if (message.trim().length > 100) {
+    return 'Commit message must be less than 100 characters'
+  }
+  return true
+}
+
+/**
+ * Get default git setup answers (for quick mode)
+ */
+export function getDefaultGitSetupAnswers(): GitSetupAnswers {
+  return {
+    initGit: true,
+    createCommit: true,
+    commitMessage: 'Initial commit: NextSpark project setup',
+  }
+}
+
+/**
+ * Run git configuration prompts
+ */
+export async function promptGitSetup(): Promise<GitSetupAnswers> {
+  showSection('Git Configuration', 9, 9)
+
+  // Ask if user wants to initialize git
+  const initGit = await confirm({
+    message: 'Initialize a Git repository?',
+    default: true,
+  })
+
+  if (!initGit) {
+    return {
+      initGit: false,
+      createCommit: false,
+    }
+  }
+
+  // Ask if user wants to create initial commit
+  const createCommit = await confirm({
+    message: 'Create an initial commit?',
+    default: true,
+  })
+
+  if (!createCommit) {
+    return {
+      initGit: true,
+      createCommit: false,
+    }
+  }
+
+  // Get commit message
+  const commitMessage = await input({
+    message: 'Commit message:',
+    default: 'Initial commit: NextSpark project setup',
+    validate: validateCommitMessage,
+  })
+
+  return {
+    initGit,
+    createCommit,
+    commitMessage,
+  }
+}

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

@@ -0,0 +1,62 @@
+/**
+ * Internationalization Prompts (Step 3)
+ *
+ * Collects language and locale configuration.
+ */
+
+import { select, checkbox } from '@inquirer/prompts'
+import { showSection, showInfo } from '../banner.js'
+import type { WizardConfig } from '../types.js'
+import { AVAILABLE_LOCALES } from '../types.js'
+
+/**
+ * Locale options for selection
+ */
+const LOCALE_OPTIONS = Object.entries(AVAILABLE_LOCALES).map(([value, name]) => ({
+  name: `${name} (${value})`,
+  value,
+  checked: value === 'en', // English selected by default
+}))
+
+/**
+ * Run i18n configuration prompts
+ */
+export async function promptI18nConfig(): Promise<Pick<WizardConfig, 'defaultLocale' | 'supportedLocales'>> {
+  showSection('Internationalization', 3, 5)
+
+  // Select supported languages
+  const supportedLocales = await checkbox({
+    message: 'Which languages do you want to support?',
+    choices: LOCALE_OPTIONS,
+    required: true,
+  })
+
+  // Ensure at least one language is selected
+  if (supportedLocales.length === 0) {
+    showInfo('At least one language is required. English has been selected.')
+    supportedLocales.push('en')
+  }
+
+  // Select default language from the selected ones
+  let defaultLocale: string = 'en'
+
+  if (supportedLocales.length === 1) {
+    defaultLocale = supportedLocales[0]
+    showInfo(`Default language set to ${AVAILABLE_LOCALES[defaultLocale]}`)
+  } else {
+    console.log('')
+    defaultLocale = await select({
+      message: 'Which should be the default language?',
+      choices: supportedLocales.map(locale => ({
+        name: `${AVAILABLE_LOCALES[locale]} (${locale})`,
+        value: locale,
+      })),
+      default: supportedLocales.includes('en') ? 'en' : supportedLocales[0],
+    })
+  }
+
+  return {
+    defaultLocale,
+    supportedLocales,
+  }
+}