@nextsparkjs/core 0.1.0-beta.45 → 0.1.0-beta.46

package/dist/styles/classes.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-01-13T17:03:25.463Z",
+  "generated": "2026-01-13T21:36:21.527Z",
   "totalClasses": 1036,
   "classes": [
     "''",

package/dist/templates/contents/themes/starter/config/permissions.config.ts

@@ -58,6 +58,34 @@ export const PERMISSIONS_CONFIG_OVERRIDES: ThemePermissionsConfig = {
       { action: 'delete', label: 'Delete tasks', description: 'Can delete tasks', roles: ['owner', 'admin'], dangerous: true },
       { action: 'assign', label: 'Assign tasks', description: 'Can assign tasks to team members', roles: ['owner', 'admin'] },
     ],
+
+    // ------------------------------------------
+    // PAGES ENTITY (uncommented by CLI if pages feature enabled)
+    // ------------------------------------------
+    // __PAGES_PERMISSIONS_START__
+    // pages: [
+    //   { action: 'create', label: 'Create Pages', description: 'Can create new pages', roles: ['owner', 'admin'] },
+    //   { action: 'read', label: 'View Pages', description: 'Can view page details', roles: ['owner', 'admin', 'member', 'viewer'] },
+    //   { action: 'list', label: 'List Pages', description: 'Can see the pages list', roles: ['owner', 'admin', 'member', 'viewer'] },
+    //   { action: 'update', label: 'Edit Pages', description: 'Can modify page content', roles: ['owner', 'admin'] },
+    //   { action: 'delete', label: 'Delete Pages', description: 'Can delete pages', roles: ['owner', 'admin'], dangerous: true },
+    //   { action: 'publish', label: 'Publish Pages', description: 'Can publish pages to make them public', roles: ['owner', 'admin'] },
+    // ],
+    // __PAGES_PERMISSIONS_END__
+
+    // ------------------------------------------
+    // POSTS ENTITY (uncommented by CLI if blog feature enabled)
+    // ------------------------------------------
+    // __POSTS_PERMISSIONS_START__
+    // posts: [
+    //   { action: 'create', label: 'Create Posts', description: 'Can create new blog posts', roles: ['owner', 'admin', 'member'] },
+    //   { action: 'read', label: 'View Posts', description: 'Can view post details', roles: ['owner', 'admin', 'member', 'viewer'] },
+    //   { action: 'list', label: 'List Posts', description: 'Can see the posts list', roles: ['owner', 'admin', 'member', 'viewer'] },
+    //   { action: 'update', label: 'Edit Posts', description: 'Can modify post content', roles: ['owner', 'admin', 'member'] },
+    //   { action: 'delete', label: 'Delete Posts', description: 'Can delete posts', roles: ['owner', 'admin'], dangerous: true },
+    //   { action: 'publish', label: 'Publish Posts', description: 'Can publish posts to make them public', roles: ['owner', 'admin'] },
+    // ],
+    // __POSTS_PERMISSIONS_END__
   },
 }
 

package/dist/types/api-presets.d.ts

