@sapui5/ts-types 1.115.0 → 1.115.1

package/types/sap.fe.core.d.ts

@@ -39,7 +39,7 @@ declare namespace sap {
         }
 
         /**
-         * @SINCE 1.90.0
+         * @since 1.90.0
          *
          * A controller extension offering hooks into the edit flow of the application
          */
@@ -47,7 +47,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Submit the current set of changes and navigate back.
            *
@@ -60,7 +60,7 @@ declare namespace sap {
             oContext: sap.ui.model.odata.v4.Context
           ): Promise<void>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Discard the editable document.
            *
@@ -86,7 +86,7 @@ declare namespace sap {
             }
           ): Promise<any>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Creates a new document.
            *
@@ -126,7 +126,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Deletes the document.
            *
@@ -152,7 +152,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Creates a draft document for an existing active document.
            *
@@ -165,7 +165,7 @@ declare namespace sap {
             oContext: sap.ui.model.odata.v4.Context
           ): Promise<void>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Invokes an action (bound or unbound) and tracks the changes so that other pages can be refreshed and
            * show the updated data upon navigation.
@@ -228,7 +228,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.98.0
+           * @since 1.98.0
            *
            * This function can be used to intercept the 'Create' action. You can execute custom coding in this function.
            * The framework waits for the returned promise to be resolved before continuing the 'Create' action.
@@ -256,7 +256,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.98.0
+           * @since 1.98.0
            *
            * This function can be used to intercept the 'Delete' action. You can execute custom coding in this function.
            * The framework waits for the returned promise to be resolved before continuing the 'Delete' action.
@@ -280,7 +280,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.98.0
+           * @since 1.98.0
            *
            * This function can be used to intercept the 'Discard' action. You can execute custom coding in this function.
            * The framework waits for the returned promise to be resolved before continuing the 'Discard' action.
@@ -304,7 +304,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.98.0
+           * @since 1.98.0
            *
            * This function can be used to intercept the 'Edit' action. You can execute custom coding in this function.
            * The framework waits for the returned promise to be resolved before continuing the 'Edit' action.
@@ -328,7 +328,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * This function can be used to intercept the 'Save' action. You can execute custom coding in this function.
            * The framework waits for the returned promise to be resolved before continuing the 'Save' action.
@@ -352,7 +352,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Saves a new document after checking it.
            *
@@ -365,7 +365,7 @@ declare namespace sap {
             oContext: sap.ui.model.odata.v4.Context
           ): Promise<void>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Secured execution of the given function. Ensures that the function is only executed when certain conditions
            * are fulfilled.
@@ -405,7 +405,7 @@ declare namespace sap {
             }
           ): Promise<void>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Updates the draft status and displays the error messages if there are errors during an update.
            *
@@ -424,7 +424,7 @@ declare namespace sap {
           ): Promise<void>;
         }
         /**
-         * @SINCE 1.86.0
+         * @since 1.86.0
          *
          * Controller extension providing hooks for intent-based navigation
          */
@@ -433,7 +433,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.86.0
+           * @since 1.86.0
            *
            * Provides a hook to customize the {@link sap.fe.navigation.SelectionVariant} related to the intent-based
            * navigation.
@@ -442,7 +442,7 @@ declare namespace sap {
             /**
              * SelectionVariant provided by SAP Fiori elements.
              */
-            _oSelectionVariant: /* was: sap.fe.navigation.SelectionVariant */ any,
+            _oSelectionVariant: sap.fe.navigation.SelectionVariant,
             /**
              * Object containing intent-based navigation-related info
              */
@@ -458,7 +458,7 @@ declare namespace sap {
             }
           ): void;
           /**
-           * @SINCE 1.86.0
+           * @since 1.86.0
            *
            * Navigates to an intent defined by an outbound definition in the manifest.
            */
@@ -480,8 +480,8 @@ declare namespace sap {
           ): void;
         }
         /**
-         * @SINCE 1.90.0
-         * @EXPERIMENTAL (since 1.90.0)
+         * @since 1.90.0
+         * @experimental (since 1.90.0)
          *
          * A controller extension offering message handling.
          */
