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

package/dist/bin/wizard/validators/index.ts

@@ -1,111 +0,0 @@
-/**
- * Validators Index
- *
- * Post-generation validation for NextSpark wizard.
- * Validates the generated theme structure, TypeScript compilation, and i18n completeness.
- */
-
-import type { WizardConfig } from '../types.js'
-import { validateTypeScript } from './typescript.js'
-import { validateRequiredFiles } from './files.js'
-import { validateI18n } from './i18n.js'
-
-/**
- * Represents a validation error that must be fixed
- */
-export interface ValidationError {
-  /** Category of the error (typescript, files, i18n, etc.) */
-  type: string
-  /** Human-readable error message */
-  message: string
-  /** Optional file path related to the error */
-  file?: string
-}
-
-/**
- * Represents a validation warning that should be reviewed
- */
-export interface ValidationWarning {
-  /** Category of the warning */
-  type: string
-  /** Human-readable warning message */
-  message: string
-}
-
-/**
- * Result of the validation process
- */
-export interface ValidationResult {
-  /** Whether validation passed with no errors */
-  valid: boolean
-  /** List of errors that must be fixed */
-  errors: ValidationError[]
-  /** List of warnings that should be reviewed */
-  warnings: ValidationWarning[]
-}
-
-/**
- * Validate the generated theme structure and content
- *
- * Runs all validation checks:
- * 1. File structure validation - checks required directories and files
- * 2. TypeScript validation - runs tsc --noEmit to check for type errors
- * 3. i18n validation - verifies translation completeness
- *
- * @param themePath - Absolute path to the generated theme directory
- * @param config - Wizard configuration used during generation
- * @returns ValidationResult with errors and warnings
- *
- * @example
- * ```typescript
- * const result = await validateGeneratedTheme(
- *   '/path/to/contents/themes/my-app',
- *   wizardConfig
- * )
- *
- * if (!result.valid) {
- *   console.error('Validation failed:', result.errors)
- * }
- * ```
- */
-export async function validateGeneratedTheme(
-  themePath: string,
-  config: WizardConfig
-): Promise<ValidationResult> {
-  const allErrors: ValidationError[] = []
-  const allWarnings: ValidationWarning[] = []
-
-  // 1. Validate file structure first (fast check)
-  const filesResult = await validateRequiredFiles(themePath, config)
-  allErrors.push(...filesResult.errors)
-  allWarnings.push(...filesResult.warnings)
-
-  // 2. Validate i18n completeness
-  const i18nResult = await validateI18n(themePath, config)
-  allErrors.push(...i18nResult.errors)
-  allWarnings.push(...i18nResult.warnings)
-
-  // 3. Validate TypeScript (slower, run last)
-  // Only run if no critical file structure errors
-  const hasCriticalFileErrors = filesResult.errors.some(
-    e => e.message.includes('Theme directory not found') ||
-         e.message.includes('Required directory missing')
-  )
-
-  if (!hasCriticalFileErrors) {
-    const tsResult = await validateTypeScript(themePath)
-    allErrors.push(...tsResult.errors)
-    allWarnings.push(...tsResult.warnings)
-  }
-
-  return {
-    valid: allErrors.length === 0,
-    errors: allErrors,
-    warnings: allWarnings,
-  }
-}
-
-// Re-export individual validators for granular usage
-export { validateTypeScript } from './typescript.js'
-export { validateRequiredFiles } from './files.js'
-export { validateI18n } from './i18n.js'

package/dist/bin/wizard/validators/typescript.ts

