From 2cd6b02a1fc7216d4ad198e5ee545a2ec0052290 Mon Sep 17 00:00:00 2001 From: "bert.hausmans" Date: Sat, 16 May 2026 12:33:07 +0200 Subject: [PATCH] docs(primevue): add anti-pattern note for responsive utility wrapping --- dev-docs/PRIMEVUE_COMPONENTS.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/dev-docs/PRIMEVUE_COMPONENTS.md b/dev-docs/PRIMEVUE_COMPONENTS.md index 33161fb7..748849a9 100644 --- a/dev-docs/PRIMEVUE_COMPONENTS.md +++ b/dev-docs/PRIMEVUE_COMPONENTS.md @@ -370,6 +370,8 @@ sane: 6. **When in doubt, prefer PrimeVue conventions.** If a form on a migrated surface needs a component this document doesn't yet cover, find the closest PrimeVue equivalent on https://primevue.org/, implement it, and append a note in §3 (or open a tightly scoped PR to update this document). F4 sub-packages are expected to refine §3 — that is the explicit growth path. 7. **F6 is the cliff.** After F6 (cleanup, ~0.5 day), Vuetify is removed from `package.json` and `` tags fail to compile. No more parallel mode. Per [RFC §9](./RFC-WS-FRONTEND-PRIMEVUE.md#9-rollback-plan), F6 is the point of no return for rollback. +Anti-pattern: directly applying responsive visibility utility classes (md:hidden, lg:flex, etc.) to PrimeVue components. PrimeVue's component CSS may override due to cascade order. Always wrap in a plain element that owns the visibility class. + --- ## 10. Cross-references and resources