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

package/templates/app/(public)/docs/plugins/[plugin]/[section]/[page]/page.tsx

@@ -1,125 +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 PluginDocsPageProps {
-  params: Promise<{
-    plugin: string
-    section: string
-    page: string
-  }>
-}
-
-export async function generateStaticParams() {
-  const params = []
-
-  // Generate params for all plugin docs
-  for (const section of DOCS_REGISTRY.plugins) {
-    for (const page of section.pages) {
-      if (!section.pluginName) continue
-
-      params.push({
-        plugin: section.pluginName,
-        section: section.slug,
-        page: page.slug
-      })
-    }
-  }
-
-  return params
-}
-
-export async function generateMetadata({ params }: PluginDocsPageProps): Promise<Metadata> {
-  const resolvedParams = await params
-  const { plugin: pluginName, section: sectionSlug, page: pageSlug } = resolvedParams
-
-  // Find plugin sections
-  const pluginSections = DOCS_REGISTRY.plugins.filter(s => s.pluginName === pluginName)
-
-  // Find section and page
-  const section = pluginSections.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)
-
-  // Format plugin name for display
-  const pluginDisplayName = pluginName
-    .split('-')
-    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-    .join(' ')
-
-  return {
-    title: `${metadata.title} | ${pluginDisplayName} Plugin | Documentation`,
-    description: metadata.description || `${pluginDisplayName} plugin documentation for ${metadata.title}`
-  }
-}
-
-export default async function PluginDocsPage({ params }: PluginDocsPageProps) {
-  const resolvedParams = await params
-  const { plugin: pluginName, section: sectionSlug, page: pageSlug } = resolvedParams
-  const t = await getTranslations('docs')
-
-  // Find plugin sections
-  const pluginSections = DOCS_REGISTRY.plugins.filter(s => s.pluginName === pluginName)
-
-  if (pluginSections.length === 0) {
-    notFound()
-  }
-
-  // Find section in plugin sections
-  const section = pluginSections.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)
-
-  // Format plugin name for display
-  const pluginDisplayName = pluginName
-    .split('-')
-    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-    .join(' ')
-
-  return (
-    <div className="max-w-4xl" data-cy="plugin-docs-page">
-      <DocsBreadcrumbs
-        items={[
-          { label: t('breadcrumbs.home'), href: '/docs' },
-          { label: t('categories.plugins'), href: '/docs/plugins' },
-          { label: `${pluginDisplayName} Plugin` },
-          { label: section.title },
-          { label: metadata.title }
-        ]}
-      />
-
-      <article className="mt-8 prose prose-slate dark:prose-invert max-w-none">
-        <div className="mb-4">
-          <span className="inline-flex items-center px-3 py-1 rounded-full text-sm font-medium bg-purple-100 text-purple-800 dark:bg-purple-900 dark:text-purple-200">
-            {pluginDisplayName} Plugin
-          </span>
-        </div>
-
-        <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/templates/app/(public)/docs/plugins/page.tsx

@@ -1,160 +0,0 @@
-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 { Puzzle, FileText, ArrowRight, Layers } from 'lucide-react'
-
-export default function PluginsIndexPage() {
-  const pluginSections = DOCS_REGISTRY.plugins
-
-  // Group sections by plugin name
-  const pluginsByName = pluginSections.reduce((acc, section) => {
-    if (!section.pluginName) return acc
-    if (!acc[section.pluginName]) {
-      acc[section.pluginName] = {
-        name: section.pluginName,
-        sections: []
-      }
-    }
-    acc[section.pluginName].sections.push(section)
-    return acc
-  }, {} as Record<string, { name: string; sections: typeof pluginSections }>)
-
-  const plugins = Object.values(pluginsByName)
-
-  if (plugins.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">Plugins Documentation</h1>
-          <p className="text-muted-foreground mb-6">
-            Documentation for all active plugins and their features.
-          </p>
-          <p className="text-muted-foreground">No plugins documentation available 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-purple-500/10 text-purple-600 dark:text-purple-400 px-3 py-1 rounded-full text-sm font-medium mb-4">
-          <Puzzle className="h-4 w-4" />
-          Plugins
-        </div>
-        <h1 className="text-4xl font-bold mb-4">Plugins Documentation</h1>
-        <p className="text-xl text-muted-foreground max-w-3xl">
-          Complete documentation for all active plugins, including installation guides, feature documentation, and usage examples.
-        </p>
-      </div>
-
-      {/* Stats */}
-      <div className="grid grid-cols-1 sm:grid-cols-3 gap-4 mb-12">
-        <Card>
-          <CardHeader className="pb-3">
-            <CardDescription>Active Plugins</CardDescription>
-            <CardTitle className="text-3xl">{plugins.length}</CardTitle>
-          </CardHeader>
-        </Card>
-        <Card>
-          <CardHeader className="pb-3">
-            <CardDescription>Total Sections</CardDescription>
-            <CardTitle className="text-3xl">{pluginSections.length}</CardTitle>
-          </CardHeader>
-        </Card>
-        <Card>
-          <CardHeader className="pb-3">
-            <CardDescription>Total Pages</CardDescription>
-            <CardTitle className="text-3xl">
-              {pluginSections.reduce((sum, section) => sum + section.pages.length, 0)}
-            </CardTitle>
-          </CardHeader>
-        </Card>
-      </div>
-
-      {/* Plugins Grid */}
-      <div className="grid grid-cols-1 gap-8">
-        {plugins.map((plugin) => {
-          const pluginDisplayName = plugin.name
-            .split('-')
-            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-            .join(' ')
-
-          const totalPages = plugin.sections.reduce((sum, section) => sum + section.pages.length, 0)
-          const firstSection = plugin.sections[0]
-          const firstPageUrl = firstSection?.pages[0]
-            ? `/docs/plugins/${plugin.name}/${firstSection.slug}/${firstSection.pages[0].slug}`
-            : '#'
-
-          return (
-            <Card key={plugin.name} 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-3 bg-purple-500/10 rounded-lg">
-                        <Puzzle className="h-6 w-6 text-purple-600 dark:text-purple-400" />
-                      </div>
-                      <div>
-                        <CardTitle className="text-2xl">{pluginDisplayName} Plugin</CardTitle>
-                        <CardDescription className="text-base mt-1">
-                          {plugin.sections.length} {plugin.sections.length === 1 ? 'section' : 'sections'} • {totalPages} {totalPages === 1 ? 'page' : 'pages'}
-                        </CardDescription>
-                      </div>
-                    </div>
-                  </div>
-                  <Button asChild>
-                    <Link href={firstPageUrl}>
-                      Get Started
-                      <ArrowRight className="h-4 w-4 ml-2" />
-                    </Link>
-                  </Button>
-                </div>
-              </CardHeader>
-              <CardContent>
-                <div className="grid grid-cols-1 lg:grid-cols-2 gap-4">
-                  {plugin.sections.map((section) => (
-                    <div key={section.slug} className="border rounded-lg p-4 hover:bg-accent/50 transition-colors">
-                      <div className="flex items-center gap-2 mb-3">
-                        <Layers className="h-4 w-4 text-muted-foreground" />
-                        <h3 className="font-semibold">{section.title}</h3>
-                      </div>
-                      <div className="space-y-2">
-                        {section.pages.map((page) => {
-                          const pageUrl = `/docs/plugins/${plugin.name}/${section.slug}/${page.slug}`
-
-                          return (
-                            <Link
-                              key={page.slug}
-                              href={pageUrl}
-                              className="flex items-center gap-2 text-sm text-muted-foreground hover:text-foreground transition-colors group"
-                            >
-                              <FileText className="h-3.5 w-3.5 group-hover:text-primary" />
-                              <span>{page.title}</span>
-                            </Link>
-                          )
-                        })}
-                      </div>
-                    </div>
-                  ))}
-                </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/templates/app/(templates)/(public)/blog/[slug]/page.d.ts

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/(public)/blog/[slug]/page.d.ts
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/(public)/blog/[slug]/page.d'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/(public)/blog/[slug]/page.tsx

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/(public)/blog/[slug]/page.tsx
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/(public)/blog/[slug]/page'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/(public)/layout.d.ts

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/(public)/layout.d.ts
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/(public)/layout.d'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

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

@@ -1,9 +0,0 @@
-/**
- * Layout template - directly imports from theme
- * Template: app/(public)/layout.tsx
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/(public)/layout'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/(public)/page.d.ts

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/(public)/page.d.ts
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/(public)/page.d'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/(public)/support/page.d.ts

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/(public)/support/page.d.ts
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/(public)/support/page.d'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/(public)/support/page.tsx

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/(public)/support/page.tsx
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/(public)/support/page'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/dashboard/(main)/agent-multi/page.d.ts

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/dashboard/(main)/agent-multi/page.d.ts
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/dashboard/(main)/agent-multi/page.d'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/dashboard/(main)/agent-multi/page.tsx

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/dashboard/(main)/agent-multi/page.tsx
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/dashboard/(main)/agent-multi/page'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/dashboard/(main)/agent-single/page.d.ts

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/dashboard/(main)/agent-single/page.d.ts
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/dashboard/(main)/agent-single/page.d'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/dashboard/(main)/agent-single/page.tsx

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/dashboard/(main)/agent-single/page.tsx
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/dashboard/(main)/agent-single/page'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/dashboard/(main)/layout.tsx

@@ -1,33 +0,0 @@
-import { DashboardShell } from '@nextsparkjs/core/components/dashboard/layouts/DashboardShell'
-import { getRegisteredEntities } from '@nextsparkjs/core/lib/entities/queries'
-import { serializeEntityConfig, type SerializableEntityConfig } from '@nextsparkjs/core/lib/entities/serialization'
-import { getTemplateOrDefault } from '@nextsparkjs/core/lib/template-resolver'
-import type { EntityConfig, ChildEntityDefinition } from '@nextsparkjs/core/lib/entities/types'
-
-// Type guard to check if entity is a full EntityConfig
-function isEntityConfig(entity: EntityConfig | ChildEntityDefinition): entity is EntityConfig {
-  return 'slug' in entity
-}
-
-// Default main dashboard layout component
-// Note: AuthGuard removed - authentication guaranteed by parent CoreDashboardLayout
-function DefaultMainDashboardLayout({
-  children
-}: {
-  children: React.ReactNode
-}) {
-  const allEntities = getRegisteredEntities()
-  // Filter to only include full EntityConfig (not child entities)
-  const entities = allEntities.filter(isEntityConfig)
-  const serializedEntities: SerializableEntityConfig[] = entities.map(serializeEntityConfig)
-
-  return (
-    <DashboardShell entities={serializedEntities}>
-      {children}
-    </DashboardShell>
-  )
-}
-
-// Export the resolved component (theme override or default)
-// Note: Template path must match registry format (WITH 'app/' prefix)
-export default getTemplateOrDefault('app/dashboard/(main)/layout.tsx', DefaultMainDashboardLayout)

package/templates/app/(templates)/dashboard/(main)/settings/ai-usage/page.d.ts

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/dashboard/(main)/settings/ai-usage/page.d.ts
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/dashboard/(main)/settings/ai-usage/page.d'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/dashboard/(main)/settings/ai-usage/page.tsx

@@ -1,9 +0,0 @@
-/**
- * Template page - directly imports from theme
- * Template: app/dashboard/(main)/settings/ai-usage/page.tsx
- * Generated by: scripts/build-registry.mjs
- */
-import TemplateComponent from '@/contents/themes/default/templates/dashboard/(main)/settings/ai-usage/page'
-
-// Direct export of the theme template (no fallback)
-export default TemplateComponent

package/templates/app/(templates)/dashboard/layout.tsx

@@ -1,90 +0,0 @@
-'use client'
-
-
-import { getTemplateOrDefaultClient } from '@nextsparkjs/registries/template-registry.client'
-import { useAuth } from '@nextsparkjs/core/hooks/useAuth'
-import { useRouter } from 'next/navigation'
-import { useEffect, Suspense } from 'react'
-import { Loader2 } from 'lucide-react'
-import { DashboardTranslationPreloader } from '@nextsparkjs/core/lib/i18n/DashboardTranslationPreloader'
-import { TranslationDebugger } from '@nextsparkjs/core/utils/dev/TranslationDebugger'
-import { useEnsureUserMetadata } from '@nextsparkjs/core/hooks/useEnsureUserMetadata'
-import { useAuthMethodDetector } from '@nextsparkjs/core/hooks/useAuthMethodDetector'
-
-/**
- * Auth Method Detector Wrapper (uses useSearchParams internally)
- */
-function AuthMethodDetectorWrapper() {
-  useAuthMethodDetector()
-  return null
-}
-
-/**
- * Dashboard Layout Content
- */
-function DashboardLayoutContent({ children }: { children: React.ReactNode }) {
-  const { user, isLoading } = useAuth()
-  const router = useRouter()
-
-  // Asegurar que el usuario tenga metadata default
-  useEnsureUserMetadata()
-
-  useEffect(() => {
-    if (!isLoading && !user) {
-      router.push('/login')
-    }
-  }, [user, isLoading, router])
-
-  if (isLoading) {
-    return (
-      <div className="min-h-screen flex items-center justify-center">
-        <Loader2 className="h-8 w-8 animate-spin text-muted-foreground" />
-      </div>
-    )
-  }
-
-  if (!user) {
-    return null
-  }
-
-  return (
-    <>
-      {/* Precargar traducciones del dashboard para mejorar UX de navegación */}
-      <DashboardTranslationPreloader key="dashboard-translation-preloader" />
-
-      {/* Debugger de traducciones (solo en desarrollo con ?debug-i18n=true) */}
-      <TranslationDebugger key="translation-debugger" />
-
-      {/* Detect and save auth method from OAuth redirects (wrapped in Suspense) */}
-      <Suspense key="auth-method-detector" fallback={null}>
-        <AuthMethodDetectorWrapper />
-      </Suspense>
-
-      {/*
-        Children run within authenticated boundary -
-        nested layouts CAN be themed but security is guaranteed
-      */}
-      <div key="dashboard-children">{children}</div>
-    </>
-  )
-}
-
-/**
- * CORE SECURITY LAYOUT - NOT OVERRIDEABLE BY THEMES
- *
- * This layout provides essential authentication and security measures
- * that cannot be bypassed by theme overrides. All dashboard routes
- * run within this authenticated boundary.
- *
- * SECURITY: This layout is intentionally NOT using template resolver
- * to prevent themes from bypassing authentication.
- */
-function CoreDashboardLayout({
-  children
-}: {
-  children: React.ReactNode
-}) {
-  return <DashboardLayoutContent>{children}</DashboardLayoutContent>
-}
-
-export default getTemplateOrDefaultClient('app/dashboard/layout.tsx', CoreDashboardLayout)