@nextsparkjs/core 0.1.0-beta.13 → 0.1.0-beta.131

package/dist/presets/ai-workflow/claude/tools/sessions/templates/tests.md

@@ -1,220 +0,0 @@
-# Tests: [Feature Name]
-
-**Session:** `.claude/sessions/YYYY-MM-DD-feature-name-v1/`
-**Created:** YYYY-MM-DD
-**Last Updated:** YYYY-MM-DD HH:MM
-**Workflow Version:** v4.1
-
----
-
-## Test Planning (qa-automation writes before implementation - NEW v4.1)
-
-**Planned by:** [Not yet planned]
-**Date:** [Date]
-
-### Tests to Create
-
-| Test ID | Type | File | Description | AC Mapping | Priority |
-|---------|------|------|-------------|------------|----------|
-| - | - | - | - | - | - |
-
-### Batch Execution Plan
-
-| Batch | Tests | Status |
-|-------|-------|--------|
-| - | - | Pending |
-
-### Execution Strategy
-
-- **Batch Size:** 5 tests per batch
-- **Success Threshold:** 90% (100% preferred)
-- **Max Retries per Batch:** 3
-
----
-
-## Selector Validation (frontend-validator writes here - NEW v4.1)
-
-**Validated by:** [Not yet validated]
-**Date:** [Date]
-**Status:** [Pending / PASSED / Failed / Skipped]
-**Skip Reason:** [If skipped, why - e.g., "requiresNewSelectors = no"]
-
-### Selectors Validated
-
-| Selector | Exists in DOM | Component | Notes |
-|----------|---------------|-----------|-------|
-| - | - | - | - |
-
-### @ui-selectors Gate Result
-
-- **Tests Created:** [Yes/No]
-- **Tests Location:** `e2e/selectors/{feature}-selectors.cy.ts`
-- **Execution Result:** [PASSED / FAILED / SKIPPED]
-- **Retries Needed:** [0-3]
-
----
-
-## Test Results (qa-automation writes here)
-
-### Latest Test Run
-**Date:** [Not yet executed]
-**Status:** [Pending / Passed / Failed]
-**Total Tests:** 0
-**Passed:** 0
-**Failed:** 0
-**Skipped:** 0
-
-### Test Summary
-
-#### API Tests
-| Test ID | Description | Status | Notes |
-|---------|-------------|--------|-------|
-| [No tests executed yet] | | | |
-
-#### UAT Tests
-| Test ID | Description | Status | Notes |
-|---------|-------------|--------|-------|
-| [No tests executed yet] | | | |
-
-### Test Execution History
-| Date | Total | Passed | Failed | Agent |
-|------|-------|--------|--------|-------|
-| [No history yet] | | | | |
-
-### Failed Test Details
-[No failures recorded]
-
----
-
-## Selectores data-cy (frontend-validator writes here)
-
-**Documented by:** frontend-validator
-**Date:** [Not yet documented]
-**Status:** [Pending / Complete]
-
-### Components Inventory
-
-| Component | File Path | Selector Pattern | Description |
-|-----------|-----------|------------------|-------------|
-| [Example] | `app/components/Example.tsx` | `example-{action}` | Example component |
-
-### Detailed Selectors
-
-#### [Entity/Feature Name] Components
-
-| Element | Selector data-cy | Usage | Notes |
-|---------|------------------|-------|-------|
-| List Container | `{entity}-list` | Main list wrapper | Required for list tests |
-| Create Button | `{entity}-list-create-btn` | Button to open create form | |
-| Table Row | `{entity}-list-row-{id}` | Individual row | Dynamic ID |
-| Edit Button | `{entity}-row-{id}-edit-btn` | Edit action per row | |
-| Delete Button | `{entity}-row-{id}-delete-btn` | Delete action per row | |
-| Form | `{entity}-form` | Create/Edit form | |
-| Submit Button | `{entity}-form-submit-btn` | Form submission | |
-| Cancel Button | `{entity}-form-cancel-btn` | Cancel action | |
-
-#### Form Fields
-
-| Field | Selector data-cy | Type | Validation |
-|-------|------------------|------|------------|
-| [Field Name] | `{entity}-form-{field}` | text/select/etc | Required/Optional |
-
-### Selector Naming Convention
-
-**Pattern:** `{entity}-{component}-{element}-{action}`
-
-**Examples:**
-- `product-list` - Products list container
-- `product-list-create-btn` - Create button in products list
-- `product-form-name` - Name field in product form
-- `product-row-123-edit-btn` - Edit button for product ID 123
-
-### Missing Selectors (Issues Found)
-
-| Component | Issue | Recommendation | Fixed |
-|-----------|-------|----------------|-------|
-| [None found] | | | |
-
----
-
-## Translation Keys Validation (frontend-validator writes here)
-
-### Translation Files Checked
-- [ ] `contents/themes/{theme}/messages/en.json`
-- [ ] `contents/themes/{theme}/messages/es.json`
-
-### Namespace Used
-**Namespace:** `[feature-namespace]`
-**Location:** `contents/themes/{theme}/messages/`
-
-### Keys Inventory
-
-| Key | EN Value | ES Value | Used In |
-|-----|----------|----------|---------|
-| [namespace.title] | [English] | [Spanish] | [Component] |
-
-### Issues Found
-
-| Issue Type | Location | Description | Fixed |
-|------------|----------|-------------|-------|
-| [None found] | | | |
-
----
-
-## AC Coverage Report (qa-automation writes here)
-
-**Generated by:** qa-automation
-**Date:** [Not yet generated]
-**Status:** [Pending / Complete]
-
-### Coverage Summary
-
-| Category | Total | Covered | Coverage |
-|----------|-------|---------|----------|
-| [AUTO] criteria | 0 | 0 | 0% |
-| [MANUAL] criteria | 0 | 0 | verified by qa-manual |
-| [REVIEW] criteria | 0 | 0 | verified by code-reviewer |
-
-### Detailed AC Coverage
-
-| AC ID | Classification | Description | Test Coverage | Status |
-|-------|----------------|-------------|---------------|--------|
-| [No ACs mapped yet] | | | | |
-
-### Coverage Notes
-
-- **[AUTO]** criteria MUST have automated tests (API or UAT)
-- **[MANUAL]** criteria verified by qa-manual during Phase 14
-- **[REVIEW]** criteria verified by code-reviewer during Phase 16
-- Coverage < 100% for [AUTO] does NOT block workflow (informative only)
-
----
-
-## Test Coverage Requirements
-
-### API Tests Required
-- [ ] CRUD operations (Create, Read, Update, Delete)
-- [ ] Validation errors (required fields, format validation)
-- [ ] Authentication (401 for unauthenticated)
-- [ ] Authorization (403 for unauthorized)
-- [ ] Pagination (if applicable)
-- [ ] Filtering/Search (if applicable)
-
-### UAT Tests Required
-- [ ] Happy path flows
-- [ ] Form validation (client-side)
-- [ ] Error states
-- [ ] Loading states
-- [ ] Responsive behavior (desktop/mobile)
-- [ ] Accessibility basics
-
----
-
-## Notes
-
-[Additional notes about testing this feature]
-
----
-
-**Updated by:** [agent-name]
-**Last Update:** YYYY-MM-DD HH:MM

