wuic-framework-lib 1.5.0 → 1.7.1

package/fesm2022/wuic-framework-lib.mjs

@@ -1,2 +1,2 @@
-export { s as AUTH_REDIRECT_REASON_KEY, t as AppSettingsEditorComponent, u as AuthSessionService, B as BooleanEditorComponent, v as BoundedRepeaterComponent, w as ButtonEditorComponent, x as CallbackPipe, y as CallbackPipe2, z as CarouselListComponent, E as CodeAreaEditorComponent, H as ColorEditorComponent, J as CrashReporterService, K as CustomAttributesService, N as CustomException, O as DataActionButtonComponent, Q as DataProviderOdataService, c as DataRepeaterComponent, b as DataSourceComponent, R as DateEditorComponent, S as DesignerRouteComponent, V as DictionaryEditorComponent, a as DynamicCompilerService, X as DynamicRowTemplateComponent, i as FieldEditorComponent, F as FilterBarComponent, o as FilterInfo, Y as FormatGridViewValuePipe, Z as GetSrcUploadPreviewPipe, G as GlobalHandler, _ as HtmlEditorComponent, $ as ImageWrapperComponent, I as ImportExportButtonComponent, a0 as IsSelectedRowPipe, a1 as KanbanListComponent, a2 as KanbanOptions, a3 as KanbanStatusColumnItem, a4 as LazyChartListComponent, a5 as LazyCodeEditorComponent, a6 as LazyDataActionButtonComponent, a7 as LazyDataSourceComponent, a8 as LazyFieldEditorComponent, a9 as LazyFirstRunWizardComponent, aa as LazyImageWrapperComponent, ab as LazyKanbanListComponent, ac as LazyMetaMenuComponent, ad as LazyPivotBuilderComponent, ae as LazyReportDesignerComponent, af as LazyReportViewerComponent, ag as LazySchedulerListComponent, ah as LazySpreadsheetListSfComponent, p as LicenseFeatureService, ai as ListGridComponent, aj as LookupEditorComponent, ak as MapListComponent, m as MetaInfo, al as MetaMenuComponent, g as MetadataEditorService, M as MetadataProviderService, e as MetadatiColonna, am as MetadatiTabella, an as NotificationBellComponent, ao as NotificationRealtimeService, ap as NumberEditorComponent, aq as PRIMARY_PALETTES, P as PagerComponent, d as ParametricDialogComponent, ar as PointFilterComponent, as as PropertyArrayEditorComponent, at as PropertyObjectEditorComponent, au as Scene3dDesignerRouteComponent, av as Scene3dViewerRouteComponent, aw as THEME_OPTIONS, ax as TextAreaEditorComponent, ay as TextEditorComponent, T as TranslationManagerService, az as TreeListComponent, aA as TreeViewSelectorComponent, aB as UploadDialogComponent, aC as UploadEditorComponent, U as UserInfoService, aD as ValidationRule, aE as ValueChangedPayload, aF as VisibleFieldListPipe, n as WUIC_SUPPRESS_GLOBAL_ERROR, aG as WidgetDefinition, aH as WorkflowDesignerRouteComponent, aI as WorkflowRunnerComponent, h as WorkflowRuntimeMetadataService, W as WtoolboxService, aJ as WuicAziendaSwitcherComponent, aK as WuicErrorDialogComponent, aL as WuicErrorInterceptor, aM as WuicFeatureDirective, aN as WuicFrozenColumnDirective, aO as WuicRagChatbotComponent, aP as WuicRagChatbotFabComponent, aQ as WuicRagService, aR as WuicRowTogglerDirective, aS as _PRIMENG_TABLE_DIRECTIVES_NAMES, aT as authExpiredInterceptor, aU as boundedRepeaterPendingChangesGuard, aV as featureRouteCanActivateGuard, aW as featureRouteCanMatchGuard, r as getThemeOptions, aX as getThemePrimaryHex, aY as inferTemplateFieldFromBaseClass, aZ as loadBooleanEditorComponent, a_ as loadButtonEditorComponent, a$ as loadCodeAreaEditorComponent, b0 as loadColorEditorComponent, b1 as loadDateEditorComponent, b2 as loadDictionaryEditorComponent, b3 as loadHtmlEditorComponent, b4 as loadLookupEditorComponent, b5 as loadNumberEditorComponent, b6 as loadPropertyArrayEditorComponent, b7 as loadPropertyObjectEditorComponent, b8 as loadTextAreaEditorComponent, b9 as loadTextEditorComponent, ba as loadTreeViewSelectorComponent, bb as loadUploadEditorComponent, bc as menuRouteAccessCanActivateGuard, bd as menuRouteAccessCanMatchGuard, be as routes, bf as scene3dDesignerPendingChangesGuard, bg as wuicErrorInterceptor } from './wuic-framework-lib-wuic-framework-lib-3TZ-j-yL.mjs';
+export { w as AUTH_REDIRECT_REASON_KEY, x as AppHeaderComponent, y as AppHeaderConfigService, z as AppSettingsEditorComponent, B as AuthSessionService, E as BooleanEditorComponent, H as BoundedRepeaterComponent, J as ButtonEditorComponent, K as CUSTOM_THEMES_STORAGE_KEY, N as CallbackPipe, O as CallbackPipe2, Q as CarouselListComponent, R as CodeAreaEditorComponent, S as ColorEditorComponent, V as CrashReporterService, X as CustomAttributesService, Y as CustomException, Z as DEFAULT_FONT_STACK, _ as DEFAULT_THEME_STORAGE_KEY, $ as DEFAULT_THEME_VALUE, a0 as DataActionButtonComponent, a1 as DataProviderOdataService, c as DataRepeaterComponent, b as DataSourceComponent, a2 as DateEditorComponent, a3 as DesignerRouteComponent, a4 as DictionaryEditorComponent, a as DynamicCompilerService, a5 as DynamicRowTemplateComponent, k as FieldEditorComponent, F as FilterBarComponent, q as FilterInfo, a6 as FormatGridViewValuePipe, a7 as GetSrcUploadPreviewPipe, G as GlobalHandler, a8 as HtmlEditorComponent, a9 as ImageWrapperComponent, I as ImportExportButtonComponent, aa as IsSelectedRowPipe, ab as KanbanListComponent, ac as KanbanOptions, ad as KanbanStatusColumnItem, ae as LazyChartListComponent, af as LazyCodeEditorComponent, ag as LazyDataActionButtonComponent, ah as LazyDataSourceComponent, ai as LazyFieldEditorComponent, aj as LazyFirstRunWizardComponent, ak as LazyImageWrapperComponent, al as LazyKanbanListComponent, am as LazyMetaMenuComponent, an as LazyPivotBuilderComponent, ao as LazyReportDesignerComponent, ap as LazyReportViewerComponent, aq as LazySchedulerListComponent, ar as LazySpreadsheetListSfComponent, as as LazyTimelineListComponent, r as LicenseFeatureService, at as ListGridComponent, au as LookupEditorComponent, av as MapListComponent, o as MetaInfo, aw as MetaMenuComponent, i as MetadataEditorService, M as MetadataProviderService, g as MetadatiColonna, ax as MetadatiTabella, ay as NotificationBellComponent, az as NotificationRealtimeService, aA as NumberEditorComponent, aB as PALETTE_STOPS, aC as PREVIEW_RESTORE_KEY, aD as PRIMARY_PALETTES, P as PagerComponent, f as ParametricDialogComponent, aE as PerformanceInspectorComponent, aF as PointFilterComponent, aG as PropertyArrayEditorComponent, aH as PropertyObjectEditorComponent, aI as RAG_DESTRUCTIVE_KINDS, aJ as RouteMetricsDashboardComponent, aK as Scene3dDesignerRouteComponent, aL as Scene3dViewerRouteComponent, aM as THEME_MODE_STORAGE_KEY, aN as THEME_OPTIONS, aO as THEME_STORAGE_KEY, aP as TextAreaEditorComponent, aQ as TextEditorComponent, aR as ThemeBuilderComponent, aS as ThemeCatalogService, aT as ThemePreviewPanelComponent, aU as ThemeRuntimeService, aV as ThemeSelectorComponent, u as TimelineOptions, T as TranslationManagerService, aW as TreeListComponent, aX as TreeViewSelectorComponent, aY as UploadDialogComponent, aZ as UploadEditorComponent, U as UserInfoService, a_ as UserLanguageService, a$ as UserMenuComponent, b0 as ValidationRule, b1 as ValueChangedPayload, b2 as VisibleFieldListPipe, b3 as WUIC_FONT_CATALOG, p as WUIC_SUPPRESS_GLOBAL_ERROR, b4 as WidgetDefinition, b5 as WorkflowDesignerRouteComponent, b6 as WorkflowRunnerComponent, j as WorkflowRuntimeMetadataService, W as WtoolboxService, b7 as WuicAziendaSwitcherComponent, b8 as WuicErrorDialogComponent, b9 as WuicErrorInterceptor, ba as WuicFeatureDirective, bb as WuicFrozenColumnDirective, bc as WuicRagChatbotComponent, bd as WuicRagChatbotFabComponent, be as WuicRagService, bf as WuicRowTogglerDirective, bg as _PRIMENG_TABLE_DIRECTIVES_NAMES, bh as authExpiredInterceptor, bi as bestContrastColor, bj as boundedRepeaterPendingChangesGuard, bk as buildCustomPreset, bl as buildThemeValue, d as clampAlpha, bm as computeDataQualitySummary, bn as contrastRatio, bo as createDraftTheme, bp as featureRouteCanActivateGuard, bq as featureRouteCanMatchGuard, br as generatePrimaryPalette, bs as generateSurfacePalette, bt as getQualityInspectorOptions, v as getThemeOptions, bu as getThemePrimaryHex, bv as hexToOklch, bw as hexToRgb, bx as hsbaToRgbaString, by as inferTemplateFieldFromBaseClass, bz as isCustomThemeValue, bA as isDestructiveRagAction, bB as isRoutePersistenceEnabled, bC as loadBooleanEditorComponent, bD as loadButtonEditorComponent, bE as loadCodeAreaEditorComponent, bF as loadColorEditorComponent, bG as loadDateEditorComponent, bH as loadDictionaryEditorComponent, bI as loadHtmlEditorComponent, bJ as loadLookupEditorComponent, bK as loadNumberEditorComponent, bL as loadPropertyArrayEditorComponent, bM as loadPropertyObjectEditorComponent, bN as loadTextAreaEditorComponent, bO as loadTextEditorComponent, bP as loadTreeViewSelectorComponent, bQ as loadUploadEditorComponent, bR as menuRouteAccessCanActivateGuard, bS as menuRouteAccessCanMatchGuard, bT as nearestPrimaryName, bU as normalizeHex, bV as oklchToHex, bW as oklchToRgb, bX as resolveBackgroundCss, bY as resolveFontStack, bZ as resolveGridStrengths, b_ as resolveThemePreset, b$ as resolveThemePresetForOption, c0 as rgbToHex, c1 as rgbToOklch, c2 as rgbaToHsbaModel, c3 as routeMetricsClient, c4 as routes, c5 as scene3dDesignerPendingChangesGuard, c6 as themeBuilderPendingChangesGuard, t as toHsbaModel, e as toPersistedColor, c7 as wcagLevel, c8 as wuicErrorInterceptor } from './wuic-framework-lib-wuic-framework-lib-BZZwta8b.mjs';
 //# sourceMappingURL=wuic-framework-lib.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wuic-framework-lib",