@@ -489,8 +489,8 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.90.0
-           * @EXPERIMENTAL (since 1.90.0)
+           * @since 1.90.0
+           * @experimental (since 1.90.0)
            *
            * Shows a message dialog with transition messages if there are any.
            * The message dialog is shown as a modal dialog. Once the user confirms the dialog, all transition messages
@@ -506,7 +506,7 @@ declare namespace sap {
           showMessageDialog(): Promise<void>;
         }
         /**
-         * @SINCE 1.94.0
+         * @since 1.94.0
          *
          * Controller extension providing hooks for the navigation using paginators
          */
@@ -514,7 +514,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.94.0
+           * @since 1.94.0
            *
            * Initiates the paginator control.
            */
@@ -529,7 +529,7 @@ declare namespace sap {
             oContext?: sap.ui.model.odata.v4.Context
           ): void;
           /**
-           * @SINCE 1.94.0
+           * @since 1.94.0
            *
            * Returns the updated context after the paginator operation.
            */
@@ -541,7 +541,7 @@ declare namespace sap {
           ): void;
         }
         /**
-         * @SINCE 1.86.0
+         * @since 1.86.0
          *
          * A controller extension offering hooks into the routing flow of the application
          */
@@ -549,7 +549,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * Allows navigation to a specific context.
            */
@@ -575,7 +575,7 @@ declare namespace sap {
             oParameters?: any
           ): Promise<boolean>;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * This function is used to intercept the routing event after binding a page.
            * If it is declared as an extension, it allows you to intercept and change the normal flow of binding.
@@ -590,7 +590,7 @@ declare namespace sap {
             oContext: object
           ): void;
           /**
-           * @SINCE 1.90.0
+           * @since 1.90.0
            *
            * This function is used to intercept the routing event before binding a page.
            * If it is declared as an extension, it allows you to intercept and change the normal flow of binding.
@@ -605,7 +605,7 @@ declare namespace sap {
             oContext: object
           ): void;
           /**
-           * @SINCE 1.86.0
+           * @since 1.86.0
            *
            * This function can be used to intercept the routing event happening during the normal process of navigating
            * from one page to another (like clicking on the table row to navigate, or when pagination buttons are
@@ -636,7 +636,7 @@ declare namespace sap {
           ): boolean;
         }
         /**
-         * @SINCE 1.86.0
+         * @since 1.86.0
          *
          * A controller extension offering hooks into the routing flow of the application
          */
@@ -644,7 +644,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @SINCE 1.93.0
+           * @since 1.93.0
            *
            * Adapts the metadata used while sharing the page URL via 'Send Email', 'Share in SAP Jam', and 'Save as
            * Tile'.
@@ -719,7 +719,7 @@ declare namespace sap {
             }
           ): Promise<object> | object;
           /**
-           * @SINCE 1.93.0
+           * @since 1.93.0
            *
            * Opens the share sheet.
            */
@@ -731,7 +731,7 @@ declare namespace sap {
           ): void;
         }
         /**
-         * @SINCE 1.85.0
+         * @since 1.85.0
          *
          * A controller extension offering hooks for state handling
          * If you need to maintain a specific state for your application, you can use the controller extension.
@@ -740,7 +740,7 @@ declare namespace sap {
           constructor();
 
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * This function should add all controls relevant for refreshing to the provided control array.
            * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
@@ -753,7 +753,7 @@ declare namespace sap {
             aCollectedControls: sap.ui.base.ManagedObject[]
           ): void;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Customize the `refreshBinding` function for a certain control.
            * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
@@ -770,7 +770,7 @@ declare namespace sap {
             oControlHandler: any[]
           ): void;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Customize the `retrieve` and `apply` functions for a certain control.
            * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
@@ -787,7 +787,7 @@ declare namespace sap {
             aControlHandler: object[]
           ): void;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * This function should add all controls for given view that should be considered for the state handling
            * to the provided control array.
@@ -801,7 +801,7 @@ declare namespace sap {
             aCollectedControls: sap.ui.base.ManagedObject[]
           ): void;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Applying additional, not control related, states - is called only if navigation type is iAppState.
            * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
@@ -818,7 +818,7 @@ declare namespace sap {
             aPromises: Promise<any>
           ): void;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Defines whether the view state should only be applied once initially.
            * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
@@ -833,7 +833,7 @@ declare namespace sap {
            */
           applyInitialStateOnly(): boolean;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Apply navigation parameters is not called if the navigation type is iAppState
            * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