@@ -1,133 +0,0 @@
-/**
- * TypeScript Validator
- *
- * Validates TypeScript compilation for the generated theme.
- */
-
-import { exec } from 'child_process'
-import { promisify } from 'util'
-import path from 'path'
-import fs from 'fs-extra'
-import type { ValidationError, ValidationWarning } from './index.js'
-
-const execAsync = promisify(exec)
-
-/**
- * Parse TypeScript compiler output to extract errors
- */
-function parseTypeScriptErrors(output: string, themePath: string): ValidationError[] {
-  const errors: ValidationError[] = []
-  const lines = output.split('\n')
-
-  for (const line of lines) {
-    // Match TypeScript error format: file(line,col): error TSxxxx: message
-    const match = line.match(/^(.+)\((\d+),(\d+)\):\s*error\s+(TS\d+):\s*(.+)$/)
-    if (match) {
-      const [, file, lineNum, col, code, message] = match
-      errors.push({
-        type: 'typescript',
-        message: `${code}: ${message} (line ${lineNum}, col ${col})`,
-        file: file.replace(themePath, '').replace(/^[/\\]/, ''),
-      })
-      continue
-    }
-
-    // Match alternative format: file:line:col - error TSxxxx: message
-    const altMatch = line.match(/^(.+):(\d+):(\d+)\s*-\s*error\s+(TS\d+):\s*(.+)$/)
-    if (altMatch) {
-      const [, file, lineNum, col, code, message] = altMatch
-      errors.push({
-        type: 'typescript',
-        message: `${code}: ${message} (line ${lineNum}, col ${col})`,
-        file: file.replace(themePath, '').replace(/^[/\\]/, ''),
-      })
-    }
-  }
-
-  return errors
-}
-
-/**
- * Validate TypeScript compilation for the generated theme
- *
- * Runs `tsc --noEmit` to check for type errors without generating output files.
- *
- * @param themePath - Absolute path to the theme directory
- * @returns Object containing errors and warnings from compilation
- */
-export async function validateTypeScript(
-  themePath: string
-): Promise<{ errors: ValidationError[]; warnings: ValidationWarning[] }> {
-  const errors: ValidationError[] = []
-  const warnings: ValidationWarning[] = []
-
-  // Check if tsconfig.json exists in project root or theme
-  const projectRoot = process.cwd()
-  const projectTsConfig = path.join(projectRoot, 'tsconfig.json')
-  const themeTsConfig = path.join(themePath, 'tsconfig.json')
-
-  let tsConfigPath: string | null = null
-  if (await fs.pathExists(themeTsConfig)) {
-    tsConfigPath = themeTsConfig
-  } else if (await fs.pathExists(projectTsConfig)) {
-    tsConfigPath = projectTsConfig
-  }
-
-  if (!tsConfigPath) {
-    warnings.push({
-      type: 'typescript',
-      message: 'No tsconfig.json found. TypeScript validation skipped.',
-    })
-    return { errors, warnings }
-  }
-
-  try {
-    // Run tsc --noEmit to check for type errors
-    const tscPath = path.join(projectRoot, 'node_modules', '.bin', 'tsc')
-    const useLocalTsc = await fs.pathExists(tscPath)
-
-    const command = useLocalTsc
-      ? `"${tscPath}" --noEmit --project "${tsConfigPath}"`
-      : `npx tsc --noEmit --project "${tsConfigPath}"`
-
-    await execAsync(command, {
-      cwd: projectRoot,
-      timeout: 120000, // 2 minute timeout
-    })
-
-    // If we get here, compilation succeeded
-  } catch (error: unknown) {
-    // TypeScript exits with non-zero on errors
-    if (error && typeof error === 'object' && 'stdout' in error) {
-      const execError = error as { stdout?: string; stderr?: string; code?: number }
-      const output = execError.stdout || execError.stderr || ''
-
-      // Parse errors from output
-      const parsedErrors = parseTypeScriptErrors(output, themePath)
-      if (parsedErrors.length > 0) {
-        errors.push(...parsedErrors)
-      } else if (output.trim()) {
-        // If we couldn't parse but there's output, add generic error
-        errors.push({
-          type: 'typescript',
-          message: `TypeScript compilation failed: ${output.slice(0, 500)}`,
-        })
-      }
-    } else if (error instanceof Error) {
-      // Handle execution errors (e.g., tsc not found)
-      if (error.message.includes('ENOENT') || error.message.includes('not found')) {
-        warnings.push({
-          type: 'typescript',
-          message: 'TypeScript compiler not found. Run "npm install" first.',
-        })
-      } else {
-        errors.push({
-          type: 'typescript',
-          message: `TypeScript validation failed: ${error.message}`,
-        })
-      }
-    }
-  }
-
-  return { errors, warnings }
-}

package/dist/templates/app/(public)/docs/[category]/[section]/[page]/page.tsx

