@pisapp/core 7.0.0-dev.20260916-153034 → 7.0.0-dev.20261029-122603

package/types.d.ts

@@ -5,11 +5,11 @@ declare type ActionInfo = {
     /**
      * Identifier of the object the entry relates to, for example the product or alias that was rejected.
      */
-    id: string;
+    id: string | null;
     /**
      * Human-readable message describing the error or warning.
      */
-    message: string;
+    message: string | null;
 };
 
 /** Toolbar customActions / menu button. */
@@ -116,7 +116,7 @@ declare type AliasSettings = {
     /**
      * List of customers for which alias display and search is enabled. Each customer is identified by system ID, sales unit, and customer ID.
      */
-    customers?: Array<Customer>;
+    customers?: Array<Customer> | null;
 };
 
 /** Aliases-table cell: catalog-type metadata but NO baseProductDetails. */
@@ -139,20 +139,24 @@ declare type ApplicationFilters = {
     /**
      * One or more CID identifiers from the ABB Offering Tree. Restricts results to product instances classified below the specified CIDs.
      */
-    restrictedCids?: Array<string>;
+    restrictedCids?: Array<string> | null;
     /**
-     * Data Owner identifiers. Includes supplier-specific products (marked with "Supplier Specific Detail" = "Yes") that are normally hidden from regular customers.
+     * Data Owner identifiers whose supplier-specific products may be included. Regular products are always included; supplier-specific products are otherwise hidden.
      */
-    dataOwners?: Array<string>;
-    inclusionCriteria?: CriteriaGroup;
-    exclusionCriteria?: CriteriaGroup;
+    supplierSpecificDataOwners?: Array<string> | null;
+    inclusionCriteria?: CriteriaGroup | null;
+    exclusionCriteria?: CriteriaGroup | null;
     /**
      * When true, product table data matching is performed per row instead of against the entire data set.
      */
-    tableRowMatching?: boolean;
-    categoryInclusionCriteria?: CategoryCriteria;
-    categoryExclusionCriteria?: CategoryCriteria;
-    explicitProductFilter?: ExplicitProductFilter;
+    tableRowMatching?: boolean | null;
+    categoryInclusionCriteria?: CategoryCriteria | null;
+    categoryExclusionCriteria?: CategoryCriteria | null;
+    explicitProductFilter?: ExplicitProductFilter | null;
+    /**
+     * When true, single-product lookups (Detail, Preview, and PDF) ignore the publisher and application filters (country availability, spare-part tree, these filters, and app-specific settings), matching v1 behaviour. When null or false, the product is returned only when it passes all filters.
+     */
+    disableStrictDetailFiltering?: boolean | null;
 };
 
 /**
@@ -162,11 +166,11 @@ declare type ApplicationUseSettings = {
     /**
      * Disable application use check. When set to true the default logic for Application Use and Application Use Type user fields is ignored.
      */
-    disable?: boolean;
+    disable?: boolean | null;
     /**
      * List of exception cids
      */
-    exceptionCids?: Array<string>;
+    exceptionCids?: Array<string> | null;
 };
 
 /**
@@ -176,19 +180,19 @@ export declare type AppSettings = {
     /**
      * ISO country code used to filter products by Country Market Availability. Only product instances available for the designated country will be returned.
      */
-    countryCode?: string;
-    treeType?: CategoryTreeTypeEnum;
+    countryCode?: string | null;
+    treeType?: CategoryTreeTypeEnum | null;
     /**
      * Controls whether internal-only data visible to ABB users is included. Requires application-level authorization.
      */
-    includeInternalData?: boolean;
-    aliases?: AliasSettings;
-    filters?: ApplicationFilters;
-    appSpecific?: AppSpecificSettings;
+    includeInternalData?: boolean | null;
+    aliases?: AliasSettings | null;
+    filters?: ApplicationFilters | null;
+    appSpecific?: AppSpecificSettings | null;
     /**
      * AGM (Attribute Group Management) predefined list code. When provided, search results are pre-filtered to show only attributes and values defined in the specified AGM list.
      */
-    agmListCode?: string;
+    agmListCode?: string | null;
     /**
      * Application code identifying the front-end application. Products are filtered by their Publishers attribute to match this code. Required.
      */
@@ -196,7 +200,7 @@ export declare type AppSettings = {
     /**
      * ISO language code for translations of labels, attribute names, and values. Defaults to "en" (English).
      */
-    langCode?: string;
+    langCode?: string | null;
 };
 
 /**
@@ -206,27 +210,27 @@ declare type AppSpecificSettings = {
     /**
      * When true, removes the leading "ABB" prefix from attribute display names in the response.
      */
-    genericizeAttName?: boolean;
+    genericizeAttName?: boolean | null;
     /**
      * Sales Unit Organization code. Enables Local Order Code search and display for the specified sales unit.
      */
-    salesUnitCode?: string;
+    salesUnitCode?: string | null;
     /**
      * When true, returns all available replacement products. When false, only replacements for obsolete or inactive products are returned. Applicable only in the Search method.
      */
-    allReplacements?: boolean;
+    allReplacements?: boolean | null;
     /**
      * Sales unit codes for local products. Includes products marked as "Local Product" = "Yes" that are normally hidden from standard search results.
      */
-    sellingUnitForLocalProducts?: Array<string>;
+    sellingUnitForLocalProducts?: Array<string> | null;
     /**
      * Standardization body codes (e.g. "IEC", "UL"). When specified, attributes from non-matching certification agencies are excluded from results.
      */
-    standardizationBody?: Array<string>;
+    standardizationBody?: Array<string> | null;
     /**
      * Customer identities that enable customer-specific product visibility and "product available by customer" features.
      */
-    customers?: Array<Customer>;
+    customers?: Array<Customer> | null;
 };
 
 /**
@@ -255,7 +259,7 @@ export declare type AttributeCriterion = {
     /**
      * Values to match when is . Must be omitted for .
      */
-    values?: Array<CriterionValue>;
+    values?: Array<CriterionValue> | null;
     operator: CriteriaOperationEnum;
 };
 
@@ -278,7 +282,7 @@ declare type AttributeGroup = {
     /**
      * Attribute group spare part supplier code
      */
-    sparePartSupplier?: string;
+    sparePartSupplier?: string | null;
     /**
      * Dictionary of product attributes Key is attribute code
      */
@@ -288,7 +292,7 @@ declare type AttributeGroup = {
     /**
      * Linked relationship
      */
-    relationshipCodes?: Array<string>;
+    relationshipCodes?: Array<string> | null;
 };
 
 /**
@@ -298,11 +302,11 @@ declare type AttributeGroupSearchResult = {
     /**
      * Attribute group items
      */
-    items?: Array<AttributeGroup>;
+    items?: Array<AttributeGroup> | null;
     /**
      * Applied AGM detail page list code.
      */
-    listCode?: string;
+    listCode?: string | null;
 };
 
 /**
@@ -348,17 +352,17 @@ declare type AttributeValue = {
     /**
      * Enumeration value code Populated only for attributes of type Enumeration
      */
-    enumerationValueCode?: string;
+    enumerationValueCode?: string | null;
     /**
      * Parsed attribute value with valid product identifiers marked inside double curly braces "{{ProductId}}". Example: Log / Set incl. 1 pc {{3BSE007949R1}} DSAI 146
      */
-    interactiveText?: string;
-    link?: Link;
+    interactiveText?: string | null;
+    link?: Link | null;
     /**
      * Tool tip.
      */
-    tooltip?: string;
-    rawValue?: CriterionValue;
+    tooltip?: string | null;
+    rawValue?: CriterionValue | null;
 };
 
 /** First value of an attribute on an item. */
