@nextsparkjs/theme-default 0.1.0-beta.31 → 0.1.0-beta.35

package/tests/cypress/e2e/{_selectors → _utils/selectors}/devtools.cy.ts

@@ -14,13 +14,20 @@
  * - Assert elements exist in DOM (no form submissions)
  * - Fast execution (< 30 seconds per describe block)
  *
+ * Test IDs:
+ * - SEL_DEVT_001: Navigation Structure
+ * - SEL_DEVT_002: Home Page
+ * - SEL_DEVT_003: Style Gallery Page
+ * - SEL_DEVT_004: Config Viewer Page
+ * - SEL_DEVT_005: Test Cases Page
+ *
  * IMPORTANT: DevTools is only accessible to users with 'developer' app role.
  */
 
-import { DevtoolsPOM } from '../../src/features/DevtoolsPOM'
-import { loginAsDefaultDeveloper } from '../../src/session-helpers'
+import { DevtoolsPOM } from '../../../src/features/DevtoolsPOM'
+import { loginAsDefaultDeveloper } from '../../../src/session-helpers'
 
-describe('DevTools Selectors Validation', { tags: ['@ui-selectors'] }, () => {
+describe('DevTools Selectors Validation', { tags: ['@ui-selectors', '@devtools'] }, () => {
   const dev = DevtoolsPOM.create()
 
   beforeEach(() => {
@@ -28,9 +35,9 @@ describe('DevTools Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // NAVIGATION STRUCTURE (8 selectors)
+  // SEL_DEVT_001: NAVIGATION STRUCTURE (8 selectors)
   // ============================================
-  describe('Navigation Structure', () => {
+  describe('SEL_DEVT_001: Navigation Structure', { tags: '@SEL_DEVT_001' }, () => {
     beforeEach(() => {
       cy.visit('/devtools', { timeout: 60000, failOnStatusCode: false })
       cy.url().should('include', '/devtools')
@@ -70,9 +77,9 @@ describe('DevTools Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // HOME PAGE (4 selectors)
+  // SEL_DEVT_002: HOME PAGE (4 selectors)
   // ============================================
-  describe('Home Page', () => {
+  describe('SEL_DEVT_002: Home Page', { tags: '@SEL_DEVT_002' }, () => {
     beforeEach(() => {
       cy.visit('/devtools', { timeout: 60000, failOnStatusCode: false })
       cy.url().should('include', '/devtools')
@@ -96,9 +103,9 @@ describe('DevTools Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // STYLE GALLERY PAGE (8 selectors)
+  // SEL_DEVT_003: STYLE GALLERY PAGE (8 selectors)
   // ============================================
-  describe('Style Gallery Page', () => {
+  describe('SEL_DEVT_003: Style Gallery Page', { tags: '@SEL_DEVT_003' }, () => {
     beforeEach(() => {
       cy.visit('/devtools/style', { timeout: 60000, failOnStatusCode: false })
       cy.url().should('include', '/devtools/style')
@@ -140,9 +147,9 @@ describe('DevTools Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // CONFIG VIEWER PAGE (8 selectors)
+  // SEL_DEVT_004: CONFIG VIEWER PAGE (8 selectors)
   // ============================================
-  describe('Config Viewer Page', () => {
+  describe('SEL_DEVT_004: Config Viewer Page', { tags: '@SEL_DEVT_004' }, () => {
     beforeEach(() => {
       cy.visit('/devtools/config', { timeout: 60000, failOnStatusCode: false })
       cy.url().should('include', '/devtools/config')
@@ -186,10 +193,10 @@ describe('DevTools Selectors Validation', { tags: ['@ui-selectors'] }, () => {
   })
 
   // ============================================
-  // TEST CASES PAGE (3 selectors)
-  // NOTE: Conditional states (loading, empty, error) removed - not testable in selector validation
+  // SEL_DEVT_005: TEST CASES PAGE (3 selectors)
+  // NOTE: Tests page components may not implement all data-cy selectors
   // ============================================
-  describe('Test Cases Page', () => {
+  describe('SEL_DEVT_005: Test Cases Page', { tags: '@SEL_DEVT_005' }, () => {
     beforeEach(() => {
       cy.visit('/devtools/tests', { timeout: 60000, failOnStatusCode: false })
       cy.url().should('include', '/devtools/tests')
@@ -207,4 +214,60 @@ describe('DevTools Selectors Validation', { tags: ['@ui-selectors'] }, () => {
       cy.get(dev.selectors.testsTree).should('exist')
     })
   })
+
+  // ============================================
+  // SEL_DEVT_006: TEST COVERAGE DASHBOARD (9 selectors)
+  // ============================================
+  describe('SEL_DEVT_006: Test Coverage Dashboard', { tags: '@SEL_DEVT_006' }, () => {
+    beforeEach(() => {
+      cy.visit('/devtools/tests', { timeout: 60000, failOnStatusCode: false })
+      cy.url().should('include', '/devtools/tests')
+    })
+
+    it('should find dashboard container (no file selected)', () => {
+      cy.get(dev.selectors.testsDashboard).should('exist')
+    })
+
+    it('should find dashboard stats container', () => {
+      cy.get(dev.selectors.testsDashboardStats).should('exist')
+    })
+
+    it('should find features stat card', () => {
+      cy.get(dev.selectors.testsDashboardStatFeatures).should('exist')
+    })
+
+    it('should find flows stat card', () => {
+      cy.get(dev.selectors.testsDashboardStatFlows).should('exist')
+    })
+
+    it('should find files stat card', () => {
+      cy.get(dev.selectors.testsDashboardStatFiles).should('exist')
+    })
+
+    it('should find tags stat card', () => {
+      cy.get(dev.selectors.testsDashboardStatTags).should('exist')
+    })
+
+    it('should find coverage gaps container', () => {
+      cy.get(dev.selectors.testsDashboardGaps).should('exist')
+    })
+
+    it('should find dashboard button when file selected', () => {
+      // First expand a folder to reveal files
+      cy.get(dev.selectors.testsTree).find('[data-cy*="folder"]').first().click()
+      // Then select a file
+      cy.get(dev.selectors.testsTree).find('[data-cy*="file"]').first().click()
+      cy.get(dev.selectors.testsDashboardButton).should('exist')
+    })
+
+    it('should return to dashboard when button clicked', () => {
+      // Expand folder and select a file
+      cy.get(dev.selectors.testsTree).find('[data-cy*="folder"]').first().click()
+      cy.get(dev.selectors.testsTree).find('[data-cy*="file"]').first().click()
+      // Click dashboard button
+      cy.get(dev.selectors.testsDashboardButton).click()
+      // Dashboard should be visible again
+      cy.get(dev.selectors.testsDashboard).should('exist')
+    })
+  })
 })

package/tests/cypress/e2e/_utils/selectors/global-search.bdd.md

@@ -0,0 +1,115 @@
+---
+feature: Global Search UI Selectors Validation
+priority: medium
+tags: [selectors, search, modal, ui-validation]
+grepTags: [ui-selectors, search, SEL_GSRCH_001, SEL_GSRCH_002, SEL_GSRCH_003]
+coverage: 3
+---
+
+# Global Search UI Selectors Validation
+
+> Validates that global search component selectors exist in the DOM. This is a lightweight test that ONLY checks selector presence, not functionality. Most selectors require the search modal to be open.
+
+## @test SEL_GSRCH_001: Search Trigger
+
+### Metadata
+- **Priority:** Medium
+- **Type:** Selector Validation
+- **Tags:** search, trigger, button
+- **Grep:** `@ui-selectors` `@SEL_GSRCH_001`
+- **Status:** Skipped - selector not implemented
+
+```gherkin:en
+Scenario: Search trigger button is accessible
+
+Given I am logged in as a valid user
+And I navigate to the dashboard
+Then I should find the search trigger button
+```
+
+```gherkin:es
+Scenario: Boton de trigger de busqueda es accesible
+
+Given estoy logueado como usuario valido
+And navego al dashboard
+Then deberia encontrar el boton de trigger de busqueda
+```
+
+### Expected Results
+- `global-search-trigger` selector exists
+
+---
+
+## @test SEL_GSRCH_002: Search Modal (when open)
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** search, modal, input
+- **Grep:** `@ui-selectors` `@SEL_GSRCH_002`
+- **Status:** Partial - 1 passing, 3 skipped
+
+```gherkin:en
+Scenario: Search modal has required components when opened
+
+Given I am logged in as a valid user
+And I navigate to the dashboard
+When I press Cmd+K to open the search modal
+Then I should find the search modal container
+And I should find the search input
+And I should find the search results container (when query entered)
+And I should find search result items (when results available)
+```
+
+```gherkin:es
+Scenario: Modal de busqueda tiene componentes requeridos cuando esta abierto
+
+Given estoy logueado como usuario valido
+And navego al dashboard
+When presiono Cmd+K para abrir el modal de busqueda
+Then deberia encontrar el contenedor del modal de busqueda
+And deberia encontrar el input de busqueda
+And deberia encontrar el contenedor de resultados (cuando hay query)
+And deberia encontrar items de resultados (cuando hay resultados)
+```
+
+### Expected Results
+- `global-search-modal` skipped - selector not implemented
+- `global-search-input` selector exists (WORKING)
+- `global-search-results` skipped - requires search query
+- `global-search-result` skipped - requires results
+
+---
+
+## @test SEL_GSRCH_003: Search Modal (opened via click)
+
+### Metadata
+- **Priority:** Low
+- **Type:** Selector Validation
+- **Tags:** search, modal, click
+- **Grep:** `@ui-selectors` `@SEL_GSRCH_003`
+- **Status:** Skipped - trigger selector not implemented
+
+```gherkin:en
+Scenario: Search modal opens via click on trigger
+
+Given I am logged in as a valid user
+And I navigate to the dashboard
+When I click on the search trigger button
+Then the search modal should open
+And I should find the search input
+```
+
+```gherkin:es
+Scenario: Modal de busqueda se abre via click en trigger
+
+Given estoy logueado como usuario valido
+And navego al dashboard
+When hago click en el boton de trigger de busqueda
+Then el modal de busqueda deberia abrirse
+And deberia encontrar el input de busqueda
+```
+
+### Expected Results
+- Search modal opens when trigger is clicked
+- `global-search-input` selector exists inside modal

package/tests/cypress/e2e/{_selectors → _utils/selectors}/global-search.cy.ts

@@ -14,13 +14,18 @@
  * - Open search modal
  * - Assert elements exist in DOM (no actual search)
  *
+ * Test IDs:
+ * - SEL_GSRCH_001: Search Trigger
+ * - SEL_GSRCH_002: Search Modal (when open)
+ * - SEL_GSRCH_003: Search Modal (opened via click)
+ *
  * NOTE: Search modal must be opened via keyboard shortcut or trigger button.
  */
 
-import { cySelector } from '../../src/selectors'
-import { loginAsDefaultOwner } from '../../src/session-helpers'
+import { cySelector } from '../../../src/selectors'
+import { loginAsDefaultDeveloper } from '../../../src/session-helpers'
 
-describe('Global Search Selectors Validation', { tags: ['@ui-selectors'] }, () => {
+describe('Global Search Selectors Validation', { tags: ['@ui-selectors', '@search'] }, () => {
   // Define selectors locally since globalSearch might not be in selectors.ts
   const selectors = {
     modal: cySelector('globalSearch.modal'),
@@ -31,25 +36,25 @@ describe('Global Search Selectors Validation', { tags: ['@ui-selectors'] }, () =
   }
 
   beforeEach(() => {
-    loginAsDefaultOwner()
+    loginAsDefaultDeveloper()
     cy.visit('/dashboard', { timeout: 60000, failOnStatusCode: false })
     cy.url().should('include', '/dashboard')
   })
 
   // ============================================
-  // SEARCH TRIGGER (1 selector)
+  // SEL_GSRCH_001: SEARCH TRIGGER (1 selector)
   // ============================================
-  describe('Search Trigger', () => {
+  describe('SEL_GSRCH_001: Search Trigger', { tags: '@SEL_GSRCH_001' }, () => {
     it.skip('should find search trigger button (selector not implemented)', () => {
       cy.get(selectors.trigger).should('exist')
     })
   })
 
   // ============================================
-  // SEARCH MODAL (4 selectors)
+  // SEL_GSRCH_002: SEARCH MODAL (4 selectors)
   // These require the modal to be open
   // ============================================
-  describe('Search Modal (when open)', () => {
+  describe('SEL_GSRCH_002: Search Modal (when open)', { tags: '@SEL_GSRCH_002' }, () => {
     beforeEach(() => {
       // Try to open search modal via keyboard shortcut (Cmd+K or Ctrl+K)
       cy.get('body').type('{meta}k')
@@ -75,9 +80,9 @@ describe('Global Search Selectors Validation', { tags: ['@ui-selectors'] }, () =
   })
 
   // ============================================
-  // ALTERNATIVE: Open via click
+  // SEL_GSRCH_003: SEARCH MODAL VIA CLICK
   // ============================================
-  describe('Search Modal (opened via click)', () => {
+  describe('SEL_GSRCH_003: Search Modal (opened via click)', { tags: '@SEL_GSRCH_003' }, () => {
     it.skip('should open search modal when clicking trigger (trigger selector not implemented)', () => {
       cy.get(selectors.trigger).click()
       cy.wait(500)

package/tests/cypress/e2e/_utils/selectors/pages-editor.bdd.md

@@ -0,0 +1,207 @@
+---
+feature: Pages Block Editor UI Selectors Validation
+priority: high
+tags: [selectors, pages, editor, page-builder, ui-validation]
+grepTags: [ui-selectors, pages, editor, SEL_PGED_001, SEL_PGED_002, SEL_PGED_003, SEL_PGED_004, SEL_PGED_005, SEL_PGED_006]
+coverage: 6
+---
+
+# Pages Block Editor UI Selectors Validation
+
+> Validates selectors specific to the Page Builder including page settings, SEO, and locale features. These tests ensure the page editor has all required UI elements.
+
+## @test SEL_PGED_001: Pages List Page Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** pages, list, table
+- **Grep:** `@ui-selectors` `@SEL_PGED_001`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Pages list has required selectors
+
+Given I am logged in as a valid user
+And I navigate to the pages list
+Then I should find the pages table container
+And I should find the add page button
+And I should find at least one page row
+```
+
+```gherkin:es
+Scenario: Lista de paginas tiene selectores requeridos
+
+Given estoy logueado como usuario valido
+And navego a la lista de paginas
+Then deberia encontrar el contenedor de tabla de paginas
+And deberia encontrar el boton de agregar pagina
+And deberia encontrar al menos una fila de pagina
+```
+
+---
+
+## @test SEL_PGED_002: Block Editor Core Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** pages, editor, core
+- **Grep:** `@ui-selectors` `@SEL_PGED_002`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Page editor has core selectors
+
+Given I am logged in as a valid user
+And I create a new page
+Then I should find the editor container
+And I should find the title input
+And I should find the slug input
+And I should find the save button
+```
+
+```gherkin:es
+Scenario: Editor de paginas tiene selectores core
+
+Given estoy logueado como usuario valido
+And creo una nueva pagina
+Then deberia encontrar el contenedor del editor
+And deberia encontrar el input de titulo
+And deberia encontrar el input de slug
+And deberia encontrar el boton de guardar
+```
+
+---
+
+## @test SEL_PGED_003: Page Settings Selectors
+
+### Metadata
+- **Priority:** Medium
+- **Type:** Selector Validation
+- **Tags:** pages, settings, seo, locale
+- **Grep:** `@ui-selectors` `@SEL_PGED_003`
+- **Status:** Partial - 2 passing, 2 skipped (SEO not implemented)
+
+```gherkin:en
+Scenario: Page editor has settings and SEO selectors
+
+Given I am logged in as a valid user
+And I edit an existing page
+When I click on the fields tab
+Then I should find the entity fields sidebar
+And I should find the locale selector
+And the SEO trigger should exist (skipped - not implemented)
+And the SEO fields should exist when expanded (skipped - not implemented)
+```
+
+```gherkin:es
+Scenario: Editor de paginas tiene selectores de configuracion y SEO
+
+Given estoy logueado como usuario valido
+And edito una pagina existente
+When hago click en la tab de campos
+Then deberia encontrar el sidebar de campos de entidad
+And deberia encontrar el selector de locale
+And el trigger de SEO deberia existir (skipped - no implementado)
+And los campos de SEO deberian existir cuando se expanden (skipped - no implementado)
+```
+
+---
+
+## @test SEL_PGED_004: Block Picker Selectors
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** pages, blocks, picker
+- **Grep:** `@ui-selectors` `@SEL_PGED_004`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Page editor has block picker selectors
+
+Given I am logged in as a valid user
+And I create a new page
+Then I should find the block picker container
+And I should find the hero block item
+And I should find the add hero block button
+```
+
+```gherkin:es
+Scenario: Editor de paginas tiene selectores de block picker
+
+Given estoy logueado como usuario valido
+And creo una nueva pagina
+Then deberia encontrar el contenedor del block picker
+And deberia encontrar el item de bloque hero
+And deberia encontrar el boton de agregar bloque hero
+```
+
+---
+
+## @test SEL_PGED_005: Block Canvas and Settings
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** pages, canvas, settings
+- **Grep:** `@ui-selectors` `@SEL_PGED_005`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Page editor canvas and settings work
+
+Given I am logged in as a valid user
+And I create a new page
+Then I should find the empty state when no blocks added
+When I add a hero block
+Then I should find the block canvas
+And I should find the settings panel
+And I should find the content and design tabs
+```
+
+```gherkin:es
+Scenario: Canvas y configuracion del editor de paginas funcionan
+
+Given estoy logueado como usuario valido
+And creo una nueva pagina
+Then deberia encontrar el estado vacio cuando no hay bloques
+When agrego un bloque hero
+Then deberia encontrar el canvas de bloques
+And deberia encontrar el panel de configuracion
+And deberia encontrar las tabs de contenido y diseno
+```
+
+---
+
+## @test SEL_PGED_006: Edit Existing Page
+
+### Metadata
+- **Priority:** High
+- **Type:** Selector Validation
+- **Tags:** pages, edit, existing
+- **Grep:** `@ui-selectors` `@SEL_PGED_006`
+- **Status:** Active
+
+```gherkin:en
+Scenario: Editing existing page loads editor correctly
+
+Given I am logged in as a valid user
+And I navigate to the pages list
+When I select an existing page to edit
+Then I should find the editor container
+And I should find the title input with existing content
+And I should find the save button
+```
+
+```gherkin:es
+Scenario: Editar pagina existente carga el editor correctamente
+
+Given estoy logueado como usuario valido
+And navego a la lista de paginas
+When selecciono una pagina existente para editar
+Then deberia encontrar el contenedor del editor
+And deberia encontrar el input de titulo con contenido existente
+And deberia encontrar el boton de guardar
+```

package/tests/cypress/e2e/{_selectors → _utils/selectors}/pages-editor.cy.ts

@@ -14,22 +14,39 @@
  * Scope:
  * - Only login and navigate
  * - Assert elements exist in DOM (no full CRUD operations)
+ *
+ * Test IDs:
+ * - SEL_PGED_001: Pages List Page Selectors
+ * - SEL_PGED_002: Block Editor Core Selectors
+ * - SEL_PGED_003: Page Settings Selectors
+ * - SEL_PGED_004: Block Picker Selectors
+ * - SEL_PGED_005: Block Canvas and Settings
+ * - SEL_PGED_006: Edit Existing Page
  */
 
-import { PageBuilderPOM } from '../../src/features/PageBuilderPOM'
-import { PagesPOM } from '../../src/entities/PagesPOM'
-import { loginAsDefaultOwner } from '../../src/session-helpers'
+import { PageBuilderPOM } from '../../../src/features/PageBuilderPOM'
+import { PagesPOM } from '../../../src/entities/PagesPOM'
+import { loginAsDefaultDeveloper } from '../../../src/session-helpers'
+
+// Team ID for developer's team (NextSpark Team)
+const DEVELOPER_TEAM_ID = 'team-nextspark-001'
 
-describe('Pages Block Editor Selectors Validation', { tags: ['@ui-selectors'] }, ()
-    => {
+describe('Pages Block Editor Selectors Validation', { tags: ['@ui-selectors', '@pages', '@editor'] }, () => {
   const pageBuilder = PageBuilderPOM.create()
   const pages = PagesPOM.create()
 
   beforeEach(() => {
-    loginAsDefaultOwner()
+    loginAsDefaultDeveloper()
+    // Set team context for entity API calls (pages is team-based)
+    cy.window().then((win) => {
+      win.localStorage.setItem('activeTeamId', DEVELOPER_TEAM_ID)
+    })
   })
 
-  describe('Pages List Page Selectors (Entity POM)', () => {
+  // ============================================
+  // SEL_PGED_001: PAGES LIST PAGE SELECTORS
+  // ============================================
+  describe('SEL_PGED_001: Pages List Page Selectors', { tags: '@SEL_PGED_001' }, () => {
     beforeEach(() => {
       pages.visitList()
       pages.waitForList()
@@ -48,7 +65,10 @@ describe('Pages Block Editor Selectors Validation', { tags: ['@ui-selectors'] },
     })
   })
 
-  describe('Block Editor Core Selectors (Pages)', () => {
+  // ============================================
+  // SEL_PGED_002: BLOCK EDITOR CORE SELECTORS
+  // ============================================
+  describe('SEL_PGED_002: Block Editor Core Selectors', { tags: '@SEL_PGED_002' }, () => {
     beforeEach(() => {
       pageBuilder.visitCreate()
       pageBuilder.waitForEditor()
@@ -71,7 +91,10 @@ describe('Pages Block Editor Selectors Validation', { tags: ['@ui-selectors'] },
     })
   })
 
-  describe('Page Settings Selectors (Pages-specific)', () => {
+  // ============================================
+  // SEL_PGED_003: PAGE SETTINGS SELECTORS
+  // ============================================
+  describe('SEL_PGED_003: Page Settings Selectors', { tags: '@SEL_PGED_003' }, () => {
     beforeEach(() => {
       // Navigate to edit an existing page to see page settings and SEO
       pages.visitList()
@@ -115,7 +138,10 @@ describe('Pages Block Editor Selectors Validation', { tags: ['@ui-selectors'] },
     })
   })
 
-  describe('Block Picker Selectors (Pages)', () => {
+  // ============================================
+  // SEL_PGED_004: BLOCK PICKER SELECTORS
+  // ============================================
+  describe('SEL_PGED_004: Block Picker Selectors', { tags: '@SEL_PGED_004' }, () => {
     beforeEach(() => {
       pageBuilder.visitCreate()
       pageBuilder.waitForEditor()
@@ -131,7 +157,10 @@ describe('Pages Block Editor Selectors Validation', { tags: ['@ui-selectors'] },
     })
   })
 
-  describe('Block Canvas and Settings (Pages)', () => {
+  // ============================================
+  // SEL_PGED_005: BLOCK CANVAS AND SETTINGS
+  // ============================================
+  describe('SEL_PGED_005: Block Canvas and Settings', { tags: '@SEL_PGED_005' }, () => {
     beforeEach(() => {
       pageBuilder.visitCreate()
       pageBuilder.waitForEditor()
@@ -153,7 +182,10 @@ describe('Pages Block Editor Selectors Validation', { tags: ['@ui-selectors'] },
     })
   })
 
-  describe('Edit Existing Page Selectors', () => {
+  // ============================================
+  // SEL_PGED_006: EDIT EXISTING PAGE
+  // ============================================
+  describe('SEL_PGED_006: Edit Existing Page', { tags: '@SEL_PGED_006' }, () => {
     it('should find editor elements when editing an existing page', () => {
       // Get a page ID from the list
       pages.visitList()