@@ -1,134 +0,0 @@
-import { notFound } from 'next/navigation'
-import { DOCS_REGISTRY } from '@nextsparkjs/registries/docs-registry'
-import { parseMarkdownFile } from '@nextsparkjs/core/lib/docs/parser'
-import { DocsBreadcrumbs } from '@nextsparkjs/core/components/docs/docs-breadcrumbs'
-import { DocsContent } from '@nextsparkjs/core/components/docs/docs-content'
-import { getTranslations } from 'next-intl/server'
-import path from 'path'
-import type { Metadata } from 'next'
-
-interface DocsPageProps {
-  params: Promise<{
-    category: string
-    section: string
-    page: string
-  }>
-}
-
-export async function generateStaticParams() {
-  const params = []
-
-  // Generate params for core docs
-  for (const section of DOCS_REGISTRY.core) {
-    for (const page of section.pages) {
-      params.push({
-        category: 'core',
-        section: section.slug,
-        page: page.slug
-      })
-    }
-  }
-
-  // Generate params for theme docs
-  for (const section of DOCS_REGISTRY.theme) {
-    for (const page of section.pages) {
-      params.push({
-        category: 'theme',
-        section: section.slug,
-        page: page.slug
-      })
-    }
-  }
-
-  // Future: Plugin docs
-  // for (const section of DOCS_REGISTRY.plugins || []) {
-  //   for (const page of section.pages) {
-  //     params.push({
-  //       category: 'plugins',
-  //       section: section.slug,
-  //       page: page.slug
-  //     })
-  //   }
-  // }
-
-  return params
-}
-
-export async function generateMetadata({ params }: DocsPageProps): Promise<Metadata> {
-  const resolvedParams = await params
-  const { category, section: sectionSlug, page: pageSlug } = resolvedParams
-
-  // Get correct registry based on category
-  const registry = category === 'core' ? DOCS_REGISTRY.core :
-                   category === 'theme' ? DOCS_REGISTRY.theme :
-                   []
-
-  // Find section and page
-  const section = registry.find(s => s.slug === sectionSlug)
-  if (!section) return { title: 'Page Not Found' }
-
-  const page = section.pages.find(p => p.slug === pageSlug)
-  if (!page) return { title: 'Page Not Found' }
-
-  // Parse markdown to get metadata
-  const filePath = path.join(process.cwd(), page.path)
-  const { metadata } = await parseMarkdownFile(filePath)
-
-  return {
-    title: `${metadata.title} | Documentation`,
-    description: metadata.description || `Documentation for ${metadata.title}`
-  }
-}
-
-export default async function DocsPage({ params }: DocsPageProps) {
-  const resolvedParams = await params
-  const { category, section: sectionSlug, page: pageSlug } = resolvedParams
-  const t = await getTranslations('docs')
-
-  // Get correct registry based on category
-  const registry = category === 'core' ? DOCS_REGISTRY.core :
-                   category === 'theme' ? DOCS_REGISTRY.theme :
-                   []
-
-  // Find section in registry
-  const section = registry.find(s => s.slug === sectionSlug)
-  if (!section) notFound()
-
-  // Find page in section
-  const page = section.pages.find(p => p.slug === pageSlug)
-  if (!page) notFound()
-
-  // Parse markdown file
-  const filePath = path.join(process.cwd(), page.path)
-  const { metadata, html } = await parseMarkdownFile(filePath)
-
-  // Get category label for breadcrumbs
-  const categoryLabels: Record<string, string> = {
-    core: t('categories.core'),
-    theme: t('categories.theme'),
-    plugins: t('categories.plugins')
-  }
-  const categoryLabel = categoryLabels[category] || category
-
-  return (
-    <div className="max-w-4xl" data-cy="docs-page">
-      <DocsBreadcrumbs
-        items={[
-          { label: t('breadcrumbs.home'), href: '/docs' },
-          { label: categoryLabel, href: `/docs/${category}` },
-          { label: section.title },
-          { label: metadata.title }
-        ]}
-      />
-
-      <article className="mt-8 prose prose-slate dark:prose-invert max-w-none">
-        <h1 className="text-4xl font-bold mb-2">{metadata.title}</h1>
-        {metadata.description && (
-          <p className="text-xl text-muted-foreground mb-8">{metadata.description}</p>
-        )}
-
-        <DocsContent html={html} />
-      </article>
-    </div>
-  )
-}

package/dist/templates/app/(public)/docs/[category]/page.tsx

