fix: strip v5 prefix from docs titles, replace jspm with mappa by bennypowers · Pull Request #3115 · patternfly/patternfly-elements

bennypowers · 2026-04-29T19:22:57Z

Summary

Strip "V5 " prefix from element names in docs sidebar, page titles, and demo headings (e.g. "V5 Accordion" becomes "Accordion")
Replace @jspm/generator with @pwrs/mappa for import map generation, fixing the Unable to resolve npm:lit@3.3.2 build error
Add v5 entry to the docs version dropdown

Changes

Title stripping (DocsPage.ts, Manifest.ts):

prettyTag() now accepts an optional prefix parameter to strip the full tag prefix instead of only the first word segment
DocsPage passes the configured tagPrefix so pf-v5-accordion becomes "Accordion" not "V5 Accordion"

Import map generation (importMap.cjs, import-map-generator.ts, create-import-map.cjs):

Replaced @jspm/generator with @pwrs/mappa in all three import map files
CDN import map uses generate() with explicit dependency list and exclude for workspace packages
Dev server plugin uses resolve() for local node_modules resolution
Removed jspm-specific provider/resolver configuration from dev server config

Version dropdown (versions.json):

Added v5 as current version, moved v4 to non-current

Test plan

npm run clean && npm run serve builds and starts successfully (281 pages)
Sidebar shows "Accordion", "Alert", etc. without "V5 " prefix
Page titles show "Accordion - PatternFly Elements"
Component pages load at /components/accordion/, /components/button/, etc.
Version dropdown shows v5 (current/disabled), v4, v3, v2, v1

…pwrs/mappa Strip the tag prefix (pf-v5-) from element display names in the docs site sidebar, page titles, and demo headings so they show "Accordion" instead of "V5 Accordion". Replace @jspm/generator with @pwrs/mappa for import map generation in both the 11ty docs build and the dev server plugin. This fixes the "Unable to resolve npm:lit@3.3.2" build error and simplifies the import map infrastructure. Also adds v5 to the docs version dropdown and marks it as current. Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

changeset-bot · 2026-04-29T19:23:01Z

⚠️ No Changeset found

Latest commit: 381d373

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

github-actions · 2026-04-29T19:28:20Z

✅ Commitlint tests passed!

More Info

{
  "valid": true,
  "errors": [],
  "warnings": [],
  "input": "fix: strip v5 prefix from docs titles, replace jspm with mappa"
}

github-actions · 2026-04-29T19:29:47Z

✅ Deploy Preview for patternfly-elements ready!

Name	Link
🔨 Latest commit	`bb75c8b`
😎 Deploy Preview	https://deploy-preview-3115--patternfly-elements.netlify.app/

To edit notification comments on pull requests, go to your Netlify site settings.

github-actions · 2026-04-29T19:30:05Z

SSR Test Run for 3cb32c2: Report

Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

github-actions · 2026-04-29T19:34:18Z

SSR Test Run for 179ab03: Report

Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

github-actions · 2026-04-29T19:38:42Z

SSR Test Run for bb75c8b: Report

zeroedin

Legacy Generator Transition: Mappa

@ts-expect-error

