@nextsparkjs/core 0.1.0-beta.67 → 0.1.0-beta.69

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

@@ -45,7 +45,8 @@ function getEntityConfigs(): Record<string, EntityConfig> {
   const registry = getEntityRegistry()
   const configs: Record<string, EntityConfig> = {}
   for (const [key, entry] of Object.entries(registry)) {
-    configs[key] = entry.config as EntityConfig
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    configs[key] = (entry as any).config as EntityConfig
   }
   return configs
 }

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

@@ -16,7 +16,7 @@ interface DocsPageProps {
 }
 
 export async function generateStaticParams() {
-  const params = []
+  const params: Array<{ section: string; page: string }> = []
 
   // Generate params for public docs only
   for (const section of DOCS_REGISTRY.public) {

package/dist/templates/app/api/devtools/config/entities/route.ts

@@ -60,7 +60,8 @@ export const GET = withRateLimitTier(async (request: Request) => {
     const registry = getEntityRegistry();
 
     for (const [, entry] of Object.entries(registry)) {
-      const config = entry.config;
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      const config = (entry as any).config;
       if (!isEntityConfig(config)) continue;
 
       entities.push({

package/dist/templates/app/api/user/plan-flags/route.ts

@@ -219,7 +219,7 @@ export const POST = withRateLimitTier(async (request: NextRequest) => {
     }
 
     const { updates } = validation.data
-    const results = []
+    const results: Array<{ success: boolean; userId: string; plan?: boolean; flags?: boolean; error?: string }> = []
 
     // Process each update
     for (const update of updates) {

package/dist/templates/app/api/v1/[entity]/[id]/child/[childType]/[childId]/route.ts

@@ -94,9 +94,11 @@ export const PUT = withRateLimitTier(async (
         
         // Handle relation-multi fields - store as JSONB array of IDs
         if (field?.type === 'relation-multi') {
-          let relationIds = []
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          let relationIds: any[] = []
           if (Array.isArray(value)) {
-            relationIds = value.map(item => 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            relationIds = value.map((item: any) =>
               typeof item === 'object' && item && 'id' in item ? item.id : item
             ).filter(id => id && String(id).trim() !== '')
           }

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

@@ -61,7 +61,8 @@ async function DefaultMainDashboardLayout({
   children: React.ReactNode
 }) {
   // Get entities directly from the imported registry
-  const allEntities = Object.values(ENTITY_REGISTRY).map(entry => entry.config)
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const allEntities = Object.values(ENTITY_REGISTRY).map(entry => (entry as any).config)
   // Filter to only include full EntityConfig (not child entities)
   const entities = allEntities.filter(isEntityConfig)
   const serializedEntities: SerializableEntityConfig[] = entities.map(serializeEntityConfig)

package/dist/templates/app/dashboard/(main)/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonDashboardHome } from '@nextsparkjs/core/components/ui/skeleton-dashboard'
+
+export default function DashboardLoading() {
+  return <SkeletonDashboardHome />
+}

package/dist/templates/app/dashboard/features/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonFeaturePlaceholder } from '@nextsparkjs/core/components/ui/skeleton-features'
+
+export default function FeaturesLoading() {
+  return <SkeletonFeaturePlaceholder />
+}

package/dist/templates/app/dashboard/settings/api-keys/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonApiKeysPage } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function ApiKeysLoading() {
+  return <SkeletonApiKeysPage />
+}

package/dist/templates/app/dashboard/settings/billing/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonBillingPage } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function BillingLoading() {
+  return <SkeletonBillingPage />
+}

package/dist/templates/app/dashboard/settings/invoices/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonInvoicesPage } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function InvoicesLoading() {
+  return <SkeletonInvoicesPage />
+}

package/dist/templates/app/dashboard/settings/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonSettingsOverview } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function SettingsLoading() {
+  return <SkeletonSettingsOverview />
+}

package/dist/templates/app/dashboard/settings/notifications/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonNotificationsPage } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function NotificationsLoading() {
+  return <SkeletonNotificationsPage />
+}

package/dist/templates/app/dashboard/settings/password/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonPasswordPage } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function PasswordLoading() {
+  return <SkeletonPasswordPage />
+}

package/dist/templates/app/dashboard/settings/plans/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonPlansPage } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function PlansLoading() {
+  return <SkeletonPlansPage />
+}

package/dist/templates/app/dashboard/settings/profile/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonProfileForm } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function ProfileLoading() {
+  return <SkeletonProfileForm />
+}

package/dist/templates/app/dashboard/settings/security/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonSecurityPage } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function SecurityLoading() {
+  return <SkeletonSecurityPage />
+}

package/dist/templates/app/dashboard/settings/teams/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonTeamsPage } from '@nextsparkjs/core/components/ui/skeleton-settings'
+
+export default function TeamsLoading() {
+  return <SkeletonTeamsPage />
+}

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

@@ -9,7 +9,7 @@ import { getTranslations } from "next-intl/server";
  * Provides read-only view with JSON formatting and copy functionality.
  */
 export default async function DevConfigPage() {
-  const t = await getTranslations('dev.config');
+  const t = await getTranslations('devtools.config');
 
   return (
     <div className="space-y-6" data-cy="devtools-config-page">

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

@@ -10,7 +10,7 @@ import { getTranslations } from "next-intl/server";
  * Shows overview of available sections in the dev area.
  */
 export default async function DevHomePage() {
-  const t = await getTranslations('dev');
+  const t = await getTranslations('devtools');
   const tCommon = await getTranslations('common');
 
   const sections = [

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

@@ -19,7 +19,7 @@ interface DevTestsPageProps {
  */
 export default async function DevTestsPage({ params }: DevTestsPageProps) {
   const { path } = await params;
-  const t = await getTranslations("dev.tests");
+  const t = await getTranslations("devtools.tests");
 
   // Convert path array to string (e.g., ['auth', 'login.bdd.md'] -> 'auth/login.bdd.md')
   const initialPath = path?.join("/") || null;

package/dist/templates/contents/themes/starter/messages/de/common.json

@@ -8,7 +8,10 @@
   "delete": "Löschen",
   "edit": "Bearbeiten",
   "create": "Erstellen",
-  "search": "Suchen...",
+  "search": {
+    "placeholder": "Suchen...",
+    "label": "Suchen"
+  },
   "noResults": "Keine Ergebnisse gefunden",
   "confirm": "Bestätigen",
   "back": "Zurück",

package/dist/templates/contents/themes/starter/messages/de/index.ts

@@ -0,0 +1,15 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+import public_ from './public.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation,
+  public: public_
+} as const

package/dist/templates/contents/themes/starter/messages/en/common.json

@@ -8,7 +8,10 @@
   "delete": "Delete",
   "edit": "Edit",
   "create": "Create",
-  "search": "Search...",
+  "search": {
+    "placeholder": "Search...",
+    "label": "Search"
+  },
   "noResults": "No results found",
   "confirm": "Confirm",
   "back": "Back",

package/dist/templates/contents/themes/starter/messages/en/index.ts

@@ -0,0 +1,15 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+import public_ from './public.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation,
+  public: public_
+} as const

package/dist/templates/contents/themes/starter/messages/es/common.json

@@ -8,7 +8,10 @@
   "delete": "Eliminar",
   "edit": "Editar",
   "create": "Crear",
-  "search": "Buscar...",
+  "search": {
+    "placeholder": "Buscar...",
+    "label": "Buscar"
+  },
   "noResults": "No se encontraron resultados",
   "confirm": "Confirmar",
   "back": "Volver",

package/dist/templates/contents/themes/starter/messages/es/index.ts

@@ -0,0 +1,15 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+import public_ from './public.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation,
+  public: public_
+} as const

package/dist/templates/contents/themes/starter/messages/fr/common.json

@@ -8,7 +8,10 @@
   "delete": "Supprimer",
   "edit": "Modifier",
   "create": "Créer",
-  "search": "Rechercher...",
+  "search": {
+    "placeholder": "Rechercher...",
+    "label": "Rechercher"
+  },
   "noResults": "Aucun résultat trouvé",
   "confirm": "Confirmer",
   "back": "Retour",

package/dist/templates/contents/themes/starter/messages/fr/index.ts

@@ -0,0 +1,15 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+import public_ from './public.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation,
+  public: public_
+} as const

package/dist/templates/contents/themes/starter/messages/it/common.json

@@ -8,7 +8,10 @@
   "delete": "Elimina",
   "edit": "Modifica",
   "create": "Crea",
-  "search": "Cerca...",
+  "search": {
+    "placeholder": "Cerca...",
+    "label": "Cerca"
+  },
   "noResults": "Nessun risultato trovato",
   "confirm": "Conferma",
   "back": "Indietro",

package/dist/templates/contents/themes/starter/messages/it/index.ts

@@ -0,0 +1,13 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation
+} as const

package/dist/templates/contents/themes/starter/messages/pt/common.json

@@ -8,7 +8,10 @@
   "delete": "Excluir",
   "edit": "Editar",
   "create": "Criar",
-  "search": "Pesquisar...",
+  "search": {
+    "placeholder": "Pesquisar...",
+    "label": "Pesquisar"
+  },
   "noResults": "Nenhum resultado encontrado",
   "confirm": "Confirmar",
   "back": "Voltar",

package/dist/templates/contents/themes/starter/messages/pt/index.ts

@@ -0,0 +1,13 @@
+import analytics from './analytics.json'
+import common from './common.json'
+import features from './features.json'
+import home from './home.json'
+import navigation from './navigation.json'
+
+export default {
+  analytics,
+  common,
+  features,
+  home,
+  navigation
+} as const

package/dist/templates/contents/themes/starter/styles/globals.css

@@ -10,10 +10,12 @@
    IMPORTS
    ============================================= */
 @import "tailwindcss";
-@import "@nextsparkjs/core/styles/ui.css";
 @import "@nextsparkjs/core/styles/utilities.css";
 @import "@nextsparkjs/core/styles/docs.css";
 @source "../../../**/*.{js,ts,jsx,tsx}";
+/* Core package: monorepo (short path) + npm projects (long path) */
+@source "../node_modules/@nextsparkjs/core/dist/**/*.js";
+@source "../../../../node_modules/@nextsparkjs/core/dist/**/*.js";
 
 /* =============================================
    THEME VARIABLES - LIGHT MODE (OKLCH)

package/dist/templates/contents/themes/starter/templates/(dashboard)/analytics/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonAnalyticsPage } from '@nextsparkjs/core/components/ui/skeleton-features'
+
+export default function AnalyticsLoading() {
+  return <SkeletonAnalyticsPage />
+}

package/dist/templates/contents/themes/starter/templates/(public)/loading.tsx

@@ -0,0 +1,5 @@
+import { SkeletonLandingPage } from '@nextsparkjs/core/components/ui/skeleton-public'
+
+export default function HomeLoading() {
+  return <SkeletonLandingPage />
+}

package/dist/templates/features/blog/blocks/post-content/component.tsx

@@ -79,7 +79,7 @@ export function PostContentBlock({
 
   // Build section classes with background
   const sectionClasses = buildSectionClasses(
-    'py-16 px-4 md:py-24',
+    'py-16 px-4 @md:py-24',
     { backgroundColor, className }
   )
 
@@ -119,7 +119,7 @@ export function PostContentBlock({
         {/* Optional Section Title */}
         {title && (
           <div className={cn('mb-12 text-center', maxWidthClasses[maxWidth], 'mx-auto')}>
-            <h2 className="text-4xl font-bold md:text-5xl lg:text-6xl tracking-tight">
+            <h2 className="text-4xl font-bold @md:text-5xl @lg:text-6xl tracking-tight">
               {title}
             </h2>
           </div>

package/dist/templates/features/pages/blocks/hero/component.tsx

@@ -83,13 +83,13 @@ export function HeroBlock({
         alignmentClasses[alignment]
       )}>
         {title && (
-          <h1 className="mb-6 text-5xl font-bold leading-tight md:text-6xl lg:text-7xl">
+          <h1 className="mb-6 text-5xl font-bold leading-tight @md:text-6xl @lg:text-7xl">
             {title}
           </h1>
         )}
 
         {displayContent && (
-          <p className="mb-8 text-xl md:text-2xl opacity-90 max-w-2xl">
+          <p className="mb-8 text-xl @md:text-2xl opacity-90 max-w-2xl">
             {displayContent}
           </p>
         )}

package/dist/templates/next.config.mjs

@@ -10,6 +10,11 @@ const withNextIntl = createNextIntlPlugin('./i18n.ts');
 
 /** @type {import('next').NextConfig} */
 const nextConfig = {
+  // Ignore TypeScript build errors - needed until DTS generation is enabled for @nextsparkjs/core
+  // Without this, production builds fail due to missing declaration files for deep imports
+  typescript: {
+    ignoreBuildErrors: true,
+  },
   transpilePackages: ['@nextsparkjs/core'],
   serverExternalPackages: ['handlebars'],
   experimental: {
@@ -142,8 +147,9 @@ const nextConfig = {
       "font-src 'self' data:",
       // wss: needed for Next.js hot reload in development
       `connect-src 'self' https://api.stripe.com${!isProduction ? ' wss:' : ''}`,
-      "frame-src https://js.stripe.com https://hooks.stripe.com",
-      "frame-ancestors 'none'",
+      "frame-src 'self' https://js.stripe.com https://hooks.stripe.com",
+      // Allow embedding in iframes from same origin (needed for page builder preview)
+      "frame-ancestors 'self'",
       "object-src 'none'",
       "base-uri 'self'",
       // CSP violation reporting - sends violations to /api/csp-report
@@ -165,8 +171,9 @@ const nextConfig = {
         value: 'nosniff'
       },
       {
+        // SAMEORIGIN allows same-origin iframes (needed for page builder preview)
         key: 'X-Frame-Options',
-        value: 'DENY'
+        value: 'SAMEORIGIN'
       },
       // X-XSS-Protection is deprecated but kept for legacy browser support
       // Modern browsers use CSP instead

package/dist/templates/{middleware.ts → proxy.ts}

@@ -1,7 +1,8 @@
 /**
- * NextSpark Middleware
+ * NextSpark Proxy (Next.js 16+)
  *
  * Handles authentication, route protection, and user context injection.
+ * Note: In Next.js 16, "middleware" was renamed to "proxy" with nodejs runtime.
  *
  * Key responsibilities:
  * 1. Theme middleware override support
@@ -14,7 +15,6 @@
  */
 import { betterFetch } from '@better-fetch/fetch'
 import { NextRequest, NextResponse } from 'next/server'
-// Edge-compatible imports (do NOT use lib/services or lib/auth - they have Node.js dependencies)
 import {
   hasThemeMiddleware,
   executeThemeMiddleware,
@@ -22,8 +22,7 @@ import {
 } from '@nextsparkjs/core/lib/middleware'
 
 /**
- * Session type for middleware (edge-compatible inline definition)
- * We can't import from @nextsparkjs/core/lib/auth because it has Node.js dependencies
+ * Session type for proxy (inline definition)
  */
 interface Session {
   user: {
@@ -65,7 +64,7 @@ function isPublicPath(pathname: string): boolean {
   )
 }
 
-export async function middleware(request: NextRequest) {
+export async function proxy(request: NextRequest) {
   const { pathname } = request.nextUrl
 
   // 1. Check for theme middleware override
@@ -178,7 +177,7 @@ export async function middleware(request: NextRequest) {
         request: { headers: requestHeaders },
       })
     } catch (error) {
-      console.error('Middleware error:', error)
+      console.error('Proxy error:', error)
       const loginUrl = new URL('/login', request.url)
       loginUrl.searchParams.set('callbackUrl', pathname)
       return NextResponse.redirect(loginUrl)

package/globals.css

@@ -292,6 +292,60 @@ body {
   @apply my-8 border-border;
 }
 
+/* =============================================
+   SKELETON - INP OPTIMIZED ANIMATIONS
+   High-performance skeleton loading states
+   ============================================= */
+
+/**
+ * GPU-accelerated skeleton pulse animation
+ * Uses opacity with will-change hint for smooth GPU-composited animation
+ * Respects prefers-reduced-motion for accessibility
+ */
+@keyframes skeleton-pulse {
+  0%, 100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.5;
+  }
+}
+
+/* Skeleton animation class - GPU accelerated */
+.animate-skeleton-pulse {
+  animation: skeleton-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
+  will-change: opacity;
+}
+
+/* Respect reduced motion preference */
+@media (prefers-reduced-motion: reduce) {
+  .animate-skeleton-pulse {
+    animation: none;
+  }
+}
+
+/**
+ * CSS Containment for skeleton elements
+ * Isolates layout/paint calculations to improve INP
+ */
+.skeleton-contained {
+  contain: content;
+}
+
+/**
+ * Skeleton container with content-visibility optimization
+ * Skips rendering of off-screen skeleton items
+ */
+.skeleton-container {
+  contain: layout style;
+}
+
+/* Apply content-visibility to direct children for virtualization effect */
+.skeleton-container > * {
+  content-visibility: auto;
+  contain-intrinsic-size: auto 100px;
+}
+
 /* =============================================
    THEME SYSTEM - BUILD-TIME LOADING
    Custom theme CSS is automatically injected based on activeTheme config

package/nextspark-entities.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Ambient type declarations for @nextsparkjs/core entity configs
+ *
+ * These declarations provide TypeScript with type information for
+ * deep imports to entity config files when DTS generation is disabled.
+ *
+ * NOTE: This file must NOT have any imports to work as global declarations.
+ */
+
+// EntityConfig type for reference (simplified version for ambient declarations)
+interface AmbientEntityConfig {
+  slug: string
+  enabled: boolean
+  names: {
+    singular: string
+    plural: string
+  }
+  icon?: unknown
+  access?: {
+    public?: boolean
+    api?: boolean
+    metadata?: boolean
+    shared?: boolean
+    basePath?: string
+  }
+  ui?: {
+    dashboard?: {
+      showInMenu?: boolean
+      showInTopbar?: boolean
+    }
+    public?: {
+      hasArchivePage?: boolean
+      hasSinglePage?: boolean
+    }
+    features?: {
+      searchable?: boolean
+      sortable?: boolean
+      filterable?: boolean
+      bulkOperations?: boolean
+    }
+  }
+  table?: {
+    name?: string
+    columns?: unknown[]
+    relations?: unknown
+  }
+  schemas?: {
+    create?: unknown
+    update?: unknown
+  }
+  fields?: unknown[]
+}
+
+// Core entity: patterns
+declare module '@nextsparkjs/core/entities/patterns/patterns.config' {
+  export const patternsEntityConfig: AmbientEntityConfig
+}
+
+// Add more core entities here as needed