@nextsparkjs/theme-default 0.1.0-beta.38 → 0.1.0-beta.40

package/tests/cypress/src/entities/TasksPOM.ts

@@ -154,6 +154,42 @@ export class TasksPOM extends DashboardEntityPOM {
     return this
   }
 
+  // ============================================
+  // FILTER METHODS
+  // ============================================
+
+  /**
+   * Filter tasks by status
+   */
+  filterByStatus(status: string) {
+    this.selectFilter('status', status)
+    return this
+  }
+
+  /**
+   * Filter tasks by priority
+   */
+  filterByPriority(priority: string) {
+    this.selectFilter('priority', priority)
+    return this
+  }
+
+  /**
+   * Clear status filter
+   */
+  clearStatusFilter() {
+    this.clearFilter('status')
+    return this
+  }
+
+  /**
+   * Clear priority filter
+   */
+  clearPriorityFilter() {
+    this.clearFilter('priority')
+    return this
+  }
+
   // ============================================
   // ENTITY-SPECIFIC ASSERTIONS
   // ============================================
@@ -171,6 +207,40 @@ export class TasksPOM extends DashboardEntityPOM {
   assertTaskNotInList(title: string) {
     return this.assertNotInList(title)
   }
+
+  /**
+   * Assert task has specific status in list
+   */
+  assertTaskStatus(title: string, status: string) {
+    cy.contains(this.selectors.rowGeneric, title)
+      .should('contain.text', status)
+    return this
+  }
+
+  /**
+   * Assert task has specific priority in list
+   */
+  assertTaskPriority(title: string, priority: string) {
+    cy.contains(this.selectors.rowGeneric, title)
+      .should('contain.text', priority)
+    return this
+  }
+
+  /**
+   * Assert task count in list
+   */
+  assertTaskCount(count: number) {
+    cy.get(this.selectors.rowGeneric).should('have.length', count)
+    return this
+  }
+
+  /**
+   * Assert no tasks in list
+   */
+  assertNoTasks() {
+    cy.get(this.selectors.rowGeneric).should('not.exist')
+    return this
+  }
 }
 
 export default TasksPOM

package/tests/cypress/src/helpers/ApiInterceptor.ts

@@ -1,177 +1,20 @@
 /**
- * ApiInterceptor - Helper para waits determinísticos en Cypress
+ * ApiInterceptor - Re-export from @nextsparkjs/testing
  *
- * Reemplaza cy.wait(ms) poco fiables con waits basados en cy.intercept()
- * que esperan respuestas reales de la API.
+ * The ApiInterceptor class is provided by @nextsparkjs/testing.
+ * This file exists for backward compatibility and to allow
+ * theme-specific extensions if needed.
  *
- * Uso básico:
- *   const api = new ApiInterceptor('customers')
- *   api.setupCrudIntercepts()
- *   cy.visit('/dashboard/customers')
- *   api.waitForList()
+ * @example Basic usage:
+ * ```ts
+ * import { ApiInterceptor } from '../helpers/ApiInterceptor'
  *
- * Uso con ruta custom:
- *   const api = new ApiInterceptor({
- *     slug: 'categories',
- *     customPath: '/api/v1/post-categories'
- *   })
+ * const api = new ApiInterceptor('tasks')
+ * api.setupCrudIntercepts()
+ * cy.visit('/dashboard/tasks')
+ * api.waitForList()
+ * ```
  */
 
