@nextsparkjs/core 0.1.0-beta.187 → 0.1.0-beta.189

package/dist/templates/contents/themes/starter/blocks/testimonials/component.tsx

@@ -0,0 +1,116 @@
+import React from 'react'
+import { Quote } from 'lucide-react'
+import { Avatar, AvatarFallback, AvatarImage } from '@nextsparkjs/core/components/ui/avatar'
+import { cn } from '@nextsparkjs/core/lib/utils'
+import { buildSectionClasses, resolveMediaUrl } from '@nextsparkjs/core/types/blocks'
+import type { TestimonialsBlockProps, TestimonialItem } from './schema'
+
+/**
+ * Testimonials Block Component
+ *
+ * Props from 3-tab structure:
+ * - Content: title, content, cta, items
+ * - Design: backgroundColor, columns
+ * - Advanced: className, id
+ */
+export function TestimonialsBlock({
+  // Base content props
+  title,
+  content,
+  cta,
+  // Testimonials-specific content
+  items,
+  // Base design props
+  backgroundColor = 'gray-50',
+  // Testimonials-specific design
+  columns = '3',
+  // Base advanced props
+  className,
+  id,
+}: TestimonialsBlockProps) {
+  // Build column classes based on columns prop
+  const columnClasses: Record<string, string> = {
+    '2': '@md:grid-cols-2',
+    '3': '@md:grid-cols-2 @lg:grid-cols-3',
+  }
+
+  // Build section classes with background and custom className
+  const sectionClasses = buildSectionClasses(
+    'py-16 px-4 @md:py-24',
+    { backgroundColor, className }
+  )
+
+  // Ensure items is always an array
+  const safeItems = Array.isArray(items) ? items : []
+
+  return (
+    <section id={id} className={sectionClasses} data-cy="block-testimonials">
+      <div className="container mx-auto max-w-6xl">
+        {/* Section Header */}
+        {(title || content) && (
+          <div className="mb-12 text-center">
+            {title && (
+              <h2 className="mb-4 text-4xl font-bold @md:text-5xl">
+                {title}
+              </h2>
+            )}
+            {content && (
+              <p className="mx-auto max-w-2xl text-lg text-muted-foreground">
+                {content}
+              </p>
+            )}
+          </div>
+        )}
+
+        {/* Testimonials Grid */}
+        <div className={cn('grid gap-8', columnClasses[columns] || columnClasses['3'])}>
+          {safeItems.map((item: TestimonialItem, index: number) => (
+            <div
+              key={index}
+              className="flex flex-col p-6 rounded-lg border bg-card"
+            >
+              <Quote className="h-8 w-8 text-primary mb-4" />
+
+              <blockquote className="mb-6 text-lg flex-grow">
+                "{item.quote}"
+              </blockquote>
+
+              <div className="flex items-center gap-3">
+                <Avatar>
+                  <AvatarImage src={resolveMediaUrl(item.avatar)} alt={item.author} />
+                  <AvatarFallback>
+                    {item.author.split(' ').map((n: string) => n[0]).join('')}
+                  </AvatarFallback>
+                </Avatar>
+
+                <div>
+                  <div className="font-semibold">{item.author}</div>
+                  {item.role && (
+                    <div className="text-sm text-muted-foreground">{item.role}</div>
+                  )}
+                </div>
+              </div>
+            </div>
+          ))}
+        </div>
+
+        {/* Optional CTA */}
+        {cta && (
+          <div className="mt-12 text-center">
+            <a
+              href={cta.link}
+              target={cta.target}
+              rel={cta.target === '_blank' ? 'noopener noreferrer' : undefined}
+              className="inline-flex items-center justify-center rounded-md bg-primary px-8 py-3 text-sm font-medium text-primary-foreground hover:bg-primary/90 transition-colors"
+            >
+              {cta.text}
+            </a>
+          </div>
+        )}
+      </div>
+    </section>
+  )
+}
+
+// The generated block registry imports this as the module's default.
+export default TestimonialsBlock

package/dist/templates/contents/themes/starter/blocks/testimonials/config.ts