package/dist/presets/blocks/README.md

@@ -1,80 +0,0 @@
-# Block Presets
-
-Ready-to-use page builder blocks that can be copied directly into any theme.
-
-## Available Blocks
-
-| Block | Category | Description |
-|-------|----------|-------------|
-| `hero` | hero | Full-width hero section with title, subtitle, CTA button, and background image |
-| `cta-section` | cta | Call-to-action section with title, description, and action buttons |
-| `features-grid` | content | Grid layout displaying multiple features with icons, titles, and descriptions |
-| `testimonials` | testimonials | Display customer testimonials with quotes, authors, and avatars |
-| `text-content` | content | Rich text content block for paragraphs, lists, and formatted text |
-
-## Usage
-
-### 1. Copy Block to Theme
-
-Copy the entire block folder to your theme's blocks directory:
-
-```bash
-# Copy a single block
-cp -r core/presets/blocks/hero contents/themes/YOUR_THEME/blocks/
-
-# Copy multiple blocks
-cp -r core/presets/blocks/cta-section contents/themes/YOUR_THEME/blocks/
-cp -r core/presets/blocks/features-grid contents/themes/YOUR_THEME/blocks/
-```
-
-### 2. Rebuild Registry
-
-After copying blocks, rebuild the registry:
-
-```bash
-node core/scripts/build/registry.mjs
-```
-
-### 3. Rebuild Theme (for thumbnails)
-
-The theme build process automatically copies block thumbnails:
-
-```bash
-node core/scripts/build/theme.mjs
-```
-
-Or if using dev server, thumbnails are copied automatically.
-
-## Block Structure
-
-Each block follows the standard 6-file structure:
-
-```
-block-name/
-├── config.ts       # Metadata: slug, name, description, category, icon
-├── schema.ts       # Zod validation schema (extends baseBlockSchema)
-├── fields.ts       # Field definitions for the editor UI
-├── component.tsx   # React component
-├── index.ts        # Re-exports all modules
-└── thumbnail.png   # Preview image for block picker
-```
-
-## Customization
-
-After copying a block, you can customize it:
-
-1. **Change metadata**: Edit `config.ts` (name, description, icon)
-2. **Add/remove fields**: Modify `schema.ts` and `fields.ts`
-3. **Update UI**: Modify `component.tsx`
-4. **Update thumbnail**: Replace `thumbnail.png` with actual preview image
-
-## Creating New Blocks
-
-For creating new blocks from scratch, use the `block-developer` agent or follow the patterns in these presets.
-
-## Notes
-
-- Blocks extend `baseBlockSchema` for consistent base fields (title, content, cta, backgroundColor, className, id)
-- Use `buildSectionClasses()` helper for consistent styling
-- Include `data-cy` attributes for testing
-- Thumbnails should be PNG images (current placeholders need to be replaced)

