Deprecated Entry Points in @yuuvis/client-framework

No import changes are required in v3. Existing @yuuvis/client-framework imports continue to work exactly as before. Behind the scenes each affected entry point has been converted into a pass-through re-export that forwards all its symbols from the new @yuuvis/client-components library.

In Shell v3, generic UI components that previously lived exclusively in @yuuvis/client-framework were extracted into this dedicated library.

Why the extraction happened

@yuuvis/client-framework originally bundled both backend-coupled infrastructure (services, API clients, object model utilities) and backend-independent UI primitives (layout containers, form controls, utility directives) in the same library. This made it impossible to use the UI components in contexts that do not depend on the yuuvis backend.

@yuuvis/client-components is the new home for all backend-independent UI components. The library has no dependency on @yuuvis/client-core or any backend API, making it reusable in generic Angular applications.

Deprecated entry points at a glance

Deprecated (v3, removed in v4)	Replacement
`@yuuvis/client-framework/autocomplete`	`@yuuvis/client-components/autocomplete`
`@yuuvis/client-framework/common`	`@yuuvis/client-components/common`
`@yuuvis/client-framework/list`	`@yuuvis/client-components/list`
`@yuuvis/client-framework/master-details`	`@yuuvis/client-components/master-details`
`@yuuvis/client-framework/overflow-hidden`	`@yuuvis/client-components/overflow-hidden`
`@yuuvis/client-framework/overflow-menu`	`@yuuvis/client-components/overflow-menu`
`@yuuvis/client-framework/popout`	`@yuuvis/client-components/popout`
`@yuuvis/client-framework/split-view`	`@yuuvis/client-components/split-view`
`@yuuvis/client-framework/widget-grid`	`@yuuvis/client-components/widget-grid`

If you only need the replacement import path, the table above is sufficient. The sections below list the individual exported symbols for each entry point.

Entry-point details

`autocomplete`

A standalone form control that provides typeahead suggestions over a configurable data source.

v3 (deprecated)
v4+ (recommended)

import { AutocompleteComponent, YuvAutocompleteModule } from '@yuuvis/client-framework/autocomplete';

import { AutocompleteComponent, YuvAutocompleteModule } from '@yuuvis/client-components/autocomplete';

Exported symbols

Symbol	Type
`AutocompleteComponent`	Component
`AutocompleteItem`	Interface
`YuvAutocompleteModule`	NgModule

`common`

A broad collection of shared UI primitives, utility directives, and services used across the shell. Commonly used symbols include ConfirmService for confirmation dialogs, BusyOverlayDirective for loading states, ThemeService for appearance management, and FileDropZoneDirective for drag-and-drop file handling.

v3 (deprecated)
v4+ (recommended)

import { ConfirmComponent, BusyOverlayDirective, ... } from '@yuuvis/client-framework/common';

import { ConfirmComponent, BusyOverlayDirective, ... } from '@yuuvis/client-components/common';

Exported symbols

Symbol	Type
`BusyOverlayComponent`	Component
`ConfirmComponent`	Component
`DialogComponent`	Component
`HaloFocusComponent`	Component
`RetentionBadgeComponent`	Component
`ScrollButtonsComponent`	Component
`AbstractMatFormField`	Abstract Class
`AutofocusChildDirective`	Directive
`AutofocusDelayedDirective`	Directive
`BusyOverlayDirective`	Directive
`ClickDoubleDirective`	Directive
`ContainerSizeDirective`	Directive
`DragScrollDirective`	Directive
`DragSelectDirective`	Directive
`DragSelectItemDirective`	Directive
`FileDropZoneDirective`	Directive
`FocusWithinDirective`	Directive
`LightDismissDirective`	Directive
`LongPressDirective`	Directive
`NoopValueAccessorDirective`	Directive
`ScrollButtonsDirective`	Directive
`ConfirmService`	Service
`FormTranslateService`	Service
`LayoutSettingsService`	Service
`ThemeService`	Service
`YuvCommonModule`	NgModule
`ConfirmOverlayData`	Interface
`CustomThemeSettings`	Interface
`DragSelectOptions`	Interface
`LayoutMode`	Type alias
`LevelType`	Type alias
`Mode`	Type alias
`DialogSize`	Enum
`ThemeStorageKeys`	Enum
`DEFAULT_THEME`	Constant
`DEFAULT_THEME_KEY`	Constant
`HIGH_CONTRAST_THEME`	Constant
`HIGH_CONTRAST_THEME_KEY`	Constant
`YUV_CUSTOM_THEME`	InjectionToken
`getFocusableChildren`	Function
`getFirstFocusableChild`	Function
`provideYuvCustomTheme`	Function

`list`

A virtualization-ready list component with a tile variant and a custom item template directive.

v3 (deprecated)
v4+ (recommended)

import { ListComponent, ListTileComponent, ListItemDirective, YuvListModule } from '@yuuvis/client-framework/list';

import { ListComponent, ListTileComponent, ListItemDirective, YuvListModule } from '@yuuvis/client-components/list';

Exported symbols

Symbol	Type
`ListComponent`	Component
`ListItemDirective`	Directive
`ListTileComponent`	Component
`YuvListModule`	NgModule

`master-details`

A two-panel layout container that manages master-list / detail-view arrangements with configurable split ratios.

v3 (deprecated)
v4+ (recommended)

import { YuvMasterDetailsComponent, YuvMasterDetailsModule } from '@yuuvis/client-framework/master-details';

import { YuvMasterDetailsComponent, YuvMasterDetailsModule } from '@yuuvis/client-components/master-details';

Exported symbols

