@verdaccio/e2e-ui 2.2.0 → 2.3.0

package/build/esm/tests/search.js

@@ -1,3 +1,4 @@
+import { maybeIt } from "../features.js";
 //#region src/tests/search.ts
 /**
 * UI tests for the Verdaccio search box.
@@ -8,6 +9,8 @@
 * a real package in the registry should live in publishTests instead.
 */
 function searchTests(config) {
+	const { features } = config;
+	const { package: pkg } = config.testIds;
 	describe("search", () => {
 		beforeEach(() => {
 			cy.intercept("GET", "**/-/verdaccio/data/search/**").as("webSearch");
@@ -43,6 +46,51 @@ function searchTests(config) {
 				expect(interception.request.url).to.contain("second-query");
 			});
 		});
+		describe("with a published package", () => {
+			const pkgName = "@verdaccio/search-fixture";
+			const pkgSlug = "search-fixture";
+			let tempFolder = null;
+			beforeEach(() => {
+				cy.task("publishPackage", {
+					pkgName,
+					version: "1.0.0",
+					unique: true
+				}).then((result) => {
+					tempFolder = result?.tempFolder ?? null;
+				});
+				cy.visit(config.registryUrl);
+			});
+			afterEach(() => {
+				cy.task("unpublishPackage", {
+					pkgName,
+					tempFolder: tempFolder ?? void 0
+				});
+				if (tempFolder) cy.task("cleanupPublished", tempFolder);
+				tempFolder = null;
+			});
+			maybeIt(features.search.resultsDropdown)("should display the matching package in the results dropdown", () => {
+				getSearchInput().clear().type(pkgSlug, { delay: 30 });
+				cy.wait(anySearchAlias(), { timeout: 1e4 }).then((interception) => {
+					expect(interception.request.url).to.contain(pkgSlug);
+				});
+				cy.get("[role=\"listbox\"]", { timeout: 5e3 }).should("be.visible");
+				cy.get("[role=\"listbox\"] [role=\"option\"]").should("have.length.at.least", 1);
+				cy.contains("[role=\"listbox\"] [role=\"option\"]", pkgName).should("be.visible");
+			});
+			maybeIt(features.search.resultClickNavigation)("should navigate to the package detail page when a result is clicked", () => {
+				cy.intercept("GET", `/-/verdaccio/data/sidebar/${pkgName}`).as("detailSidebar");
+				cy.intercept("GET", `/-/verdaccio/data/package/readme/${pkgName}`).as("detailReadme");
+				getSearchInput().clear().type(pkgSlug, { delay: 30 });
+				cy.wait(anySearchAlias(), { timeout: 1e4 });
+				cy.contains("[role=\"listbox\"] [role=\"option\"]", pkgName).should("be.visible").click();
+				cy.location("pathname").should("contain", "/-/web/detail");
+				cy.location("pathname").should("contain", "search-fixture");
+				cy.wait("@detailSidebar", { timeout: 1e4 });
+				cy.wait("@detailReadme", { timeout: 1e4 });
+				cy.getByTestId(pkg.sidebar).should("be.visible");
+				cy.getByTestId(pkg.readme).should("be.visible");
+			});
+		});
 	});
 }
 /**

package/build/esm/tests/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","names":[],"sources":["../../../src/tests/search.ts"],"sourcesContent":["/// <reference types=\"cypress\" />\n\nimport { RegistryConfig } from '../types';\n\n/**\n * UI tests for the Verdaccio search box.\n *\n * These tests do NOT depend on any published package — they assert the\n * search *flow* (input exists, typing triggers the search API, results\n * region updates) rather than specific package metadata. Tests that need\n * a real package in the registry should live in publishTests instead.\n */\nexport function searchTests(config: RegistryConfig) {\n  describe('search', () => {\n    beforeEach(() => {\n      // Verdaccio's search endpoint — covers both the web API and the\n      // npm v1 search API, depending on which one the UI calls.\n      cy.intercept('GET', '**/-/verdaccio/data/search/**').as('webSearch');\n      cy.intercept('GET', '**/-/v1/search**').as('v1Search');\n      cy.intercept('GET', '**/-/verdaccio/data/packages').as('pkgs');\n\n      cy.visit(config.registryUrl);\n      cy.get('body').should('be.visible');\n    });\n\n    it('should render the search input', () => {\n      getSearchInput().should('be.visible');\n    });\n\n    it('should fire a search request when typing a query', () => {\n      const query = 'verdaccio';\n\n      getSearchInput().clear().type(query, { delay: 30 });\n\n      // Whichever endpoint the UI is wired to, at least one should hit.\n      cy.wait(anySearchAlias(), { timeout: 10000 }).then((interception: any) => {\n        expect(interception.request.url).to.contain(query);\n      });\n    });\n\n    it('should show a \"no results\" state for an impossible query', () => {\n      const query = 'xyzzy-no-such-package-' + Date.now();\n\n      getSearchInput().clear().type(query, { delay: 30 });\n      cy.wait(anySearchAlias(), { timeout: 10000 });\n\n      // Give the UI a tick to render the empty state.\n      cy.wait(300);\n\n      // The UI may render \"No Match\", \"No results\", or similar — match\n      // loosely rather than binding to one exact string.\n      cy.contains(/no\\s+(match|results|packages)/i, { timeout: 5000 }).should(\n        'be.visible'\n      );\n    });\n\n    it('should clear the query and allow typing a new one', () => {\n      getSearchInput().clear().type('first-query', { delay: 20 });\n      cy.wait(anySearchAlias(), { timeout: 10000 });\n\n      // Clearing should empty the input value. We deliberately do NOT\n      // assert on the autocomplete dropdown's empty-state text: on a\n      // registry with no packages published it lingers regardless of\n      // the input value, which previously caused a false positive.\n      getSearchInput().clear();\n      getSearchInput().should('have.value', '');\n\n      // Typing a fresh query must fire another search request so the\n      // search box is still functional after a clear.\n      getSearchInput().type('second-query', { delay: 20 });\n      cy.wait(anySearchAlias(), { timeout: 10000 }).then(\n        (interception: any) => {\n          expect(interception.request.url).to.contain('second-query');\n        }\n      );\n    });\n  });\n}\n\n/**\n * Resolve the search input. Verdaccio 6 renders it with different\n * data-testid values across versions, so we try a few in order before\n * falling back to a generic role/type selector.\n */\nfunction getSearchInput() {\n  return cy.get(\n    [\n      '[data-testid=\"search-input\"]',\n      '[data-testid=\"header--input-search\"]',\n      '[data-testid=\"autoCompleteSearch\"] input',\n      'input[aria-label*=\"earch\"]',\n      'input[placeholder*=\"earch\"]',\n      'input[type=\"search\"]',\n    ].join(', '),\n    { timeout: 10000 }\n  );\n}\n\n/**\n * Cypress `cy.wait` only accepts one alias at a time, so pick whichever\n * alias fires first. This helper lets us stay agnostic to which search\n * endpoint the UI is wired to.\n */\nfunction anySearchAlias(): string {\n  // In practice most Verdaccio 6 builds call the web search endpoint;\n  // prefer that one and let the test fail loud if neither fires.\n  return '@webSearch';\n}\n"],"mappings":";;;;;;;;;AAYA,SAAgB,YAAY,QAAwB;AAClD,UAAS,gBAAgB;AACvB,mBAAiB;AAGf,MAAG,UAAU,OAAO,gCAAgC,CAAC,GAAG,YAAY;AACpE,MAAG,UAAU,OAAO,mBAAmB,CAAC,GAAG,WAAW;AACtD,MAAG,UAAU,OAAO,+BAA+B,CAAC,GAAG,OAAO;AAE9D,MAAG,MAAM,OAAO,YAAY;AAC5B,MAAG,IAAI,OAAO,CAAC,OAAO,aAAa;IACnC;AAEF,KAAG,wCAAwC;AACzC,mBAAgB,CAAC,OAAO,aAAa;IACrC;AAEF,KAAG,0DAA0D;GAC3D,MAAM,QAAQ;AAEd,mBAAgB,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,OAAO,IAAI,CAAC;AAGnD,MAAG,KAAK,gBAAgB,EAAE,EAAE,SAAS,KAAO,CAAC,CAAC,MAAM,iBAAsB;AACxE,WAAO,aAAa,QAAQ,IAAI,CAAC,GAAG,QAAQ,MAAM;KAClD;IACF;AAEF,KAAG,oEAAkE;GACnE,MAAM,QAAQ,2BAA2B,KAAK,KAAK;AAEnD,mBAAgB,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,OAAO,IAAI,CAAC;AACnD,MAAG,KAAK,gBAAgB,EAAE,EAAE,SAAS,KAAO,CAAC;AAG7C,MAAG,KAAK,IAAI;AAIZ,MAAG,SAAS,kCAAkC,EAAE,SAAS,KAAM,CAAC,CAAC,OAC/D,aACD;IACD;AAEF,KAAG,2DAA2D;AAC5D,mBAAgB,CAAC,OAAO,CAAC,KAAK,eAAe,EAAE,OAAO,IAAI,CAAC;AAC3D,MAAG,KAAK,gBAAgB,EAAE,EAAE,SAAS,KAAO,CAAC;AAM7C,mBAAgB,CAAC,OAAO;AACxB,mBAAgB,CAAC,OAAO,cAAc,GAAG;AAIzC,mBAAgB,CAAC,KAAK,gBAAgB,EAAE,OAAO,IAAI,CAAC;AACpD,MAAG,KAAK,gBAAgB,EAAE,EAAE,SAAS,KAAO,CAAC,CAAC,MAC3C,iBAAsB;AACrB,WAAO,aAAa,QAAQ,IAAI,CAAC,GAAG,QAAQ,eAAe;KAE9D;IACD;GACF;;;;;;;AAQJ,SAAS,iBAAiB;AACxB,QAAO,GAAG,IACR;EACE;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,KAAK,KAAK,EACZ,EAAE,SAAS,KAAO,CACnB;;;;;;;AAQH,SAAS,iBAAyB;AAGhC,QAAO"}
+{"version":3,"file":"search.js","names":[],"sources":["../../../src/tests/search.ts"],"sourcesContent":["/// <reference types=\"cypress\" />\n\nimport { maybeIt } from '../features';\nimport { RegistryConfig } from '../types';\n\n/**\n * UI tests for the Verdaccio search box.\n *\n * These tests do NOT depend on any published package — they assert the\n * search *flow* (input exists, typing triggers the search API, results\n * region updates) rather than specific package metadata. Tests that need\n * a real package in the registry should live in publishTests instead.\n */\nexport function searchTests(config: RegistryConfig) {\n  const { features } = config;\n  const { package: pkg } = config.testIds;\n\n  describe('search', () => {\n    beforeEach(() => {\n      // Verdaccio's search endpoint — covers both the web API and the\n      // npm v1 search API, depending on which one the UI calls.\n      cy.intercept('GET', '**/-/verdaccio/data/search/**').as('webSearch');\n      cy.intercept('GET', '**/-/v1/search**').as('v1Search');\n      cy.intercept('GET', '**/-/verdaccio/data/packages').as('pkgs');\n\n      cy.visit(config.registryUrl);\n      cy.get('body').should('be.visible');\n    });\n\n    it('should render the search input', () => {\n      getSearchInput().should('be.visible');\n    });\n\n    it('should fire a search request when typing a query', () => {\n      const query = 'verdaccio';\n\n      getSearchInput().clear().type(query, { delay: 30 });\n\n      // Whichever endpoint the UI is wired to, at least one should hit.\n      cy.wait(anySearchAlias(), { timeout: 10000 }).then((interception: any) => {\n        expect(interception.request.url).to.contain(query);\n      });\n    });\n\n    it('should show a \"no results\" state for an impossible query', () => {\n      const query = 'xyzzy-no-such-package-' + Date.now();\n\n      getSearchInput().clear().type(query, { delay: 30 });\n      cy.wait(anySearchAlias(), { timeout: 10000 });\n\n      // Give the UI a tick to render the empty state.\n      cy.wait(300);\n\n      // The UI may render \"No Match\", \"No results\", or similar — match\n      // loosely rather than binding to one exact string.\n      cy.contains(/no\\s+(match|results|packages)/i, { timeout: 5000 }).should(\n        'be.visible'\n      );\n    });\n\n    it('should clear the query and allow typing a new one', () => {\n      getSearchInput().clear().type('first-query', { delay: 20 });\n      cy.wait(anySearchAlias(), { timeout: 10000 });\n\n      // Clearing should empty the input value. We deliberately do NOT\n      // assert on the autocomplete dropdown's empty-state text: on a\n      // registry with no packages published it lingers regardless of\n      // the input value, which previously caused a false positive.\n      getSearchInput().clear();\n      getSearchInput().should('have.value', '');\n\n      // Typing a fresh query must fire another search request so the\n      // search box is still functional after a clear.\n      getSearchInput().type('second-query', { delay: 20 });\n      cy.wait(anySearchAlias(), { timeout: 10000 }).then(\n        (interception: any) => {\n          expect(interception.request.url).to.contain('second-query');\n        }\n      );\n    });\n\n    // ── Rendering assertions that require real package data ────────\n    // Publishes a throwaway package before each test and unpublishes\n    // after so the outer \"no results\" test still sees a clean registry.\n    // The search query uses a substring of the package name to avoid\n    // scope-parsing issues with `@` / `/` characters in the URL.\n    describe('with a published package', () => {\n      const pkgName = '@verdaccio/search-fixture';\n      // Unique slug we can type into the search box — must be a\n      // substring of pkgName so Verdaccio's search matches it.\n      const pkgSlug = 'search-fixture';\n      let tempFolder: string | null = null;\n\n      beforeEach(() => {\n        cy.task('publishPackage', {\n          pkgName,\n          version: '1.0.0',\n          unique: true,\n        }).then((result) => {\n          tempFolder = result?.tempFolder ?? null;\n        });\n        cy.visit(config.registryUrl);\n      });\n\n      afterEach(() => {\n        cy.task('unpublishPackage', {\n          pkgName,\n          tempFolder: tempFolder ?? undefined,\n        });\n        if (tempFolder) {\n          cy.task('cleanupPublished', tempFolder);\n        }\n        tempFolder = null;\n      });\n\n      maybeIt(features.search.resultsDropdown)(\n        'should display the matching package in the results dropdown',\n        () => {\n        getSearchInput().clear().type(pkgSlug, { delay: 30 });\n\n        // Wait for the search request to resolve with results.\n        cy.wait(anySearchAlias(), { timeout: 10000 }).then(\n          (interception: any) => {\n            expect(interception.request.url).to.contain(pkgSlug);\n          }\n        );\n\n        // MUI Autocomplete opens a listbox with role=\"listbox\" when\n        // there are matching options. Each result renders with\n        // role=\"option\". No data-testids on the dropdown itself, so\n        // we lean on the ARIA roles which are stable across MUI\n        // versions.\n        cy.get('[role=\"listbox\"]', { timeout: 5000 }).should('be.visible');\n        cy.get('[role=\"listbox\"] [role=\"option\"]').should(\n          'have.length.at.least',\n          1\n        );\n        // The result item must contain the full package name.\n        cy.contains('[role=\"listbox\"] [role=\"option\"]', pkgName).should(\n          'be.visible'\n        );\n        }\n      );\n\n      maybeIt(features.search.resultClickNavigation)(\n        'should navigate to the package detail page when a result is clicked',\n        () => {\n          // Intercept the two data endpoints that the detail route\n          // fetches on mount. Waiting on these is the most reliable\n          // way to know the router actually resolved the new page\n          // (not just changed the URL).\n          cy.intercept('GET', `/-/verdaccio/data/sidebar/${pkgName}`).as(\n            'detailSidebar'\n          );\n          cy.intercept(\n            'GET',\n            `/-/verdaccio/data/package/readme/${pkgName}`\n          ).as('detailReadme');\n\n          getSearchInput().clear().type(pkgSlug, { delay: 30 });\n          cy.wait(anySearchAlias(), { timeout: 10000 });\n\n          cy.contains('[role=\"listbox\"] [role=\"option\"]', pkgName)\n            .should('be.visible')\n            .click();\n\n          // Verdaccio routes package detail under /-/web/detail/<pkg>.\n          cy.location('pathname').should('contain', '/-/web/detail');\n          cy.location('pathname').should('contain', 'search-fixture');\n\n          // Wait for the detail page's own fetches to settle so\n          // assertions don't race the async content.\n          cy.wait('@detailSidebar', { timeout: 10000 });\n          cy.wait('@detailReadme', { timeout: 10000 });\n\n          // Detail page rendered both panes end-to-end.\n          cy.getByTestId(pkg.sidebar).should('be.visible');\n          cy.getByTestId(pkg.readme).should('be.visible');\n        }\n      );\n    });\n  });\n}\n\n/**\n * Resolve the search input. Verdaccio 6 renders it with different\n * data-testid values across versions, so we try a few in order before\n * falling back to a generic role/type selector.\n */\nfunction getSearchInput() {\n  return cy.get(\n    [\n      '[data-testid=\"search-input\"]',\n      '[data-testid=\"header--input-search\"]',\n      '[data-testid=\"autoCompleteSearch\"] input',\n      'input[aria-label*=\"earch\"]',\n      'input[placeholder*=\"earch\"]',\n      'input[type=\"search\"]',\n    ].join(', '),\n    { timeout: 10000 }\n  );\n}\n\n/**\n * Cypress `cy.wait` only accepts one alias at a time, so pick whichever\n * alias fires first. This helper lets us stay agnostic to which search\n * endpoint the UI is wired to.\n */\nfunction anySearchAlias(): string {\n  // In practice most Verdaccio 6 builds call the web search endpoint;\n  // prefer that one and let the test fail loud if neither fires.\n  return '@webSearch';\n}\n"],"mappings":"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"}

package/build/esm/tests/settings.js

@@ -1,3 +1,4 @@
+import { maybeIt } from "../features.js";
 //#region src/tests/settings.ts
 /**
 * Tests for the header Settings dialog and the Translations (language)
@@ -18,6 +19,7 @@
 */
 function settingsTests(config) {
 	const { header } = config.testIds;
+	const { features } = config;
 	describe("settings & language", () => {
 		beforeEach(() => {
 			cy.visit(config.registryUrl);
@@ -42,7 +44,7 @@ function settingsTests(config) {
 			cy.contains("[role=\"dialog\"]", "English").should("be.visible");
 			cy.contains("[role=\"dialog\"]", "German").should("be.visible");
 		});
-		it("should change the UI language when a language card is clicked", () => {
+		maybeIt(features.settings.languageSwitcher)("should change the UI language when a language card is clicked", () => {
 			cy.getByTestId(header.settingsTooltip).click();
 			cy.get("[role=\"dialog\"]").should("be.visible");
 			cy.contains("[role=\"dialog\"] [role=\"tab\"]", "Translations").click();

package/build/esm/tests/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","names":[],"sources":["../../../src/tests/settings.ts"],"sourcesContent":["/// <reference types=\"cypress\" />\n\nimport { RegistryConfig } from '../types';\n\n/**\n * Tests for the header Settings dialog and the Translations (language)\n * picker inside it.\n *\n * Requires `web.showSettings: true` in the registry config — the gear\n * icon only renders when the flag is on (see HeaderRight in Verdaccio's\n * ui-components package).\n *\n * Selector strategy: the language cards in LanguageSwitch do NOT have\n * data-testids, so this suite leans on:\n *   - MUI's ARIA roles: `[role=\"dialog\"]`, `[role=\"tab\"]`\n *   - The stable English labels \"Configuration\", \"Translations\",\n *     \"English\", \"German\", and the language description text, which are\n *     bundled into the ui-theme via `@verdaccio/ui-i18n`\n *   - The settings trigger's testid from Verdaccio's HeaderToolTipIcon:\n *     `header--tooltip-settings`\n */\nexport function settingsTests(config: RegistryConfig) {\n  const { header } = config.testIds;\n\n  describe('settings & language', () => {\n    beforeEach(() => {\n      cy.visit(config.registryUrl);\n      cy.get('body').should('be.visible');\n    });\n\n    it('should open the settings dialog from the header', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      // Dialog title key: dialog.settings.title → \"Configuration\" in EN.\n      cy.contains('[role=\"dialog\"]', 'Configuration').should('be.visible');\n    });\n\n    it('should show both Package Managers and Translations tabs', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      cy.get('[role=\"dialog\"] [role=\"tab\"]').should('have.length', 2);\n      cy.contains('[role=\"dialog\"] [role=\"tab\"]', 'Translations').should(\n        'be.visible'\n      );\n    });\n\n    it('should switch to the Translations tab and list languages', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      cy.contains('[role=\"dialog\"] [role=\"tab\"]', 'Translations').click();\n      // language.description text is bundled in EN — good sentinel.\n      cy.contains(\n        '[role=\"dialog\"]',\n        /this is the configuration details for the language/i\n      ).should('be.visible');\n      // Sanity-check a couple of language cards are rendered.\n      cy.contains('[role=\"dialog\"]', 'English').should('be.visible');\n      cy.contains('[role=\"dialog\"]', 'German').should('be.visible');\n    });\n\n    it('should change the UI language when a language card is clicked', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      cy.contains('[role=\"dialog\"] [role=\"tab\"]', 'Translations').click();\n\n      // Before switching, capture the current dialog title so we can\n      // assert it changes. This avoids hard-coding the German string.\n      cy.contains('[role=\"dialog\"]', 'Configuration')\n        .invoke('text')\n        .then((englishTitle) => {\n          // Click the German card. We scope to the dialog + the MUI\n          // card class to avoid matching other \"German\" text.\n          cy.contains('[role=\"dialog\"] .MuiCard-root', 'German').click({\n            force: true,\n          });\n\n          // The English tab label \"Translations\" must no longer be\n          // present anywhere in the dialog — strongest proof the\n          // language actually switched.\n          cy.contains('[role=\"dialog\"] [role=\"tab\"]', 'Translations').should(\n            'not.exist'\n          );\n          // And the original dialog title text should also be gone.\n          cy.contains('[role=\"dialog\"]', englishTitle).should('not.exist');\n        });\n    });\n\n    it('should close the settings dialog with Escape', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      cy.get('body').type('{esc}');\n      cy.get('[role=\"dialog\"]').should('not.exist');\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cAAc,QAAwB;CACpD,MAAM,EAAE,WAAW,OAAO;AAE1B,UAAS,6BAA6B;AACpC,mBAAiB;AACf,MAAG,MAAM,OAAO,YAAY;AAC5B,MAAG,IAAI,OAAO,CAAC,OAAO,aAAa;IACnC;AAEF,KAAG,yDAAyD;AAC1D,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAE9C,MAAG,SAAS,qBAAmB,gBAAgB,CAAC,OAAO,aAAa;IACpE;AAEF,KAAG,iEAAiE;AAClE,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAC9C,MAAG,IAAI,mCAA+B,CAAC,OAAO,eAAe,EAAE;AAC/D,MAAG,SAAS,oCAAgC,eAAe,CAAC,OAC1D,aACD;IACD;AAEF,KAAG,kEAAkE;AACnE,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAC9C,MAAG,SAAS,oCAAgC,eAAe,CAAC,OAAO;AAEnE,MAAG,SACD,qBACA,sDACD,CAAC,OAAO,aAAa;AAEtB,MAAG,SAAS,qBAAmB,UAAU,CAAC,OAAO,aAAa;AAC9D,MAAG,SAAS,qBAAmB,SAAS,CAAC,OAAO,aAAa;IAC7D;AAEF,KAAG,uEAAuE;AACxE,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAC9C,MAAG,SAAS,oCAAgC,eAAe,CAAC,OAAO;AAInE,MAAG,SAAS,qBAAmB,gBAAgB,CAC5C,OAAO,OAAO,CACd,MAAM,iBAAiB;AAGtB,OAAG,SAAS,mCAAiC,SAAS,CAAC,MAAM,EAC3D,OAAO,MACR,CAAC;AAKF,OAAG,SAAS,oCAAgC,eAAe,CAAC,OAC1D,YACD;AAED,OAAG,SAAS,qBAAmB,aAAa,CAAC,OAAO,YAAY;KAChE;IACJ;AAEF,KAAG,sDAAsD;AACvD,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAC9C,MAAG,IAAI,OAAO,CAAC,KAAK,QAAQ;AAC5B,MAAG,IAAI,oBAAkB,CAAC,OAAO,YAAY;IAC7C;GACF"}
+{"version":3,"file":"settings.js","names":[],"sources":["../../../src/tests/settings.ts"],"sourcesContent":["/// <reference types=\"cypress\" />\n\nimport { maybeIt } from '../features';\nimport { RegistryConfig } from '../types';\n\n/**\n * Tests for the header Settings dialog and the Translations (language)\n * picker inside it.\n *\n * Requires `web.showSettings: true` in the registry config — the gear\n * icon only renders when the flag is on (see HeaderRight in Verdaccio's\n * ui-components package).\n *\n * Selector strategy: the language cards in LanguageSwitch do NOT have\n * data-testids, so this suite leans on:\n *   - MUI's ARIA roles: `[role=\"dialog\"]`, `[role=\"tab\"]`\n *   - The stable English labels \"Configuration\", \"Translations\",\n *     \"English\", \"German\", and the language description text, which are\n *     bundled into the ui-theme via `@verdaccio/ui-i18n`\n *   - The settings trigger's testid from Verdaccio's HeaderToolTipIcon:\n *     `header--tooltip-settings`\n */\nexport function settingsTests(config: RegistryConfig) {\n  const { header } = config.testIds;\n  const { features } = config;\n\n  describe('settings & language', () => {\n    beforeEach(() => {\n      cy.visit(config.registryUrl);\n      cy.get('body').should('be.visible');\n    });\n\n    it('should open the settings dialog from the header', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      // Dialog title key: dialog.settings.title → \"Configuration\" in EN.\n      cy.contains('[role=\"dialog\"]', 'Configuration').should('be.visible');\n    });\n\n    it('should show both Package Managers and Translations tabs', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      cy.get('[role=\"dialog\"] [role=\"tab\"]').should('have.length', 2);\n      cy.contains('[role=\"dialog\"] [role=\"tab\"]', 'Translations').should(\n        'be.visible'\n      );\n    });\n\n    it('should switch to the Translations tab and list languages', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      cy.contains('[role=\"dialog\"] [role=\"tab\"]', 'Translations').click();\n      // language.description text is bundled in EN — good sentinel.\n      cy.contains(\n        '[role=\"dialog\"]',\n        /this is the configuration details for the language/i\n      ).should('be.visible');\n      // Sanity-check a couple of language cards are rendered.\n      cy.contains('[role=\"dialog\"]', 'English').should('be.visible');\n      cy.contains('[role=\"dialog\"]', 'German').should('be.visible');\n    });\n\n    maybeIt(features.settings.languageSwitcher)(\n      'should change the UI language when a language card is clicked',\n      () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      cy.contains('[role=\"dialog\"] [role=\"tab\"]', 'Translations').click();\n\n      // Before switching, capture the current dialog title so we can\n      // assert it changes. This avoids hard-coding the German string.\n      cy.contains('[role=\"dialog\"]', 'Configuration')\n        .invoke('text')\n        .then((englishTitle) => {\n          // Click the German card. We scope to the dialog + the MUI\n          // card class to avoid matching other \"German\" text.\n          cy.contains('[role=\"dialog\"] .MuiCard-root', 'German').click({\n            force: true,\n          });\n\n          // The English tab label \"Translations\" must no longer be\n          // present anywhere in the dialog — strongest proof the\n          // language actually switched.\n          cy.contains('[role=\"dialog\"] [role=\"tab\"]', 'Translations').should(\n            'not.exist'\n          );\n          // And the original dialog title text should also be gone.\n          cy.contains('[role=\"dialog\"]', englishTitle).should('not.exist');\n        });\n      }\n    );\n\n    it('should close the settings dialog with Escape', () => {\n      cy.getByTestId(header.settingsTooltip).click();\n      cy.get('[role=\"dialog\"]').should('be.visible');\n      cy.get('body').type('{esc}');\n      cy.get('[role=\"dialog\"]').should('not.exist');\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,cAAc,QAAwB;CACpD,MAAM,EAAE,WAAW,OAAO;CAC1B,MAAM,EAAE,aAAa;AAErB,UAAS,6BAA6B;AACpC,mBAAiB;AACf,MAAG,MAAM,OAAO,YAAY;AAC5B,MAAG,IAAI,OAAO,CAAC,OAAO,aAAa;IACnC;AAEF,KAAG,yDAAyD;AAC1D,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAE9C,MAAG,SAAS,qBAAmB,gBAAgB,CAAC,OAAO,aAAa;IACpE;AAEF,KAAG,iEAAiE;AAClE,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAC9C,MAAG,IAAI,mCAA+B,CAAC,OAAO,eAAe,EAAE;AAC/D,MAAG,SAAS,oCAAgC,eAAe,CAAC,OAC1D,aACD;IACD;AAEF,KAAG,kEAAkE;AACnE,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAC9C,MAAG,SAAS,oCAAgC,eAAe,CAAC,OAAO;AAEnE,MAAG,SACD,qBACA,sDACD,CAAC,OAAO,aAAa;AAEtB,MAAG,SAAS,qBAAmB,UAAU,CAAC,OAAO,aAAa;AAC9D,MAAG,SAAS,qBAAmB,SAAS,CAAC,OAAO,aAAa;IAC7D;AAEF,UAAQ,SAAS,SAAS,iBAAiB,CACzC,uEACM;AACN,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAC9C,MAAG,SAAS,oCAAgC,eAAe,CAAC,OAAO;AAInE,MAAG,SAAS,qBAAmB,gBAAgB,CAC5C,OAAO,OAAO,CACd,MAAM,iBAAiB;AAGtB,OAAG,SAAS,mCAAiC,SAAS,CAAC,MAAM,EAC3D,OAAO,MACR,CAAC;AAKF,OAAG,SAAS,oCAAgC,eAAe,CAAC,OAC1D,YACD;AAED,OAAG,SAAS,qBAAmB,aAAa,CAAC,OAAO,YAAY;KAChE;IAEL;AAED,KAAG,sDAAsD;AACvD,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,IAAI,oBAAkB,CAAC,OAAO,aAAa;AAC9C,MAAG,IAAI,OAAO,CAAC,KAAK,QAAQ;AAC5B,MAAG,IAAI,oBAAkB,CAAC,OAAO,YAAY;IAC7C;GACF"}

package/build/esm/tests/signin.js

@@ -1,13 +1,15 @@
+import { maybeIt } from "../features.js";
 //#region src/tests/signin.ts
 function signinTests(config) {
-	const { header } = config.testIds;
+	const { header, login } = config.testIds;
 	const { loginDialog } = config.selectors;
+	const { features } = config;
 	describe("sign in / sign out", () => {
 		beforeEach(() => {
 			cy.intercept("POST", "/-/verdaccio/sec/login").as("sign");
+			cy.visit(config.registryUrl);
 		});
 		it("should login user", () => {
-			cy.visit(config.registryUrl);
 			cy.login(config.credentials.user, config.credentials.password, {
 				loginButton: header.loginButton,
 				...loginDialog
@@ -18,7 +20,6 @@ function signinTests(config) {
 			cy.getByTestId(header.greetingsLabel).contains(config.credentials.user);
 		});
 		it("should logout a user", () => {
-			cy.visit(config.registryUrl);
 			cy.login(config.credentials.user, config.credentials.password, {
 				loginButton: header.loginButton,
 				...loginDialog
@@ -30,6 +31,27 @@ function signinTests(config) {
 			cy.wait(200);
 			cy.getByTestId(header.loginButton).contains("Login");
 		});
+		maybeIt(features.signin.validationTests)("should disable the submit button while the form is empty", () => {
+			cy.getByTestId(header.loginButton).click();
+			cy.getByTestId(login.dialog).should("be.visible");
+			cy.get(loginDialog.submitButton).should("be.disabled");
+		});
+		maybeIt(features.signin.validationTests)("should keep the submit button disabled when only the username is filled", () => {
+			cy.getByTestId(header.loginButton).click();
+			cy.getByTestId(login.dialog).should("be.visible");
+			cy.get(loginDialog.usernameInput).type(config.credentials.user);
+			cy.get(loginDialog.submitButton).should("be.disabled");
+		});
+		maybeIt(features.signin.validationTests)("should show an error banner on invalid credentials", () => {
+			cy.login(config.credentials.user, "definitely-wrong-password-xyz", {
+				loginButton: header.loginButton,
+				...loginDialog
+			});
+			cy.wait("@sign").its("response.statusCode").should("not.eq", 200);
+			cy.getByTestId(login.error, { timeout: 5e3 }).should("be.visible");
+			cy.getByTestId(login.error).should("contain.text", "Invalid username or password");
+			cy.getByTestId(login.dialog).should("be.visible");
+		});
 	});
 }
 //#endregion

package/build/esm/tests/signin.js.map

@@ -1 +1 @@
-{"version":3,"file":"signin.js","names":[],"sources":["../../../src/tests/signin.ts"],"sourcesContent":["/// <reference types=\"cypress\" />\n\nimport { RegistryConfig } from '../types';\n\nexport function signinTests(config: RegistryConfig) {\n  const { header } = config.testIds;\n  const { loginDialog } = config.selectors;\n\n  describe('sign in / sign out', () => {\n    beforeEach(() => {\n      cy.intercept('POST', '/-/verdaccio/sec/login').as('sign');\n    });\n\n    it('should login user', () => {\n      cy.visit(config.registryUrl);\n      cy.login(config.credentials.user, config.credentials.password, {\n        loginButton: header.loginButton,\n        ...loginDialog,\n      });\n      cy.wait('@sign');\n      cy.getByTestId(header.logInDialogIcon).click();\n      cy.wait(100);\n      cy.getByTestId(header.greetingsLabel).contains(config.credentials.user);\n    });\n\n    it('should logout a user', () => {\n      cy.visit(config.registryUrl);\n      cy.login(config.credentials.user, config.credentials.password, {\n        loginButton: header.loginButton,\n        ...loginDialog,\n      });\n      cy.wait('@sign');\n      cy.getByTestId(header.logInDialogIcon).click();\n      cy.wait(100);\n      cy.getByTestId(header.logOutDialogIcon).click();\n      cy.wait(200);\n      cy.getByTestId(header.loginButton).contains('Login');\n    });\n  });\n}\n"],"mappings":";AAIA,SAAgB,YAAY,QAAwB;CAClD,MAAM,EAAE,WAAW,OAAO;CAC1B,MAAM,EAAE,gBAAgB,OAAO;AAE/B,UAAS,4BAA4B;AACnC,mBAAiB;AACf,MAAG,UAAU,QAAQ,yBAAyB,CAAC,GAAG,OAAO;IACzD;AAEF,KAAG,2BAA2B;AAC5B,MAAG,MAAM,OAAO,YAAY;AAC5B,MAAG,MAAM,OAAO,YAAY,MAAM,OAAO,YAAY,UAAU;IAC7D,aAAa,OAAO;IACpB,GAAG;IACJ,CAAC;AACF,MAAG,KAAK,QAAQ;AAChB,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,KAAK,IAAI;AACZ,MAAG,YAAY,OAAO,eAAe,CAAC,SAAS,OAAO,YAAY,KAAK;IACvE;AAEF,KAAG,8BAA8B;AAC/B,MAAG,MAAM,OAAO,YAAY;AAC5B,MAAG,MAAM,OAAO,YAAY,MAAM,OAAO,YAAY,UAAU;IAC7D,aAAa,OAAO;IACpB,GAAG;IACJ,CAAC;AACF,MAAG,KAAK,QAAQ;AAChB,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,KAAK,IAAI;AACZ,MAAG,YAAY,OAAO,iBAAiB,CAAC,OAAO;AAC/C,MAAG,KAAK,IAAI;AACZ,MAAG,YAAY,OAAO,YAAY,CAAC,SAAS,QAAQ;IACpD;GACF"}
+{"version":3,"file":"signin.js","names":[],"sources":["../../../src/tests/signin.ts"],"sourcesContent":["/// <reference types=\"cypress\" />\n\nimport { maybeIt } from '../features';\nimport { RegistryConfig } from '../types';\n\nexport function signinTests(config: RegistryConfig) {\n  const { header, login } = config.testIds;\n  const { loginDialog } = config.selectors;\n  const { features } = config;\n\n  describe('sign in / sign out', () => {\n    beforeEach(() => {\n      cy.intercept('POST', '/-/verdaccio/sec/login').as('sign');\n      cy.visit(config.registryUrl);\n    });\n\n    it('should login user', () => {\n      cy.login(config.credentials.user, config.credentials.password, {\n        loginButton: header.loginButton,\n        ...loginDialog,\n      });\n      cy.wait('@sign');\n      cy.getByTestId(header.logInDialogIcon).click();\n      cy.wait(100);\n      cy.getByTestId(header.greetingsLabel).contains(config.credentials.user);\n    });\n\n    it('should logout a user', () => {\n      cy.login(config.credentials.user, config.credentials.password, {\n        loginButton: header.loginButton,\n        ...loginDialog,\n      });\n      cy.wait('@sign');\n      cy.getByTestId(header.logInDialogIcon).click();\n      cy.wait(100);\n      cy.getByTestId(header.logOutDialogIcon).click();\n      cy.wait(200);\n      cy.getByTestId(header.loginButton).contains('Login');\n    });\n\n    // ── Validation tests ───────────────────────────────────────────\n    // The login form uses a yup schema (username >= 2 chars + URL-safe,\n    // password >= 2 chars) and the submit button is `disabled={!isValid}`.\n    // Server rejection renders an error banner with `data-testid=\"error\"`\n    // inside `LoginDialogFormError`. Gated on\n    // `features.signin.validationTests` so builds with a different\n    // schema or error string can skip without forking.\n\n    maybeIt(features.signin.validationTests)(\n      'should disable the submit button while the form is empty',\n      () => {\n        cy.getByTestId(header.loginButton).click();\n        cy.getByTestId(login.dialog).should('be.visible');\n        // Neither field filled → schema invalid → button disabled.\n        cy.get(loginDialog.submitButton).should('be.disabled');\n      }\n    );\n\n    maybeIt(features.signin.validationTests)(\n      'should keep the submit button disabled when only the username is filled',\n      () => {\n        cy.getByTestId(header.loginButton).click();\n        cy.getByTestId(login.dialog).should('be.visible');\n        cy.get(loginDialog.usernameInput).type(config.credentials.user);\n        // Password still empty → schema still invalid.\n        cy.get(loginDialog.submitButton).should('be.disabled');\n      }\n    );\n\n    maybeIt(features.signin.validationTests)(\n      'should show an error banner on invalid credentials',\n      () => {\n        cy.login(config.credentials.user, 'definitely-wrong-password-xyz', {\n          loginButton: header.loginButton,\n          ...loginDialog,\n        });\n        // The request goes through (valid schema), the server rejects it.\n        cy.wait('@sign').its('response.statusCode').should('not.eq', 200);\n        // The form sets errors.root which renders via LoginDialogFormError\n        // with a fixed English string (\"Invalid username or password\").\n        cy.getByTestId(login.error, { timeout: 5000 }).should('be.visible');\n        cy.getByTestId(login.error).should(\n          'contain.text',\n          'Invalid username or password'\n        );\n        // Dialog should still be open so the user can retry.\n        cy.getByTestId(login.dialog).should('be.visible');\n      }\n    );\n  });\n}\n"],"mappings":";;AAKA,SAAgB,YAAY,QAAwB;CAClD,MAAM,EAAE,QAAQ,UAAU,OAAO;CACjC,MAAM,EAAE,gBAAgB,OAAO;CAC/B,MAAM,EAAE,aAAa;AAErB,UAAS,4BAA4B;AACnC,mBAAiB;AACf,MAAG,UAAU,QAAQ,yBAAyB,CAAC,GAAG,OAAO;AACzD,MAAG,MAAM,OAAO,YAAY;IAC5B;AAEF,KAAG,2BAA2B;AAC5B,MAAG,MAAM,OAAO,YAAY,MAAM,OAAO,YAAY,UAAU;IAC7D,aAAa,OAAO;IACpB,GAAG;IACJ,CAAC;AACF,MAAG,KAAK,QAAQ;AAChB,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,KAAK,IAAI;AACZ,MAAG,YAAY,OAAO,eAAe,CAAC,SAAS,OAAO,YAAY,KAAK;IACvE;AAEF,KAAG,8BAA8B;AAC/B,MAAG,MAAM,OAAO,YAAY,MAAM,OAAO,YAAY,UAAU;IAC7D,aAAa,OAAO;IACpB,GAAG;IACJ,CAAC;AACF,MAAG,KAAK,QAAQ;AAChB,MAAG,YAAY,OAAO,gBAAgB,CAAC,OAAO;AAC9C,MAAG,KAAK,IAAI;AACZ,MAAG,YAAY,OAAO,iBAAiB,CAAC,OAAO;AAC/C,MAAG,KAAK,IAAI;AACZ,MAAG,YAAY,OAAO,YAAY,CAAC,SAAS,QAAQ;IACpD;AAUF,UAAQ,SAAS,OAAO,gBAAgB,CACtC,kEACM;AACJ,MAAG,YAAY,OAAO,YAAY,CAAC,OAAO;AAC1C,MAAG,YAAY,MAAM,OAAO,CAAC,OAAO,aAAa;AAEjD,MAAG,IAAI,YAAY,aAAa,CAAC,OAAO,cAAc;IAEzD;AAED,UAAQ,SAAS,OAAO,gBAAgB,CACtC,iFACM;AACJ,MAAG,YAAY,OAAO,YAAY,CAAC,OAAO;AAC1C,MAAG,YAAY,MAAM,OAAO,CAAC,OAAO,aAAa;AACjD,MAAG,IAAI,YAAY,cAAc,CAAC,KAAK,OAAO,YAAY,KAAK;AAE/D,MAAG,IAAI,YAAY,aAAa,CAAC,OAAO,cAAc;IAEzD;AAED,UAAQ,SAAS,OAAO,gBAAgB,CACtC,4DACM;AACJ,MAAG,MAAM,OAAO,YAAY,MAAM,iCAAiC;IACjE,aAAa,OAAO;IACpB,GAAG;IACJ,CAAC;AAEF,MAAG,KAAK,QAAQ,CAAC,IAAI,sBAAsB,CAAC,OAAO,UAAU,IAAI;AAGjE,MAAG,YAAY,MAAM,OAAO,EAAE,SAAS,KAAM,CAAC,CAAC,OAAO,aAAa;AACnE,MAAG,YAAY,MAAM,MAAM,CAAC,OAC1B,gBACA,+BACD;AAED,MAAG,YAAY,MAAM,OAAO,CAAC,OAAO,aAAa;IAEpD;GACD"}

package/build/features.d.ts

@@ -0,0 +1,94 @@
+/// <reference types="cypress" />
+/// <reference types="cypress" />
+/**
+ * Per-test feature flags for enabling/disabling individual test cases
+ * in the e2e-ui suites.
+ *
+ * The Verdaccio UI behaves differently across branches — search result
+ * payload shape differs between the `/-/v1/search` and
+ * `/-/verdaccio/data/search/*` endpoints, the language picker was
+ * added in a specific minor, etc. Rather than forking the suite per
+ * branch, consumers can disable individual tests via
+ * `createRegistryConfig({ features: { … } })`.
+ *
+ * Every flag defaults to `true` (test runs). Override to `false` to
+ * convert the test into a Mocha `it.skip` call — the suite still
+ * reports the test but marks it as pending.
+ */
+export interface Features {
+    search: {
+        /**
+         * Whether to run the "results dropdown renders a matching
+         * package" test. Disable on builds where the search result shape
+         * or the Autocomplete rendering differs from the default assumption.
+         */
+        resultsDropdown: boolean;
+        /**
+         * Whether to run the "clicking a result navigates to detail" test.
+         * Depends on the Autocomplete `onSelectItem` → router wiring.
+         */
+        resultClickNavigation: boolean;
+    };
+    home: {
+        /**
+         * Whether to run the `with a published package` sub-block inside
+         * `homeTests` (publishes a throwaway package and asserts it
+         * renders in the package list).
+         */
+        publishedPackageRendering: boolean;
+    };
+    settings: {
+        /**
+         * Whether to run the "change language via card click" test.
+         * Depends on the `LanguageSwitch` component layout and its
+         * translation sentinels ("Translations", "German"). Skip on
+         * builds that lag behind the upstream translation file.
+         */
+        languageSwitcher: boolean;
+    };
+    signin: {
+        /**
+         * Whether to run the three validation tests (disabled submit
+         * button, invalid credentials error banner). Depends on the
+         * current yup schema and the hard-coded "Invalid username or
+         * password" error string.
+         */
+        validationTests: boolean;
+    };
+    layout: {
+        /**
+         * Whether to run the dark/light theme switch test. Depends on
+         * `web.showThemeSwitch` (defaults to true in ui-theme) and the
+         * `header--button--light` / `header--button--dark` testids.
+         */
+        themeSwitch: boolean;
+    };
+    publish: {
+        /**
+         * Whether to run the "tarball download button fires a GET" test.
+         * Depends on `web.showDownloadTarball` (defaults to true) and
+         * the published package manifest having a valid `dist.tarball`.
+         */
+        downloadTarball: boolean;
+        /**
+         * Whether to run the "raw viewer dialog opens + closes" test.
+         * Depends on `web.showRaw` (defaults to true).
+         */
+        rawViewer: boolean;
+    };
+}
+/** Defaults: all flags on. */
+export declare const DEFAULT_FEATURES: Features;
+import type { DeepPartial } from './testIds';
+/**
+ * Merge user overrides into the default feature flags. Per-section,
+ * one level deep — matching the style of `mergeTestIds`.
+ */
+export declare function mergeFeatures(defaults: Features, overrides?: DeepPartial<Features>): Features;
+/**
+ * Helper that returns either `it` or `it.skip` depending on an
+ * enabled flag. Usage:
+ *
+ *   maybeIt(features.search.resultsDropdown)('…', () => { … });
+ */
+export declare function maybeIt(enabled: boolean): Mocha.TestFunction | Mocha.PendingTestFunction;

package/build/index.d.ts

@@ -3,7 +3,9 @@ import { RegistryConfig, VerdaccioUiOptions } from './types';
 export type { RegistryConfig, RegistryTaskResult, VerdaccioUiOptions, } from './types';
 export type { PublishPackageInput, PublishPackageTaskInput, PublishPackageResult, UnpublishPackageInput, UnpublishPackageResult, } from './tasks';
 export type { DeepPartial, Selectors, TestIds } from './testIds';
+export type { Features } from './features';
 export { DEFAULT_SELECTORS, DEFAULT_TEST_IDS } from './testIds';
+export { DEFAULT_FEATURES, maybeIt } from './features';
 export { publishPackage, cleanupPublished, unpublishPackage } from './tasks';
 export { homeTests, signinTests, publishTests, searchTests, settingsTests, layoutTests, } from './tests';
 /**

package/build/testIds.d.ts

@@ -41,6 +41,14 @@ export interface TestIds {
         settingsTooltip: string;
         /** Info icon that opens the registry info dialog. */
         infoTooltip: string;
+        /**
+         * Theme switch button shown while in LIGHT mode (clicking it
+         * flips to dark). The underlying component swaps between this
+         * and `themeSwitchDark` based on `isDarkMode`.
+         */
+        themeSwitchLight: string;
+        /** Theme switch button shown while in DARK mode. */
+        themeSwitchDark: string;
         /** Menu icon shown after login (opens the logged-in menu). */
         logInDialogIcon: string;
         /** "Log out" entry inside the logged-in menu. */
@@ -54,6 +62,18 @@ export interface TestIds {
         /** "Powered by" version text on the right side of the footer. */
         version: string;
     };
+    login: {
+        /** Login dialog container (the MUI Dialog root). */
+        dialog: string;
+        /** DialogContent wrapper inside the login dialog. */
+        dialogContent: string;
+        /**
+         * Error banner shown inside the login dialog when the server
+         * rejects credentials (or any other `errors.root` message the form
+         * sets). Renders inside the `LoginDialogFormError` component.
+         */
+        error: string;
+    };
     package: {
         /** Wrapper around the list of packages on the home page. */
         itemList: string;
@@ -85,6 +105,14 @@ export interface TestIds {
         uplinksTab: string;
         /** Empty-state message when the package has no uplinks. */
         noUplinks: string;
+        /** Action-bar tarball download FAB. */
+        downloadTarballBtn: string;
+        /** Action-bar "view raw manifest" FAB. */
+        rawBtn: string;
+        /** Full-screen dialog that opens when `rawBtn` is clicked. */
+        rawViewerDialog: string;
+        /** Close button inside the raw viewer dialog. */
+        closeRawViewer: string;
     };
 }
 /**

package/build/types.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="cypress" />
 /// <reference types="cypress" />
 /// <reference types="cypress" />
+import type { Features } from './features';
 import type { PublishPackageResult, PublishPackageTaskInput, UnpublishPackageInput, UnpublishPackageResult } from './tasks';
 import type { DeepPartial, Selectors, TestIds } from './testIds';
 export type RegistryConfig = {
@@ -15,6 +16,11 @@ export type RegistryConfig = {
     testIds: TestIds;
     /** Fully-resolved CSS selector map (defaults merged with overrides). */
     selectors: Selectors;
+    /**
+     * Per-test feature flags — set to `false` to convert a specific
+     * test into `it.skip` without forking the suite.
+     */
+    features: Features;
 };
 export type VerdaccioUiOptions = {
     registryUrl: string;
@@ -28,6 +34,8 @@ export type VerdaccioUiOptions = {
     testIds?: DeepPartial<TestIds>;
     /** Partial override of the default CSS selector map. */
     selectors?: DeepPartial<Selectors>;
+    /** Partial override of the default feature flags. */
+    features?: DeepPartial<Features>;
 };
 /**
  * Return value of the `registry` Cypress task — exposed as a named

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verdaccio/e2e-ui",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "type": "module",
   "license": "MIT",
   "description": "Cypress plugin for Verdaccio UI e2e tests — run against any registry",