0066: Allow plugins to replace project creation choices

[illume]

Summary

• Export stable IDs for Headlamp's built-in project creation choices.
• Let plugins replace either the namespace-based or YAML-based choice by registering a custom creator with the corresponding ID.
• Keep plugin-provided additional creation choices after the two built-in positions.
• Add focused unit and end-to-end coverage before the feature commit.
• Document the public plugin SDK API with responsive before-and-after examples.

Screenshots

Mobile (375 x 812)

Default choices	Plugin replacements

Source

This ports patch 0066 retained by Azure/aks-desktop#823:
Azure/aks-desktop#823

The original project creation extensibility work was reviewed in Azure/aks-desktop#370 and committed as e68b527ce56e42aa3f6e82d7e41f828b6f0efff3:
Azure/aks-desktop#370
Azure/aks-desktop@e68b527

PR 823 retained the upstreamable patch as embedded commit 9ddff4a9ccfae8f6cdc0a92d14ce2f6fa30a4e9a in its numbered patch series. The upstreamed feature commit preserves Thomas Gamble's authorship and original August 1, 2026 author date, with René Dudfield as co-author.

Improvements over the existing version

• Prevent the built-in namespace project form from rendering alongside a plugin replacement that uses the built-in new-project ID.
• Add a React key for additional plugin creation choices.
• Raise focused NewProjectPopup.tsx branch coverage from 67.18% to 81.33%.
• Add a Playwright flow for the built-in chooser and YAML navigation.
• Export the replacement IDs from @kinvolk/headlamp-plugin/lib and document them in the generated API reference.
• Document the replacement API and usage guidance in the plugin functionality guide.
• Update the projects example plugin to demonstrate replacing a built-in choice and explain when to append a separate creator instead.

Testing

• npm run ci-lint
• npm run tsc
• CI=1 npm run test -- --coverage (2,740 tests)
• npx vitest run src/components/project/NewProjectPopup.test.tsx src/components/project/NewProjectPopup.replace.test.tsx --no-cache --coverage.enabled --coverage.include=src/components/project/NewProjectPopup.tsx (15 tests; 81.33% branches)
• npx vitest run src/plugin/pluginLib.test.ts --no-cache (2 tests)
• Plugin SDK TypeScript build with runtime and declaration export checks
• Projects example plugin production build and TypeScript check against the local SDK
• npm run build-storybook
• npx playwright test tests/projects.spec.ts --list (1 Chromium test discovered)

The full Playwright flow was not run locally because this environment has no HEADLAMP_TEST_URL, no HEADLAMP_TEST_TOKEN, and no Headlamp server listening on the default port.

Assisted by copilot

[kubernetes-prow]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: illume

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

• OWNERS [illume]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[Copilot]

Pull request overview

Adds replaceable built-in project creation choices for plugins.

Changes:

• Exports stable IDs and replacement logic.
• Preserves additional plugin choices.
• Adds unit, snapshot, and end-to-end coverage.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
frontend/src/redux/projectsSlice.ts	Defines built-in choice IDs.
frontend/src/plugin/registry.tsx	Exposes IDs through the registry.
frontend/src/plugin/__snapshots__/pluginLib.snapshot	Updates runtime API snapshot.
frontend/src/components/project/NewProjectPopup.tsx	Implements choice replacement.
frontend/src/components/project/NewProjectPopup.test.tsx	Expands creation-flow coverage.
frontend/src/components/project/NewProjectPopup.replace.test.tsx	Tests both replacement IDs.
e2e-tests/tests/projects.spec.ts	Tests built-in chooser navigation.

The plugin SDK barrel and generated API documentation still require updates. CI has no failures reported, but several checks remain pending.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 20 changed files in this pull request and generated no new comments.

Suppressed comments (3)

docs/development/plugins/functionality/index.md:222

• This repeated API-reference link also targets a path that is not generated. Link to the registerCustomCreateProject anchor in the committed modules/plugin_registry.md output instead.

- API reference: [registerCustomCreateProject](../../api/plugin/registry/functions/registercustomcreateproject)

docs/development/plugins/functionality/index.md:182

• This API link does not match the committed TypeDoc layout: there is no docs/development/api/plugin/registry/functions/registercustomcreateproject target, while the new function is generated in docs/development/api/modules/plugin_registry.md under the registercustomcreateproject anchor. As written, plugin authors following this link get a missing page. Please point it at the generated module anchor.

This issue also appears on line 222 of the same file.

Add a project creation choice with
[registerCustomCreateProject](../../api/plugin/registry/functions/registercustomcreateproject).

e2e-tests/tests/projects.spec.ts:24

• Blocking history cleanup: the PR range contains corrective follow-up commits rather than an atomic commit flow. In particular, 7e4086a9 fixes the route introduced by b5c25f29, and a3b4d1f8 adds the SDK export/documentation omitted from the feature commit ddfac238. Please squash/reorder these corrections into the commits they fix so each commit is coherent and reviewable.

  await headlampPage.navigateTopage('/');
  await page.getByRole('tab', { name: 'Projects' }).click();