@@ -0,0 +1,11 @@
+import type { BlockConfig } from '@nextsparkjs/core/types/blocks'
+
+export const config: Omit<BlockConfig, 'schema' | 'fieldDefinitions' | 'Component' | 'examples'> = {
+  slug: 'testimonials',
+  name: 'Testimonials',
+  description: 'Display customer testimonials with quotes, authors, and avatars',
+  category: 'testimonials',
+  icon: 'Quote',
+  thumbnail: '/theme/blocks/testimonials/thumbnail.png',
+  scope: ['pages']
+}

package/dist/templates/contents/themes/starter/blocks/testimonials/fields.ts

@@ -0,0 +1,105 @@
+import type { FieldDefinition } from '@nextsparkjs/core/types/blocks'
+import {
+  baseContentFields,
+  baseDesignFields,
+  baseAdvancedFields,
+} from '@nextsparkjs/core/types/blocks'
+
+/**
+ * Testimonials Block Field Definitions
+ *
+ * Organized into 3 tabs:
+ * - Content: title, description, cta (from base) + items array
+ * - Design: backgroundColor (from base) + columns
+ * - Advanced: className, id (from base)
+ */
+
+// Testimonials-specific content fields
+const testimonialsContentFields: FieldDefinition[] = [
+  {
+    name: 'items',
+    label: 'Testimonials',
+    type: 'array',
+    tab: 'content',
+    required: true,
+    description: 'Customer testimonials to display',
+    helpText: 'Add up to 6 testimonials',
+    minItems: 1,
+    maxItems: 6,
+    itemFields: [
+      {
+        name: 'quote',
+        label: 'Quote',
+        type: 'textarea',
+        tab: 'content',
+        required: true,
+        placeholder: 'This product changed my life...',
+        maxLength: 500,
+        rows: 3,
+      },
+      {
+        name: 'author',
+        label: 'Author Name',
+        type: 'text',
+        tab: 'content',
+        required: true,
+        placeholder: 'John Doe',
+        maxLength: 100,
+      },
+      {
+        name: 'role',
+        label: 'Role/Title',
+        type: 'text',
+        tab: 'content',
+        required: false,
+        placeholder: 'CEO at Company',
+        maxLength: 100,
+      },
+      {
+        name: 'avatar',
+        label: 'Avatar Image',
+        type: 'image',
+        tab: 'content',
+        required: false,
+        description: 'Profile picture of the person',
+        helpText: 'Recommended size: 100x100px',
+      },
+    ],
+  },
+]
+
+// Testimonials-specific design fields
+const testimonialsDesignFields: FieldDefinition[] = [
+  {
+    name: 'columns',
+    label: 'Grid Columns',
+    type: 'select',
+    tab: 'design',
+    required: false,
+    default: '3',
+    description: 'Number of columns in the grid layout',
+    options: [
+      { label: '2 Columns', value: '2' },
+      { label: '3 Columns', value: '3' },
+    ],
+  },
+]
+
+/**
+ * Complete field definitions organized by tab
+ */
+export const fieldDefinitions: FieldDefinition[] = [
+  // Content tab: base fields + testimonials-specific
+  ...baseContentFields,
+  ...testimonialsContentFields,
+
+  // Design tab: base fields + testimonials-specific
+  ...baseDesignFields,
+  ...testimonialsDesignFields,
+
+  // Advanced tab: base fields only
+  ...baseAdvancedFields,
+]
+
+// Alias for compatibility
+export const fields = fieldDefinitions

package/dist/templates/contents/themes/starter/blocks/testimonials/index.ts

@@ -0,0 +1,6 @@
+export { config } from './config'
+export { schema } from './schema'
+export { fields } from './fields'
+export { TestimonialsBlock as Component } from './component'
+
+export type { TestimonialsBlockProps } from './schema'