-  "version": "1.5.0",
+  "version": "1.7.1",
   "description": "Wuic Angular Framework Library",
   "author": "Wuic",
   "license": "MIT",
@@ -41,7 +41,12 @@
     "three": "^0.185.1",
     "primeflex": "^3.3.1",
     "primeicons": "^7.0.0",
-    "primeng": ">=21.0.0"
+    "primeng": ">=21.0.0",
+    "@primeuix/styled": ">=0.7.0",
+    "@primeuix/themes": ">=2.0.0",
+    "three-gpu-pathtracer": "^0.0.24",
+    "three-mesh-bvh": "^0.9.10",
+    "@dimforge/rapier3d-compat": "^0.12.0"
   },
   "dependencies": {
     "stimulsoft-designer-angular": "^2026.1.7",
@@ -81,6 +86,20 @@
       "default": "./fesm2022/wuic-framework-lib-widget-loaders.mjs"
     }
   },
+  "peerDependenciesMeta": {
+    "three-gpu-pathtracer": {
+      "optional": true
+    },
+    "three-mesh-bvh": {
+      "optional": true
+    },
+    "@dimforge/rapier3d-compat": {
+      "optional": true
+    },
+    "three": {
+      "optional": true
+    }
+  },
   "module": "fesm2022/wuic-framework-lib.mjs",
   "typings": "types/wuic-framework-lib.d.ts",
   "type": "module"

