@nextsparkjs/core 0.1.0-beta.135 → 0.1.0-beta.137

package/templates/app/api/csp-report/route.ts

@@ -5,15 +5,18 @@ import { NextRequest, NextResponse } from 'next/server';
 let checkDistributedRateLimit: ((id: string, tier: string) => Promise<{ allowed: boolean; limit: number; remaining: number; resetTime: number; retryAfter?: number }>) | null = null;
 let createRateLimitErrorResponse: ((result: { allowed: boolean; limit: number; remaining: number; resetTime: number; retryAfter?: number }) => NextResponse) | null = null;
 
-// Try to load rate limiting functions
-try {
-  // eslint-disable-next-line @typescript-eslint/no-require-imports
-  const rateLimitModule = require('@nextsparkjs/core/lib/api');
-  checkDistributedRateLimit = rateLimitModule.checkDistributedRateLimit;
-  createRateLimitErrorResponse = rateLimitModule.createRateLimitErrorResponse;
-} catch {
-  // Rate limiting not available - will skip rate limit checks
-  console.warn('[CSP Report] Rate limiting not available - running without rate limits');
+// Lazy-load rate limiting functions on first request
+let rateLimitLoaded = false;
+async function ensureRateLimitLoaded() {
+  if (rateLimitLoaded) return;
+  rateLimitLoaded = true;
+  try {
+    const rateLimitModule = await import('@nextsparkjs/core/lib/api');
+    checkDistributedRateLimit = rateLimitModule.checkDistributedRateLimit;
+    createRateLimitErrorResponse = rateLimitModule.createRateLimitErrorResponse;
+  } catch {
+    console.warn('[CSP Report] Rate limiting not available - running without rate limits');
+  }
 }
 
 /**
@@ -73,6 +76,7 @@ function getClientIp(request: NextRequest): string {
 }
 
 export async function POST(request: NextRequest) {
+  await ensureRateLimitLoaded();
   const requestId = randomUUID().slice(0, 8);
   let rateLimitHeaders: Record<string, string> = {};
 

package/templates/app/dashboard/(main)/[entity]/[id]/page.tsx

@@ -77,27 +77,9 @@ async function EntityDetailPage({ params }: PageProps) {
   )
 }
 
-export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
-  const resolvedParams = await params
-  const entitySlug = resolvedParams.entity
-
-  if (!(entitySlug in getEntityRegistry())) {
-    return {
-      title: 'Not Found - Dashboard'
-    }
-  }
-
-  const entityConfig = getEntity(entitySlug as string)
-  if (!entityConfig || !isEntityConfig(entityConfig)) {
-    return {
-      title: 'Not Found - Dashboard'
-    }
-  }
-
-  return {
-    title: `${entityConfig.names.plural} #${resolvedParams.id} - Dashboard`,
-    description: `View details for ${entityConfig.names.singular}`
-  }
+export const metadata: Metadata = {
+  title: 'Dashboard',
+  description: 'View entity details'
 }
 
 export default EntityDetailPage

package/templates/app/dashboard/(main)/[entity]/page.tsx

@@ -63,28 +63,9 @@ async function EntityListPage({ params }: PageProps) {
   )
 }
 
-export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
-  const resolvedParams = await params
-  const entitySlug = resolvedParams.entity
-
-  const registry = getEntityRegistry()
-  if (!(entitySlug in registry)) {
-    return {
-      title: 'Not Found - Dashboard'
-    }
-  }
-
-  const entityConfig = getEntity(entitySlug)
-  if (!entityConfig || !isEntityConfig(entityConfig)) {
-    return {
-      title: 'Not Found - Dashboard'
-    }
-  }
-
-  return {
-    title: `${entityConfig.names.plural} - Dashboard`,
-    description: `Manage ${entityConfig.names.plural.toLowerCase()} in your dashboard`
-  }
+export const metadata: Metadata = {
+  title: 'Dashboard',
+  description: 'Manage entities in your dashboard'
 }
 
 export default getTemplateOrDefault('app/dashboard/(main)/[entity]/page.tsx', EntityListPage)

package/templates/app/dashboard/settings/password/page.tsx

@@ -301,6 +301,5 @@ function UpdatePasswordPage() {
 }
 
 // Opt out of static generation due to client-side state
-export const dynamic = 'force-dynamic';
 
 export default getTemplateOrDefaultClient('app/dashboard/settings/password/page.tsx', UpdatePasswordPage)

package/templates/app/devtools/blocks/[slug]/page.tsx

@@ -33,7 +33,9 @@ export default async function BlockDetailPage({ params }: BlockDetailPageProps)
  * Generate static params for all blocks
  */
 export async function generateStaticParams() {
-  return Object.keys(BLOCK_REGISTRY).map((slug) => ({
+  const keys = Object.keys(BLOCK_REGISTRY);
+  if (keys.length === 0) return [{ slug: '_placeholder' }];
+  return keys.map((slug) => ({
     slug,
   }));
 }

package/templates/app/devtools/blocks/page.tsx

@@ -1,3 +1,4 @@
+import { Suspense } from "react";
 import { BlocksViewer } from "@nextsparkjs/core/components/devtools/BlocksViewer";
 import { LayoutGrid } from "lucide-react";
 import { getTranslations } from "next-intl/server";
@@ -8,7 +9,7 @@ import { getTranslations } from "next-intl/server";
  * Displays all page builder blocks with field definitions and coverage info.
  * Provides filtering and search capabilities.
  */
-export default async function DevBlocksPage() {
+async function DevBlocksPageContent() {
   const t = await getTranslations("devtools.blocks");
 
   return (
@@ -29,3 +30,11 @@ export default async function DevBlocksPage() {
     </div>
   );
 }
+
+export default function DevBlocksPage() {
+  return (
+    <Suspense fallback={null}>
+      <DevBlocksPageContent />
+    </Suspense>
+  );
+}

package/templates/app/devtools/config/page.tsx

@@ -1,3 +1,4 @@
+import { Suspense } from "react";
 import { ConfigViewer } from "@nextsparkjs/core/components/devtools";
 import { Settings } from "lucide-react";
 import { getTranslations } from "next-intl/server";
@@ -8,7 +9,7 @@ import { getTranslations } from "next-intl/server";
  * Displays theme configuration and entity registry information.
  * Provides read-only view with JSON formatting and copy functionality.
  */
-export default async function DevConfigPage() {
+async function DevConfigPageContent() {
   const t = await getTranslations('dev.config');
 
   return (
@@ -29,3 +30,11 @@ export default async function DevConfigPage() {
     </div>
   );
 }
+
+export default function DevConfigPage() {
+  return (
+    <Suspense fallback={null}>
+      <DevConfigPageContent />
+    </Suspense>
+  );
+}

package/templates/app/devtools/features/page.tsx

@@ -1,3 +1,4 @@
+import { Suspense } from "react";
 import { FeaturesViewer } from "@nextsparkjs/core/components/devtools/FeaturesViewer";
 import { Layers } from "lucide-react";
 import { getTranslations } from "next-intl/server";
@@ -8,7 +9,7 @@ import { getTranslations } from "next-intl/server";
  * Displays all features from the testing registry with coverage information.
  * Provides filtering and search capabilities.
  */
-export default async function DevFeaturesPage() {
+async function DevFeaturesPageContent() {
   const t = await getTranslations("devtools.features");
 
   return (
@@ -29,3 +30,11 @@ export default async function DevFeaturesPage() {
     </div>
   );
 }
+
+export default function DevFeaturesPage() {
+  return (
+    <Suspense fallback={null}>
+      <DevFeaturesPageContent />
+    </Suspense>
+  );
+}

package/templates/app/devtools/flows/page.tsx

@@ -1,3 +1,4 @@
+import { Suspense } from "react";
 import { FlowsViewer } from "@nextsparkjs/core/components/devtools/FlowsViewer";
 import { GitBranch } from "lucide-react";
 import { getTranslations } from "next-intl/server";
@@ -8,7 +9,7 @@ import { getTranslations } from "next-intl/server";
  * Displays all user journey flows from the testing registry with coverage information.
  * Provides filtering and search capabilities.
  */
-export default async function DevFlowsPage() {
+async function DevFlowsPageContent() {
   const t = await getTranslations("devtools.flows");
 
   return (
@@ -29,3 +30,11 @@ export default async function DevFlowsPage() {
     </div>
   );
 }
+
+export default function DevFlowsPage() {
+  return (
+    <Suspense fallback={null}>
+      <DevFlowsPageContent />
+    </Suspense>
+  );
+}

package/templates/app/devtools/page.tsx

@@ -1,3 +1,4 @@
+import { Suspense } from "react";
 import { Code, Palette, FileText, Settings } from "lucide-react";
 import Link from "next/link";
 import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@nextsparkjs/core/components/ui/card";
@@ -9,7 +10,7 @@ import { getTranslations } from "next-intl/server";
  * Dashboard with quick links to development tools and documentation.
  * Shows overview of available sections in the dev area.
  */
-export default async function DevHomePage() {
+async function DevHomePageContent() {
   const t = await getTranslations('dev');
   const tCommon = await getTranslations('common');
 
@@ -119,3 +120,11 @@ export default async function DevHomePage() {
     </div>
   );
 }
+
+export default function DevHomePage() {
+  return (
+    <Suspense fallback={null}>
+      <DevHomePageContent />
+    </Suspense>
+  );
+}

package/templates/app/devtools/tags/page.tsx

@@ -1,3 +1,4 @@
+import { Suspense } from "react";
 import { TagsOverview } from "@nextsparkjs/core/components/devtools/TagsOverview";
 import { Tag } from "lucide-react";
 import { getTranslations } from "next-intl/server";
@@ -8,7 +9,7 @@ import { getTranslations } from "next-intl/server";
  * Displays all test tags organized by category.
  * Provides search and copy-to-clipboard functionality.
  */
-export default async function DevTagsPage() {
+async function DevTagsPageContent() {
   const t = await getTranslations("devtools.tags");
 
   return (
@@ -29,3 +30,11 @@ export default async function DevTagsPage() {
     </div>
   );
 }
+
+export default function DevTagsPage() {
+  return (
+    <Suspense fallback={null}>
+      <DevTagsPageContent />
+    </Suspense>
+  );
+}

package/templates/app/devtools/tests/[[...path]]/page.tsx

@@ -1,3 +1,4 @@
+import { Suspense } from "react";
 import { TestCasesViewer } from "@nextsparkjs/core/components/devtools";
 import { FileText } from "lucide-react";
 import { getTranslations } from "next-intl/server";
@@ -17,7 +18,7 @@ interface DevTestsPageProps {
  * - /dev/tests/auth/login-logout.bdd.md          → File selected
  * - /dev/tests/page-builder/admin/block-editor.bdd.md → Nested file
  */
-export default async function DevTestsPage({ params }: DevTestsPageProps) {
+async function DevTestsPageContent({ params }: DevTestsPageProps) {
   const { path } = await params;
   const t = await getTranslations("dev.tests");
 
@@ -45,3 +46,11 @@ export default async function DevTestsPage({ params }: DevTestsPageProps) {
     </div>
   );
 }
+
+export default function DevTestsPage({ params }: DevTestsPageProps) {
+  return (
+    <Suspense fallback={null}>
+      <DevTestsPageContent params={params} />
+    </Suspense>
+  );
+}

package/templates/app/layout.ppr.tsx

@@ -0,0 +1,105 @@
+/**
+ * Root Layout — PPR-compatible (Partial Prerendering)
+ *
+ * Fully static: no async data fetching in the root layout.
+ * The PPR static shell (html/body/fonts/content) renders instantly from CDN.
+ *
+ * Prerequisites:
+ * - Next.js 16.2.2+ with cacheComponents: true in next.config
+ * - Run `pnpm build:registries` to generate PPR exports
+ * - See docs/migration-ppr.md for full migration guide
+ *
+ * Key differences from the default async layout:
+ * - Layout is sync (not async) — enables PPR static shell
+ * - Uses StaticIntlProvider instead of NextIntlClientProvider
+ * - Messages/locale/theme mode are pre-merged at build time via registry
+ * - No PluginService.initializeAll() — plugins initialize on-demand
+ *
+ * Generated by @nextspark/core
+ * Regenerate with: npx nextspark generate
+ */
+
+import type { Metadata } from "next"
+import { Suspense } from "react"
+import { Geist, Geist_Mono } from "next/font/google"
+
+import "./globals.css"
+import { getBillingResourceHints } from "@nextsparkjs/core/lib/billing/gateways/factory"
+import { StaticIntlProvider } from "@nextsparkjs/core/providers/static-intl-provider"
+import { QueryProvider } from "@nextsparkjs/core/providers/query-provider"
+import { ThemeProvider as NextThemeProvider } from "@nextsparkjs/core/providers/theme-provider"
+import { ThemeProvider as CustomThemeProvider } from "@nextsparkjs/core/lib/theme/ThemeProvider"
+import { TeamProvider } from "@nextsparkjs/core/contexts/TeamContext"
+import { SubscriptionProvider } from "@nextsparkjs/core/contexts/SubscriptionContext"
+import { Toaster } from "@nextsparkjs/core/components/ui/sonner"
+import { getMetadataOrDefault } from '@nextsparkjs/core/lib/template-resolver'
+import { DEFAULT_LOCALE, DEFAULT_THEME_MODE, STATIC_MESSAGES } from '@nextsparkjs/registries/translation-registry'
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+})
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+})
+
+const defaultMetadata: Metadata = {
+  title: "NextSpark App",
+  description: "Built with NextSpark",
+}
+
+export const metadata: Metadata = getMetadataOrDefault(
+  'app/layout.tsx',
+  defaultMetadata
+)
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode
+}>) {
+  return (
+    <html lang={DEFAULT_LOCALE} suppressHydrationWarning>
+      <head>
+        {(() => {
+          const hints = getBillingResourceHints()
+          return (
+            <>
+              {hints.preconnect.map((domain) => (
+                <link key={`pre-${domain}`} rel="preconnect" href={domain} />
+              ))}
+              {[...hints.preconnect, ...hints.dnsPrefetch].map((domain) => (
+                <link key={`dns-${domain}`} rel="dns-prefetch" href={domain} />
+              ))}
+            </>
+          )
+        })()}
+      </head>
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        <StaticIntlProvider locale={DEFAULT_LOCALE} messages={STATIC_MESSAGES}>
+          <NextThemeProvider
+            attribute="class"
+            defaultTheme={DEFAULT_THEME_MODE}
+            enableSystem={DEFAULT_THEME_MODE === 'system'}
+            disableTransitionOnChange
+          >
+            <CustomThemeProvider>
+              <QueryProvider>
+                <TeamProvider>
+                  <SubscriptionProvider>
+                    <main>{children}</main>
+                    <Suspense><Toaster position="bottom-left" /></Suspense>
+                  </SubscriptionProvider>
+                </TeamProvider>
+              </QueryProvider>
+            </CustomThemeProvider>
+          </NextThemeProvider>
+        </StaticIntlProvider>
+      </body>
+    </html>
+  )
+}

package/templates/app/layout.tsx

@@ -1,10 +1,18 @@
 /**
- * AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY
+ * Root Layout — Async (default)
+ *
+ * Uses async data fetching for locale, messages, and theme mode.
+ * Compatible with all Next.js versions (15+, 16+).
+ *
+ * For PPR-optimized layout (requires Next.js 16.2.2+ with cacheComponents: true),
+ * see layout.ppr.tsx which uses pre-merged static imports for faster shell rendering.
+ *
  * Generated by @nextspark/core
  * Regenerate with: npx nextspark generate
  */
 
 import type { Metadata } from "next"
+import { Suspense } from "react"
 import { Geist, Geist_Mono } from "next/font/google"
 import { NextIntlClientProvider } from 'next-intl'
 import { getMessages } from 'next-intl/server'
@@ -92,7 +100,7 @@ export default async function RootLayout({
                   <SubscriptionProvider>
                     <TranslationContextManager />
                     <main>{children}</main>
-                    <Toaster position="bottom-left" />
+                    <Suspense><Toaster position="bottom-left" /></Suspense>
                   </SubscriptionProvider>
                 </TeamProvider>
               </QueryProvider>

package/templates/app/superadmin/docs/[section]/[page]/page.tsx

@@ -39,12 +39,10 @@ export async function generateMetadata({ params }: SuperadminDocsPageProps): Pro
   const page = section.pages.find(p => p.slug === pageSlug)
   if (!page) return { title: 'Page Not Found' }
 
-  const filePath = path.join(process.cwd(), page.path)
-  const { metadata } = await parseMarkdownFile(filePath)
-
+  const title = page.title || pageSlug.replace(/-/g, ' ')
   return {
-    title: `${metadata.title} | Admin Docs`,
-    description: metadata.description || `Admin documentation for ${metadata.title}`,
+    title: `${title} | Admin Docs`,
+    description: `Admin documentation for ${title}`,
     robots: 'noindex, nofollow'
   }
 }

package/templates/next.config.mjs

@@ -17,6 +17,9 @@ const nextConfig = {
   },
   transpilePackages: ['@nextsparkjs/core'],
   serverExternalPackages: ['handlebars'],
+  turbopack: {
+    root: __dirname,
+  },
   experimental: {
     externalDir: true,
   },