@@ -37,10 +37,14 @@ export interface ApiPreset {
     description?: string;
     /** HTTP method for this preset */
     method: HttpMethod;
+    /** Path suffix for sub-routes (e.g., '/{id}', '/{id}/child/{childType}') */
+    path?: string;
     /** Path parameters (for dynamic segments like [id]) */
     pathParams?: Record<string, string>;
     /** Query parameters */
     params?: Record<string, string | number | boolean>;
+    /** Query parameters (alias for params) */
+    queryParams?: Record<string, string | number | boolean>;
     /** Custom headers */
     headers?: Record<string, string>;
     /** Request body (for POST/PATCH/PUT) */

package/dist/types/api-presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-presets.d.ts","sourceRoot":"","sources":["../../src/types/api-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAA;AAEnF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,MAAM,EAAE,UAAU,CAAA;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IAClD,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,iCAAiC;IACjC,aAAa,CAAC,EAAE,mBAAmB,CAAA;IACnC,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;AAEzD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAC7C,eAAe;IACf,IAAI,EAAE;QACJ,cAAc,EAAE,MAAM,CAAA;QACtB,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACjC,eAAe;IACf,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,GAC7C,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAExC"}
+{"version":3,"file":"api-presets.d.ts","sourceRoot":"","sources":["../../src/types/api-presets.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/core",
-  "version": "0.1.0-beta.45",
+  "version": "0.1.0-beta.46",
   "description": "NextSpark - The complete SaaS framework for Next.js",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",
@@ -96,6 +96,22 @@
       "types": "./dist/lib/scheduled-actions/index.d.ts",
       "import": "./dist/lib/scheduled-actions/index.js"
     },
+    "./lib/permissions": {
+      "types": "./dist/lib/permissions/index.d.ts",
+      "import": "./dist/lib/permissions/index.js"
+    },
+    "./lib/permissions/system": {
+      "types": "./dist/lib/permissions/system.d.ts",
+      "import": "./dist/lib/permissions/system.js"
+    },
+    "./lib/permissions/types": {
+      "types": "./dist/lib/permissions/types.d.ts",
+      "import": "./dist/lib/permissions/types.js"
+    },
+    "./lib/config/config-sync": {
+      "types": "./dist/lib/config/config-sync.d.ts",
+      "import": "./dist/lib/config/config-sync.js"
+    },
     "./lib/*": {
       "types": "./dist/lib/*.d.ts",
       "import": "./dist/lib/*.js"
@@ -104,6 +120,10 @@
       "types": "./dist/hooks/index.d.ts",
       "import": "./dist/hooks/index.js"
     },
+    "./hooks/teams": {
+      "types": "./dist/hooks/teams/index.d.ts",
+      "import": "./dist/hooks/teams/index.js"
+    },
     "./hooks/*": {
       "types": "./dist/hooks/*.d.ts",
       "import": "./dist/hooks/*.js"
@@ -219,6 +239,7 @@
   },
   "files": [
     "dist",
+    "styles",
     "templates",
     "migrations",
     "tests/cypress/support",
@@ -320,7 +341,7 @@
     "tailwind-merge": "^3.3.1",
     "uuid": "^13.0.0",
     "zod": "^4.1.5",
-    "@nextsparkjs/testing": "0.1.0-beta.45"
+    "@nextsparkjs/testing": "0.1.0-beta.46"
   },
   "scripts": {
     "build": "tsup && pnpm build:dts && pnpm build:ui-css",

package/scripts/build/registry/config.mjs

@@ -14,7 +14,7 @@
 
 import { join, dirname } from 'path'
 import { fileURLToPath } from 'url'
-import { existsSync, lstatSync } from 'fs'
+import { existsSync, lstatSync, readlinkSync } from 'fs'
 import dotenv from 'dotenv'
 import { loadNextSparkConfigSync } from '../config-loader.mjs'
 
@@ -86,9 +86,15 @@ export function detectProjectRoot() {
 }
 
 /**
- * Check if NextSpark is installed as a package (not a symlink from monorepo)
+ * Check if NextSpark is installed as a package (from npm registry)
+ *
+ * This handles both traditional npm/yarn AND pnpm:
+ * - npm/yarn: packages are copied to node_modules (not symlinks)
+ * - pnpm: ALL packages are symlinks, but npm packages point to .pnpm/ store
+ * - pnpm workspace: local packages symlink to the actual package path
+ *
  * @param {string} root - Project root path
- * @returns {boolean} True if installed as npm package (not a symlink)
+ * @returns {boolean} True if installed from npm registry
  */
 export function isInstalledAsPackage(root) {
   const corePath = join(root, 'node_modules/@nextsparkjs/core')
@@ -96,11 +102,27 @@ export function isInstalledAsPackage(root) {
     return false
   }
 
-  // In monorepo mode with pnpm workspaces, packages are symlinked
-  // A real npm installation is not a symlink
   try {
     const stat = lstatSync(corePath)
-    return !stat.isSymbolicLink()
+
+    // If not a symlink, it's a traditional npm/yarn install
+    if (!stat.isSymbolicLink()) {
+      return true
+    }
+
+    // For symlinks (pnpm), check WHERE it points to:
+    // - npm install: points to .pnpm/@nextsparkjs+core@version.../node_modules/@nextsparkjs/core
+    // - workspace: points to ../../packages/core or similar
+    const linkTarget = readlinkSync(corePath)
+
+    // If symlink points to .pnpm/ directory, it's a real npm installation via pnpm
+    // The .pnpm directory is pnpm's content-addressable store
+    if (linkTarget.includes('.pnpm/') || linkTarget.includes('.pnpm\\')) {
+      return true
+    }
+
+    // Otherwise it's a workspace symlink (monorepo development)
+    return false
   } catch {
     return false
   }

package/scripts/build/theme.mjs

@@ -32,6 +32,75 @@ function getActiveTheme() {
   return process.env.NEXT_PUBLIC_ACTIVE_THEME
 }
 
+/**
+ * Sync app/globals.css to import from the active theme
+ *
+ * This ensures the import path in app/globals.css always matches
+ * NEXT_PUBLIC_ACTIVE_THEME, handling both npm and monorepo modes.
+ *
+ * @param {object} config - Configuration from getConfig()
+ * @param {string} activeTheme - Active theme name
+ * @returns {boolean} - True if file was updated, false if already correct
+ */
+function syncAppGlobalsCss(config, activeTheme) {
+  const appGlobalsCssPath = path.join(config.projectRoot, 'app', 'globals.css')
+
+  // Calculate the correct relative path from app/ to theme globals.css
+  const appDir = path.join(config.projectRoot, 'app')
+  const themeGlobalsPath = path.join(config.themesDir, activeTheme, 'styles', 'globals.css')
+  const relativePath = path.relative(appDir, themeGlobalsPath)
+
+  // Expected import statement
+  const expectedImport = `@import "${relativePath}";`
+
+  // Template for app/globals.css
+  const template = `/* =============================================
+   GLOBAL STYLES - Import from Active Theme
+
+   This file imports styles from the active theme.
+   DO NOT edit directly - all styles are in:
+   contents/themes/{theme}/styles/globals.css
+
+   To customize colors, typography and tokens, edit
+   the globals.css file in your active theme.
+   ============================================= */
+
+${expectedImport}
+`
+
+  // Check if file exists and has correct import
+  if (fs.existsSync(appGlobalsCssPath)) {
+    const currentContent = fs.readFileSync(appGlobalsCssPath, 'utf8')
+
+    // Extract current import (handle various formats)
+    const importMatch = currentContent.match(/@import\s+["']([^"']+)["'];?/)
+
+    if (importMatch) {
+      const currentImportPath = importMatch[1]
+
+      // Check if it's already pointing to the correct theme
+      if (currentImportPath === relativePath) {
+        return false // Already correct, no update needed
+      }
+
+      // Update only the import line, preserving any custom comments
+      const updatedContent = currentContent.replace(
+        /@import\s+["'][^"']+["'];?/,
+        expectedImport
+      )
+
+      fs.writeFileSync(appGlobalsCssPath, updatedContent)
+      console.log(`   🔄 Updated app/globals.css import: ${relativePath}`)
+      return true
+    }
+  }
+
+  // File doesn't exist or has no import - write full template
+  fs.writeFileSync(appGlobalsCssPath, template)
+  console.log(`   ✅ Created app/globals.css with import: ${relativePath}`)
+  return true
+}
+
 /**
  * Recursively copy directory contents
  */
@@ -217,9 +286,9 @@ export async function buildTheme(projectRoot = null) {
     fs.mkdirSync(outputDir, { recursive: true })
   }
 
-  // NOTE: app/globals.css should import from theme, NOT be overwritten by core
-  // Theme is the single source of truth for all CSS variables
-  // See: contents/themes/{theme}/styles/globals.css
+  // Sync app/globals.css to import from the active theme
+  // This handles path differences between npm and monorepo modes
+  syncAppGlobalsCss(config, activeTheme)
 
   // Copy theme public assets (for all themes, including default)
   if (fs.existsSync(themePath)) {

package/styles/docs.css

@@ -0,0 +1,82 @@
+/* =============================================
+   DOCUMENTATION - Markdown Styles
+   Styles for rendered markdown content in docs pages.
+   These styles USE theme variables (--foreground, --muted, etc.)
+   Include this file in your theme's globals.css
+   ============================================= */
+
+.docs-content {
+  @apply space-y-4;
+}
+
+.docs-content h2 {
+  @apply text-2xl font-bold mt-8 mb-4 border-b pb-2 border-border;
+}
+
+.docs-content h3 {
+  @apply text-xl font-semibold mt-6 mb-3;
+}
+
+.docs-content h4 {
+  @apply text-lg font-semibold mt-4 mb-2;
+}
+
+.docs-content p {
+  @apply leading-7 text-foreground;
+}
+
+.docs-content code {
+  @apply bg-muted px-1.5 py-0.5 rounded text-sm font-mono text-foreground;
+}
+
+.docs-content pre {
+  @apply bg-muted p-4 rounded-lg overflow-x-auto my-4 border border-border;
+}
+
+.docs-content pre code {
+  @apply bg-transparent p-0;
+}
+
+.docs-content ul {
+  @apply list-disc list-inside space-y-2 text-foreground;
+}
+
+.docs-content ol {
+  @apply list-decimal list-inside space-y-2 text-foreground;
+}
+
+.docs-content li {
+  @apply leading-7;
+}
+
+.docs-content a {
+  @apply text-primary underline-offset-4 hover:underline transition-colors;
+}
+
+.docs-content blockquote {
+  @apply border-l-4 border-primary pl-4 italic text-muted-foreground my-4;
+}
+
+.docs-content table {
+  @apply w-full border-collapse my-4;
+}
+
+.docs-content thead {
+  @apply border-b-2 border-border;
+}
+
+.docs-content th {
+  @apply text-left p-2 font-semibold bg-muted;
+}
+
+.docs-content td {
+  @apply p-2 border-b border-border;
+}
+
+.docs-content img {
+  @apply rounded-lg my-4 max-w-full h-auto;
+}
+
+.docs-content hr {
+  @apply my-8 border-border;
+}

package/styles/utilities.css

@@ -0,0 +1,37 @@
+/* =============================================
+   CORE UTILITIES - Keyframes and Animations
+   These utilities USE theme variables but don't define them.
+   Include this file in your theme's globals.css
+   ============================================= */
+
+/* Accordion animations for Radix UI */
+@keyframes accordion-down {
+  from {
+    height: 0;
+  }
+  to {
+    height: var(--radix-accordion-content-height);
+  }
+}
+
+@keyframes accordion-up {
+  from {
+    height: var(--radix-accordion-content-height);
+  }
+  to {
+    height: 0;
+  }
+}
+
+/* Wiggle animation for icons and interactive elements */
+@keyframes wiggle {
+  0%, 100% {
+    transform: rotate(0deg);
+  }
+  25% {
+    transform: rotate(-15deg);
+  }
+  75% {
+    transform: rotate(15deg);
+  }
+}

package/templates/contents/themes/starter/config/permissions.config.ts

@@ -58,6 +58,34 @@ export const PERMISSIONS_CONFIG_OVERRIDES: ThemePermissionsConfig = {
       { action: 'delete', label: 'Delete tasks', description: 'Can delete tasks', roles: ['owner', 'admin'], dangerous: true },
       { action: 'assign', label: 'Assign tasks', description: 'Can assign tasks to team members', roles: ['owner', 'admin'] },
     ],
+
+    // ------------------------------------------
+    // PAGES ENTITY (uncommented by CLI if pages feature enabled)
+    // ------------------------------------------
+    // __PAGES_PERMISSIONS_START__
+    // pages: [
+    //   { action: 'create', label: 'Create Pages', description: 'Can create new pages', roles: ['owner', 'admin'] },
+    //   { action: 'read', label: 'View Pages', description: 'Can view page details', roles: ['owner', 'admin', 'member', 'viewer'] },
+    //   { action: 'list', label: 'List Pages', description: 'Can see the pages list', roles: ['owner', 'admin', 'member', 'viewer'] },
+    //   { action: 'update', label: 'Edit Pages', description: 'Can modify page content', roles: ['owner', 'admin'] },
+    //   { action: 'delete', label: 'Delete Pages', description: 'Can delete pages', roles: ['owner', 'admin'], dangerous: true },
+    //   { action: 'publish', label: 'Publish Pages', description: 'Can publish pages to make them public', roles: ['owner', 'admin'] },
+    // ],
+    // __PAGES_PERMISSIONS_END__
+
+    // ------------------------------------------
+    // POSTS ENTITY (uncommented by CLI if blog feature enabled)
+    // ------------------------------------------
+    // __POSTS_PERMISSIONS_START__
+    // posts: [
+    //   { action: 'create', label: 'Create Posts', description: 'Can create new blog posts', roles: ['owner', 'admin', 'member'] },
+    //   { action: 'read', label: 'View Posts', description: 'Can view post details', roles: ['owner', 'admin', 'member', 'viewer'] },
+    //   { action: 'list', label: 'List Posts', description: 'Can see the posts list', roles: ['owner', 'admin', 'member', 'viewer'] },
+    //   { action: 'update', label: 'Edit Posts', description: 'Can modify post content', roles: ['owner', 'admin', 'member'] },
+    //   { action: 'delete', label: 'Delete Posts', description: 'Can delete posts', roles: ['owner', 'admin'], dangerous: true },
+    //   { action: 'publish', label: 'Publish Posts', description: 'Can publish posts to make them public', roles: ['owner', 'admin'] },
+    // ],
+    // __POSTS_PERMISSIONS_END__
   },
 }