package/styles/_wuic-tokens.scss

@@ -0,0 +1,82 @@
+// Token di design condivisi del framework (--wuic-*).
+// Sono DERIVATI dai token semantici PrimeUIX (--p-*): commutano da soli al
+// cambio tema/preset, in dark mode (darkModeSelector `.theme-dark` ricalcola i
+// --p-*) e in alto contrasto (l'host rimappa i --p-* sui --hc-*). Per questo
+// i componenti che usano --wuic-* NON devono aggiungere blocchi
+// `:host-context(.theme-dark)` propri: la commutazione avviene qui, una volta.
+// I fallback hex servono solo quando i --p-* non sono ancora installati
+// (bootstrap primissimo paint) e replicano il light di default.
+
+:root {
+    // Superfici
+    --wuic-surface: var(--p-content-background, #ffffff);
+    --wuic-surface-soft: var(--p-content-hover-background, #f8fafc);
+
+    // Bordi
+    --wuic-border: var(--p-content-border-color, #d9e2ec);
+    --wuic-border-soft: color-mix(in srgb, var(--wuic-border) 55%, var(--wuic-surface));
+
+    // Testo
+    --wuic-text: var(--p-text-color, #1f2937);
+    --wuic-text-muted: var(--p-text-muted-color, #64748b);
+
+    // Accent (colore primario del tema attivo)
+    --wuic-accent: var(--p-primary-color, #3b82f6);
+    --wuic-accent-contrast: var(--p-primary-contrast-color, #ffffff);
+    --wuic-accent-soft: color-mix(in srgb, var(--wuic-accent) 12%, var(--wuic-surface));
+
+    // Raggi
+    --wuic-radius-sm: var(--p-border-radius-sm, 4px);
+    --wuic-radius-md: var(--p-border-radius-md, 6px);
+    --wuic-radius-lg: var(--p-border-radius-lg, 10px);
+
+    // Ombre: non derivabili dai --p-* (PrimeUIX non espone shadow semantiche),
+    // quindi hanno l'unico override esplicito in `.theme-dark` qui sotto.
+    --wuic-shadow-1: 0 1px 3px rgba(15, 23, 42, 0.08);
+    --wuic-shadow-2: 0 10px 24px rgba(15, 23, 42, 0.08);
+
+    // Spaziature (pilotate anche dal tema "dense")
+    --wuic-space-1: 4px;
+    --wuic-space-2: 8px;
+    --wuic-space-3: 16px;
+
+    // Tipografia e sfondo pagina.
+    // NON derivano dai --p-*: PrimeUIX non ha token per font-family, per il
+    // font-size globale (esistono solo `formField.sm/lg.fontSize`) ne' per lo
+    // sfondo della pagina. Sono scritti dal Theme Builder via
+    // documentElement.style.setProperty e applicati in styles.scss.
+    //
+    // Il default dello stack NON e' neutro di proposito: senza font-family il
+    // browser cade sul serif di sistema (verificato: body in "Times New Roman"),
+    // che non e' mai stata una scelta di design del framework.
+    --wuic-font-family: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+    --wuic-font-scale: 16px;
+    --wuic-app-bg: var(--wuic-surface);
+    --wuic-app-bg-image: none;
+    --wuic-app-bg-overlay: transparent;
+    /* Resa dell'immagine di sfondo: `auto` + `repeat` per le texture,
+       `cover` per le foto a piena pagina. */
+    --wuic-app-bg-size: cover;
+    --wuic-app-bg-repeat: no-repeat;
+    --wuic-app-bg-position: center;
+    /* Durata della deriva del gradiente animato: lunga di proposito, deve
+       essere percepibile solo di sfuggita. */
+    --wuic-app-bg-anim-duration: 32s;
+}
+
+// Unico blocco dark globale: solo i token non derivabili dai --p-*.
+:is(html, body).theme-dark {
+    --wuic-shadow-1: 0 1px 3px rgba(0, 0, 0, 0.35);
+    --wuic-shadow-2: 0 14px 30px rgba(0, 0, 0, 0.35);
+}
+
+// Densita' compatta: classe applicata su html/body dal theme selector (stesso
+// meccanismo di `.theme-dark`) perche' definePreset() scrive solo --p-*.
+// Solo spacing: i radius NON vanno ridefiniti qui — derivano gia' dai
+// --p-border-radius-* che il preset Dense riduce, e un override creerebbe
+// due fonti di verita' in conflitto.
+:is(html, body).theme-dense {
+    --wuic-space-1: 2px;
+    --wuic-space-2: 5px;
+    --wuic-space-3: 10px;
+}

package/styles/styles.scss

@@ -1,3 +1,5 @@
+@use 'wuic-tokens';
+
 $main_background: #fff;
 
 :root {
@@ -5,10 +7,30 @@ $main_background: #fff;
     --p-menubar-padding: 4px !important;
 }
 
+/* Scala tipografica globale: PrimeNG dimensiona tutto in `rem`, quindi il
+   font-size di <html> e' l'unica leva che scala coerentemente testo, padding e
+   altezze dei componenti. Pilotato dal Theme Builder entro 12-18px. */
+html {
+    font-size: var(--wuic-font-scale, 16px);
+}
+
 html,
 body {
     margin: 0;
     height: 100%;
+    /* Sfondo pagina dai token: senza, html/body restano trasparenti e nei
+       webview/browser con canvas scuro la cornice attorno alla shell appare
+       nera. Con i token segue anche dark e high-contrast.
+       `--wuic-app-bg` permette al Theme Builder di sovrascrivere il colore
+       (o mettere un gradiente) senza toccare la superficie dei componenti. */
+    background-color: var(--wuic-app-bg, var(--wuic-surface, #ffffff));
+    background-image: var(--wuic-app-bg-image, none);
+    background-size: var(--wuic-app-bg-size, cover);
+    background-repeat: var(--wuic-app-bg-repeat, no-repeat);
+    background-position: var(--wuic-app-bg-position, center);
+    background-attachment: fixed;
+    color: var(--wuic-text, #1f2937);
+    font-family: var(--wuic-font-family);
 }
 
 body {
@@ -17,6 +39,88 @@ body {
     box-sizing: border-box;
 }
 
+/* Deriva lenta del gradiente di sfondo (opt-in dal tema, classe messa da
+   `ThemeRuntimeService`).
+ *
+ * Si anima l'INCLINAZIONE del gradiente. Un `linear-gradient` non e'
+ * interpolabile di per se': la registrazione con `@property` dichiara
+ * `--wuic-app-bg-angle` come `<angle>`, ed e' quella dichiarazione a rendere
+ * la proprieta' animabile. Nei browser che non supportano `@property` la
+ * custom property resta al valore iniziale e il gradiente e' semplicemente
+ * fermo — degradazione voluta.
+ *
+ * L'oscillazione e' di +/- 28 gradi attorno all'inclinazione scelta
+ * dall'admin (`--wuic-app-bg-angle-base`): abbastanza per vedere i colori
+ * riorganizzarsi, non tanto da ribaltare il gradiente e stravolgere il tema. */
+@property --wuic-app-bg-spin {
+    syntax: '<angle>';
+    inherits: true;
+    initial-value: 0deg;
+}
+
+/* L'animazione va su `html`, NON su `body`: il gradiente vive dentro
+   `--wuic-app-bg-image`, che `ThemeRuntimeService` dichiara su `html`, e il
+   `var(--wuic-app-bg-spin)` annidato si risolve sull'elemento che DICHIARA la
+   variabile. Animando su `body` lo spin cambiava (verificato) ma il gradiente
+   continuava a leggere il valore iniziale di `html`, restando fermo. */
+html.wuic-bg-animated {
+    animation: wuic-app-bg-drift var(--wuic-app-bg-anim-duration, 32s) ease-in-out infinite alternate;
+}
+
+/* I due estremi sono LETTERALI, non `calc(var(...) ± delta)`: un keyframe il
+   cui valore contiene `var()` non viene interpolato (verificato: l'angolo
+   restava fermo al valore di partenza). L'inclinazione scelta dall'admin
+   entra quindi nel gradiente, non qui: il gradiente animato e' costruito come
+   `linear-gradient(calc(<base> + var(--wuic-app-bg-spin)), ...)` e questi
+   keyframe fanno oscillare il solo scostamento.
+   Ampiezza +/- 60 gradi: il movimento si vede, ma il gradiente non raggiunge
+   mai l'orientamento opposto (servirebbero 180 gradi di scostamento), quindi
+   i colori non si scambiano mai i lati e l'inclinazione impostata resta
+   riconoscibile per tutto il ciclo. */
+@keyframes wuic-app-bg-drift {
+    from { --wuic-app-bg-spin: -60deg; }
+    to { --wuic-app-bg-spin: 60deg; }
+}
+
+/* Chi ha chiesto meno movimento non lo subisce: l'animazione e' continua e
+   copre l'intera finestra, cioe' il caso peggiore per chi soffre di motion
+   sickness. Il gradiente resta, fermo. */
+@media (prefers-reduced-motion: reduce) {
+    html.wuic-bg-animated {
+        animation: none;
+        --wuic-app-bg-spin: 0deg;
+    }
+}
+
+/* Velo opzionale sopra l'immagine di sfondo: senza, un'immagine con molto
+   contrasto rende illeggibile il testo della shell. `pointer-events: none` e
+   z-index negativo perche' non deve mai intercettare i click. */
+body::before {
+    content: '';
+    position: fixed;
+    inset: 0;
+    background: var(--wuic-app-bg-overlay, transparent);
+    pointer-events: none;
+    z-index: -1;
+}
+
+/* I controlli form nativi NON ereditano il font dal documento (default dello
+   user-agent: usano il font di sistema), per questo i bottoni restavano in
+   Arial mentre il resto della pagina cambiava. Regola classica di normalize.
+   Mirata ai soli elementi form: NON tocca gli <i>/<span> delle icon-font, che
+   restano su primeicons/Material Icons e continuano a mostrare i glifi.
+   (Una guardia con `font-family: revert` sulle icone sarebbe controproducente:
+   `revert` scarta anche la regola author di primeicons e le icone tornerebbero
+   a ereditare il font della pagina, cioe' esattamente il bug che dovrebbe
+   prevenire — verificato.) */
+button,
+input,
+textarea,
+select,
+optgroup {
+    font-family: inherit;
+}
+
 $widget_edit_popup_height: 90%;
 $widget_edit_popup_width: 75%;
 
@@ -70,6 +174,62 @@ a.p-menuitem-link {
     word-break: break-word;
 }
 
+/* ── Posizioni header (tab "Header & Menu" di app-settings-editor) ──────────
+   Classi `wuic-header-pos-*` applicate su html/body da <wuic-app-header>
+   (stesso meccanismo di `theme-dark`). Targettano le convenzioni della shell
+   host (`.app-shell`, `.app-shell-header`, `.app-shell-content`): le install
+   che usano <wuic-app-header> ereditano i layout senza toccare la shell. */
+:is(html, body).wuic-header-pos-bottom .app-shell {
+    flex-direction: column-reverse;
+}
+
+:is(html, body).wuic-header-pos-left .app-shell {
+    flex-direction: row;
+}
+
+:is(html, body).wuic-header-pos-right .app-shell {
+    flex-direction: row-reverse;
+}
+
+:is(html, body).wuic-header-pos-left .app-shell-header,
+:is(html, body).wuic-header-pos-right .app-shell-header {
+    flex: 0 0 280px;
+    width: 280px;
+    min-width: 280px;
+    height: 100%;
+    overflow-y: auto;
+    overflow-x: visible;
+}
+
+/* La shell orizzontale usa `height: 0` sul content (trucco flex): in verticale
+   il content e' un fratello di riga e deve riempire l'altezza reale. */
+:is(html, body).wuic-header-pos-left .app-shell-content,
+:is(html, body).wuic-header-pos-right .app-shell-content {
+    height: 100%;
+}
+
+/* ── Submenu a colonna singola ("Multi-column submenus" OFF) ────────────────
+   Classe `wuic-submenu-singlecol` applicata da <wuic-app-header>. I submenu
+   grandi non stanno nel viewport: il primo livello diventa scrollabile e i
+   NESTED passano a inline/accordion — un flyout absolute dentro uno scroll
+   container verrebbe clippato (feedback 2026-08-07: "overflow auto rompe la
+   gestione del menu"). Scoped su .wuic-app-header-menu per non toccare gli
+   altri p-menubar della pagina (es. caption bar della list-grid). */
+:is(html, body).wuic-submenu-singlecol .wuic-app-header-menu .p-menubar-root-list > .p-menubar-item > .p-menubar-submenu {
+    max-height: calc(100vh - 140px);
+    overflow-y: auto;
+    overflow-x: hidden;
+}
+
+:is(html, body).wuic-submenu-singlecol .wuic-app-header-menu .p-menubar-submenu .p-menubar-submenu {
+    position: static !important;
+    width: 100% !important;
+    min-width: 0;
+    box-shadow: none;
+    border: 0;
+    padding-left: 16px;
+}
+
 .edit-form-button-bar {
     list-style-type: none;
     padding: 0;