package/dist/templates/contents/themes/starter/blocks/testimonials/schema.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod'
+import { baseBlockSchema, mediaRefSchema } from '@nextsparkjs/core/types/blocks'
+
+/**
+ * Testimonial Item Schema
+ * Individual testimonial entry
+ */
+const testimonialItemSchema = z.object({
+  quote: z.string().min(1, 'Quote is required').max(500),
+  author: z.string().min(1, 'Author name is required').max(100),
+  role: z.string().max(100).optional(),
+  avatar: mediaRefSchema.optional(),
+})
+
+export type TestimonialItem = z.infer<typeof testimonialItemSchema>
+
+/**
+ * Testimonials Block Schema
+ *
+ * Extends base schema with:
+ * - items: Array of testimonial items
+ * - columns: Grid layout option (2, 3 columns)
+ *
+ * Note: Uses base schema title, description, cta, backgroundColor, className, id
+ */
+export const testimonialsSpecificSchema = z.object({
+  // Content: array of testimonials
+  items: z.array(testimonialItemSchema)
+    .min(1, 'At least one testimonial is required')
+    .max(6, 'Maximum 6 testimonials allowed'),
+
+  // Design: column layout
+  columns: z.enum(['2', '3']).default('3'),
+})
+
+/**
+ * Complete Testimonials Block Schema
+ */
+export const schema = baseBlockSchema.extend(testimonialsSpecificSchema.shape)
+
+export type TestimonialsBlockProps = z.infer<typeof schema>

package/dist/templates/contents/themes/starter/blocks/text-content/component.tsx

@@ -0,0 +1,100 @@
+import React from 'react'
+import { cn } from '@nextsparkjs/core/lib/utils'
+import { buildSectionClasses } from '@nextsparkjs/core/types/blocks'
+import { sanitizeBlockHtml } from '@nextsparkjs/core/lib/blocks/sanitize-html'
+import type { TextContentBlockProps } from './schema'
+
+/**
+ * Text Content Block Component
+ *
+ * Props from 3-tab structure:
+ * - Content: title, content (rich-text), cta
+ * - Design: backgroundColor, maxWidth, alignment
+ * - Advanced: className, id
+ *
+ * Note: `content` is the main rich-text body of this block
+ */
+export function TextContentBlock({
+  // Base content props
+  title,
+  content,
+  cta,
+  // Base design props
+  backgroundColor,
+  // Text-content-specific design
+  maxWidth = 'lg',
+  alignment = 'left',
+  // Base advanced props
+  className,
+  id,
+}: TextContentBlockProps) {
+  const maxWidthClasses: Record<string, string> = {
+    sm: 'max-w-2xl',
+    md: 'max-w-3xl',
+    lg: 'max-w-4xl',
+    xl: 'max-w-5xl',
+    full: 'max-w-none',
+  }
+
+  const alignmentClasses: Record<string, string> = {
+    left: 'text-left',
+    center: 'text-center mx-auto',
+    right: 'text-right ml-auto',
+  }
+
+  // Build section classes with background and custom className
+  const sectionClasses = buildSectionClasses(
+    'py-16 px-4 @md:py-24',
+    { backgroundColor, className }
+  )
+
+  return (
+    <section id={id} className={sectionClasses} data-cy="block-text-content">
+      <div className="container mx-auto">
+        {/* Optional Section Title */}
+        {title && (
+          <div className={cn(
+            'mb-8',
+            maxWidthClasses[maxWidth],
+            alignmentClasses[alignment]
+          )}>
+            <h2 className="text-3xl font-bold @md:text-4xl">
+              {title}
+            </h2>
+          </div>
+        )}
+
+        {/* Rich Text Content */}
+        <div
+          className={cn(
+            'prose prose-lg dark:prose-invert',
+            maxWidthClasses[maxWidth],
+            alignmentClasses[alignment]
+          )}
+          dangerouslySetInnerHTML={{ __html: sanitizeBlockHtml(content) }}
+        />
+
+        {/* Optional CTA */}
+        {cta && (
+          <div className={cn(
+            'mt-8',
+            maxWidthClasses[maxWidth],
+            alignmentClasses[alignment]
+          )}>
+            <a
+              href={cta.link}
+              target={cta.target}
+              rel={cta.target === '_blank' ? 'noopener noreferrer' : undefined}
+              className="inline-flex items-center justify-center rounded-md bg-primary px-8 py-3 text-sm font-medium text-primary-foreground hover:bg-primary/90 transition-colors"
+            >
+              {cta.text}
+            </a>
+          </div>
+        )}
+      </div>
+    </section>
+  )
+}
+
+// The generated block registry imports this as the module's default.
+export default TextContentBlock