-export interface ApiInterceptorConfig {
-  /** Entity slug - usado para generar aliases */
-  slug: string
-  /** Ruta API custom (ej: '/api/v1/post-categories') */
-  customPath?: string
-}
-
-export class ApiInterceptor {
-  private slug: string
-  private endpoint: string
-
-  constructor(slugOrConfig: string | ApiInterceptorConfig) {
-    if (typeof slugOrConfig === 'string') {
-      this.slug = slugOrConfig
-      this.endpoint = `/api/v1/${slugOrConfig}`
-    } else {
-      this.slug = slugOrConfig.slug
-      this.endpoint = slugOrConfig.customPath || `/api/v1/${slugOrConfig.slug}`
-    }
-  }
-
-  // ============================================
-  // ACCESSORS
-  // ============================================
-
-  /** Get the API endpoint path */
-  get path(): string {
-    return this.endpoint
-  }
-
-  /** Get the entity slug */
-  get entitySlug(): string {
-    return this.slug
-  }
-
-  /** Get alias names for all operations */
-  get aliases() {
-    return {
-      list: `${this.slug}List`,
-      create: `${this.slug}Create`,
-      update: `${this.slug}Update`,
-      delete: `${this.slug}Delete`
-    }
-  }
-
-  // ============================================
-  // INTERCEPT SETUP
-  // ============================================
-
-  /**
-   * Setup intercepts for all CRUD operations
-   * Call this BEFORE navigation in beforeEach or at test start
-   *
-   * Note: We intercept both PUT and PATCH for updates since different
-   * APIs may use different HTTP methods for updates.
-   */
-  setupCrudIntercepts(): this {
-    cy.intercept('GET', `${this.endpoint}*`).as(this.aliases.list)
-    cy.intercept('POST', this.endpoint).as(this.aliases.create)
-    // Intercept both PUT and PATCH for updates (APIs may use either)
-    cy.intercept('PUT', `${this.endpoint}/*`).as(this.aliases.update)
-    cy.intercept('PATCH', `${this.endpoint}/*`).as(`${this.aliases.update}Patch`)
-    cy.intercept('DELETE', `${this.endpoint}/*`).as(this.aliases.delete)
-    return this
-  }
-
-  /**
-   * Setup only list + create intercepts
-   * Useful for list pages with inline create
-   */
-  setupListIntercepts(): this {
-    cy.intercept('GET', `${this.endpoint}*`).as(this.aliases.list)
-    cy.intercept('POST', this.endpoint).as(this.aliases.create)
-    return this
-  }
-
-  // ============================================
-  // WAIT METHODS
-  // ============================================
-
-  /**
-   * Wait for list response (GET)
-   * Use after navigation or after mutations to wait for refresh
-   */
-  waitForList(timeout = 10000): Cypress.Chainable {
-    return cy.wait(`@${this.aliases.list}`, { timeout })
-  }
-
-  /**
-   * Wait for create response (POST) and validate success status
-   */
-  waitForCreate(timeout = 10000): Cypress.Chainable {
-    return cy.wait(`@${this.aliases.create}`, { timeout })
-      .its('response.statusCode')
-      .should('be.oneOf', [200, 201])
-  }
-
-  /**
-   * Wait for update response (PATCH or PUT) and validate success status
-   * Waits for PATCH first (more common), falls back to PUT
-   */
-  waitForUpdate(timeout = 10000): Cypress.Chainable {
-    // Try PATCH first (more common in modern APIs), fall back to PUT
-    return cy.wait(`@${this.aliases.update}Patch`, { timeout })
-      .its('response.statusCode')
-      .should('be.oneOf', [200, 201])
-  }
-
-  /**
-   * Wait for delete response (DELETE) and validate success status
-   */
-  waitForDelete(timeout = 10000): Cypress.Chainable {
-    return cy.wait(`@${this.aliases.delete}`, { timeout })
-      .its('response.statusCode')
-      .should('be.oneOf', [200, 204])
-  }
-
-  // ============================================
-  // CONVENIENCE METHODS
-  // ============================================
-
-  /**
-   * Wait for list refresh (alias for waitForList)
-   * Semantic name for use after create/update/delete
-   */
-  waitForRefresh(timeout = 10000): Cypress.Chainable {
-    return this.waitForList(timeout)
-  }
-
-  /**
-   * Wait for create + list refresh
-   * Common pattern: create entity, wait for success, wait for list to refresh
-   */
-  waitForCreateAndRefresh(timeout = 10000): Cypress.Chainable {
-    this.waitForCreate(timeout)
-    return this.waitForList(timeout)
-  }
-
-  /**
-   * Wait for update + list refresh
-   * Common pattern: update entity, wait for success, wait for list to refresh
-   */
-  waitForUpdateAndRefresh(timeout = 10000): Cypress.Chainable {
-    this.waitForUpdate(timeout)
-    return this.waitForList(timeout)
-  }
-
-  /**
-   * Wait for delete + list refresh
-   * Common pattern: delete entity, wait for success, wait for list to refresh
-   */
-  waitForDeleteAndRefresh(timeout = 10000): Cypress.Chainable {
-    this.waitForDelete(timeout)
-    return this.waitForList(timeout)
-  }
-}
-
-export default ApiInterceptor
+// Re-export from testing package
+export { ApiInterceptor, type ApiInterceptorConfig } from '@nextsparkjs/testing/helpers'

package/tests/cypress.config.ts

@@ -10,8 +10,11 @@
 import { defineConfig } from 'cypress'
 import path from 'path'
 import fs from 'fs'
+import { fileURLToPath } from 'url'
 
-// __dirname works natively with CommonJS module resolution (tsconfig.cypress.json)
+// ESM-compatible __dirname
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
 
 // Paths relative to this config file
 const themeRoot = path.resolve(__dirname, '..')