@@ -374,15 +378,15 @@ declare type AutocompleteItem = {
     /**
      * Customer-specific alias identifiers for this product.
      */
-    aliases?: Array<string>;
+    aliases?: Array<string> | null;
     /**
      * Replacement products available for this item (e.g. successor or substitute products).
      */
-    replacements?: Array<ProductReplacement>;
+    replacements?: Array<ProductReplacement> | null;
     /**
      * Additional metadata entries attached to this product (e.g. configurator links, ordering info).
      */
-    additionalInfo?: Array<ProductAdditionalInfo>;
+    additionalInfo?: Array<ProductAdditionalInfo> | null;
     /**
      * When true, the product is inactive and navigation to detail/preview should be disabled in the UI.
      */
@@ -390,7 +394,7 @@ declare type AutocompleteItem = {
     /**
      * Product images.
      */
-    images?: Array<PisImage>;
+    images?: Array<PisImage> | null;
     /**
      * Indicates whether the product is published and visible for the current application.
      */
@@ -398,7 +402,7 @@ declare type AutocompleteItem = {
     /**
      * All available PRM relationship identifiers for this product (e.g. accessories, spare parts, replacements).
      */
-    allRelationships?: Array<PrmRelationshipIdentifier>;
+    allRelationships?: Array<PrmRelationshipIdentifier> | null;
     /**
      * Indicates whether variants of the product are available.
      */
@@ -406,19 +410,19 @@ declare type AutocompleteItem = {
     /**
      * List of variant attributes associated with the product item
      */
-    variantAttributes?: Array<Attribute>;
+    variantAttributes?: Array<Attribute> | null;
     /**
      * Customer specific data. Contains information such as Customer system id, customer sales unit, customer id, and restriction status for each customer.
      */
-    customerSpecificData?: Array<CustomerSpecificData>;
+    customerSpecificData?: Array<CustomerSpecificData> | null;
     /**
      * Extended Object Data (EOM) associated with the product. Contains additional metadata and structured information for the product. To retrieve EOM data, must be set to true.
      */
-    extendedObjectData?: Array<EomObject>;
+    extendedObjectData?: Array<EomObject> | null;
     /**
      * Product domain
      */
-    productIdDomain?: string;
+    productIdDomain?: string | null;
     /**
      * Identifies whether product is spare part.
      */
@@ -427,7 +431,7 @@ declare type AutocompleteItem = {
      * Exact Match is true when search text matches any of product identifiers.
      */
     exactMatch: boolean;
-    classifications?: ProductItemClassifications;
+    classifications?: ProductItemClassifications | null;
     /**
      * Product identifier.
      */
@@ -507,6 +511,25 @@ export declare interface BaseOptions {
      * When set to true, loaded translations are cached in SessionStorage
      */
     cacheTranslations?: boolean;
+    /**
+     * When set to true, interactive elements rendered by the components (buttons,
+     * links, form controls, tabs, and other focusable or ARIA-interactive
+     * controls) receive a deterministic `data-test-id` attribute for automated UI
+     * tests. Ids follow `<component-name>[-<hook>]-<kind>[-<n> | ~<data-key>...]`, where
+     * `hook` comes from the element's `ext-*` customization classes or `name`
+     * attribute and each `~<data-key>` is the `productId`, `cid`, `attributeCode`,
+     * or filter value of a data item the element is rendered for. Only ids
+     * without data keys are numbered (`-<n>`) when they repeat. Attribute group
+     * headers, attribute labels, and attribute values are also stamped
+     * (`<component-name>-header~<group code>`,
+     * `<component-name>-attribute-label~<attributeCode>`,
+     * `<component-name>-attribute-value~<attributeCode>`). Catalog previews
+     * reuse the attribute label/value ids; classification node names use
+     * `<component-name>-node-label~<cid>`.
+     * Explicit `data-test-id` values and consumer template content are left
+     * untouched. Defaults to false; no attributes are emitted when disabled.
+     */
+    testMode?: boolean;
     /**
      * Use to handle errors, change error text, or suppress default error messages
      */
@@ -554,7 +577,7 @@ declare type BreadcrumbsSearchResult = {
     /**
      * Ordered list of breadcrumb nodes from root to the current classification level.
      */
-    items?: Array<BreadcrumbItem>;
+    items?: Array<BreadcrumbItem> | null;
 };
 
 declare type CancelJobCommandArgs = {
@@ -569,7 +592,8 @@ export declare interface CardComponentOptions extends BaseComponentOptions {
     card?: boolean;
     /**
      * When true, displays the default icon associated with the component.
-     * Default value is true.
+     * Products search categories, filters, favorite categories, and favorite views default to false;
+     * Catalogs cards default to true.
      */
     icon?: boolean;
     /**
@@ -577,6 +601,12 @@ export declare interface CardComponentOptions extends BaseComponentOptions {
      * Default value is false.
      */
     collapsed?: boolean;
+    /**
+     * When true, removes card, header, and footer backgrounds, borders, and shadows while retaining card spacing and collapse behavior.
+     * List backgrounds are transparent; interactive list states and controls keep their styling.
+     * Has no effect when card is false. Default value is false.
+     */
+    transparent?: boolean;
 }
 
 /**
@@ -705,11 +735,23 @@ export declare interface CatalogAliasesSearchOptions {
     /** Alias filters options. */
     filters?: CatalogAliasFiltersOptions;
     /** Alias search toolbar options. */
-    toolbar?: CatalogSearchToolbarOptions;
+    toolbar?: CatalogAliasesSearchToolbarOptions;
     /** Alias results table options. */
     table?: CatalogAliasesTableOptions;
 }
 
+export declare interface CatalogAliasesSearchToolbarOptions extends BaseComponentOptions {
+    /**
+     *  Page size selection for alias search results, for example [12,24]
+     */
+    pageSizes?: number[];
+    /**
+     * Alias list actions dropdown button (trigger) callbacks. Takes precedence over
+     * `components.search.common.actions.aliasListMenu.buttonTemplate`.
+     */
+    buttonTemplate?: MountPoint<CatalogsAliasesSearchToolbarButtonContext>;
+}
+
 export declare interface CatalogAliasesTableOptions extends BaseComponentOptions {
     /**
      * Table columns configuration
@@ -732,8 +774,9 @@ declare interface CatalogAnyActionCommandArgs {
  * Application context of the request, identifying the calling application and language. Required.
  */
 declare type CatalogAppSettings = {
-    client?: ClientInfo;
-    catalogType?: CatalogTypeEnum;
+    appSpecific?: CatalogAppSpecificSettings | null;
+    aliases?: AliasSettings | null;
+    catalogType?: CatalogTypeEnum | null;
     /**
      * Application code identifying the front-end application. Products are filtered by their Publishers attribute to match this code. Required.
      */
@@ -741,19 +784,17 @@ declare type CatalogAppSettings = {
     /**
      * ISO language code for translations of labels, attribute names, and values. Defaults to "en" (English).
      */
-    langCode?: string;
-    appSpecific?: CatalogAppSpecificSettings;
-    aliases?: AliasSettings;
+    langCode?: string | null;
 };
 
 /**
- * Catalog application specific settings
+ * Catalog-specific feature settings used when listing configured aliases.
  */
 declare type CatalogAppSpecificSettings = {
     /**
      * Enables configured item aliases. When enabled all configured items will have alias view, search and editing features.
      */
-    configuredItemAliasesEnabled?: boolean;
+    configuredItemAliasesEnabled?: boolean | null;
 };
 
 declare interface CatalogCopyActionData {
@@ -787,7 +828,11 @@ declare type CatalogDetail = {
     /**
      * Quantities
      */
-    quantities?: Array<QuantityItem>;
+    quantities?: Array<QuantityItem> | null;
+    /**
+     * Custom fields to store additional information in key value pair format used by front end application
+     */
+    customFields?: Array<CustomFieldItem> | null;
     /**
      * Unique identifier of the catalog, used to reference it in subsequent requests.
      */
@@ -832,7 +877,7 @@ declare interface CatalogExportCommandArgs extends CatalogAnyActionCommandArgs {
 }
 
 /**
- * Price settings
+ * Price export settings.
  */
 declare type CatalogExportPriceSettings = {
     /**
@@ -1156,15 +1201,15 @@ declare type CatalogProductAddItem = {
     /**
      * Description
      */
-    description?: string;
+    description?: string | null;
     /**
      * Customer classification
      */
-    customerClassification?: string;
+    customerClassification?: string | null;
     /**
      * Base product id
      */
-    baseProductId?: string;
+    baseProductId?: string | null;
     /**
      * Quantity
      */
@@ -1176,15 +1221,15 @@ declare type CatalogProductAddItem = {
     /**
      * Store additional information used by front end application
      */
-    store?: string;
+    store?: string | null;
     /**
      * Custom fields to store additional information in key value pair format used by front end application
      */
-    customFields?: Array<CustomFieldItem>;
+    customFields?: Array<CustomFieldItem> | null;
     /**
      * Alternate Product id
      */
-    alternateProductId?: string;
+    alternateProductId?: string | null;
 };
 
 declare interface CatalogProductCopyActionData {
@@ -1219,7 +1264,7 @@ declare type CatalogProductItem = {
     /**
      * List of aliases
      */
-    aliases?: Array<AliasItem>;
+    aliases?: Array<AliasItem> | null;
     /**
      * Specifies whenever product is inactive and navigation for details and preview should be disabled.
      */
@@ -1227,45 +1272,41 @@ declare type CatalogProductItem = {
     /**
      * Catalogs
      */
-    catalogs?: Array<CatalogDetail>;
+    catalogs?: Array<CatalogDetail> | null;
     productType: CatalogProductTypeEnum;
     /**
      * Product images
      */
-    images?: Array<PisImage>;
-    baseProduct?: ProductItem;
+    images?: Array<PisImage> | null;
+    baseProduct?: ProductItem | null;
     /**
      * Customer classification
      */
-    customerClassification?: string;
+    customerClassification?: string | null;
     /**
      * Product modified date In Alias mode, property contains latest DateModified from all product aliases.
      */
-    dateModified?: string;
+    dateModified?: string | null;
     /**
      * Product created date In Alias mode, property contains latest DateCreated from all product aliases.
      */
-    dateCreated?: string;
-    /**
-     * Custom fields to store additional information in key value pair format used by front end application
-     */
-    customFields?: Array<CustomFieldItem>;
+    dateCreated?: string | null;
     /**
      * Specifies whenever product was imported
      */
-    imported?: boolean;
+    imported?: boolean | null;
     /**
      * Import order (whenever product was imported)
      */
-    importOrder?: number;
+    importOrder?: number | null;
     /**
      * Alternate Product id
      */
-    alternateProductId?: string;
+    alternateProductId?: string | null;
     /**
      * Product domain
      */
-    productIdDomain?: string;
+    productIdDomain?: string | null;
     /**
      * Identifies whether product is spare part.
      */
@@ -1274,7 +1315,7 @@ declare type CatalogProductItem = {
      * Exact Match is true when search text matches any of product identifiers.
      */
     exactMatch: boolean;
-    classifications?: ProductItemClassifications;
+    classifications?: ProductItemClassifications | null;
     /**
      * Product identifier.
      */
@@ -1287,6 +1328,20 @@ declare type CatalogProductItem = {
     };
 };
 
+/**
+ * Controls optional data and attributes returned for each product.
+ */
+declare type CatalogProductItemSettings = {
+    /**
+     * Attribute codes to return for each product. Supports wildcard patterns.
+     */
+    attributeCodes?: Array<string> | null;
+    /**
+     * Maximum number of images to return for each product. When omitted or null, no images are returned.
+     */
+    maxProductImages?: number | null;
+};
+
 /**
  * Catalog product search data types enumeration
  *
@@ -1309,11 +1364,11 @@ declare enum CatalogProductSearchDataTypeEnum {
  * Search result
  */
 declare type CatalogProductSearchResult = {
-    productClassifications?: ClassificationsSearchResult;
-    partClassifications?: ClassificationsSearchResult;
-    products?: CatalogProductsSearchResult;
-    filters?: FilterSearchResult;
-    breadcrumbs?: BreadcrumbsSearchResult;
+    productClassifications?: ClassificationsSearchResult | null;
+    partClassifications?: ClassificationsSearchResult | null;
+    products?: CatalogProductsSearchResult | null;
+    filters?: FilterSearchResult | null;
+    breadcrumbs?: BreadcrumbsSearchResult | null;
 };
 
 /**
@@ -1375,7 +1430,7 @@ export declare interface CatalogProductsSearchOptions {
     /** Breadcrumbs component options. */
     breadcrumbs?: BaseComponentOptions;
     /** Selection options. */
-    selection?: SelectionOptions;
+    selection?: SelectionOptions<CatalogsProductsSearchSelectionActionsContext>;
     /** Table sub-view options. */
     table?: CatalogItemsTableOptions;
     /** List sub-view options. */
@@ -1394,7 +1449,7 @@ export declare interface CatalogProductsSearchOptions {
  * Products search result
  */
 declare type CatalogProductsSearchResult = {
-    items?: Array<CatalogProductItem>;
+    items?: Array<CatalogProductItem> | null;
     totalCount: number;
 };
 
@@ -1462,7 +1517,10 @@ export declare interface CatalogProductsSearchTemplateMap {
 export declare interface CatalogProductSwitchOptions {
     /** Views offered by the catalog/product/alias switch. */
     views?: CatalogProductSwitchView[];
-    /** View selected initially. */
+    /**
+     * View selected when the instance initializes without a route `view`. Ignored when
+     * it is not one of `views` or when `init()` receives an explicit route view.
+     */
     defaultView?: CatalogProductSwitchView;
 }
 
@@ -1494,15 +1552,15 @@ declare type CatalogProductUpdateItem = {
     /**
      * Description
      */
-    description?: string;
+    description?: string | null;
     /**
      * Customer classification
      */
-    customerClassification?: string;
+    customerClassification?: string | null;
     /**
      * Base product id
      */
-    baseProductId?: string;
+    baseProductId?: string | null;
     /**
      * Quantity
      */
@@ -1514,15 +1572,15 @@ declare type CatalogProductUpdateItem = {
     /**
      * Store additional information used by front end application
      */
-    store?: string;
+    store?: string | null;
     /**
      * Custom fields to store additional information in key value pair format used by front end application
      */
-    customFields?: Array<CustomFieldItem>;
+    customFields?: Array<CustomFieldItem> | null;
     /**
      * Alternate Product id
      */
-    alternateProductId?: string;
+    alternateProductId?: string | null;
 };
 
 /** Every command name the catalogs domain can dispatch. */
@@ -1920,14 +1978,8 @@ export declare interface CatalogSearchFormOptions extends BaseComponentOptions {
 }
 
 export declare interface CatalogSearchOptions {
-    /**
-     *  Additional attribute codes returned in search
-     */
-    attributeCodes?: string[];
-    /**
-     *  Max product images to fetch.
-     */
-    maxProductImages?: number;
+    /** Controls attributes and images returned for each catalog product. */
+    productItemSettings?: CatalogProductItemSettings;
 }
 
 export declare interface CatalogSearchOptionsRoot {
@@ -1952,7 +2004,7 @@ declare type CatalogSearchResult = {
     /**
      * Catalogs belonging to the requested page. Null or empty when no catalog matches the criteria.
      */
-    items?: Array<CatalogItem>;
+    items?: Array<CatalogItem> | null;
     /**
      * Total number of catalogs matching the criteria, regardless of paging. Use it to calculate the number of pages.
      */
@@ -2409,9 +2461,9 @@ export declare type CatalogsViewType = 'catalogs' | 'products' | 'aliases';
  * extension namespace — the only place `dataInterceptor` code may add fields.
  */
 declare type CatalogsWithCustomDataItems<TResult> = TResult extends {
-    items?: (infer TItem)[];
+    items?: (infer TItem)[] | null;
 } ? Omit<TResult, 'items'> & {
-    items?: (TItem & TemplateItem)[];
+    items?: (TItem & TemplateItem)[] | Extract<TResult['items'], null>;
 } : TResult;
 
 /**
@@ -2447,7 +2499,7 @@ export declare interface CatalogTableColumn {
 }
 
 /**
- * Catalog type global filter. To select All catalog types ignore property or set NULL.
+ * Catalog type global filter. To select all catalog types, omit the property or set it to null.
  *
  * Values:
  * - `Company` — Catalog shared by the whole company and visible to all of its users.
@@ -2475,7 +2527,7 @@ declare interface CategoryGroup {
     hitCount: number;
     nested: boolean;
     items?: CategoryGroup[];
-    breadcrumb?: BreadcrumbItem[];
+    breadcrumb?: BreadcrumbItem[] | null;
 }
 
 /**
@@ -2530,13 +2582,13 @@ declare enum ClassificationAdditionalInfoTypeEnum {
 
 declare interface ClassificationFavorites {
     /**
-     *  Array of selected items.
+     *  Array of favorite items (current favorites, not the selection).
      */
     selectedItems: {
         cid: string;
     }[];
     /**
-     *  Selected items count.
+     *  Favorite items count.
      */
     count: number;
     /**
@@ -2577,9 +2629,8 @@ declare interface ClassificationFavorites {
 
 export declare interface ClassificationFavoritesOptions extends BaseComponentOptions {
     /**
-     * Initial favorite nodes.
-     * When value is an array of string with CIDs passed, the selection is shared across Offering and ProductLine trees.
-     * When value is an array of object, favorites are scoped to trees.
+     * Not read by the runtime. Set initial favorites with the top-level `favoriteNodes` option instead:
+     * a node with `type` is scoped to that tree, a node without `type` matches every configured Offering and ProductLine tab.
      */
     favoriteItems?: {
         cid: string;
@@ -2594,7 +2645,7 @@ declare type ClassificationItem = {
     /**
      * Children classifications
      */
-    children?: Array<ClassificationItem>;
+    children?: Array<ClassificationItem> | null;
     /**
      * Products count
      */
@@ -2610,7 +2661,7 @@ declare type ClassificationItem = {
     /**
      * Classification images.
      */
-    images?: Array<PisImage>;
+    images?: Array<PisImage> | null;
     /**
      * Gets the classification unique identifier for the classification node.
      */
@@ -2622,15 +2673,15 @@ declare type ClassificationItem = {
     /**
      * Gets the level of the classification node within the hierarchy.
      */
-    nodeLevel?: string;
+    nodeLevel?: string | null;
     /**
      * Gets the usage type of the classification node.
      */
-    nodeUse?: string;
+    nodeUse?: string | null;
     /**
      * Classification additional info. List of
      */
-    additionalInfo?: Array<ClassificationAdditionalInfo>;
+    additionalInfo?: Array<ClassificationAdditionalInfo> | null;
 };
 
 /**
@@ -2648,15 +2699,15 @@ declare type ClassificationNode = {
     /**
      * Gets the level of the classification node within the hierarchy.
      */
-    nodeLevel?: string;
+    nodeLevel?: string | null;
     /**
      * Gets the usage type of the classification node.
      */
-    nodeUse?: string;
+    nodeUse?: string | null;
     /**
      * Classification additional info. List of
      */
-    additionalInfo?: Array<ClassificationAdditionalInfo>;
+    additionalInfo?: Array<ClassificationAdditionalInfo> | null;
 };
 
 /**
@@ -2666,7 +2717,7 @@ declare type ClassificationNodesSearchResult = {
     /**
      * Collection of classification nodes matching the query criteria.
      */
-    items?: Array<ClassificationNode>;
+    items?: Array<ClassificationNode> | null;
 };
 
 /** Every command name the classifications domain can dispatch. */
@@ -2696,11 +2747,10 @@ export declare interface ClassificationsAccessor {
  * Application context of the request, identifying the calling application and language. Required.
  */
 declare type ClassificationsBrowserAppSettings = {
-    client?: ClientInfo;
     /**
      * Country code. The Country Market Availability and Country Market Availability Type attribute values associated with a product instance determine the countries where a product will be seen. Filters the results to only the product instances available for the designated Country
      */
-    countryCode?: string;
+    countryCode?: string | null;
     /**
      * Application code identifying the front-end application. Products are filtered by their Publishers attribute to match this code. Required.
      */
@@ -2708,24 +2758,24 @@ declare type ClassificationsBrowserAppSettings = {
     /**
      * ISO language code for translations of labels, attribute names, and values. Defaults to "en" (English).
      */
-    langCode?: string;
-    filters?: ClassificationsBrowserFilters;
+    langCode?: string | null;
+    filters?: ClassificationsBrowserFilters | null;
     /**
      * Product Line Period. Allows the user to select the product line period of the Product Line Tree that will be displayed in the Product Line Tree link.
      */
-    productLinePeriod?: string;
+    productLinePeriod?: string | null;
 };
 
 /**
  * Classifications browser filters
  */
 declare type ClassificationsBrowserFilters = {
-    applicationUse?: ApplicationUseSettings;
+    applicationUse?: ApplicationUseSettings | null;
     /**
      * List of Life Cycle Phase. As a default, the Classifications Browser view shows only nodes with a Life Cycle Phase of Active and Restricted.
      */
-    lifeCyclePhases?: Array<string>;
-    countryMarketAvailability?: CountryMarketAvailabilitySettings;
+    lifeCyclePhases?: Array<string> | null;
+    countryMarketAvailability?: CountryMarketAvailabilitySettings | null;
     lifeCyclePhaseMode?: LifeCyclePhaseModeEnum;
 };
 
@@ -2744,11 +2794,11 @@ declare type ClassificationsBrowserNode = {
     /**
      * English name of the classification node (used as fallback or for reference).
      */
-    enName?: string;
+    enName?: string | null;
     /**
      * Child nodes of this classification in the tree hierarchy.
      */
-    children?: Array<ClassificationsBrowserNode>;
+    children?: Array<ClassificationsBrowserNode> | null;
     /**
      * Indicates whether the search text exactly matches this node's name.
      */
@@ -2763,7 +2813,7 @@ declare type ClassificationsBrowserNode = {
      */
     selectable: boolean;
     productGroup: ProductGroup;
-    reference?: ClassificationsBrowserNodeReference;
+    reference?: ClassificationsBrowserNodeReference | null;
 };
 
 /**
@@ -2773,19 +2823,19 @@ declare type ClassificationsBrowserNodeReference = {
     /**
      * Tree CID from Original CID
      */
-    classificationCode?: string;
+    classificationCode?: string | null;
     /**
      * Original CID
      */
-    cid?: string;
+    cid?: string | null;
     /**
      * CID from parent node
      */
-    refCid?: string;
+    refCid?: string | null;
     /**
      * Path to CID
      */
-    refPath?: string;
+    refPath?: string | null;
 };
 
 /**
@@ -2796,7 +2846,7 @@ declare type ClassificationsBrowserPathNode = {
      * CID of the classification
      */
     cid: string;
-    tree?: ClassificationsBrowserTreeTypeEnum;
+    tree?: ClassificationsBrowserTreeTypeEnum | null;
 };
 
 /**
@@ -2806,19 +2856,19 @@ declare type ClassificationsBrowserSearchResult = {
     /**
      * Collection of classification nodes matching the search criteria.
      */
-    items?: Array<ClassificationsBrowserNode>;
+    items?: Array<ClassificationsBrowserNode> | null;
     /**
      * Collection of currently selected classification nodes for reference.
      */
-    selectedItems?: Array<ClassificationsBrowserNode>;
+    selectedItems?: Array<ClassificationsBrowserNode> | null;
     /**
      * Indicates whether the search results exceeded the configured limit and were truncated.
      */
-    limitExceeded?: boolean;
+    limitExceeded?: boolean | null;
     /**
      * Maximum number of results that can be returned. Results are truncated when this limit is exceeded.
      */
-    limit?: number;
+    limit?: number | null;
 };
 
 export declare type ClassificationsBrowserTabsIconContext = TreeTypeTabTemplateProps<ClassificationsInstance>;
@@ -2956,23 +3006,11 @@ export declare interface ClassificationSearchFormOptions extends BaseComponentOp
     useAutocomplete: boolean;
 }
 
+/**
+ * Tab visibility is configured per tab with `components.browser.tabs.items[].visible`;
+ * Apply/Cancel visibility with `components.browser.actions`.
+ */
 export declare interface ClassificationSearchToolbarOptions extends BaseComponentOptions {
-    /**
-     *  Shows product line tree tab
-     */
-    productLineTreeVisible?: boolean;
-    /**
-     *  Shows favorites tab
-     */
-    favoritesVisible?: boolean;
-    /**
-     *  Shows cancel button
-     */
-    cancelVisible?: boolean;
-    /**
-     *  Shows apply button
-     */
-    applyVisible?: boolean;
     /**
      *  Shows expand favorites link
      */
@@ -3028,9 +3066,8 @@ declare interface ClassificationSelection {
 
 export declare interface ClassificationSelectionOptions extends BaseComponentOptions {
     /**
-     * Initial selected nodes.
-     * When value is an array of string with CIDs passed, the selection is shared across Offering and ProductLine trees.
-     * When value is an array of object, favorites are scoped to trees.
+     * Not read by the runtime. Set the initial selection with the top-level `selectedNodes` option instead:
+     * a node with `type` is scoped to that tree, a node without `type` matches every configured Offering and ProductLine tab.
      */
     selectedItems?: {
         cid: string;
@@ -3243,11 +3280,11 @@ declare type ClassificationsSearchResult = {
     /**
      * Additional metadata for the requested classification node (e.g., description, image).
      */
-    additionalInfo?: Array<ClassificationAdditionalInfo>;
+    additionalInfo?: Array<ClassificationAdditionalInfo> | null;
     /**
      * Collection of classification tree items (child nodes of the requested CID or root).
      */
-    items?: Array<ClassificationItem>;
+    items?: Array<ClassificationItem> | null;
 };
 
 /** A selected classification node, as carried by selection and favorites events. */
@@ -3278,9 +3315,9 @@ declare interface ClassificationsValidatedEvent {
  * extension namespace — the only place `dataInterceptor` code may add fields.
  */
 declare type ClassificationsWithCustomDataItems<TResult> = TResult extends {
-    items?: (infer TItem)[];
+    items?: (infer TItem)[] | null;
 } ? Omit<TResult, 'items'> & {
-    items?: (TItem & TemplateItem)[];
+    items?: (TItem & TemplateItem)[] | Extract<TResult['items'], null>;
 } : TResult;
 
 /** Configuration of a single classification tree-type tab. */
@@ -3327,20 +3364,6 @@ export declare interface ClassificationTreeTypeTabsOptions extends BaseComponent
     items?: ClassificationTabOption[];
 }
 
-/**
- * Client info
- */
-declare type ClientInfo = {
-    /**
-     * End client IP address.
-     */
-    ipAddress?: string;
-    /**
-     * End-client user agent string (browser identifier).
-     */
-    userAgent?: string;
-};
-
 /**
  * A command executed by the instance, as passed to the `commandInterceptor`.
  */
@@ -3385,11 +3408,11 @@ declare type CompareClassificationItem = {
     /**
      * Full breadcrumb path from root to this classification node.
      */
-    breadcrumb?: Array<BreadcrumbItem>;
+    breadcrumb?: Array<BreadcrumbItem> | null;
     /**
      * Children classifications
      */
-    children?: Array<ClassificationItem>;
+    children?: Array<ClassificationItem> | null;
     /**
      * Products count
      */
@@ -3405,7 +3428,7 @@ declare type CompareClassificationItem = {
     /**
      * Classification images.
      */
-    images?: Array<PisImage>;
+    images?: Array<PisImage> | null;
     /**
      * Gets the classification unique identifier for the classification node.
      */
@@ -3417,15 +3440,15 @@ declare type CompareClassificationItem = {
     /**
      * Gets the level of the classification node within the hierarchy.
      */
-    nodeLevel?: string;
+    nodeLevel?: string | null;
     /**
      * Gets the usage type of the classification node.
      */
-    nodeUse?: string;
+    nodeUse?: string | null;
     /**
      * Classification additional info. List of
      */
-    additionalInfo?: Array<ClassificationAdditionalInfo>;
+    additionalInfo?: Array<ClassificationAdditionalInfo> | null;
 };
 
 /** Compare header — unique `selectedCid` + `categories`. */
@@ -3443,11 +3466,8 @@ export declare interface CompareHeaderTemplateProps<TCategory = TemplateItem, TI
 }
 
 export declare interface CompareOptions extends BaseComponentOptions {
-    /**
-     *  Optional, list of attribute codes to include in item data
-     * (not affecting attribute groups, can be used in item templates, replaces default item attributes)
-     */
-    attributeCodes?: string[];
+    /** Controls optional data and attributes returned for each compared product. */
+    productItemSettings?: ProductItemSettings;
     /**
      * v7: view title/header callbacks, shown in the first fixed column.
      * Replaces the v6 `headerTemplate` string template. ctx =
@@ -3519,21 +3539,17 @@ export declare interface CompareOptions extends BaseComponentOptions {
      *  If true, print button is visible (print command must be handled by application)
      */
     printButtonVisible?: boolean;
-    /**
-     *  Max product images to fetch.
-     */
-    maxProductImages?: number;
 }
 
 /**
  * A single product in the comparison result, with its summary data and aligned attribute groups.
  */
 declare type CompareProductDetail = {
-    item?: ProductItem;
+    item?: ProductItem | null;
     /**
      * Attribute groups with values for this product, aligned with the comparison matrix.
      */
-    attributeGroups?: Array<AttributeGroup>;
+    attributeGroups?: Array<AttributeGroup> | null;
 };
 
 /**
@@ -3543,11 +3559,11 @@ declare type CompareResult = {
     /**
      * Classification nodes shared by the compared products, including breadcrumb paths.
      */
-    classifications?: Array<CompareClassificationItem>;
+    classifications?: Array<CompareClassificationItem> | null;
     /**
      * Compared product details with their aligned attribute groups.
      */
-    items?: Array<CompareProductDetail>;
+    items?: Array<CompareProductDetail> | null;
 };
 
 /** `CompareOptions` (products compare + compare-table-data). */
@@ -3625,7 +3641,7 @@ declare type ConfiguratorItemSearchResult = {
     /**
      * Configurator entries with their classification hit counts.
      */
-    items?: Array<ConfiguratorItem>;
+    items?: Array<ConfiguratorItem> | null;
 };
 
 export declare interface ConfiguratorOptions extends BaseComponentOptions {
@@ -3742,7 +3758,7 @@ declare type CountryMarketAvailabilitySettings = {
     /**
      * Disable country market availability check. When set to true the default logic for Country Market Availability and Country Market Availability Type user fields is ignored.
      */
-    disable?: boolean;
+    disable?: boolean | null;
 };
 
 /**
@@ -3797,7 +3813,7 @@ export declare type CriterionValue = {
     /**
      * Multidimensional value header
      */
-    h?: string;
+    h?: string | null;
     /**
      * Value to match. For attribute codes, provide attribute value (wildcards supported: "Value*", "*Value", "*Value*"). For "CID", provide classification node identifiers.
      */
@@ -3805,7 +3821,7 @@ export declare type CriterionValue = {
     /**
      * Multidimensional unit of measure (UOM)
      */
-    u?: string;
+    u?: string | null;
 };
 
 /**
@@ -3833,15 +3849,15 @@ declare type CustomerSpecificData = {
     /**
      * Customer system id
      */
-    systemId?: string;
+    systemId?: string | null;
     /**
      * Customer sales unit
      */
-    salesUnit?: string;
+    salesUnit?: string | null;
     /**
      * Customer id
      */
-    customerId?: string;
+    customerId?: string | null;
     /**
      * Restricted. Indicates whether the product is restricted for the specific customer.
      */
@@ -3939,6 +3955,8 @@ export declare interface DetailsComponentOptions {
 }
 
 export declare interface DetailsDataOptions extends Omit<DetailsOptions, 'actionTemplate'> {
+    /** Controls optional data and attributes returned for the main detail product. */
+    productItemSettings?: ProductItemSettings;
     /** Downloads section options. */
     downloads?: DownloadsOptions;
 }
@@ -3984,11 +4002,7 @@ export declare interface DetailsHeaderOptions extends BaseComponentOptions {
 
 export declare interface DetailsOptions {
     /** Variant behavior for product detail requests. */
-    variants?: VariantSettings;
-    /**
-     * Additional attribute codes to load
-     */
-    attributeCodes?: string[];
+    variants?: DetailsVariantOptions;
     /**
      * v7: detail view action callbacks. Replaces the v6 `actionTemplate` string
      * template. ctx = { instance, item, emit, t }.
@@ -4016,17 +4030,13 @@ export declare interface DetailsOptions {
      *  Product relationships (PRM) options
      */
     relationships?: DetailsRelationshipOptions;
-    /**
-     *  Max product images to fetch.
-     */
-    maxProductImages?: number;
 }
 
 export declare interface DetailsRelationshipOptions {
     /** Applies application-level product filtering to related products. */
     productRelationshipFiltering?: boolean;
-    /** Additional attribute codes returned for related products. */
-    attributeCodes?: string[];
+    /** Controls optional data and attributes returned for each related product. */
+    productItemSettings?: ProductItemSettings;
     /**
      * Number of relationship items displayed in one page
      */
@@ -4087,6 +4097,11 @@ export declare interface DetailsRelationshipOptions {
     };
 }
 
+declare interface DetailsVariantOptions extends VariantSettings {
+    /** Controls optional data and attributes returned for each variant product. */
+    productItemSettings?: ProductItemSettings;
+}
+
 export declare interface DetailsVariantsDropdownOptions extends BaseComponentOptions {
     /** Show product images in dropdown */
     showImages?: boolean;
@@ -4141,7 +4156,7 @@ declare type EomAttribute = {
     /**
      * List of values
      */
-    values?: Array<EomAttributeValue>;
+    values?: Array<EomAttributeValue> | null;
 };
 
 /**
@@ -4151,17 +4166,17 @@ declare type EomAttributeValue = {
     /**
      * Value
      */
-    value?: string;
+    value?: string | null;
     /**
      * Label
      */
-    label?: string;
+    label?: string | null;
     /**
      * Translations Dictionary < LanguageCode, Value >
      */
     translations?: {
         [key: string]: string;
-    };
+    } | null;
 };
 
 /**
@@ -4187,7 +4202,7 @@ declare type EomObject = {
     /**
      * List of attributes
      */
-    attributes?: Array<EomAttribute>;
+    attributes?: Array<EomAttribute> | null;
 };
 
 /**
@@ -4197,7 +4212,7 @@ declare type EomSearchResult = {
     /**
      * List of items
      */
-    items?: Array<EomObject>;
+    items?: Array<EomObject> | null;
 };
 
 /**
@@ -4207,11 +4222,11 @@ declare type ExplicitProductFilter = {
     /**
      * Product identifiers matched against any identifier indexed for a product, including its global ID, commercial aliases, extended product type, EAN, ABB type, alternative product reference, and product ID. A product may match any value in this list; it must still satisfy all other applicable filters. A null or empty list does not restrict results.
      */
-    productIdentifiers?: Array<string>;
+    productIdentifiers?: Array<string> | null;
     /**
      * When true and contains values, matching products are prioritized according to the identifiers' order. This ordering takes precedence over the regular sort field and direction supplied by search methods. When false or null, the regular sort options remain in effect.
      */
-    sortByProductIdentifiers?: boolean;
+    sortByProductIdentifiers?: boolean | null;
 };
 
 export declare interface ExportMenuItem {
@@ -4258,12 +4273,12 @@ declare type FavoriteView = {
     /**
      * Unique identifier of the favorite view.
      */
-    id?: string;
+    id?: string | null;
     /**
      * User-defined code or name for the favorite view.
      */
-    code?: string;
-    data?: FavoriteViewData;
+    code?: string | null;
+    data?: FavoriteViewData | null;
 };
 
 /**
@@ -4272,7 +4287,7 @@ declare type FavoriteView = {
 declare type FavoriteViewData = {
     treeType: CategoryTreeTypeEnum;
     pager: PagerSettings;
-    search: SearchSettings;
+    search: ProductsSearchSettings;
     sort: SortSettings;
 };
 
@@ -4300,7 +4315,7 @@ declare type FavoriteViewsSearchResult = {
     /**
      * Collection of favorite views matching the requested identifiers.
      */
-    items?: Array<FavoriteView>;
+    items?: Array<FavoriteView> | null;
 };
 
 /**
@@ -4340,7 +4355,7 @@ declare type FilterSearchResult = {
     /**
      * Filter metadata items. Values are retrieved separately from a FilterValues endpoint.
      */
-    items?: Array<FilterItem>;
+    items?: Array<FilterItem> | null;
     /**
      * Total number of available filters before optional response limiting.
      */
@@ -4665,7 +4680,7 @@ declare enum JobSortFieldEnum {
 }
 
 /**
- * Ordering applied to the returned jobs. When omitted, the service default ordering is used.
+ * Ordering applied to the returned jobs.
  */
 declare type JobSortSettings = {
     field: JobSortFieldEnum;
@@ -4845,19 +4860,19 @@ declare type Link = {
     /**
      * Product id This value exists only for the Link equals Detail
      */
-    productId?: string;
+    productId?: string | null;
     /**
      * Search text This value exists only for the Link equals Search
      */
-    searchText?: string;
+    searchText?: string | null;
     /**
      * Cid This value exists only for the Link equals Classification
      */
-    cid?: string;
+    cid?: string | null;
     /**
      * Document id This value exists only for the Link equals Document
      */
-    documentId?: string;
+    documentId?: string | null;
     type: LinkTypeEnum;
 };
 
@@ -4881,6 +4896,21 @@ declare enum LinkTypeEnum {
     TECHNICAL_INFORMATION = "TechnicalInformation"
 }
 
+/**
+ * Defines sorting behavior for a single product attribute, including sort direction or a custom value-based ordering.
+ */
+declare type MapSettings = {
+    /**
+     * Attribute code to sort by. MultiDimensional and Translatable attribute types are not supported.
+     */
+    attributeCode: string;
+    direction?: SortDirectionEnum | null;
+    /**
+     * Custom value order for sorting. Products are ranked by the position of their attribute value in this list. When null, alphabetical sorting using is applied instead.
+     */
+    values?: Array<string> | null;
+};
+
 /**
  * Master product
  */
@@ -4906,7 +4936,7 @@ declare type MasterProductSearchResult = {
     /**
      * Master product items. May be null when exceeds the maximum allowed and results cannot be displayed.
      */
-    items?: Array<MasterProduct>;
+    items?: Array<MasterProduct> | null;
     /**
      * Total number of master products matching the criteria. When this value exceeds the maximum threshold and Items is null, the result set is too large to display.
      */
@@ -5016,23 +5046,23 @@ declare type Owner = {
     /**
      * Unique identifier of the owner.
      */
-    id?: string;
+    id?: string | null;
     /**
      * Identifier of the user owning the object. Populated for personal owners.
      */
-    userId?: string;
+    userId?: string | null;
     /**
      * Identifier of the source system the owner originates from.
      */
-    systemId?: string;
+    systemId?: string | null;
     /**
      * Identifier of the customer the owner represents. Populated for company owners.
      */
-    customerId?: string;
+    customerId?: string | null;
     /**
      * Sales unit the owner is assigned to.
      */
-    salesUnit?: string;
+    salesUnit?: string | null;
     type?: OwnerTypeEnum;
 };
 
@@ -5049,7 +5079,7 @@ declare enum OwnerTypeEnum {
 }
 
 /**
- * Pager settings
+ * Page number and page size. Defaults to the first page with the default page size when omitted.
  */
 declare type PagerSettings = {
     /**
@@ -5095,7 +5125,7 @@ declare type PartType = {
     /**
      * Part type name
      */
-    name?: string;
+    name?: string | null;
 };
 
 /**
@@ -5125,7 +5155,7 @@ declare type PartTypesSearchResult = {
     /**
      * Part type entries with their display names and product counts.
      */
-    items?: Array<PartType>;
+    items?: Array<PartType> | null;
 };
 
 export declare const PIS: Pis;
@@ -5559,7 +5589,7 @@ declare type PisImage = {
     /**
      * Specifies whenever served image is "no-image".
      */
-    noImage?: boolean;
+    noImage?: boolean | null;
 };
 
 export declare interface PisInstance<TOptions extends BaseOptions = BaseOptions, TRouteData = Record<string, unknown>, TSelection = ProductSelection> extends BaseInstance {
@@ -5635,8 +5665,15 @@ export declare interface PisInstance<TOptions extends BaseOptions = BaseOptions,
 }
 
 declare interface PisNotification {
+    /**
+     * Auto-dismiss delay in milliseconds. When omitted, non-danger notifications
+     * auto-dismiss after 6000 ms; danger notifications stay until closed. Pass 0
+     * to keep a notification visible until it is closed.
+     */
     dismissAfter?: number | undefined;
+    /** Toast text; may carry safe formatting markup (sanitized at render). */
     message: string;
+    /** Severity; controls styling and the auto-dismiss default. */
     type: NotificationType;
 }
 
@@ -6110,14 +6147,8 @@ export declare interface PreviewOptions extends BaseComponentOptions {
      * template. ctx = { instance, item, emit, t }.
      */
     imageOverlayTemplate?: MountPoint<ProductsPreviewViewImageOverlayContext>;
-    /**
-     * Attribute codes to show, replaces default preview attributes
-     */
-    attributeCodes?: string[];
-    /**
-     *  Max product images to fetch.
-     */
-    maxProductImages?: number;
+    /** Controls optional data and attributes returned for the preview product. */
+    productItemSettings?: ProductItemSettings;
 }
 
 /** `PreviewOptions` (products + catalogs preview). */
@@ -6132,72 +6163,11 @@ declare interface PricingExportOptions {
     customerId?: string;
 }
 
-/**
- * Criteria identifying the source product, relationship, and filter attributes whose values are requested.
- */
-declare type PrmFilterSettings = {
-    /**
-     * Attribute codes for which available relationship filter values are returned. At most 100 codes are accepted.
-     */
-    attributeCodes: Array<string>;
-    /**
-     * Optional PRM relationship code to filter by a specific relationship definition.
-     */
-    relationshipCode?: string;
-    relationshipType: PrmRelationshipTypeEnum;
-    /**
-     * Free-text search applied to related products within the relationship.
-     */
-    searchText?: string;
-    filter?: CriteriaGroup;
-    /**
-     * Product id
-     */
-    productId: string;
-};
-
 declare interface PrmLoadArgs {
-    search: PrmSearchSettings;
+    search: RelationshipSearchSettings;
     pager: PagerSettings;
 }
 
-/**
- * A single PRM relationship definition with its related product data, images, and filter facets.
- */
-declare type PrmRelationship = {
-    /**
-     * Unique code identifying this PRM relationship definition.
-     */
-    code: string;
-    /**
-     * Localized display name of the relationship.
-     */
-    description: string;
-    type: PrmRelationshipTypeEnum;
-    orgType?: PrmRelationshipOrgTypeEnum;
-    /**
-     * Organization code associated with this relationship, if applicable.
-     */
-    orgCode?: string;
-    /**
-     * PisImage identifiers for this relationship. Only populated for relationships.
-     */
-    images?: Array<string>;
-    /**
-     * Custom user-defined fields associated with this relationship.
-     */
-    userFields?: Array<UserField>;
-    /**
-     * Available filter facets for narrowing related products within this relationship.
-     */
-    filters?: Array<FilterItem>;
-    /**
-     * Relationship columns.
-     */
-    columns?: Array<TableColumn>;
-    products?: ProductSearchResult;
-};
-
 /**
  * PRM relationship identifier
  */
@@ -6213,89 +6183,7 @@ declare type PrmRelationshipIdentifier = {
     /**
      * Spare part secondary supplier from the relationship user field code 'SparePartSupplier'.
      */
-    sparePartSupplier?: string;
-};
-
-/**
- * Organization type that owns this relationship, if applicable.
- *
- * Values:
- * - `Sps` — Spare part supplier
- * - `Do` — Data owner
- */
-declare enum PrmRelationshipOrgTypeEnum {
-    SPS = "Sps",
-    DO = "Do"
-}
-
-/**
- * Relationship type (e.g. Accessories, Spare Parts).
- *
- * Values:
- * - `All` — All
- * - `Accessories` — Accessories
- * - `AlternativeSell` — Alternative sell
- * - `ConsistsOf` — Consists of
- * - `CrossSell` — Cross sell
- * - `DeviceTypeCode` — Device type code
- * - `DeviceTypeList` — Device type list
- * - `KitContents` — Kit contents
- * - `SoftwareList` — Software list
- * - `UpSell` — Up sell
- * - `SparePartSelectionList` — Spare part selection list
- * - `SparePartUsedOnList` — Spare part used on list
- * - `SuperCodeBoM` — Super code bom
- * - `WhereUsed` — Where used
- * - `EnhancedSparePartFilters` — Enhanced spare part filters
- * - `Variants` — Product variants
- */
-declare enum PrmRelationshipTypeEnum {
-    ALL = "All",
-    ACCESSORIES = "Accessories",
-    ALTERNATIVE_SELL = "AlternativeSell",
-    CONSISTS_OF = "ConsistsOf",
-    CROSS_SELL = "CrossSell",
-    DEVICE_TYPE_CODE = "DeviceTypeCode",
-    DEVICE_TYPE_LIST = "DeviceTypeList",
-    KIT_CONTENTS = "KitContents",
-    SOFTWARE_LIST = "SoftwareList",
-    UP_SELL = "UpSell",
-    SPARE_PART_SELECTION_LIST = "SparePartSelectionList",
-    SPARE_PART_USED_ON_LIST = "SparePartUsedOnList",
-    SUPER_CODE_BO_M = "SuperCodeBoM",
-    WHERE_USED = "WhereUsed",
-    ENHANCED_SPARE_PART_FILTERS = "EnhancedSparePartFilters",
-    VARIANTS = "Variants"
-}
-
-/**
- * Product relationships (replacements, accessories, spare parts). Populated when DataTypes includes ProductRelationships.
- */
-declare type PrmSearchResult = {
-    /**
-     * List of items
-     */
-    items?: Array<PrmRelationship>;
-};
-
-/**
- * Prm search settings
- */
-declare type PrmSearchSettings = {
-    /**
-     * Optional PRM relationship code to filter by a specific relationship definition.
-     */
-    relationshipCode?: string;
-    relationshipType: PrmRelationshipTypeEnum;
-    /**
-     * Free-text search applied to related products within the relationship.
-     */
-    searchText?: string;
-    filter?: CriteriaGroup;
-    /**
-     * Product id
-     */
-    productId: string;
+    sparePartSupplier?: string | null;
 };
 
 /**
@@ -6306,7 +6194,7 @@ declare type ProductAdditionalInfo = {
     /**
      * Text
      */
-    text?: string;
+    text?: string | null;
 };
 
 /**
@@ -6342,12 +6230,12 @@ declare type ProductAttribute = {
     /**
      * Attribute translated name
      */
-    attributeName?: string;
+    attributeName?: string | null;
     /**
      * Attribute values Only for type
      */
-    values?: Array<AttributeValue>;
-    table?: Table;
+    values?: Array<AttributeValue> | null;
+    table?: Table | null;
     /**
      * Determines if ProductAttribute is internal
      */
@@ -6355,7 +6243,7 @@ declare type ProductAttribute = {
     /**
      * Tool tip
      */
-    tooltip?: string;
+    tooltip?: string | null;
     /**
      * Highlight Indicates if the Product Attribute should be highlighted.
      */
@@ -6371,57 +6259,178 @@ declare type ProductClassificationsSearchResult = {
      */
     items?: {
         [key: string]: Array<Array<BreadcrumbItem>>;
-    };
+    } | null;
 };
 
 /**
  * Composite response from the product Detail endpoint. Contains the data sections requested via DataTypes.
  */
 declare type ProductDetail = {
-    productDetails?: ProductDetailSearchResult;
-    attributeGroups?: AttributeGroupSearchResult;
-    productClassifications?: ProductClassificationsSearchResult;
-    productRelationships?: PrmSearchResult;
-    relatedLinks?: RelatedLinksSearchResult;
-    relatedProducts?: RelatedProductsSearchResult;
-    productVariantsSelector?: ProductVariantsSelectorSearchResult;
-    productVariantsTable?: ProductVariantsTableSearchResult;
-    productVariantsDropdown?: ProductVariantsDropdownSearchResult;
-    extendedObjectData?: EomSearchResult;
-    breadcrumbs?: BreadcrumbsSearchResult;
+    productDetails?: ProductDetailSearchResult | null;
+    attributeGroups?: AttributeGroupSearchResult | null;
+    productClassifications?: ProductClassificationsSearchResult | null;
+    productRelationships?: RelationshipSearchResult | null;
+    relatedLinks?: RelatedLinksSearchResult | null;
+    relatedProducts?: RelatedProductsSearchResult | null;
+    productVariantsSelector?: ProductVariantsSelectorSearchResult | null;
+    productVariantsTable?: ProductVariantsTableSearchResult | null;
+    productVariantsDropdown?: ProductVariantsDropdownSearchResult | null;
+    extendedObjectData?: EomSearchResult | null;
+    breadcrumbs?: BreadcrumbsSearchResult | null;
 };
 
 /**
  * Core product data including attributes, images, and status. Populated when DataTypes includes ProductDetails.
  */
 declare type ProductDetailSearchResult = {
-    item?: ProductItem;
+    item?: ProductItem | null;
 };
 
-declare interface ProductErrorsActionData {
-    errors: ActionInfo[];
-    warnings: ActionInfo[];
+export declare interface ProductDetailsRenderOptions {
+    /** Product id for the detail request. */
+    productId: string;
+    /** Optional classification node id scoping the detail request. */
+    cid?: string;
+    /**
+     * Instance id written into the emitted `instance-id` attributes. Pass the
+     * same id your client bootstrap will `init()`. Default: `pis-ssr`.
+     * (In `template` mode the markup's own attributes are preserved verbatim;
+     * this id is only what the renderer resolves internally and reports back.)
+     */
+    instanceId?: string;
+    /**
+     * Standard products init options (`appSettings`, `components`, `baseUrl`,
+     * `accessToken`, ...). `baseUrl` is required by `init()` validation even in
+     * full-payload mode; server-side fetches additionally need `accessToken`.
+     */
+    options: ProductsOptions;
+    /**
+     * Details components to render, in order. `data` is the tabbed container
+     * (navigation, attribute groups, relationships, variants table,
+     * classifications, related links); the remaining entries are the standalone
+     * sections for ABB-style compositions. Default: header, gallery, data.
+     * Mutually exclusive with `template`.
+     */
+    composition?: ProductDetailsServerComponent[];
+    /**
+     * Consumer-authored partial markup (a .NET partial view, a PHP template
+     * fragment, ...): the renderer keeps every byte of your chrome, finds the
+     * `pis-products-details-*` host tags inside, and injects each component's
+     * server-rendered internals while preserving the tags' attributes and your
+     * static slotted children. Unknown `pis-*` tags pass through untouched as
+     * shells. Mutually exclusive with `composition`.
+     */
+    template?: string;
+    /** Pre-fetched API responses; missing pieces are fetched server-side. */
+    payload?: ProductDetailsRenderPayload;
+    /** Header control for server-side fetches (ignored in full-payload mode). */
+    fetch?: ProductDetailsServerFetch;
+    /** Emit schema.org Product JSON-LD derived from the detail payload. */
+    structuredData?: boolean;
+    /**
+     * Theme stylesheet entry (a `dist/styles/<theme>.css` file name without
+     * extension). Default: `theme-abb`.
+     */
+    theme?: string;
+    /** How long to wait for the data load before failing. Default: 15 s. */
+    timeoutMs?: number;
 }
 
 /**
- * Product group classification of this node (e.g., configurable, standard).
+ * Pre-fetched PIS Web API responses for the render, following the documented
+ * "SSR-Embedded Initial Data" payload contract: full, unmodified API responses
+ * exactly as the Web API would have answered.
  */
-declare type ProductGroup = {
-    status: ProductGroupValidationStatusEnum;
+export declare interface ProductDetailsRenderPayload {
+    /** Full `/v2/Products/Detail` response. */
+    detail?: ProductDetail;
+    /** Full `/v2/Translations` response. */
+    translations?: TranslationItem[];
+}
+
+export declare interface ProductDetailsRenderResult {
     /**
-     * Product group code
+     * Server-rendered `pis-*` markup. In composition mode: the instance wrapper
+     * with the details-router-view and every composed component host tag
+     * carrying fully rendered internals. In template mode: the consumer
+     * template verbatim, with each `pis-products-details-*` host carrying its
+     * rendered internals. Place it where the shells would go; the client
+     * upgrade re-renders the same content in place.
      */
-    code?: string;
+    html: string;
+    /** The instance id the emitted markup carries. */
+    instanceId: string;
+    /** Whether the detail request produced a product item. */
+    found: boolean;
+    head: {
+        /** Product display name derived from `#DisplayName`. */
+        title?: string;
+        /** Meta description derived from `#Description` / `#ShortDescription`. */
+        metaDescription?: string;
+        /** schema.org Product JSON-LD (only with `structuredData: true`). */
+        jsonLd?: Record<string, unknown>;
+    };
+    /** Recommended stylesheet imports for first-paint styling, in load order: theme, `pis.css`, `fonts.css`. */
+    cssImports: string[];
     /**
-     * Product group name
+     * Escaped JSON payloads for the documented one-shot client `httpInterceptor`
+     * hydration (embed as `application/json` script tags).
      */
-    name?: string;
-};
+    embeddedPayload: {
+        detailJson: string;
+        translationsJson: string;
+    };
+}
 
 /**
- * Product group validation status
- *
- * Values:
+ * D10 amendment (plan/25): the deliberate server rendering surface. Everything
+ * in this module runs in a Node ESM server environment; importing it from
+ * browser code is a usage error (the render functions need no DOM, but the
+ * entry exists for server consumers only and is exported under the `node`
+ * condition of `@pisapp/core/server`).
+ */
+/** A details-view component the server renderer can emit. */
+export declare type ProductDetailsServerComponent = 'header' | 'gallery' | 'variants-dropdown' | 'variants-selector' | 'data' | 'actions' | 'classifications' | 'general-information' | 'attribute-groups' | 'relationships' | 'related-links' | 'variants-table';
+
+/**
+ * Controls the server-side PIS Web API fetches when a payload does not cover
+ * them. Per the v2 request rules, a server sets `User-Agent` itself and derives
+ * `X-Forwarded-For` from its trusted incoming connection - never copy an
+ * untrusted forwarding header from an outside request.
+ */
+export declare interface ProductDetailsServerFetch {
+    /**
+     * Extra headers on every PIS Web API request (`User-Agent`,
+     * `X-Forwarded-For`, tenant headers...). The renderer adds `Authorization`,
+     * `Content-Type`, and `Component-Version`.
+     */
+    headers?: Record<string, string>;
+}
+
+declare interface ProductErrorsActionData {
+    errors: ActionInfo[];
+    warnings: ActionInfo[];
+}
+
+/**
+ * Product group classification of this node (e.g., configurable, standard).
+ */
+declare type ProductGroup = {
+    status: ProductGroupValidationStatusEnum;
+    /**
+     * Product group code
+     */
+    code?: string | null;
+    /**
+     * Product group name
+     */
+    name?: string | null;
+};
+
+/**
+ * Product group validation status
+ *
+ * Values:
  * - `NonApplicable` — Non applicable
  * - `Valid` — Valid
  * - `Invalid` — Invalid
@@ -6444,15 +6453,15 @@ declare type ProductItem = {
     /**
      * Customer-specific alias identifiers for this product.
      */
-    aliases?: Array<string>;
+    aliases?: Array<string> | null;
     /**
      * Replacement products available for this item (e.g. successor or substitute products).
      */
-    replacements?: Array<ProductReplacement>;
+    replacements?: Array<ProductReplacement> | null;
     /**
      * Additional metadata entries attached to this product (e.g. configurator links, ordering info).
      */
-    additionalInfo?: Array<ProductAdditionalInfo>;
+    additionalInfo?: Array<ProductAdditionalInfo> | null;
     /**
      * When true, the product is inactive and navigation to detail/preview should be disabled in the UI.
      */
@@ -6460,7 +6469,7 @@ declare type ProductItem = {
     /**
      * Product images.
      */
-    images?: Array<PisImage>;
+    images?: Array<PisImage> | null;
     /**
      * Indicates whether the product is published and visible for the current application.
      */
@@ -6468,7 +6477,7 @@ declare type ProductItem = {
     /**
      * All available PRM relationship identifiers for this product (e.g. accessories, spare parts, replacements).
      */
-    allRelationships?: Array<PrmRelationshipIdentifier>;
+    allRelationships?: Array<PrmRelationshipIdentifier> | null;
     /**
      * Indicates whether variants of the product are available.
      */
@@ -6476,19 +6485,19 @@ declare type ProductItem = {
     /**
      * List of variant attributes associated with the product item
      */
-    variantAttributes?: Array<Attribute>;
+    variantAttributes?: Array<Attribute> | null;
     /**
      * Customer specific data. Contains information such as Customer system id, customer sales unit, customer id, and restriction status for each customer.
      */
-    customerSpecificData?: Array<CustomerSpecificData>;
+    customerSpecificData?: Array<CustomerSpecificData> | null;
     /**
      * Extended Object Data (EOM) associated with the product. Contains additional metadata and structured information for the product. To retrieve EOM data, must be set to true.
      */
-    extendedObjectData?: Array<EomObject>;
+    extendedObjectData?: Array<EomObject> | null;
     /**
      * Product domain
      */
-    productIdDomain?: string;
+    productIdDomain?: string | null;
     /**
      * Identifies whether product is spare part.
      */
@@ -6497,7 +6506,7 @@ declare type ProductItem = {
      * Exact Match is true when search text matches any of product identifiers.
      */
     exactMatch: boolean;
-    classifications?: ProductItemClassifications;
+    classifications?: ProductItemClassifications | null;
     /**
      * Product identifier.
      */
@@ -6517,32 +6526,86 @@ declare type ProductItemClassifications = {
     /**
      * Product Class CID's (PC)
      */
-    classCids?: Array<string>;
+    classCids?: Array<string> | null;
     /**
      * Product Type CID's (T)
      */
-    typeCids?: Array<string>;
+    typeCids?: Array<string> | null;
     /**
      * Product leaf CID's
      */
-    leafCids?: Array<string>;
+    leafCids?: Array<string> | null;
     /**
      * Product Level 0 (ROOT) CID's
      */
-    level0Cids?: Array<string>;
+    level0Cids?: Array<string> | null;
     /**
      * Breadcrumbs. All item classifications with full path. To retrieve Breadcrumbs data, or must be set to true.
      */
     breadcrumbs?: {
         [key: string]: Array<Array<BreadcrumbItem>>;
-    };
+    } | null;
+};
+
+/**
+ * Controls optional data and attributes returned for each product result.
+ */
+export declare type ProductItemSettings = {
+    /**
+     * When true, includes product classification assignments.
+     */
+    includeClassifications?: boolean | null;
+    /**
+     * When true, includes classification breadcrumbs.
+     */
+    includeClassificationBreadcrumbs?: boolean | null;
+    /**
+     * When true, includes identifiers for all product relationships.
+     */
+    includeAllRelationships?: boolean | null;
+    /**
+     * When true, includes metadata describing the product's variant attributes.
+     */
+    includeVariantAttributes?: boolean | null;
+    /**
+     * When true, includes product aliases.
+     */
+    includeAliases?: boolean | null;
+    /**
+     * When true, includes replacement products.
+     */
+    includeReplacements?: boolean | null;
+    /**
+     * When true, includes additional product metadata.
+     */
+    includeAdditionalInfo?: boolean | null;
+    /**
+     * When true, includes customer-specific product data.
+     */
+    includeCustomerSpecificData?: boolean | null;
+    /**
+     * Attribute codes to return for each product. Supports wildcard patterns.
+     */
+    attributeCodes?: Array<string> | null;
+    /**
+     * When true, includes criterion-ready raw values for returned attributes.
+     */
+    includeRawValues?: boolean | null;
+    /**
+     * When true, includes Extended Object Data (EOM) for the product.
+     */
+    includeExtendedObjectData?: boolean | null;
+    /**
+     * Maximum number of images to return for each product. When omitted or null, no images are returned.
+     */
+    maxProductImages?: number | null;
 };
 
 /**
  * Response from the Preview endpoint containing the full product item.
  */
 declare type ProductPreview = {
-    item?: ProductItem;
+    item?: ProductItem | null;
 };
 
 /**
@@ -6553,12 +6616,20 @@ declare type ProductReplacement = {
      * Label
      */
     label: string;
-    link?: Link;
+    link?: Link | null;
 };
 
 /** Every command name the products domain can dispatch. */
 declare const PRODUCTS_COMMAND_NAMES: readonly ["filter-search", "details", "preview", "scroll-to-top", "document", "configurator", "back", "search-view", "sub-view", "filter-classification", "filter-parts-type", "filter-master-product", "paginate", "page-size", "sort-by", "filter-parametric-apply", "filter-parametric-remove", "get-filters", "get-filter-values", "get-variant-table-group", "get-autocomplete", "get-prm-list", "get-prm-autocomplete", "get-prm-filter-values", "export", "favorite-views-load", "favorite-views-save", "favorite-views-delete", "favorite-views-apply", "get-classifications-nodes", "favorite-category-add", "favorite-category-remove", "print-to-pdf", "show-print-view", "notification-show", "notification-hide", "filter-compare", "remove-compare-item", "show-compare-print-view", "product-action-completed", "add-to-catalog", "product-errors-action", "catalog-get-options", "catalogs-fetch", "catalog-create-new", "product-add-to-catalog"];
 
+export declare const PRODUCTS_HTTP_ROUTES: {
+    readonly search: '/v2/Products/Search';
+    readonly count: '/v2/Products/Count';
+    readonly detail: '/v2/Products/Detail';
+    readonly variantsTable: '/v2/Products/Variants/Table';
+    readonly translations: '/v2/Translations';
+};
+
 /** Internal (non-swagger) data types the products domain can register. */
 declare const PRODUCTS_INTERNAL_DATA_TYPES: {
     readonly ProductPreview: "ProductPreview";
@@ -6600,7 +6671,7 @@ export declare interface ProductsCommandArgs {
     /** Search input form submitted. */
     'filter-search': {
         searchText: string;
-        searchType: SearchTypeEnum;
+        searchType: ProductsSearchTypeEnum;
         resetCategories?: boolean;
         resetFilters?: boolean;
         cid?: string;
@@ -6686,7 +6757,7 @@ export declare interface ProductsCommandArgs {
     /** PRM autocomplete load. */
     'get-prm-autocomplete': PrmLoadArgs;
     /** PRM filter values load. */
-    'get-prm-filter-values': PrmFilterSettings;
+    'get-prm-filter-values': RelationshipFilterSettings;
     /** Search results export action triggered. */
     export: ExportMenuItem;
     /** Favorite views load. */
@@ -6790,7 +6861,7 @@ export declare interface ProductsCompareRouteData {
      *  FirstFound - first product detail template is used.
      *  Flat - attribute grouping is not applied.
      */
-    mergeMethod?: AttributeMergeMethodEnum;
+    mergeMethod?: `${AttributeMergeMethodEnum}`;
     /**
      *  If true, only attribute values that are present on the product detail page AGM template are shown. If attribute is not present on the AGM template, N/A is displayed.
      *  If false, all attribute values that exist in the product data are shown.
@@ -6848,13 +6919,13 @@ declare const ProductsDataType: {
     readonly RelatedProducts: "RelatedProducts";
     readonly ProductCompare: "ProductCompare";
     readonly ProductIdToName: "ProductIdToName";
-    readonly Classifications: SearchDataTypeEnum.CLASSIFICATIONS;
-    readonly Products: SearchDataTypeEnum.PRODUCTS;
-    readonly Filters: SearchDataTypeEnum.FILTERS;
-    readonly Breadcrumbs: SearchDataTypeEnum.BREADCRUMBS;
-    readonly Configurators: SearchDataTypeEnum.CONFIGURATORS;
-    readonly MasterProducts: SearchDataTypeEnum.MASTER_PRODUCTS;
-    readonly PartTypes: SearchDataTypeEnum.PART_TYPES;
+    readonly Classifications: ProductsSearchDataTypeEnum.CLASSIFICATIONS;
+    readonly Products: ProductsSearchDataTypeEnum.PRODUCTS;
+    readonly Filters: ProductsSearchDataTypeEnum.FILTERS;
+    readonly Breadcrumbs: ProductsSearchDataTypeEnum.BREADCRUMBS;
+    readonly Configurators: ProductsSearchDataTypeEnum.CONFIGURATORS;
+    readonly MasterProducts: ProductsSearchDataTypeEnum.MASTER_PRODUCTS;
+    readonly PartTypes: ProductsSearchDataTypeEnum.PART_TYPES;
     readonly ProductDetails: DetailDataTypeEnum.PRODUCT_DETAILS;
     readonly ProductClassifications: DetailDataTypeEnum.PRODUCT_CLASSIFICATIONS;
     readonly AttributeGroups: DetailDataTypeEnum.ATTRIBUTE_GROUPS;
@@ -6866,7 +6937,7 @@ declare const ProductsDataType: {
     readonly ExtendedObjectData: DetailDataTypeEnum.EXTENDED_OBJECT_DATA;
 };
 
-declare type ProductsDataType = DetailDataTypeEnum | SearchDataTypeEnum | ProductsInternalDataType;
+declare type ProductsDataType = DetailDataTypeEnum | ProductsSearchDataTypeEnum | ProductsInternalDataType;
 
 export declare interface ProductsDetailRouteData {
     /**
@@ -6945,10 +7016,10 @@ export declare type ProductsDetailsVariantsTableHeaderContext = HeaderTemplatePr
 export declare type ProductsDetailsVariantsTableHeaderProps = TemplateProps<'products.details.variantsTable.header'>;
 
 /**
- * Products search result
+ * Related product search result.
  */
 declare type ProductSearchResult = {
-    items?: Array<ProductItem>;
+    items?: Array<ProductItem> | null;
     totalCount: number;
 };
 
@@ -7018,7 +7089,7 @@ declare interface ProductsEventMap {
      * this event contains the complete search response; item rows may carry
      * `customData` fields added by `dataInterceptor`.
      */
-    'search-loaded': SearchResult;
+    'search-loaded': ProductsSearchResult;
     /**
      * Triggered after search query results have been fetched and the search
      * state has changed (for example filters, pager, or search text). No
@@ -7140,7 +7211,7 @@ declare interface ProductsLoadEventPayloads {
     ProductDetails: ProductsWithCustomDataItems<ProductDetailSearchResult>;
     ProductClassifications: ProductsWithCustomDataItems<ProductClassificationsSearchResult>;
     AttributeGroups: ProductsWithCustomDataItems<AttributeGroupSearchResult>;
-    ProductRelationships: ProductsWithCustomDataItems<PrmSearchResult>;
+    ProductRelationships: ProductsWithCustomDataItems<RelationshipSearchResult>;
     Configurators: ProductsWithCustomDataItems<ConfiguratorItemSearchResult>;
     RelatedLinks: ProductsWithCustomDataItems<RelatedLinksSearchResult>;
     ProductPreview: ProductsWithCustomDataItems<ProductPreview>;
@@ -7266,6 +7337,28 @@ export declare type ProductsSearchCommonConfiguratorsActionContext = Configurato
 
 export declare type ProductsSearchCommonConfiguratorsActionProps = TemplateProps<'products.search.common.configurators.action'>;
 
+/**
+ * Specifies which data sections to include in a v2 product search response. Multiple values can be combined.
+ *
+ * Values:
+ * - `Classifications` — Classification tree nodes matching the search criteria.
+ * - `Products` — Product instances matching the search criteria.
+ * - `Filters` — Available filter facets (attribute values) for the current result set.
+ * - `Breadcrumbs` — Breadcrumb trail from the root to the current classification node.
+ * - `Configurators` — Configurator items and configurator hit counts in the classification tree.
+ * - `MasterProducts` — Master products for spare-part narrowing. Available only in the Parts view.
+ * - `PartTypes` — Available spare-part type facets for the current result set.
+ */
+declare enum ProductsSearchDataTypeEnum {
+    CLASSIFICATIONS = "Classifications",
+    PRODUCTS = "Products",
+    FILTERS = "Filters",
+    BREADCRUMBS = "Breadcrumbs",
+    CONFIGURATORS = "Configurators",
+    MASTER_PRODUCTS = "MasterProducts",
+    PART_TYPES = "PartTypes"
+}
+
 export declare type ProductsSearchFormAutocompleteItemContext = ItemLightTemplateProps<Item<AutocompleteModelItem>, ProductsInstance>;
 
 export declare type ProductsSearchFormAutocompleteItemProps = TemplateProps<'products.search.form.autocompleteItem'>;
@@ -7326,6 +7419,19 @@ export declare type ProductsSearchPaginationPaginationContext = PaginationTempla
 
 export declare type ProductsSearchPaginationPaginationProps = TemplateProps<'products.search.pagination.pagination'>;
 
+/**
+ * Composite response returned by the v2 product Search endpoint.
+ */
+declare type ProductsSearchResult = {
+    classifications?: ClassificationsSearchResult | null;
+    products?: ProductSearchResult | null;
+    filters?: FilterSearchResult | null;
+    breadcrumbs?: BreadcrumbsSearchResult | null;
+    configurators?: ConfiguratorItemSearchResult | null;
+    masterProducts?: MasterProductSearchResult | null;
+    partTypes?: PartTypesSearchResult | null;
+};
+
 export declare interface ProductsSearchRouteData {
     /**
      *  Search phrase. No default: an empty value stays empty.
@@ -7334,7 +7440,7 @@ export declare interface ProductsSearchRouteData {
     /**
      *  Search method/type. Filled from the default route when empty.
      */
-    searchType: SearchTypeEnum;
+    searchType: ProductsSearchTypeEnum;
     /**
      *  Category filter. No default: an empty value stays empty.
      */
@@ -7377,6 +7483,27 @@ export declare type ProductsSearchSelectionActionsContext = SelectionActionsTemp
 
 export declare type ProductsSearchSelectionActionsProps = TemplateProps<'products.search.selection.actions'>;
 
+/**
+ * Search and filter settings saved in this favorite view.
+ */
+declare type ProductsSearchSettings = {
+    /**
+     * Classification node identifier (CID) to scope the search to a specific tree branch.
+     */
+    cid?: string | null;
+    partType: PartTypeEnum;
+    /**
+     * Master product id. Used to narrow down search results to products related to the specified master product.
+     */
+    masterProductId?: string | null;
+    filter?: CriteriaGroup | null;
+    /**
+     * Free-text search term used to match products by name, description, or attribute values.
+     */
+    searchText?: string | null;
+    searchType: ProductsSearchTypeEnum;
+};
+
 export declare type ProductsSearchTableCellContext = TableCellTemplateProps<Item<ProductItem>, ProductsInstance>;
 
 export declare type ProductsSearchTableCellProps = TemplateProps<'products.search.table.cell'>;
@@ -7405,6 +7532,24 @@ export declare type ProductsSearchToolbarCustomActionsContext = ActionsBaseTempl
 
 export declare type ProductsSearchToolbarCustomActionsProps = TemplateProps<'products.search.toolbar.customActions'>;
 
+/**
+ * Text matching strategy applied to .
+ *
+ * Values:
+ * - `WithAllWords` — All words in the search term must appear in the result.
+ * - `WithAtLeastOneWord` — At least one word in the search term must appear in the result.
+ * - `ExactPhrase` — The search term is matched as an exact phrase.
+ * - `SparePartMasterIdentifier` — Search by spare-part master identifier. Only available in the Parts view.
+ * - `Hierarchical` — Cascading search: tries ExactPhrase first, then WithAllWords, then WithAtLeastOneWord.
+ */
+export declare enum ProductsSearchTypeEnum {
+    WITH_ALL_WORDS = "WithAllWords",
+    WITH_AT_LEAST_ONE_WORD = "WithAtLeastOneWord",
+    EXACT_PHRASE = "ExactPhrase",
+    SPARE_PART_MASTER_IDENTIFIER = "SparePartMasterIdentifier",
+    HIERARCHICAL = "Hierarchical"
+}
+
 export declare interface ProductsTableColumn {
     /**
      * Table header caption
@@ -7481,9 +7626,9 @@ export declare type ProductsViewType = 'search' | 'detail' | 'compare';
  * extension namespace — the only place `dataInterceptor` code may add fields.
  */
 declare type ProductsWithCustomDataItems<TResult> = TResult extends {
-    items?: (infer TItem)[];
+    items?: (infer TItem)[] | null;
 } ? Omit<TResult, 'items'> & {
-    items?: (TItem & TemplateItem)[];
+    items?: (TItem & TemplateItem)[] | Extract<TResult['items'], null>;
 } : TResult;
 
 declare type ProductTreeType = TreeTypeEnum;
@@ -7526,11 +7671,11 @@ declare type ProductVariantGroup = {
     /**
      * Variant attributes that are dependent on this attribute.
      */
-    variantAttributes?: Array<ProductVariantGroupAttribute>;
+    variantAttributes?: Array<ProductVariantGroupAttribute> | null;
     /**
      * Products matching this variant group.
      */
-    products?: Array<ProductItem>;
+    products?: Array<ProductItem> | null;
 };
 
 /**
@@ -7554,7 +7699,7 @@ declare type ProductVariantsDropdownSearchResult = {
     /**
      * List of items
      */
-    items?: Array<ProductVariantGroup>;
+    items?: Array<ProductVariantGroup> | null;
 };
 
 /**
@@ -7564,7 +7709,7 @@ declare type ProductVariantsSelectorSearchResult = {
     /**
      * List of items
      */
-    items?: Array<ProductVariantAttribute>;
+    items?: Array<ProductVariantAttribute> | null;
 };
 
 /**
@@ -7574,7 +7719,7 @@ declare type ProductVariantsTableSearchResult = {
     /**
      * List of product variant groups.
      */
-    items?: Array<ProductVariantGroup>;
+    items?: Array<ProductVariantGroup> | null;
 };
 
 /**
@@ -7593,7 +7738,7 @@ declare type ProductVariantValue = {
      * Indicates whether the product variant value matches the specified criteria.
      */
     match: boolean;
-    product?: ProductItem;
+    product?: ProductItem | null;
 };
 
 export declare type PublicSelection = ProductSelection;
@@ -7623,11 +7768,11 @@ declare type QuantityItem = {
     /**
      * Store
      */
-    store?: string;
+    store?: string | null;
     /**
      * Configuration ids
      */
-    configurationIds?: Array<ConfigurationId>;
+    configurationIds?: Array<ConfigurationId> | null;
     /**
      * Quantity modified date
      */
@@ -7653,15 +7798,15 @@ declare type RelatedLink = {
     /**
      * Related link text
      */
-    text?: string;
+    text?: string | null;
     /**
      * Related link url
      */
-    url?: string;
+    url?: string | null;
     /**
      * Related link image
      */
-    image?: string;
+    image?: string | null;
     /**
      * Is related link internal
      */
@@ -7682,7 +7827,7 @@ declare type RelatedLinksSearchResult = {
     /**
      * List of items
      */
-    items?: Array<RelatedLink>;
+    items?: Array<RelatedLink> | null;
 };
 
 /**
@@ -7692,15 +7837,15 @@ declare type RelatedProduct = {
     /**
      * Parent product condition. 'PartType' attribute value.
      */
-    condition?: string;
+    condition?: string | null;
     /**
      * Related product id
      */
-    productId?: string;
+    productId?: string | null;
     /**
      * Related product global commercial alias
      */
-    gloComAli?: string;
+    gloComAli?: string | null;
 };
 
 /**
@@ -7710,11 +7855,48 @@ declare type RelatedProductsSearchResult = {
     /**
      * Current product condition. First 'PartType' attribute value.
      */
-    condition?: string;
+    condition?: string | null;
     /**
      * List of items
      */
-    items?: Array<RelatedProduct>;
+    items?: Array<RelatedProduct> | null;
+};
+
+/**
+ * A v2 relationship definition with related product data, images, and optional filter facets.
+ */
+declare type Relationship = {
+    /**
+     * Unique code identifying this relationship definition.
+     */
+    code: string;
+    /**
+     * Localized display name of the relationship definition.
+     */
+    description: string;
+    type: RelationshipTypeEnum;
+    orgType?: RelationshipOrgTypeEnum | null;
+    /**
+     * Organization code associated with this relationship, if applicable.
+     */
+    orgCode?: string | null;
+    /**
+     * PisImage identifiers for this relationship. Only populated for relationships.
+     */
+    images?: Array<string> | null;
+    /**
+     * Custom user-defined fields associated with this relationship.
+     */
+    userFields?: Array<UserField> | null;
+    /**
+     * Available filter facets for narrowing related products within this relationship.
+     */
+    filters?: Array<FilterItem> | null;
+    /**
+     * Relationship columns.
+     */
+    columns?: Array<TableColumn> | null;
+    products?: ProductSearchResult | null;
 };
 
 /** v7 relationship action-column cell — extends the table cell with `relationship` + `row`. */
@@ -7757,6 +7939,114 @@ export declare interface RelationshipActionTemplates {
  */
 export declare type RelationshipDisplayMode = 'table' | 'list';
 
+/**
+ * Criteria identifying the source product, relationship, and filter attributes whose values are requested.
+ */
+declare type RelationshipFilterSettings = {
+    /**
+     * Attribute codes for which available relationship filter values are returned. At most 100 codes are accepted.
+     */
+    attributeCodes: Array<string>;
+    /**
+     * Optional relationship code to filter by a specific relationship definition.
+     */
+    relationshipCode?: string | null;
+    relationshipType: RelationshipTypeEnum;
+    /**
+     * Free-text search applied to related products within the relationship.
+     */
+    searchText?: string | null;
+    filter?: CriteriaGroup | null;
+    /**
+     * Product id
+     */
+    productId: string;
+};
+
+/**
+ * Organization type that owns this relationship, if applicable.
+ *
+ * Values:
+ * - `Sps` — Spare part supplier
+ * - `Do` — Data owner
+ */
+declare enum RelationshipOrgTypeEnum {
+    SPS = "Sps",
+    DO = "Do"
+}
+
+/**
+ * Product relationships (replacements, accessories, spare parts). Populated when DataTypes includes ProductRelationships.
+ */
+declare type RelationshipSearchResult = {
+    /**
+     * Relationship definitions and their related product results.
+     */
+    items?: Array<Relationship> | null;
+};
+
+/**
+ * Relationship search criteria used to identify the source relationship and search text.
+ */
+declare type RelationshipSearchSettings = {
+    /**
+     * Optional relationship code to filter by a specific relationship definition.
+     */
+    relationshipCode?: string | null;
+    relationshipType: RelationshipTypeEnum;
+    /**
+     * Free-text search applied to related products within the relationship.
+     */
+    searchText?: string | null;
+    filter?: CriteriaGroup | null;
+    /**
+     * Product id
+     */
+    productId: string;
+};
+
+/**
+ * Relationship type (e.g. Accessories, Spare Parts).
+ *
+ * Values:
+ * - `All` — All
+ * - `Accessories` — Accessories
+ * - `AlternativeSell` — Alternative sell
+ * - `ConsistsOf` — Consists of
+ * - `CrossSell` — Cross sell
+ * - `DeviceTypeCode` — Device type code
+ * - `DeviceTypeList` — Device type list
+ * - `KitContents` — Kit contents
+ * - `SoftwareList` — Software list
+ * - `UpSell` — Up sell
+ * - `SparePartSelectionList` — Spare part selection list
+ * - `SparePartUsedOnList` — Spare part used on list
+ * - `SuperCodeBoM` — Super code bom
+ * - `WhereUsed` — Where used
+ * - `EnhancedSparePartFilters` — Enhanced spare part filters
+ * - `Variants` — Product variants
+ */
+declare enum RelationshipTypeEnum {
+    ALL = "All",
+    ACCESSORIES = "Accessories",
+    ALTERNATIVE_SELL = "AlternativeSell",
+    CONSISTS_OF = "ConsistsOf",
+    CROSS_SELL = "CrossSell",
+    DEVICE_TYPE_CODE = "DeviceTypeCode",
+    DEVICE_TYPE_LIST = "DeviceTypeList",
+    KIT_CONTENTS = "KitContents",
+    SOFTWARE_LIST = "SoftwareList",
+    UP_SELL = "UpSell",
+    SPARE_PART_SELECTION_LIST = "SparePartSelectionList",
+    SPARE_PART_USED_ON_LIST = "SparePartUsedOnList",
+    SUPER_CODE_BO_M = "SuperCodeBoM",
+    WHERE_USED = "WhereUsed",
+    ENHANCED_SPARE_PART_FILTERS = "EnhancedSparePartFilters",
+    VARIANTS = "Variants"
+}
+
+export declare function renderProductDetails(options: ProductDetailsRenderOptions): Promise<ProductDetailsRenderResult>;
+
 /**
  * Recursively optional patch shape of a route-data read type.
  *
@@ -7815,7 +8105,7 @@ export declare interface SearchComponentOptions {
     /** Favorite categories options. */
     favoriteCategories?: FavoriteCategoriesOptions;
     /** Selection options. */
-    selection?: SelectionOptions;
+    selection?: SelectionOptions<ProductsSearchSelectionActionsContext>;
     /** Table sub-view options. */
     table?: ItemsTableOptions;
     /** List sub-view options. */
@@ -7828,28 +8118,6 @@ export declare interface SearchComponentOptions {
     noResults?: BaseComponentOptions;
 }
 
-/**
- * Specifies which data sections to include in a product search response. Multiple values can be combined.
- *
- * Values:
- * - `Classifications` — Classification tree nodes matching the search criteria.
- * - `Products` — Product instances matching the search criteria.
- * - `Filters` — Available filter facets (attribute values) for the current result set.
- * - `Breadcrumbs` — Breadcrumb trail from the root to the current classification node.
- * - `Configurators` — Configurator items and configurator hit counts in the classification tree.
- * - `MasterProducts` — Master products for spare-part narrowing via SearchSettings.MasterProductId. Available only in the Parts view.
- * - `PartTypes` — Available spare-part type facets for the current result set.
- */
-declare enum SearchDataTypeEnum {
-    CLASSIFICATIONS = "Classifications",
-    PRODUCTS = "Products",
-    FILTERS = "Filters",
-    BREADCRUMBS = "Breadcrumbs",
-    CONFIGURATORS = "Configurators",
-    MASTER_PRODUCTS = "MasterProducts",
-    PART_TYPES = "PartTypes"
-}
-
 declare interface SearchFavoriteViewsAppliedData {
     routeData: ProductsRouteData;
 }
@@ -7942,26 +8210,14 @@ export declare type SearchNarrowByProductOptions = CardComponentOptions;
 export declare interface SearchOptions {
     /** Variant behavior shared by product search, autocomplete, counts, and filters. */
     variants?: VariantSettings;
-    /**
-     *  Additional attribute codes returned in search
-     */
-    attributeCodes?: string[];
-    /**
-     *  Max product images to fetch.
-     */
-    maxProductImages?: number;
+    /** Attribute value ordering applied to product search requests. */
+    sortMap?: SortMapSettings;
+    /** Controls optional data and attributes returned for each product result. */
+    productItemSettings?: ProductItemSettings;
     /**
      *  Max category images to fetch.
      */
     maxCategoryImages?: number;
-    /**
-     * Include product classifications in search results
-     */
-    includeProductClassifications?: boolean;
-    /**
-     * Include Extended Object Data (EOM) in search results.
-     * */
-    includeExtendedObjectData?: boolean;
 }
 
 export declare interface SearchPaginationOptions extends BaseComponentOptions {
@@ -7988,40 +8244,6 @@ declare interface SearchProductsCommandArgs {
     resetFilters?: boolean;
 }
 
-/**
- * Composite response returned by the product Search endpoint. Contains the data sections requested via DataTypes.
- */
-declare type SearchResult = {
-    classifications?: ClassificationsSearchResult;
-    products?: ProductSearchResult;
-    filters?: FilterSearchResult;
-    breadcrumbs?: BreadcrumbsSearchResult;
-    configurators?: ConfiguratorItemSearchResult;
-    masterProducts?: MasterProductSearchResult;
-    partTypes?: PartTypesSearchResult;
-};
-
-/**
- * Search and filter settings saved in this favorite view.
- */
-declare type SearchSettings = {
-    /**
-     * Classification node identifier (CID) to scope the search to a specific tree branch.
-     */
-    cid?: string;
-    partType: PartTypeEnum;
-    /**
-     * Master product id. Used to narrow down search results to products related to the specified master product.
-     */
-    masterProductId?: string;
-    filter?: CriteriaGroup;
-    /**
-     * Free-text search term used to match products by name, description, or attribute values.
-     */
-    searchText?: string;
-    searchType: SearchTypeEnum;
-};
-
 export declare interface SearchToolbarComponentOptions extends SearchToolbarOptions {
     /** Export actions rendered by the search toolbar. */
     exportMenu?: ExportMenuOptions;
@@ -8059,24 +8281,6 @@ export declare interface SearchToolbarOptions extends BaseComponentOptions {
     subViewsVisible?: boolean;
 }
 
-/**
- * Text matching strategy applied to .
- *
- * Values:
- * - `WithAllWords` — All words in the search term must appear in the result.
- * - `WithAtLeastOneWord` — At least one word in the search term must appear in the result.
- * - `ExactPhrase` — The search term is matched as an exact phrase.
- * - `SparePartMasterIdentifier` — Search by spare-part master identifier. Only available in the Parts view.
- * - `Hierarchical` — Cascading search: tries ExactPhrase first, then WithAllWords, then WithAtLeastOneWord.
- */
-export declare enum SearchTypeEnum {
-    WITH_ALL_WORDS = "WithAllWords",
-    WITH_AT_LEAST_ONE_WORD = "WithAtLeastOneWord",
-    EXACT_PHRASE = "ExactPhrase",
-    SPARE_PART_MASTER_IDENTIFIER = "SparePartMasterIdentifier",
-    HIERARCHICAL = "Hierarchical"
-}
-
 /** Selection actions — the only surface with NO emit and NO item. */
 export declare interface SelectionActionsTemplateProps<TInstance extends TemplateInstance = TemplateInstance> {
     /** The domain instance, e.g. ctx.instance.eventBus or ctx.instance.execute(command). */
@@ -8102,7 +8306,7 @@ declare interface SelectionChanged<T = {
     selected: T[];
 }
 
-export declare interface SelectionOptions extends BaseComponentOptions {
+export declare interface SelectionOptions<TContext extends object = SelectionActionsTemplateProps> extends BaseComponentOptions {
     /**
      * If true, selection is persisted, and not cleared on component navigation
      */
@@ -8123,7 +8327,7 @@ export declare interface SelectionOptions extends BaseComponentOptions {
      * v7: custom actions callbacks. Replaces the v6 `actionsTemplate` string
      * template. ctx = { instance, t } (no emit).
      */
-    actionsTemplate?: MountPoint<SelectionActionsTemplateProps>;
+    actionsTemplate?: MountPoint<TContext>;
 }
 
 /** `SelectionOptions` (products + catalogs selection). */
@@ -8155,6 +8359,16 @@ export declare enum SortFieldEnum {
     RELEVANCE = "Relevance"
 }
 
+/**
+ * Attribute-based sort mappings for the query.
+ */
+declare type SortMapSettings = {
+    /**
+     * Ordered list of attribute sort mappings. Each entry defines sorting behavior for a specific product attribute.
+     */
+    map?: Array<MapSettings> | null;
+};
+
 /**
  * Sort settings saved in this favorite view.
  */
@@ -8315,7 +8529,7 @@ declare type TableRow = {
      */
     values?: {
         [key: string]: Array<TableValue>;
-    };
+    } | null;
 };
 
 /**
@@ -8325,12 +8539,12 @@ declare type TableValue = {
     /**
      * Text
      */
-    text?: string;
+    text?: string | null;
     /**
      * Tool tip
      */
-    tooltip?: string;
-    link?: Link;
+    tooltip?: string | null;
+    link?: Link | null;
 };
 
 /**
@@ -8485,11 +8699,11 @@ declare type UserField = {
     /**
      * Name of the user field
      */
-    name?: string;
+    name?: string | null;
     /**
      * Values of the user field
      */
-    values?: Array<string>;
+    values?: Array<string> | null;
 };
 
 /**
@@ -8513,11 +8727,7 @@ export declare type VariantSettings = {
     /**
      * When set to true, similar product variants are collapsed into a single result.
      */
-    clustering?: boolean;
-    /**
-     * Additional attribute codes to return for variant products. Wildcard patterns are supported.
-     */
-    attributeCodes?: Array<string>;
+    clustering?: boolean | null;
 };
 
 /** Variants-table cell — has `group`, NO `emit`, NO `attrValues`. */