package/dist/templates/contents/themes/starter/blocks/text-content/config.ts

@@ -0,0 +1,11 @@
+import type { BlockConfig } from '@nextsparkjs/core/types/blocks'
+
+export const config: Omit<BlockConfig, 'schema' | 'fieldDefinitions' | 'Component' | 'examples'> = {
+  slug: 'text-content',
+  name: 'Text Content',
+  description: 'Rich text content block for paragraphs, lists, and formatted text',
+  category: 'content',
+  icon: 'FileText',
+  thumbnail: '/theme/blocks/text-content/thumbnail.png',
+  scope: ['pages']
+}

package/dist/templates/contents/themes/starter/blocks/text-content/fields.ts

@@ -0,0 +1,88 @@
+import type { FieldDefinition } from '@nextsparkjs/core/types/blocks'
+import {
+  baseContentFields,
+  baseDesignFields,
+  baseAdvancedFields,
+} from '@nextsparkjs/core/types/blocks'
+
+/**
+ * Text Content Block Field Definitions
+ *
+ * Organized into 3 tabs:
+ * - Content: title, cta (from base) + content (rich-text, replaces base content)
+ * - Design: backgroundColor (from base) + maxWidth, alignment
+ * - Advanced: className, id (from base)
+ *
+ * Note: The `content` field is overridden with a rich-text version
+ */
+
+// Filter out base content field (we'll replace it with rich-text version)
+const baseContentFieldsWithoutContent = baseContentFields.filter(
+  (field) => field.name !== 'content'
+)
+
+// Text-content-specific content fields (rich-text content)
+const textContentFields: FieldDefinition[] = [
+  {
+    name: 'content',
+    label: 'Content',
+    type: 'rich-text',
+    tab: 'content',
+    required: true,
+    placeholder: 'Enter your content here...',
+    helpText: 'Rich text content with formatting support',
+  },
+]
+
+// Text-content-specific design fields
+const textDesignFields: FieldDefinition[] = [
+  {
+    name: 'maxWidth',
+    label: 'Maximum Width',
+    type: 'select',
+    tab: 'design',
+    required: false,
+    default: 'lg',
+    helpText: 'Maximum content width',
+    options: [
+      { label: 'Small (640px)', value: 'sm' },
+      { label: 'Medium (768px)', value: 'md' },
+      { label: 'Large (1024px)', value: 'lg' },
+      { label: 'Extra Large (1280px)', value: 'xl' },
+      { label: 'Full Width', value: 'full' },
+    ],
+  },
+  {
+    name: 'alignment',
+    label: 'Text Alignment',
+    type: 'select',
+    tab: 'design',
+    required: false,
+    default: 'left',
+    helpText: 'Text alignment within the content area',
+    options: [
+      { label: 'Left', value: 'left' },
+      { label: 'Center', value: 'center' },
+      { label: 'Right', value: 'right' },
+    ],
+  },
+]
+
+/**
+ * Complete field definitions organized by tab
+ */
+export const fieldDefinitions: FieldDefinition[] = [
+  // Content tab: base fields (without content) + rich-text content
+  ...baseContentFieldsWithoutContent,
+  ...textContentFields,
+
+  // Design tab: base fields + text-specific
+  ...baseDesignFields,
+  ...textDesignFields,
+
+  // Advanced tab: base fields only
+  ...baseAdvancedFields,
+]
+
+// Alias for compatibility
+export const fields = fieldDefinitions

package/dist/templates/contents/themes/starter/blocks/text-content/index.ts

@@ -0,0 +1,6 @@
+export { config } from './config'
+export { schema } from './schema'
+export { fields } from './fields'
+export { TextContentBlock as Component } from './component'
+
+export type { TextContentBlockProps } from './schema'