package/dist/presets/blocks/cta-section/component.tsx

@@ -1,99 +0,0 @@
-import React from 'react'
-import { Button } from '@/core/components/ui/button'
-import { buildSectionClasses } from '@/core/types/blocks'
-import type { CTASectionBlockProps } from './schema'
-
-/**
- * CTA Section Block Component
- *
- * Props from 3-tab structure:
- * - Content: title, content, cta (primary), secondaryButton
- * - Design: backgroundColor
- * - Advanced: className, id
- */
-export function CTASectionBlock({
-  // Base content props
-  title,
-  content,
-  cta,
-  // CTA-specific content
-  secondaryButton,
-  // Base design props
-  backgroundColor,
-  // Base advanced props
-  className,
-  id,
-  // Legacy props for backward compatibility
-  ...legacyProps
-}: CTASectionBlockProps & {
-  buttonText?: string
-  buttonLink?: string
-  primaryButton?: { text: string; link: string; variant?: string }
-  description?: string
-}) {
-  // Handle legacy format (buttonText/buttonLink or primaryButton)
-  const primaryCta = cta || (legacyProps.primaryButton ? {
-    text: legacyProps.primaryButton.text,
-    link: legacyProps.primaryButton.link,
-    target: '_self' as const,
-  } : legacyProps.buttonText ? {
-    text: legacyProps.buttonText,
-    link: legacyProps.buttonLink || '#',
-    target: '_self' as const,
-  } : undefined)
-
-  // Handle legacy description prop
-  const displayContent = content || (legacyProps as { description?: string }).description
-
-  // 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-cta-section">
-      <div className="container mx-auto max-w-4xl text-center">
-        {title && (
-          <h2 className="mb-4 text-4xl font-bold md:text-5xl">{title}</h2>
-        )}
-
-        {displayContent && (
-          <p className="mb-8 text-lg md:text-xl opacity-90">{displayContent}</p>
-        )}
-
-        {(primaryCta || secondaryButton) && (
-          <div className="flex flex-col gap-4 sm:flex-row sm:justify-center">
-            {primaryCta && (
-              <Button asChild size="lg">
-                <a
-                  href={primaryCta.link}
-                  target={primaryCta.target}
-                  rel={primaryCta.target === '_blank' ? 'noopener noreferrer' : undefined}
-                >
-                  {primaryCta.text}
-                </a>
-              </Button>
-            )}
-
-            {secondaryButton && (
-              <Button
-                asChild
-                size="lg"
-                variant={secondaryButton.variant || 'outline'}
-              >
-                <a
-                  href={secondaryButton.link}
-                  target={secondaryButton.target}
-                  rel={secondaryButton.target === '_blank' ? 'noopener noreferrer' : undefined}
-                >
-                  {secondaryButton.text}
-                </a>
-              </Button>
-            )}
-          </div>
-        )}
-      </div>
-    </section>
-  )
-}