* feat!: rename all elements to pf-v5-* prefix Rename all 35 elements and their sub-components from pf-* to pf-v5-*. CSS custom properties renamed from --pf-c-* to --pf-v5-c-*. Global tokens (--pf-global--*) are unchanged. Closes #3052, closes #3053, closes #3054, closes #3055, closes #3056, closes #3057, closes #3058, closes #3059, closes #3060, closes #3061, closes #3062, closes #3063, closes #3064, closes #3065, closes #3066, closes #3067, closes #3068, closes #3069, closes #3070, closes #3071, closes #3072, closes #3073, closes #3074, closes #3075, closes #3076, closes #3077, closes #3078, closes #3079, closes #3080, closes #3081, closes #3082, closes #3083, closes #3084, closes #3085, closes #3086 Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat!: remove bundled entrypoint (pfe.min.js) (#3089) * feat!: remove bundled entrypoint (pfe.min.js) The bundled entrypoint causes custom element double-registration issues and is not the recommended way to consume the library. Closes #3087 Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: remove bundle references from docs plugin Remove the bundle() call and pfe.min.* passthrough copies from the Eleventy docs plugin, since the bundled entrypoint was removed. Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: remove trailing blank line in pfe-assets plugin Fixes padded-blocks lint error. Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * docs: update element references from pf-* to pf-v5-* Update all docs site references to use the new pf-v5-* element names, including HTML tags, CSS selectors, import paths, and code examples. Blog posts and changelogs left unchanged as historical records. PF4 core CSS tokens (--pf-c-content/title/text) left unchanged as they reference the PF CSS framework, not pf-elements components. Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(docs): fix docs build after pf-v5-* rename - Update main.mjs to import PfV5Icon from renamed path - Update pfe-assets.cjs regex and JSDoc for pf-v5-* paths - Pass prefix option to PfeAssetsPlugin in eleventy config - Replace broken generateImportMap shortcodes with static import maps (jspm.io can't resolve unpublished pf-v5-* paths) - Fix pre-existing TS build errors: use Router.Middleware instead of non-existent RouterMiddleware export, remove stale @ts-expect-error directive - Fix pre-existing slug function call using deprecated eleventyConfig.javascript.functions API Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat!: remove deprecated APIs (#3090) - Remove CascadeController and @Cascades decorator (use @lit/context) - Remove SlotController.anonymous (use SlotController.default) - Remove pf-popover closeButtonLabel / close-label attribute (use accessible-close-label) pfeCustomElementsManifestConfig was already removed from the codebase. Closes #2975, closes #2974, closes #2973, closes #2972 Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(tools): fix TS build errors on CI - Use koa Middleware type instead of Router.Middleware namespace (namespace not available with Node moduleResolution) - Use @ts-ignore instead of @ts-expect-error for colorjs.io import (error occurs on CI but not locally due to moduleResolution) Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(docs): handle ESM default export from slugify v2 `@sindresorhus/slugify` v2 is ESM-only. Node 22 `require()` of ESM returns the module namespace object, not the default export, causing `TypeError: slugify is not a function` in the eleventy `ids` transform. Assisted-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com> * chore: clean up remaining pf-* references after rename - README: update test path examples to pf-v5-* element dirs - elements/package.json: remove orphaned pf-jazz-hands export entry - eslint.config.js: fix pf-icon ignore path to pf-v5-icon - bundle.ts: update pf-icon export to pf-v5-icon - dev server index.html template: update pf-button/pf-icon/pf-card tags and imports to pf-v5-* equivalents - docs/_snippets: update accordion-jsx and card-html import paths - vue.md: fix CodeSandbox search hint to @patternfly/elements Assisted-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com> * fix: tools and docs for pf-v5 prefix/ elements rename compatibility (#3114) * docs: rename doc files to match pf-v5 element names * chore: update tagPrefix in config * fix: use unbundled element modules for docs site * refactor(tools): use pfe config for tag aliasing in DocsPage * chore(tools): add changeset * chore: correct npm run docs to include the elements build * fix: copy element screenshots to docs site * fix: copy demo assets to docs site * fix: strip v5 prefix from docs titles, replace jspm with mappa (#3115) * fix: strip v5 prefix from docs titles, replace @jspm/generator with @pwrs/mappa Strip the tag prefix (pf-v5-) from element display names in the docs site sidebar, page titles, and demo headings so they show "Accordion" instead of "V5 Accordion". Replace @jspm/generator with @pwrs/mappa for import map generation in both the 11ty docs build and the dev server plugin. This fixes the "Unable to resolve npm:lit@3.3.2" build error and simplifies the import map infrastructure. Also adds v5 to the docs version dropdown and marks it as current. Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: remove stale @jspm/generator patch file Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: lint errors in create-import-map and package.json sort order Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: operator-linebreak style in create-import-map Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Benny Powers <web@bennypowers.com> Co-authored-by: Benny Powers <bennypowers@users.noreply.github.com>

github-actions Bot added the AT passed Automated testing has passed label Apr 29, 2026

fix: remove stale @jspm/generator patch file

6611df3

Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: lint errors in create-import-map and package.json sort order

4c6edc0

Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

fix: operator-linebreak style in create-import-map

381d373

Assisted-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

zeroedin approved these changes Apr 29, 2026

View reviewed changes

bennypowers merged commit 36cc662 into staging/pfe5 Apr 29, 2026
12 checks passed

bennypowers deleted the fix/docs-v5-titles-and-mappa branch April 29, 2026 20:20

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix: strip v5 prefix from docs titles, replace jspm with mappa#3115

fix: strip v5 prefix from docs titles, replace jspm with mappa#3115
bennypowers merged 4 commits intostaging/pfe5from
fix/docs-v5-titles-and-mappa

bennypowers commented Apr 29, 2026

Uh oh!

changeset-bot Bot commented Apr 29, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 29, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 29, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 29, 2026

Uh oh!

github-actions Bot commented Apr 29, 2026

Uh oh!

github-actions Bot commented Apr 29, 2026

Uh oh!

zeroedin left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

bennypowers commented Apr 29, 2026

Summary

Changes

Test plan

Uh oh!

changeset-bot Bot commented Apr 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

github-actions Bot commented Apr 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Commitlint tests passed!

Uh oh!

github-actions Bot commented Apr 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for patternfly-elements ready!

Uh oh!

github-actions Bot commented Apr 29, 2026

Uh oh!

github-actions Bot commented Apr 29, 2026

Uh oh!

github-actions Bot commented Apr 29, 2026

Uh oh!

zeroedin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

changeset-bot Bot commented Apr 29, 2026 •

edited

Loading

github-actions Bot commented Apr 29, 2026 •

edited

Loading

github-actions Bot commented Apr 29, 2026 •

edited

Loading