@@ -882,7 +882,7 @@ declare namespace sap {
             oNavParameter: sap.fe.core.controllerextensions.ViewState.NavigationParameter
           ): Promise<any>;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Hook to react when state for given view was applied.
            * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
@@ -895,7 +895,7 @@ declare namespace sap {
             aPromises: Promise<any>
           ): void;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Hook to react before a state for given view is applied.
            * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
@@ -920,7 +920,7 @@ declare namespace sap {
            */
           onSuspend(): void;
           /**
-           * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * Extend the map of additional states (not control bound) to be added to the current view state of the
            * given view.
@@ -948,8 +948,8 @@ declare namespace sap {
        */
       namespace fpm {
         /**
-         * @SINCE 1.92.0
-         * @EXPERIMENTAL (since 1.92.0)
+         * @since 1.92.0
+         * @experimental (since 1.92.0)
          *
          * Component that can be used as a wrapper component for custom pages.
          * The component can be used in case you want to use SAP Fiori elements Building Blocks or XML template
@@ -982,7 +982,7 @@ declare namespace sap {
 
       namespace rootView {
         /**
-         * @SINCE 1.110.0
+         * @since 1.110.0
          *
          * Base controller class for your own root view with an sap.f.FlexibleColumnLayout control.
          * By using or extending this controller, you can use your own root view with the sap.fe.core.AppComponent
@@ -1001,7 +1001,7 @@ declare namespace sap {
           displayErrorPage(): Promise<boolean>;
         }
         /**
-         * @SINCE 1.108.0
+         * @since 1.108.0
          *
          * Base controller class for your own root view with a sap.m.NavContainer control.
          * By using or extending this controller you can use your own root view with the sap.fe.core.AppComponent
@@ -1068,7 +1068,7 @@ declare namespace sap {
         initializeFeatureToggles(): Promise<void>;
       }
       /**
-       * @SINCE 1.90.0
+       * @since 1.90.0
        *
        * Internal base controller class for SAP Fiori elements application.
        * If you want to extend a base controller for your custom page, please use for sap.fe.core.PageController.
@@ -1077,7 +1077,7 @@ declare namespace sap {
         constructor();
 
         /**
-         * @SINCE 1.91.0
+         * @since 1.91.0
          *
          * Returns the current app component.
          *
@@ -1113,7 +1113,7 @@ declare namespace sap {
         ): sap.ui.core.mvc.View;
       }
       /**
-       * @SINCE 1.79.0
+       * @since 1.79.0
        *
        * Common Extension API for all pages of SAP Fiori elements for OData V4.
        * To correctly integrate your app extension coding with SAP Fiori elements, use only the extensionAPI of
@@ -1190,11 +1190,11 @@ declare namespace sap {
             /**
              * The contextPath to be used for the templating process
              */
-            contextPath: string;
+            contextPath?: string;
             /**
              * The controller to be attached to the fragment
              */
-            controller: object;
+            controller?: object;
             /**
              * The ID of the fragment itself
              */
@@ -1202,7 +1202,7 @@ declare namespace sap {
             /**
              * The initial binding context
              */
-            initialBindingContext: sap.ui.model.Context;
+            initialBindingContext?: sap.ui.model.Context;
             /**
              * The name of the fragment to be loaded
              */
@@ -1240,7 +1240,7 @@ declare namespace sap {
         updateAppState(): Promise<object | void>;
       }
       /**
-       * @SINCE 1.88.0
+       * @since 1.88.0
        *
        * Base controller class for your custom page used inside an SAP Fiori elements application.
        * This controller provides preconfigured extensions that will ensure you have the basic functionalities
@@ -1257,7 +1257,7 @@ declare namespace sap {
         getExtensionAPI(): sap.fe.core.ExtensionAPI;
       }
       /**
-       * @SINCE 1.86.0
+       * @since 1.86.0
        *
        * Possible initial load (first app startup) modes for a ListReport.
        */

package/types/sap.fe.macros.d.ts

@@ -648,19 +648,19 @@ declare namespace sap {
           | `{${string}}`;
       }
 
-      interface $ChartSelectionChangeEventParameters {}
+      interface Chart$SelectionChangeEventParameters {}
 
-      interface $FieldChangeEventParameters {}
+      interface Field$ChangeEventParameters {}
 
-      interface $FilterBarAfterClearEventParameters {}
+      interface FilterBar$AfterClearEventParameters {}
 
-      interface $FilterBarFilterChangedEventParameters {}
+      interface FilterBar$FilterChangedEventParameters {}
 
-      interface $FilterBarSearchEventParameters {}
+      interface FilterBar$SearchEventParameters {}
 
-      interface $TableRowPressEventParameters {}
+      interface Table$RowPressEventParameters {}
 
-      interface $TableSelectionChangeEventParameters {}
+      interface Table$SelectionChangeEventParameters {}
 
       /**
        * Base API control for building blocks.
@@ -827,7 +827,7 @@ declare namespace sap {
         constructor();
       }
       /**
-       * @SINCE 1.90.0
+       * @since 1.90.0
        *
        * Building block used to create a form element based on the metadata provided by OData V4.
        */
@@ -835,7 +835,7 @@ declare namespace sap {
         constructor();
       }
       /**
-       * @SINCE 1.93.0
+       * @since 1.93.0
        *
        * Building block used to create a MicroChart based on the metadata provided by OData V4.
        */
@@ -843,7 +843,7 @@ declare namespace sap {
         constructor();
       }
       /**
-       * @SINCE 1.94.0
+       * @since 1.94.0
        *
        * Building block used to create a paginator control.
        * Usage example:
@@ -1013,6 +1013,62 @@ declare namespace sap {
          */
         showMessages: boolean;
       };
+
+      /**
+       * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'Chart$SelectionChangeEventParameters'
+       * in 1.115.1 and any later releases.
+       */
+      type $ChartSelectionChangeEventParameters = sap.fe.macros.Chart$SelectionChangeEventParameters;
+
+      type Chart$SelectionChangeEvent = sap.ui.base.Event<Chart$SelectionChangeEventParameters>;
+
+      /**
+       * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'Field$ChangeEventParameters'
+       * in 1.115.1 and any later releases.
+       */
+      type $FieldChangeEventParameters = sap.fe.macros.Field$ChangeEventParameters;
+
+      type Field$ChangeEvent = sap.ui.base.Event<Field$ChangeEventParameters>;
+
+      /**
+       * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'FilterBar$AfterClearEventParameters'
+       * in 1.115.1 and any later releases.
+       */
+      type $FilterBarAfterClearEventParameters = sap.fe.macros.FilterBar$AfterClearEventParameters;
+
+      type FilterBar$AfterClearEvent = sap.ui.base.Event<FilterBar$AfterClearEventParameters>;
+
+      /**
+       * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'FilterBar$FilterChangedEventParameters'
+       * in 1.115.1 and any later releases.
+       */
+      type $FilterBarFilterChangedEventParameters = sap.fe.macros.FilterBar$FilterChangedEventParameters;
+
+      type FilterBar$FilterChangedEvent = sap.ui.base.Event<FilterBar$FilterChangedEventParameters>;
+
+      /**
+       * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'FilterBar$SearchEventParameters'
+       * in 1.115.1 and any later releases.
+       */
+      type $FilterBarSearchEventParameters = sap.fe.macros.FilterBar$SearchEventParameters;
+
+      type FilterBar$SearchEvent = sap.ui.base.Event<FilterBar$SearchEventParameters>;
+
+      /**
+       * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'Table$RowPressEventParameters'
+       * in 1.115.1 and any later releases.
+       */
+      type $TableRowPressEventParameters = sap.fe.macros.Table$RowPressEventParameters;
+
+      type Table$RowPressEvent = sap.ui.base.Event<Table$RowPressEventParameters>;
+
+      /**
+       * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'Table$SelectionChangeEventParameters'
+       * in 1.115.1 and any later releases.
+       */
+      type $TableSelectionChangeEventParameters = sap.fe.macros.Table$SelectionChangeEventParameters;
+
+      type Table$SelectionChangeEvent = sap.ui.base.Event<Table$SelectionChangeEventParameters>;
     }
   }
 