package/dist/templates/contents/themes/starter/blocks/text-content/schema.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod'
+import { baseBlockSchema } from '@nextsparkjs/core/types/blocks'
+
+/**
+ * Text Content Block Schema
+ *
+ * Extends base schema with:
+ * - content: Rich text/HTML content (overrides base content with required)
+ * - maxWidth: Content width constraint
+ * - alignment: Text alignment
+ *
+ * Note: Uses base schema title, cta, backgroundColor, className, id
+ * The `content` field is overridden to be required and serves as rich-text body
+ */
+export const textContentSpecificSchema = z.object({
+  // Content: rich text body (overrides base optional content)
+  content: z.string().min(1, 'Content is required'),
+
+  // Design: layout options
+  maxWidth: z.enum(['sm', 'md', 'lg', 'xl', 'full']).default('lg'),
+  alignment: z.enum(['left', 'center', 'right']).default('left'),
+})
+
+/**
+ * Complete Text Content Block Schema
+ * Note: textContentSpecificSchema.content overrides baseBlockSchema.content
+ */
+export const schema = baseBlockSchema.extend(textContentSpecificSchema.shape)
+
+export type TextContentBlockProps = z.infer<typeof schema>

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

@@ -134,6 +134,14 @@ export const APP_CONFIG_OVERRIDES = {
     //   expiresIn: 60 * 60 * 24 * 90, // 90 days
     //   updateAge: 60 * 60 * 24 * 7,  // renew weekly
     // },
+
+    /**
+     * Email OTP code lifetime (seconds) and length (digits) — defaults: 300
+     * (5 minutes) / 6. Drives the `emailOTP` plugin, the login form's
+     * countdown, and the OTP email's "expires in" notice together, so they
+     * can't drift apart:
+     */
+    // otp: { expiresIn: 60 * 10, otpLength: 6 },
     /**
      * Whether Better Auth automatically sends the verification email on signup.
      *

package/dist/templates/contents/themes/starter/entities/tasks/tasks.config.ts

@@ -38,6 +38,13 @@ export const taskEntityConfig: EntityConfig = {
     dashboard: {
       showInMenu: true,
       showInTopbar: true,
+      // `filterable` below turns the feature on; this says what to filter by.
+      // Without it the list renders no filter controls at all, which is what
+      // the UAT specs (and the cypress entities fixture) already expect.
+      filters: [
+        { field: 'status', type: 'multiSelect' },
+        { field: 'priority', type: 'multiSelect' },
+      ],
     },
     public: {
       hasArchivePage: false,

package/dist/templates/contents/themes/starter/tests/cypress/e2e/_utils/devtools/access.cy.ts

@@ -6,6 +6,7 @@ import {
   loginAsDefaultDeveloper,
   loginAsDefaultSuperadmin,
   loginAsDefaultMember,
+  hasSeededTeamRoleUser,
   CORE_USERS
 } from '../../../src/session-helpers'
 
@@ -145,7 +146,14 @@ describe('DevTools - Access Control', {
     })
   })
 
-  describe('ACCESS-007: Member is BLOCKED from /devtools', { tags: '@smoke' }, () => {
+  // Needs a user with a plain team role, which the starter does not seed — it
+  // creates superadmin and developer only. ACCESS-006 above already covers a
+  // non-developer being blocked, using a user that does exist, so skipping this
+  // leaves no path untested. A theme that seeds team members sets MEMBER_EMAIL
+  // and it runs.
+  const memberSuite = hasSeededTeamRoleUser('MEMBER') ? describe : describe.skip
+
+  memberSuite('ACCESS-007: Member is BLOCKED from /devtools', { tags: '@smoke' }, () => {
     it('should redirect member to /dashboard when attempting to access /devtools', { tags: '@smoke' }, () => {
       allure.severity('critical')
 

package/dist/templates/contents/themes/starter/tests/cypress/e2e/api/entities/tasks/TaskAPIController.js

@@ -6,8 +6,8 @@
  * - API Key with tasks:read, tasks:write scopes (or superadmin with *)
  * - x-team-id header for team context
  */
-const BaseAPIController = require('../../src/controllers/BaseAPIController')
-const entitiesConfig = require('../../fixtures/entities.json')
+const BaseAPIController = require('../../../../src/controllers/BaseAPIController')
+const entitiesConfig = require('../../../../fixtures/entities.json')
 
 const { slug } = entitiesConfig.entities.tasks