package/dist/presets/blocks/features-grid/component.tsx

@@ -1,111 +0,0 @@
-import React from 'react'
-import * as Icons from 'lucide-react'
-import { cn } from '@/core/lib/utils'
-import { buildSectionClasses } from '@/core/types/blocks'
-import type { FeaturesGridBlockProps, FeatureItem } from './schema'
-
-/**
- * Features Grid Block Component
- *
- * Props from 3-tab structure:
- * - Content: title, content, cta, items
- * - Design: backgroundColor, columns
- * - Advanced: className, id
- */
-export function FeaturesGridBlock({
-  // Base content props
-  title,
-  content,
-  cta,
-  // Features-specific content
-  items,
-  // Base design props
-  backgroundColor,
-  // Features-specific design
-  columns = '3',
-  // Base advanced props
-  className,
-  id,
-  // Legacy props for backward compatibility
-  ...legacyProps
-}: FeaturesGridBlockProps & { features?: FeatureItem[]; description?: string }) {
-  // Handle legacy 'features' prop for backward compatibility
-  const safeItems = Array.isArray(items)
-    ? items
-    : Array.isArray((legacyProps as { features?: FeatureItem[] }).features)
-      ? (legacyProps as { features: FeatureItem[] }).features
-      : []
-
-  // Handle legacy description prop
-  const displayContent = content || (legacyProps as { description?: string }).description
-
-  // Build column classes based on columns prop
-  const columnClasses: Record<string, string> = {
-    '2': 'sm:grid-cols-2',
-    '3': 'sm:grid-cols-2 lg:grid-cols-3',
-    '4': 'sm:grid-cols-2 lg:grid-cols-4',
-  }
-
-  // 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-features-grid">
-      <div className="container mx-auto max-w-6xl">
-        {/* Section Header */}
-        {(title || displayContent) && (
-          <div className="mb-12 text-center">
-            {title && (
-              <h2 className="mb-4 text-4xl font-bold md:text-5xl">
-                {title}
-              </h2>
-            )}
-            {displayContent && (
-              <p className="mx-auto max-w-2xl text-lg text-muted-foreground">
-                {displayContent}
-              </p>
-            )}
-          </div>
-        )}
-
-        {/* Features Grid */}
-        <div className={cn('grid gap-8', columnClasses[columns] || columnClasses['3'])}>
-          {safeItems.map((item, index) => {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const IconComponent = (Icons as any)[item.icon] || Icons.Circle
-
-            return (
-              <div
-                key={index}
-                className="flex flex-col items-center text-center p-6 rounded-lg border bg-card"
-              >
-                <div className="mb-4 rounded-full bg-primary/10 p-4">
-                  <IconComponent className="h-8 w-8 text-primary" />
-                </div>
-                <h3 className="mb-2 text-xl font-semibold">{item.title}</h3>
-                <p className="text-muted-foreground">{item.description}</p>
-              </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>
-  )
-}

package/dist/presets/blocks/hero/component.tsx

@@ -1,99 +0,0 @@
-import React from 'react'
-import { Button } from '@/core/components/ui/button'
-import { cn } from '@/core/lib/utils'
-import { buildSectionClasses } from '@/core/types/blocks'
-import type { HeroBlockProps } from './schema'
-
-/**
- * Hero Block Component
- *
- * Props from 3-tab structure:
- * - Content: title, content, cta
- * - Design: backgroundColor, backgroundImage, textColor
- * - Advanced: className, id
- */
-export function HeroBlock({
-  // Base content props
-  title,
-  content,
-  cta,
-  // Base design props
-  backgroundColor,
-  // Hero-specific design
-  backgroundImage,
-  textColor = 'light',
-  // Base advanced props
-  className,
-  id,
-  // Legacy props for backward compatibility
-  ...legacyProps
-}: HeroBlockProps & {
-  ctaText?: string
-  ctaLink?: string
-  subtitle?: string
-  description?: string
-}) {
-  // Handle legacy CTA format (ctaText, ctaLink) for backward compatibility
-  const ctaConfig = cta || (legacyProps.ctaText ? {
-    text: legacyProps.ctaText,
-    link: legacyProps.ctaLink || '#',
-    target: '_self' as const,
-  } : undefined)
-
-  // Handle legacy subtitle/description props for backward compatibility
-  const displayContent = content || legacyProps.subtitle || legacyProps.description
-
-  // Build section classes with background and custom className
-  const sectionClasses = buildSectionClasses(
-    cn(
-      'relative flex min-h-[600px] items-center justify-center overflow-hidden px-4 py-20',
-      textColor === 'light' ? 'text-white' : 'text-gray-900'
-    ),
-    { backgroundColor, className }
-  )
-
-  return (
-    <section id={id} className={sectionClasses} data-cy="block-hero">
-      {/* Background Image */}
-      {backgroundImage && (
-        <div
-          className="absolute inset-0 z-0"
-          style={{
-            backgroundImage: `url(${backgroundImage})`,
-            backgroundSize: 'cover',
-            backgroundPosition: 'center',
-          }}
-        >
-          <div className="absolute inset-0 bg-black/40" />
-        </div>
-      )}
-
-      {/* Content */}
-      <div className="container relative z-10 mx-auto max-w-4xl text-center">
-        {title && (
-          <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">
-            {displayContent}
-          </p>
-        )}
-
-        {ctaConfig && (
-          <Button asChild size="lg" className="text-lg px-8 py-6">
-            <a
-              href={ctaConfig.link}
-              target={ctaConfig.target}
-              rel={ctaConfig.target === '_blank' ? 'noopener noreferrer' : undefined}
-            >
-              {ctaConfig.text}
-            </a>
-          </Button>
-        )}
-      </div>
-    </section>
-  )
-}

package/dist/presets/blocks/hero/schema.ts

@@ -1,32 +0,0 @@
-import { z } from 'zod'
-import {
-  baseBlockSchema,
-  type BaseBlockProps,
-} from '@/core/types/blocks'
-
-/**
- * Hero Block Schema
- *
- * Extends base schema with hero-specific fields:
- * - backgroundImage: Optional hero background
- * - textColor: Light/dark for contrast
- *
- * Note: Uses base schema title, content, cta, backgroundColor, className, id
- * The `content` field serves as the hero subtitle/description
- */
-export const heroSpecificSchema = z.object({
-  // Hero-specific design fields
-  backgroundImage: z.string().url('Must be a valid URL').optional(),
-  textColor: z.enum(['light', 'dark']).default('light'),
-})
-
-/**
- * Complete Hero Block Schema
- * Combines base fields + hero-specific fields
- */
-export const schema = baseBlockSchema.merge(heroSpecificSchema)
-
-export type HeroBlockProps = z.infer<typeof schema>
-
-// Also export for type-only imports
-export type { BaseBlockProps }