@@ -52,22 +55,14 @@ export default defineConfig({
     // Base URL for the application
     baseUrl: `http://localhost:${port}`,
 
-    // Spec patterns: theme tests (core tests only in monorepo)
-    specPattern: isNpmMode
-      ? [
-          // npm mode: only theme tests
-          path.join(__dirname, 'cypress/e2e/**/*.cy.{js,ts}'),
-        ]
-      : [
-          // Monorepo: core tests + theme tests
-          path.join(projectRoot, 'packages/core/tests/cypress/e2e/core/**/*.cy.{js,ts}'),
-          path.join(__dirname, 'cypress/e2e/**/*.cy.{js,ts}'),
-        ],
-
-    // Support file (theme-local in npm mode, core in monorepo)
-    supportFile: isNpmMode
-      ? path.join(__dirname, 'cypress/support/e2e.ts')
-      : path.join(projectRoot, 'packages/core/tests/cypress/support/e2e.ts'),
+    // Spec patterns: theme tests only
+    // Note: core e2e tests were removed as they were empty
+    specPattern: [
+      path.join(__dirname, 'cypress/e2e/**/*.cy.{js,ts}'),
+    ],
+
+    // Support file (always theme-local)
+    supportFile: path.join(__dirname, 'cypress/support/e2e.ts'),
 
     // Fixtures folder (theme-specific)
     fixturesFolder: path.join(__dirname, 'cypress/fixtures'),

package/tests/cypress/e2e/_utils/docs/tutorials/sector7-superadmin-teams.narration.json

@@ -1,155 +0,0 @@
-{
-  "title": "Sector 7 - SuperAdmin Teams View",
-  "description": "Tutorial que muestra cómo un super administrador puede acceder a Sector 7 y visualizar todos los equipos del sistema.",
-  "language": "es",
-  "estimatedDuration": "1-1:30 minutos",
-  "targetAudience": "Usuarios finales con rol superadmin",
-  "chapters": [
-    {
-      "id": "intro",
-      "title": "Introducción",
-      "narrations": [
-        {
-          "step": 1,
-          "text": "Bienvenido a Sector 7, el área exclusiva para super administradores.",
-          "action": "none",
-          "estimatedSeconds": 4
-        },
-        {
-          "step": 2,
-          "text": "Hoy veremos cómo acceder y visualizar todos los equipos del sistema.",
-          "action": "none",
-          "estimatedSeconds": 4
-        }
-      ]
-    },
-    {
-      "id": "login",
-      "title": "Login como SuperAdmin",
-      "narrations": [
-        {
-          "step": 3,
-          "text": "Iniciamos sesión con las credenciales de superadmin.",
-          "action": "visit-login",
-          "estimatedSeconds": 3
-        },
-        {
-          "step": 4,
-          "text": "Usamos el email del superadmin de prueba.",
-          "action": "fill-email",
-          "estimatedSeconds": 4
-        },
-        {
-          "step": 5,
-          "text": "Ingresamos la contraseña y enviamos.",
-          "action": "fill-password-submit",
-          "estimatedSeconds": 5
-        },
-        {
-          "step": 6,
-          "text": "Acceso concedido. Observa el icono de Sector 7 en la barra superior.",
-          "action": "highlight-sector7-icon",
-          "estimatedSeconds": 5
-        }
-      ]
-    },
-    {
-      "id": "navigation",
-      "title": "Navegación a Sector 7",
-      "narrations": [
-        {
-          "step": 7,
-          "text": "Hacemos clic para ingresar al área restringida.",
-          "action": "click-sector7",
-          "estimatedSeconds": 3
-        },
-        {
-          "step": 8,
-          "text": "Este es el panel de control del super administrador.",
-          "action": "show-dashboard",
-          "estimatedSeconds": 5
-        },
-        {
-          "step": 9,
-          "text": "En el menú lateral vemos las opciones disponibles.",
-          "action": "highlight-teams-nav",
-          "estimatedSeconds": 4
-        }
-      ]
-    },
-    {
-      "id": "teams-view",
-      "title": "Visualización de Teams",
-      "narrations": [
-        {
-          "step": 10,
-          "text": "Navegamos a la sección de Equipos.",
-          "action": "click-teams-nav",
-          "estimatedSeconds": 3
-        },
-        {
-          "step": 11,
-          "text": "Aquí vemos todos los equipos del sistema con estadísticas.",
-          "action": "show-stats",
-          "estimatedSeconds": 5
-        },
-        {
-          "step": 12,
-          "text": "La pestaña Work Teams muestra equipos colaborativos.",
-          "action": "highlight-work-tab",
-          "estimatedSeconds": 4
-        },
-        {
-          "step": 13,
-          "text": "También podemos ver los equipos personales de cada usuario.",
-          "action": "click-personal-tab",
-          "estimatedSeconds": 5
-        },
-        {
-          "step": 14,
-          "text": "El buscador permite filtrar equipos por nombre o email del propietario.",
-          "action": "highlight-search",
-          "estimatedSeconds": 4
-        }
-      ]
-    },
-    {
-      "id": "conclusion",
-      "title": "Conclusión",
-      "narrations": [
-        {
-          "step": 15,
-          "text": "Así funciona Sector 7: acceso exclusivo a la gestión global del sistema.",
-          "action": "none",
-          "estimatedSeconds": 5
-        },
-        {
-          "step": 16,
-          "text": "Gracias por ver este tutorial.",
-          "action": "none",
-          "estimatedSeconds": 3
-        }
-      ]
-    }
-  ],
-  "totalSteps": 16,
-  "technicalNotes": {
-    "users": {
-      "superadmin": "superadmin@cypress.com",
-      "password": "Pandora1234"
-    },
-    "routes": [
-      "/login",
-      "/dashboard",
-      "/sector7",
-      "/sector7/teams"
-    ],
-    "selectors": {
-      "topnavSector7": "[data-cy='topnav-sector7']",
-      "sector7NavTeams": "[data-cy='sector7-nav-teams']",
-      "teamsSearchInput": "[data-cy='teams-search-input']",
-      "workTeamsTab": "[value='work']",
-      "personalTeamsTab": "[value='personal']"
-    }
-  }
-}