Symbol	Type
`YuvMasterDetailsComponent`	Component
`MasterDetailsLayoutOptions`	Interface
`YuvMasterDetailsModule`	NgModule

`overflow-hidden`

A container that clips its content and can reveal hidden overflow on demand (e.g. expandable tag clouds).

v3 (deprecated)
v4+ (recommended)

import { OverflowHiddenComponent, YuvOverflowHiddenModule } from '@yuuvis/client-framework/overflow-hidden';

import { OverflowHiddenComponent, YuvOverflowHiddenModule } from '@yuuvis/client-components/overflow-hidden';

Exported symbols

Symbol	Type
`OverflowHiddenComponent`	Component
`YuvOverflowHiddenModule`	NgModule

`overflow-menu`

A toolbar-overflow component that collapses excess action items into a “more” button when the container is too narrow.

v3 (deprecated)
v4+ (recommended)

import { OverflowMenuComponent, YuvOverflowMenuModule } from '@yuuvis/client-framework/overflow-menu';

import { OverflowMenuComponent, YuvOverflowMenuModule } from '@yuuvis/client-components/overflow-menu';

Exported symbols

Symbol	Type
`OverflowMenuComponent`	Component
`OverflowMenuItem`	Interface
`YuvOverflowMenuModule`	NgModule

`popout`

A floating panel that can detach from the main document flow and be displayed in a separate browser window (pop-out mode).

v3 (deprecated)
v4+ (recommended)

import { PopoutComponent, PopoutTriggerComponent, YuvPopoutModule } from '@yuuvis/client-framework/popout';

import { PopoutComponent, PopoutTriggerComponent, YuvPopoutModule } from '@yuuvis/client-components/popout';

Exported symbols

Symbol	Type
`PopoutComponent`	Component
`PopoutTriggerComponent`	Component
`FullscreenDirective`	Directive
`YuvPopoutModule`	NgModule
`PopoutTriggerConfig`	Interface
`PopoutWindowConfig`	Interface
`PopoutTriggerPosition`	Enum

`split-view`

A resizable split-panel layout with support for horizontal and vertical orientations and programmatic collapse.

v3 (deprecated)
v4+ (recommended)

import { SplitViewComponent, SplitAreaDirective, YuvSplitViewModule } from '@yuuvis/client-framework/split-view';

import { SplitViewComponent, SplitAreaDirective, YuvSplitViewModule } from '@yuuvis/client-components/split-view';

Exported symbols

Symbol	Type
`SplitViewComponent`	Component
`SplitAreaDirective`	Directive
`SplitViewLayoutSettings`	Interface
`SplitAreaLayoutSettings`	Interface
`SplitViewOutputData`	Type alias
`YuvSplitViewModule`	NgModule

`widget-grid`

A drag-and-drop dashboard grid with workspace management, widget registry, and serializable layout persistence.

v3 (deprecated)
v4+ (recommended)

import { YuvWidgetGridComponent, YuvWidgetGridWorkspacesComponent, WidgetGridService, YuvWidgetGridModule } from '@yuuvis/client-framework/widget-grid';

import { YuvWidgetGridComponent, YuvWidgetGridWorkspacesComponent, WidgetGridService, YuvWidgetGridModule } from '@yuuvis/client-components/widget-grid';

Exported symbols

Symbol	Type
`YuvWidgetGridComponent`	Component
`YuvWidgetGridWorkspacesComponent`	Component
`WidgetGridRegistry`	Service
`WidgetGridService`	Service
`GridWidget`	Interface
`IWidgetComponent`	Interface
`IWidgetSetupComponent`	Interface
`WidgetGridConfig`	Interface
`WidgetGridItem`	Interface
`WidgetGridItemConfig`	Interface
`WidgetGridWorkspace`	Interface
`WidgetGridWorkspaceConfig`	Interface
`WidgetGridWorkspaceOptions`	Interface
`WidgetPickerData`	Interface
`WidgetPickerOptions`	Interface
`AddItemSize`	Interface
`GridItemEvent`	Interface
`YuvWidgetGridModule`	NgModule

Performing the migration

The migration is a mechanical find-and-replace of the package name in import statements. No component API, template syntax, or behavior has changed — only the import path.

Replace all occurrences of:

@yuuvis/client-framework/<entry-point>

with:

@yuuvis/client-components/<entry-point>

For example, using a project-wide search-and-replace in your IDE or with sed:

# Dry run — preview what would change (checks .ts files; adjust --include for other file types)
grep -r "@yuuvis/client-framework/" src/ --include="*.ts"

# Apply the rename
# macOS/BSD: sed -i ''    Linux: remove the '' and use sed -i alone
# Add -name "*.html" to also cover Angular templates
find src -name "*.ts" -exec sed -i '' \
  's|@yuuvis/client-framework/autocomplete|@yuuvis/client-components/autocomplete|g;
   s|@yuuvis/client-framework/common|@yuuvis/client-components/common|g;
   s|@yuuvis/client-framework/list|@yuuvis/client-components/list|g;
   s|@yuuvis/client-framework/master-details|@yuuvis/client-components/master-details|g;
   s|@yuuvis/client-framework/overflow-hidden|@yuuvis/client-components/overflow-hidden|g;
   s|@yuuvis/client-framework/overflow-menu|@yuuvis/client-components/overflow-menu|g;
   s|@yuuvis/client-framework/popout|@yuuvis/client-components/popout|g;
   s|@yuuvis/client-framework/split-view|@yuuvis/client-components/split-view|g;
   s|@yuuvis/client-framework/widget-grid|@yuuvis/client-components/widget-grid|g' {} +