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

package/dist/bin/test-local.sh

@@ -1,307 +0,0 @@
-#!/bin/bash
-#
-# NextSpark Local Testing Script
-#
-# This script automates the complete testing flow from scratch:
-# 1. Rebuilds the core package
-# 2. Creates a fresh test project
-# 3. Installs NextSpark from local tarball
-# 4. Runs tests
-#
-# Usage:
-#   ./test-local.sh              # Full test (rebuild + create + test)
-#   ./test-local.sh --skip-build # Skip rebuild, only recreate test-app
-#   ./test-local.sh --test-only  # Only run tests on existing test-app
-#
-
-set -e  # Exit on error
-
-# =============================================================================
-# Configuration
-# =============================================================================
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-CORE_DIR="$(dirname "$SCRIPT_DIR")"
-REPO_DIR="$(dirname "$(dirname "$CORE_DIR")")"
-PROJECT_DIR="$(dirname "$REPO_DIR")/project"
-TEST_APP_DIR="$PROJECT_DIR/test-app"
-TARBALL_NAME="nextsparkjs-core-0.3.0.tgz"
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-CYAN='\033[0;36m'
-NC='\033[0m' # No Color
-
-# =============================================================================
-# Helper Functions
-# =============================================================================
-
-log_step() {
-    echo ""
-    echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
-    echo -e "${CYAN}  $1${NC}"
-    echo -e "${BLUE}═══════════════════════════════════════════════════════════════${NC}"
-    echo ""
-}
-
-log_success() {
-    echo -e "${GREEN}  ✓ $1${NC}"
-}
-
-log_warning() {
-    echo -e "${YELLOW}  ⚠ $1${NC}"
-}
-
-log_error() {
-    echo -e "${RED}  ✗ $1${NC}"
-}
-
-log_info() {
-    echo -e "  $1"
-}
-
-# =============================================================================
-# Parse Arguments
-# =============================================================================
-
-SKIP_BUILD=false
-TEST_ONLY=false
-SKIP_TESTS=false
-
-while [[ "$#" -gt 0 ]]; do
-    case $1 in
-        --skip-build) SKIP_BUILD=true ;;
-        --test-only) TEST_ONLY=true ;;
-        --skip-tests) SKIP_TESTS=true ;;
-        -h|--help)
-            echo "Usage: $0 [options]"
-            echo ""
-            echo "Options:"
-            echo "  --skip-build    Skip rebuilding the core package"
-            echo "  --test-only     Only run tests on existing test-app"
-            echo "  --skip-tests    Create project but don't run tests"
-            echo "  -h, --help      Show this help message"
-            exit 0
-            ;;
-        *) echo "Unknown parameter: $1"; exit 1 ;;
-    esac
-    shift
-done
-
-# =============================================================================
-# Main Script
-# =============================================================================
-
-echo ""
-echo -e "${CYAN}╔═══════════════════════════════════════════════════════════════╗${NC}"
-echo -e "${CYAN}║           NextSpark Local Testing Script                      ║${NC}"
-echo -e "${CYAN}╚═══════════════════════════════════════════════════════════════╝${NC}"
-echo ""
-echo -e "  Core Dir:     ${BLUE}$CORE_DIR${NC}"
-echo -e "  Test App Dir: ${BLUE}$TEST_APP_DIR${NC}"
-echo -e "  Skip Build:   $SKIP_BUILD"
-echo -e "  Test Only:    $TEST_ONLY"
-
-# -----------------------------------------------------------------------------
-# Step 0: Test Only Mode
-# -----------------------------------------------------------------------------
-
-if [ "$TEST_ONLY" = true ]; then
-    log_step "Running Tests Only"
-
-    if [ ! -d "$TEST_APP_DIR" ]; then
-        log_error "test-app does not exist. Run without --test-only first."
-        exit 1
-    fi
-
-    cd "$TEST_APP_DIR"
-
-    log_info "Running Jest tests..."
-    pnpm test:theme || log_warning "Some Jest tests failed"
-
-    log_success "Test run completed!"
-    exit 0
-fi
-
-# -----------------------------------------------------------------------------
-# Step 1: Build Core Package
-# -----------------------------------------------------------------------------
-
-if [ "$SKIP_BUILD" = false ]; then
-    log_step "Step 1/7: Building Core Package"
-
-    cd "$CORE_DIR"
-
-    log_info "Running pnpm build..."
-    pnpm build 2>&1 | tail -5
-    log_success "Core package built"
-
-    log_info "Building CLI..."
-    cd bin
-    npx tsup --config tsup.config.ts 2>&1 | tail -3
-    cd ..
-    log_success "CLI built"
-
-    log_info "Creating tarball..."
-    rm -f "$TARBALL_NAME"
-    pnpm pack
-    log_success "Tarball created: $TARBALL_NAME"
-else
-    log_step "Step 1/7: Skipping Build (--skip-build)"
-    log_warning "Using existing tarball"
-fi
-
-# -----------------------------------------------------------------------------
-# Step 2: Clean Previous Test App
-# -----------------------------------------------------------------------------
-
-log_step "Step 2/7: Cleaning Previous Test App"
-
-if [ -d "$TEST_APP_DIR" ]; then
-    log_info "Removing existing test-app..."
-    rm -rf "$TEST_APP_DIR"
-    log_success "Previous test-app removed"
-else
-    log_info "No existing test-app found"
-fi
-
-# Ensure project directory exists
-mkdir -p "$PROJECT_DIR"
-
-# -----------------------------------------------------------------------------
-# Step 3: Create New Next.js Project
-# -----------------------------------------------------------------------------
-
-log_step "Step 3/7: Creating New Next.js Project"
-
-cd "$PROJECT_DIR"
-
-log_info "Running create-next-app..."
-# Use echo to automatically answer "No" to the React Compiler prompt
-echo "n" | pnpm create next-app@latest test-app \
-    --typescript \
-    --tailwind \
-    --eslint \
-    --app \
-    --no-src-dir \
-    --import-alias "@/*" \
-    --use-pnpm \
-    2>&1 | grep -E "(Success|Created|Installing)" || true
-
-if [ ! -d "$TEST_APP_DIR" ]; then
-    log_error "Failed to create Next.js project. Directory does not exist."
-    exit 1
-fi
-
-log_success "Next.js project created"
-
-# -----------------------------------------------------------------------------
-# Step 4: Install NextSpark from Tarball
-# -----------------------------------------------------------------------------
-
-log_step "Step 4/7: Installing NextSpark from Tarball"
-
-cd "$TEST_APP_DIR"
-
-TARBALL_PATH="$CORE_DIR/$TARBALL_NAME"
-
-if [ ! -f "$TARBALL_PATH" ]; then
-    log_error "Tarball not found: $TARBALL_PATH"
-    exit 1
-fi
-
-log_info "Installing $TARBALL_NAME..."
-pnpm add "$TARBALL_PATH" 2>&1 | tail -5
-log_success "NextSpark installed"
-
-# -----------------------------------------------------------------------------
-# Step 5: Run nextspark init
-# -----------------------------------------------------------------------------
-
-log_step "Step 5/7: Running nextspark init"
-
-log_info "Initializing NextSpark..."
-npx nextspark init 2>&1 | grep -E "(✅|Created|Added|Copied|Updated)" || true
-log_success "NextSpark initialized"
-
-# Reinstall to apply hoisting
-log_info "Reinstalling dependencies with hoisting..."
-rm -rf node_modules
-pnpm install 2>&1 | tail -3
-log_success "Dependencies reinstalled"
-
-# -----------------------------------------------------------------------------
-# Step 6: Setup Environment
-# -----------------------------------------------------------------------------
-
-log_step "Step 6/7: Setting Up Environment"
-
-# Create .env file
-cat > .env << 'EOF'
-# Database
-DATABASE_URL=postgresql://postgres:postgres@localhost:54322/postgres
-
-# Auth
-BETTER_AUTH_SECRET=test-secret-key-for-local-development-only
-NEXT_PUBLIC_APP_URL=http://localhost:3000
-
-# Theme
-NEXT_PUBLIC_ACTIVE_THEME=default
-
-# Email (optional)
-RESEND_API_KEY=
-RESEND_FROM_EMAIL=
-
-# Stripe (optional)
-STRIPE_SECRET_KEY=
-STRIPE_WEBHOOK_SECRET=
-NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
-EOF
-
-log_success ".env file created"
-
-# Generate registries
-log_info "Generating registries..."
-pnpm build:registries 2>&1 | tail -3
-log_success "Registries generated"
-
-# -----------------------------------------------------------------------------
-# Step 7: Run Tests
-# -----------------------------------------------------------------------------
-
-# Note: Test dependencies (Jest, Cypress) are now automatically added by nextspark init
-# and installed during the pnpm install step in Step 5
-
-if [ "$SKIP_TESTS" = false ]; then
-    log_step "Step 7/7: Running Tests"
-
-    log_info "Running Jest tests..."
-    pnpm test:theme 2>&1 | tail -20 || log_warning "Some tests failed (this may be expected)"
-else
-    log_step "Step 7/7: Skipping Tests"
-    log_warning "Skipping tests (--skip-tests)"
-fi
-
-# -----------------------------------------------------------------------------
-# Done!
-# -----------------------------------------------------------------------------
-
-echo ""
-echo -e "${GREEN}╔═══════════════════════════════════════════════════════════════╗${NC}"
-echo -e "${GREEN}║                    Setup Complete!                            ║${NC}"
-echo -e "${GREEN}╚═══════════════════════════════════════════════════════════════╝${NC}"
-echo ""
-echo -e "  ${CYAN}Test app location:${NC} $TEST_APP_DIR"
-echo ""
-echo -e "  ${CYAN}Available commands:${NC}"
-echo -e "    cd $TEST_APP_DIR"
-echo -e "    pnpm dev              # Start dev server"
-echo -e "    pnpm test:theme       # Run Jest tests"
-echo -e "    pnpm cy:open          # Open Cypress"
-echo ""
-echo -e "  ${CYAN}To run migrations (requires database):${NC}"
-echo -e "    pnpm db:migrate"
-echo ""

package/dist/bin/tsup.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from 'tsup'
-
-export default defineConfig({
-  entry: ['./init.ts'],
-  format: ['esm'],
-  dts: false,
-  outDir: './dist',
-  clean: true,
-  outExtension: () => ({ js: '.js' }),
-  banner: {
-    js: '#!/usr/bin/env node',
-  },
-})

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>
-  )
-}