package/types/sap.fe.navigation.d.ts

@@ -7,7 +7,7 @@ declare namespace sap {
      */
     namespace navigation {
       /**
-       * @SINCE 1.83.0
+       * @since 1.83.0
        *
        * This is the successor of {@link sap.ui.generic.app.navigation.service.NavError}.
        *  An object that provides error handling information during runtime.
@@ -31,7 +31,7 @@ declare namespace sap {
         getErrorCode(): string;
       }
       /**
-       * @SINCE 1.83.0
+       * @since 1.83.0
        *
        * This is the successor of {@link sap.ui.generic.app.navigation.service.NavigationHandler}.
        *  Creates a new NavigationHandler class by providing the required environment.
@@ -65,7 +65,7 @@ declare namespace sap {
         constructor();
 
         /**
-         * @PROTECTED - DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
          * The method creates a context url based on provided data. This context url can either be used as
          * {@link sap.fe.navigation.NavigationHandler#setParameterContextUrl ParameterContextUrl} or
@@ -456,7 +456,7 @@ declare namespace sap {
         ): object;
       }
       /**
-       * @SINCE 1.83.0
+       * @since 1.83.0
        *
        * This is the successor of {@link sap.ui.generic.app.navigation.service.PresentationVariant}.
        *  Creates a new instance of a PresentationVariant class. If no parameter is passed, an new empty instance
@@ -592,7 +592,7 @@ declare namespace sap {
         toJSONString(): string;
       }
       /**
-       * @SINCE 1.83.0
+       * @since 1.83.0
        */
       class SelectionVariant extends sap.ui.base.Object {
         constructor();

package/types/sap.fe.placeholder.d.ts

@@ -0,0 +1,3 @@
+// For Library Version: 1.115.1
+
+declare namespace sap {}

package/types/sap.fe.templates.d.ts

@@ -8,14 +8,14 @@ declare namespace sap {
     namespace templates {
       namespace ListReport {
         /**
-         * @SINCE 1.79.0
+         * @since 1.79.0
          *
          * Extension API for list reports in SAP Fiori elements for OData V4.
          * To correctly integrate your app extension coding with SAP Fiori elements, use only the extensionAPI of
          * SAP Fiori elements. Don't access or manipulate controls, properties, models, or other internal objects
          * created by the SAP Fiori elements framework.
          */
-        class ExtensionAPI /* was: sap.fe.core.ExtensionAPI */ extends Object {
+        class ExtensionAPI extends sap.fe.core.ExtensionAPI {
           constructor();
 
           /**
@@ -103,8 +103,7 @@ declare namespace sap {
         /**
          * Controller class for the list report page, used inside an SAP Fiori elements application.
          */
-        class ListReportController
-          /* was: sap.fe.core.PageController */ extends Object {
+        class ListReportController extends sap.fe.core.PageController {
           constructor();
 
           /**
@@ -162,14 +161,14 @@ declare namespace sap {
 
       namespace ObjectPage {
         /**
-         * @SINCE 1.79.0
+         * @since 1.79.0
          *
          * Extension API for object pages on SAP Fiori elements for OData V4.
          * To correctly integrate your app extension coding with SAP Fiori elements, use only the extensionAPI of
          * SAP Fiori elements. Don't access or manipulate controls, properties, models, or other internal objects
          * created by the SAP Fiori elements framework.
          */
-        class ExtensionAPI /* was: sap.fe.core.ExtensionAPI */ extends Object {
+        class ExtensionAPI extends sap.fe.core.ExtensionAPI {
           constructor();
 
           /**