@@ -1,139 +0,0 @@
-import { notFound } from 'next/navigation'
-import Link from 'next/link'
-import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@nextsparkjs/core/components/ui/card'
-import { Button } from '@nextsparkjs/core/components/ui/button'
-import { DOCS_REGISTRY } from '@nextsparkjs/registries/docs-registry'
-import { BookOpen, FileText, ArrowRight, Layers } from 'lucide-react'
-
-interface CategoryPageProps {
-  params: Promise<{
-    category: string
-  }>
-}
-
-export default async function CategoryIndexPage({ params }: CategoryPageProps) {
-  const { category } = await params
-
-  // Get sections for this category
-  let sections
-  let categoryTitle
-  let categoryDescription
-
-  if (category === 'core') {
-    sections = DOCS_REGISTRY.core
-    categoryTitle = 'Core Documentation'
-    categoryDescription = 'Complete documentation for the core framework features, architecture, and patterns.'
-  } else if (category === 'theme') {
-    sections = DOCS_REGISTRY.theme
-    categoryTitle = 'Theme Documentation'
-    categoryDescription = 'Documentation for the active theme, including customization and styling guides.'
-  } else if (category === 'plugins') {
-    sections = DOCS_REGISTRY.plugins
-    categoryTitle = 'Plugins Documentation'
-    categoryDescription = 'Documentation for all active plugins and their features.'
-  } else {
-    notFound()
-  }
-
-  if (!sections || sections.length === 0) {
-    return (
-      <div className="container max-w-4xl mx-auto px-4 py-8">
-        <div className="text-center">
-          <h1 className="text-3xl font-bold mb-4">{categoryTitle}</h1>
-          <p className="text-muted-foreground mb-6">{categoryDescription}</p>
-          <p className="text-muted-foreground">No documentation available for this category yet.</p>
-        </div>
-      </div>
-    )
-  }
-
-  return (
-    <div className="container max-w-6xl mx-auto px-4 py-8">
-      {/* Hero Section */}
-      <div className="mb-12">
-        <div className="inline-flex items-center gap-2 bg-primary/10 text-primary px-3 py-1 rounded-full text-sm font-medium mb-4">
-          <BookOpen className="h-4 w-4" />
-          {category.charAt(0).toUpperCase() + category.slice(1)}
-        </div>
-        <h1 className="text-4xl font-bold mb-4">{categoryTitle}</h1>
-        <p className="text-xl text-muted-foreground max-w-3xl">
-          {categoryDescription}
-        </p>
-      </div>
-
-      {/* Sections Grid */}
-      <div className="grid grid-cols-1 gap-6">
-        {sections.map((section) => {
-          const firstPageUrl = section.pages[0]
-            ? category === 'plugins' && section.pluginName
-              ? `/docs/plugins/${section.pluginName}/${section.slug}/${section.pages[0].slug}`
-              : `/docs/${category}/${section.slug}/${section.pages[0].slug}`
-            : '#'
-
-          return (
-            <Card key={section.slug} className="hover:shadow-lg transition-shadow">
-              <CardHeader>
-                <div className="flex items-start justify-between">
-                  <div className="flex-1">
-                    <div className="flex items-center gap-3 mb-2">
-                      <div className="p-2 bg-primary/10 rounded-lg">
-                        <Layers className="h-5 w-5 text-primary" />
-                      </div>
-                      <CardTitle className="text-2xl">{section.title}</CardTitle>
-                    </div>
-                    <CardDescription className="text-base">
-                      {section.pages.length} {section.pages.length === 1 ? 'page' : 'pages'} available
-                      {section.pluginName && (
-                        <span className="ml-2 text-xs bg-purple-500/10 text-purple-600 dark:text-purple-400 px-2 py-0.5 rounded">
-                          Plugin: {section.pluginName}
-                        </span>
-                      )}
-                    </CardDescription>
-                  </div>
-                  <Button asChild variant="ghost" size="sm">
-                    <Link href={firstPageUrl}>
-                      <span className="sr-only">View {section.title}</span>
-                      <ArrowRight className="h-4 w-4" />
-                    </Link>
-                  </Button>
-                </div>
-              </CardHeader>
-              <CardContent>
-                <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-3">
-                  {section.pages.map((page) => {
-                    const pageUrl = category === 'plugins' && section.pluginName
-                      ? `/docs/plugins/${section.pluginName}/${section.slug}/${page.slug}`
-                      : `/docs/${category}/${section.slug}/${page.slug}`
-
-                    return (
-                      <Link
-                        key={page.slug}
-                        href={pageUrl}
-                        className="flex items-center gap-2 p-3 rounded-lg hover:bg-accent transition-colors group"
-                      >
-                        <FileText className="h-4 w-4 text-muted-foreground group-hover:text-foreground transition-colors" />
-                        <span className="text-sm font-medium group-hover:text-primary transition-colors">
-                          {page.title}
-                        </span>
-                      </Link>
-                    )
-                  })}
-                </div>
-              </CardContent>
-            </Card>
-          )
-        })}
-      </div>
-
-      {/* Back to Docs */}
-      <div className="mt-12 text-center">
-        <Button asChild variant="outline">
-          <Link href="/docs">
-            <ArrowRight className="h-4 w-4 mr-2 rotate-180" />
-            Back to Documentation Home
-          </Link>
-        </Button>
-      </div>
-    </div>
-  )
-}

package/dist/templates/app/(public)/docs/layout.tsx

@@ -1,23 +0,0 @@
-import { Suspense } from 'react'
-import { DocsLayout } from '@nextsparkjs/core/components/docs/docs-layout'
-import { DocsSidebar } from '@nextsparkjs/core/components/docs/docs-sidebar'
-import { DOCS_REGISTRY } from '@nextsparkjs/registries/docs-registry'
-
-export default function DocsLayoutPage({
-  children
-}: {
-  children: React.ReactNode
-}) {
-  const sections = DOCS_REGISTRY.all
-
-  return (
-    <DocsLayout>
-      <DocsSidebar sections={sections} />
-      <main className="flex-1 p-6 lg:p-8" data-cy="docs-main-content">
-        <Suspense fallback={<div className="animate-pulse">Loading...</div>}>
-          {children}
-        </Suspense>
-      </main>
-    </DocsLayout>
-  )
-}