UI5 wc ngx: topics to investigate

[droshev]

Describe your proposal

• Analyze the importing of the ui5wc wrappers:

Is everything correct? The user raised:

There is discrepancy between the documentation, and actual library structure, even in the latest 'v0.60.1-rc.5' of '@fundamental-ngx/ui5-webcomponents-fiori'
 
The README is telling to import the components from specific sub-modules (see 1.)
But the library itself, does not contain such sub-modules (see 2.) in contrast to '@fundamental-ngx/ui5-webcomponents' 
Therefore, whole 'ui5/webcomponents-fiori' imported / exported (see 3.)

• Investigate how to use Illustrated Messages (ui5wc) and manage to keep the blueprint to the bundle size minimal. At the moment it bring a lot of illustrated messages.

• document what is the best way to import the wrappers (avoid barrel imports)

Proposed Solution

Update the documentation at least

Proposed Alternatives

No response

Organization

No response

StackBlitz example(s)

No response

Priority

None

Declaration

• I'm not disclosing any internal or sensitive information.

[droshev]

Point 1.
✅ Correct Way to Import (as documented)

The README is correct. Users should import from secondary entry points:

// ✅ CORRECT - Angular wrapper with full functionality
import { ShellBarComponent } from
'@fundamental-ngx/ui5-webcomponents-fiori/shell-bar';
import { DynamicPageComponent } from
'@fundamental-ngx/ui5-webcomponents-fiori/dynamic-page';
import { TimelineComponent } from
'@fundamental-ngx/ui5-webcomponents-fiori/timeline';

Benefits:

• Gets the Angular wrapper (not raw UI5 component)
• Tree-shakeable - only imports the needed component
• Includes all Angular integration (signals, content density, etc.)
• Proper TypeScript types

❌ Avoid Barrel Imports

// ❌ BAD - Imports entire library
import { ShellBarComponent, DynamicPageComponent } from
'@fundamental-ngx/ui5-webcomponents-fiori';