@nextsparkjs/core 0.1.0-beta.136 → 0.1.0-beta.138

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/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,
   },