@sassoftware/vi-api 1.7.1 → 1.9.0

package/alert-reps/index.d.ts

@@ -1,6 +1,6 @@
 /* tslint:disable */
 /* eslint-disable */
-// Generated using typescript-generator version 2.15.527 on 2023-01-24 10:52:40.
+// Generated using typescript-generator version 2.15.527 on 2023-07-07 09:34:28.
 
 export interface ActionRequestRep {
     version?: number;

package/alert-reps/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@types/alert-reps",
-  "version": "15.3.20",
+  "version": "16.0.12",
   "types": "index.d.ts"
 }

package/config/config-api.d.ts

@@ -14,6 +14,7 @@ export interface SolutionExtension extends ControlMetadata {
     metadata?: SolutionExtensionMetadata;
     resolvedDisplayName?: string;
     resolvedDescription?: string;
+    clientApplication?: string;
     name: string;
 }
 export interface SolutionExtensionConfigTypeAttributes {

package/control/control-api.d.ts

@@ -166,6 +166,21 @@ export interface ControlStateApi {
      * True if the control is hidden, otherwise false.
      */
     readonly hidden: boolean;
+    /**
+     * Returns the masked state of the calling control.
+     * True if the control is masked, otherwise false.
+     */
+    readonly masked: boolean;
+    /**
+     * Returns the authorization state of a masked field of the calling control.
+     * True if the control is masked, otherwise false.
+     */
+    readonly authorizedToUnmask: boolean;
+    /**
+     * Returns the disabled state of the calling control.
+     * True if the control is disabled, otherwise false.
+     */
+    readonly disabled: boolean;
     /**
      * Registers a function to be invoked whenever a state change event occurs.
      * This function receives an object that contains information about the change event.

package/control/restrictions.d.ts

@@ -1,4 +1,4 @@
-import { FieldType } from "./data-types";
+import { FieldType, NumberDataType } from "./data-types";
 export interface RequirableRestriction {
     required: boolean;
 }
@@ -16,6 +16,10 @@ export interface NumericRestrictions extends FieldRestrictions {
     scale?: number;
     precision?: number;
 }
+export interface NumberRestrictions extends FieldRestrictions {
+    fieldDataType: NumberDataType;
+    precision?: number;
+}
 export interface ReferenceDataRestrictions extends FieldRestrictions {
     constrainingListName: string;
     cascadingReferenceDataName?: string;

package/event/event-api.d.ts

@@ -16,7 +16,9 @@ export declare enum PageEvents {
     SelectNodeEvent = "spb::selectNode",
     UpdateSubDocumentTypeEvent = "spb::updateSubDocumentType",
     TabSelectedEvent = "spb::tabSelected",
-    VisitAllTabs = "spb::mark-all-tabs-visited"
+    VisitAllTabs = "spb::mark-all-tabs-visited",
+    MaskToggleEvent = "spb::mask-toggle",
+    MaskAllEvent = "spb::mask-all"
 }
 export interface Subscription {
     unsubscribe(): void;

package/event/event-api.js

@@ -18,6 +18,8 @@ export var PageEvents;
     PageEvents["UpdateSubDocumentTypeEvent"] = "spb::updateSubDocumentType";
     PageEvents["TabSelectedEvent"] = "spb::tabSelected";
     PageEvents["VisitAllTabs"] = "spb::mark-all-tabs-visited";
+    PageEvents["MaskToggleEvent"] = "spb::mask-toggle";
+    PageEvents["MaskAllEvent"] = "spb::mask-all";
 })(PageEvents || (PageEvents = {}));
 /**
  * Callback function executed when subscription is triggered by an event.

package/index.d.ts

@@ -20,6 +20,7 @@ import { SheetApi } from "./sheet/sheet-api";
 import { TabApi } from "./tab/tab-api";
 import { ThemeApi } from "./theme/theme-api";
 import { TraversalApi } from "./traversal/traversal-api";
+import { ShellTabsApi } from "./shell-tabs/shell-tabs-api";
 /**
  * Common API Functions.
  */
@@ -41,6 +42,7 @@ export interface SviCommonApi {
     theme: ThemeApi;
     traversal: TraversalApi;
     config: ConfigApi;
+    shellTabs: ShellTabsApi;
 }
 /**
  * The Client API.

package/metadata/metadata-api.d.ts

@@ -1,3 +1,4 @@
+import { IIdentityOption } from "@sas/nexus-shared-ui/identities/input";
 import { CoreStoredObjectField, Entity, Relationship, RelationshipDTO, StoredObjectDTO } from "../svi-datahub";
 export interface NodeShapeMultipliers {
     square: number;
@@ -28,8 +29,8 @@ export interface SandDataObject extends DataObject {
 }
 export interface DataObject extends PersistableObject {
     name: string;
-    dataStoreName: string;
-    tableName: string;
+    dataStoreName?: string;
+    tableName?: string;
     deleteTableName?: string;
     readOnly: boolean;
     archived: boolean;
@@ -78,6 +79,8 @@ export interface DataObjectField extends PersistableObject, LocalizableObject {
     cascadingReferenceDataName?: string;
     cascadingReferenceDataFilterByCode?: string;
     cascadingReferenceDataFilterByField?: string;
+    masked?: boolean;
+    authorizedToRevealMasked?: IIdentityOption[];
     [index: string]: any;
 }
 export interface LocalizableObject {

package/object/object-api.d.ts

@@ -1,4 +1,4 @@
-import { Relationship, StoredObjectFieldDTO, Comment } from "../svi-datahub";
+import { Comment, Relationship, StoredObjectFieldDTO } from "../svi-datahub";
 import { FileOperation } from "../file/file-api";
 import { PageModel } from "../page-model/page-model-api";
 import { ClientSheet, Sheet } from "../sheet/sheet-api";
@@ -84,6 +84,19 @@ export interface ObjectApi {
      * @return A Promise that resolves to the updated object when the object has successfully been updated.
      */
     updateObject(objectType: string, objectId: string, objectTypeId: number, objectTypeVersion: number, fieldValues: FieldValues, options?: UpdateObjectOptions): Promise<VIObject>;
+    /**
+     * @method
+     * @description Updates an existing object with the provided data.
+     * @param objectType {string} Object type.
+     * @param objectId {string} Object ID.
+     * @param objectTypeId {number} Object type ID.
+     * @param objectTypeVersion {number} Object type version.
+     * @param originalFieldValues {FieldValues} Field values before the object was edited
+     * @param newFieldValues {FieldValues} Field values after the object was edited
+     * @param [options] {UpdateObjectOptions} Optional extra parameters.
+     * @return A Promise that resolves to the updated object when the object has successfully been updated.
+     */
+    patchObject(objectType: string, objectId: string, objectTypeId: number, objectTypeVersion: number, originalFieldValues: FieldValues, newFieldValues: FieldValues, options?: UpdateObjectOptions): Promise<VIObject>;
     /**
      * @method
      * @description Deletes an object.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sassoftware/vi-api",
-  "version": "1.7.1",
+  "version": "1.9.0",
   "description": "Types used in the SAS Visual Investigator API",
   "keywords": [
     "SAS",

package/page-state/page-state-api.d.ts

@@ -1,31 +1,4 @@
-import { Template, StoredObjectDTO } from "../svi-datahub";
-/**
- * SAS Visual Investigator API's representation of a UI-Router state.
- * Accessed from the window at window.sas.vi.pageState.
- */
-export interface StateObject {
-    /** The parent StateObject. */
-    parent: StateObject;
-    /** Name used to register the state. */
-    name: string;
-    /** Parent StateObject array from this state up to the root. */
-    path: StateObject[];
-    data: any;
-    /**
-     * An object containing the parent States' names as keys and
-     * true as their values.
-     */
-    includes: {
-        [name: string]: boolean;
-    };
-    /**
-     * Function to return the root node of this state's tree.
-     *
-     * @returns The root of this state's tree.
-     */
-    root(): StateObject;
-    toString(): string;
-}
+import { StoredObjectDTO, Template } from "../svi-datahub";
 export interface HomepageDesignerState {
     isNew: boolean;
     page: Template;
@@ -48,21 +21,21 @@ export interface PageStateApi {
      * @description Returns the state of the current page.
      * @returns An object containing the page state data or undefined if no page exists.
      */
-    getCurrent(): StateObject | undefined;
+    getCurrent(): HomepageDesignerState | ObjectPageDesignerState | undefined;
     /**
      * @method
      * @description Returns the state of the page matching the ID.
      * @param id {string | number} Page ID for which the state will be returned.
      * @returns An object containing the page state data or undefined if the ID doesn't exist.
      */
-    get(id: string | number): StateObject | undefined;
+    get(id: string | number): HomepageDesignerState | ObjectPageDesignerState | undefined;
     /**
      * @method
      * @description Creates a page state.
      * @param id {string | number} Page ID to be created.
-     * @param state {StateObject} Object containing the state data required to create the page.
+     * @param state {HomepageDesignerState | ObjectPageDesignerState} Object containing the state data required to create the page.
      */
-    add(id: string | number, state: StateObject): void;
+    add(id: string | number, state: HomepageDesignerState | ObjectPageDesignerState): void;
     /**
      * @method
      * @description Deletes a page state.

package/score-reps/index.d.ts

@@ -1,6 +1,6 @@
 /* tslint:disable */
 /* eslint-disable */
-// Generated using typescript-generator version 2.15.527 on 2023-01-24 10:52:36.
+// Generated using typescript-generator version 2.15.527 on 2023-07-07 09:38:54.
 
 export interface BaseRep extends TrackedResource {
     links?: Link[];

package/score-reps/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@types/score-reps",
-  "version": "3.3.20",
+  "version": "4.0.12",
   "types": "index.d.ts"
 }

package/search/client/client-search-api.d.ts

@@ -1,5 +1,5 @@
 import { Relationship } from "../../svi-datahub";
-import { MapBoundedBoxFilter, MapBoundedPolygonFilter, MapRadiusFilter, MapShapeFilter, QueryMode, SearchRepresentation, SearchResponse } from "../../svi-sand";
+import { MapBoundedBoxFilter, MapBoundedPolygonFilter, MapRadiusFilter, MapShapeFilter, QueryMode, SearchRepresentation, SearchResponse, SummaryVisualizationResponse } from "../../svi-sand";
 import { ObjectIdentifier } from "../../object/object-api";
 import { QueryBuilderModel, SearchApi } from "../search-api";
 export declare enum SearchVisualization {
@@ -52,7 +52,7 @@ export interface SearchAndCreateDialogModel {
     canCreate?: boolean;
     linkReasons?: Relationship[];
     /**
-     * Values returned on the close of the dialog. May be undefined when dialog is cancelled.
+     * Values returned on the close of the dialog box. May be undefined when dialog box is cancelled.
      */
     result?: SearchAndCreateResponse;
 }
@@ -92,7 +92,7 @@ export interface ClientSearchApi extends SearchApi {
      * @param queryText {string} Text used to form the query.
      * @param visualizationName {"summary" | "map" | "table"} Visualization to query for and then display to the user.
      * @param [mapFilters] {MapFilter[]} The map filter object to include with the search query. This can consist of MapBoundedPolygonFilter, MapRadiusFilter, MapBoundedBoxFilter or MapShapeFilter.
-     * @param [queryMode] {"standard" | "phonetic" | "synonym"} Used to perform phonetic and synonym searches. Default is "standard".
+     * @param [queryMode] {"standard" | "phonetic" | "synonym"} Used to perform phonetic and synonym searches. Default: "standard".
      */
     navigateSearch(queryText: string, visualizationName: SearchVisualization, mapFilters?: MapFilter[], queryMode?: QueryMode[]): Promise<void>;
     /**
@@ -119,13 +119,13 @@ export interface ClientSearchApi extends SearchApi {
      * @description Sets the query builder model for the given ID. If no ID is given, it sets the query model for SEARCH.
      * When stored, the query model is used to initially populate a Query Builder opened with the given ID.
      * @param queryModel {QueryBuilderModel} A query builder model.
-     * @param [id] {string} ID of the model to set. Defaults to SEARCH.
+     * @param [id] {string} ID of the model to set. Default: SEARCH.
      */
     setQueryBuilderModel(queryModel: QueryBuilderModel, id?: string): void;
     /**
      * @method
      * @description Opens the "Add Objects to Workspace" dialog box and then performs the action after a document and workspace have been selected.
-     * @param visualizationName {Visualization} Visualization to initially display after the objects have been added.
+     * @param visualizationName {Visualization} Visualization to display after the objects have been added.
      * @param objects {Array<ObjectIdentifier | ResolvedObjectIdentifier>} Objects to add to the workspace.
      * @param [currentObject] {ObjectIdentifier} The document the user is currently viewing. This is used as a visual aid in the dialog box.
      * @param [networkData] {NetworkData} Network visualization data to be copied to the workspace.
@@ -154,10 +154,20 @@ export interface ClientSearchApi extends SearchApi {
     addToNewWorkspace(objectsToAdd: Array<ObjectIdentifier | ResolvedObjectIdentifier>, targetObjectType: string, targetObjectId?: string, visualization?: Visualization, workspaceName?: string, networkData?: NetworkData): Promise<void>;
     /**
      * @method
-     * @description Launches a wizard allowing users to search first, before creating an object/relationship.
-     * Relationship wizard is determined by relateToParentLabel or relateToParentName being defined within the wizardValues parameter.
+     * @description Launches a wizard allowing users to search, before creating an object/relationship.
+     * The relationship wizard is determined by the relateToParentLabel or relateToParentName defined in the wizardValues parameter.
      * @param wizardValues {SearchAndCreateDialogModel} Object containing entity and relationship data.
-     * @returns A Promise which resolves when the dialog is closed.
+     * @returns A Promise which resolves when the dialog box is closed.
      */
     openSearchAndCreateDialog(wizardValues: SearchAndCreateDialogModel): Promise<SearchAndCreateDialogModel>;
+    /**
+     * @method
+     * @description Gets the selected items within the search result or specified workspace.
+     * @param selectionId {string} The selection ID for the currently selected objects. Default: "SEARCH".
+     * @param maxItems {number} The maximum number of items to get in the selection. Default: 50.
+     * @param textAnalytics {boolean} Boolean value to determine whether the current visualization is Text Analytics. Default: false.
+     */
+    getSelectedItems(selectionId: string, maxItems: number, textAnalytics: boolean): Promise<{
+        [index: string]: SummaryVisualizationResponse;
+    } | undefined>;
 }

package/shell-tabs/package.json

@@ -0,0 +1,9 @@
+{
+    "name": "@sassoftware/vi-api/shell-tabs",
+    "files": [
+        "**/*.d.ts",
+        "**/*.js"
+    ],
+    "main": "public-api.js",
+    "types": "public-api.d.ts"
+}

package/shell-tabs/public-api.d.ts

@@ -0,0 +1,2 @@
+export * from "./shell-tabs-api";
+export * from "./shell-tabs-lifecycle-api";

package/shell-tabs/public-api.js

@@ -0,0 +1,2 @@
+export * from "./shell-tabs-api";
+export * from "./shell-tabs-lifecycle-api";

package/shell-tabs/shell-tabs-api.d.ts

@@ -0,0 +1,199 @@
+import { Observable } from "rxjs";
+import { INavigationBarTabSaveOptions } from "./shell-tabs-lifecycle-api";
+export interface WebElementData {
+    elementName: string;
+    doNotReuse?: boolean;
+}
+export interface INavigationBarTabs<D1 = any, D2 = D1> {
+    primary: INavigationBarTab<D1>;
+    secondary?: INavigationBarTab<D2>;
+}
+export interface INavigationBarTab<D = {
+    [key: string]: any;
+}, SecondaryData = D> {
+    /** unique tab id */
+    id: string;
+    /** url relative to shell root e.g. /user/123 - this must start with a / */
+    routeUrl: string;
+    /** label for the tab, can be String or the resource.key (if .isLabelResourceKey:true) */
+    label: string;
+    /** a weight used during .sort to order the tabs; will default to the order the tabs came as
+     * doesnt mean their array index, as many can be the same, negatives, fractions
+     * */
+    sortIndex?: number;
+    /** when true, will use resourceService.get to resolve INavigationBarTab.label */
+    isLabelResourceKey?: boolean;
+    /** font icon */
+    icon?: string;
+    /**  image url */
+    img?: string;
+    /** aria-controls id */
+    controlsId?: string;
+    /** list  of secondary tabs which will be displayed under the top-level tab */
+    secondaryTabs?: Array<ISecondaryNavigationBarTab<SecondaryData>>;
+    /** keep track of the currently selected secondary tab */
+    selectedSecondaryTab?: ISecondaryNavigationBarTab<SecondaryData>;
+    /** callback to configure save confirm actions on close. */
+    getSaveOptions?(tab: INavigationBarTab): INavigationBarTabSaveOptions | undefined;
+    /** callback when tab is removed */
+    onClose?(tab: INavigationBarTab): Promise<boolean> | Observable<boolean> | boolean;
+    /** mark tab as dirty */
+    dirty?: boolean;
+    /** visually disable and make tab unselectable */
+    disabled?: boolean;
+    /** visually hide tab and make unselectable */
+    hidden?: boolean;
+    /** exclude tab from appearing in the navigation bar system tab menu */
+    excludedFromSystemMenu?: boolean;
+    /** visually hide secondary tabs bar for a tab */
+    hideSecondaryTabs?: boolean;
+    /** indicate that the tab is associated with some new object being created. */
+    creating?: boolean;
+    /** any extra data to be associated with the tab */
+    data?: D;
+}
+export declare type ISecondaryNavigationBarTab<D = {
+    [key: string]: any;
+}> = Omit<INavigationBarTab<D>, "secondaryTabs" | "selectedSecondaryTab">;
+export interface ExternalTabConfig<T = any, P = any> {
+    /**
+     * will try to place at this index, can be negative, fraction, etc to put before/between existing tabs
+     */
+    sortIndex?: number;
+    /**
+     * finds TabId, and adds this as a secondaryTab to that tab
+     */
+    mainTabId?: string;
+    /**
+     * this is the element/tag name that will get presented
+     */
+    elementName: string;
+    /**
+     * this is the URL that the tab will be registered under,
+     * technically it's just a unique ID as this will be used to unregister a route and close any related tab(s)
+     */
+    configUrl: string;
+    /**
+     * function to return {@link INavigationBarTab} , remember routeUrl is from baseURL with a leading /
+     * fullUrl is the full URL that relates to the tab, useful when catching wildcards
+     * params is constructed as of /:param1/:param2, so {param1: string, param2: string}
+     * be aware fullUrl/params will be undefined if buildOnRegister true
+     */
+    buildTab: (fullUrl?: string, params?: P) => INavigationBarTab<T>;
+    /**
+     * add as a systemTab?, if left out will default to applicationTab, ignored if mainTabId is defined
+     */
+    systemTab?: boolean;
+    /**
+     * set this to true if you want the component to reset every time you navigate away
+     */
+    doNotReuse?: boolean;
+    /**
+     * set this to true if you want buildTab to run when registered (e.g. for a system tab that's always there)
+     * if your buildTab takes params, this can not be provided and must be assumed undefined
+     * a secondaryTab (one that has mainTabId) will be created regardless of this flag.
+     */
+    buildOnRegister?: boolean;
+}
+export declare type ShellTabsApi = {
+    /**
+     * this is used to expose any {@link PotentialTabItem} hooks on a component up to the Tab Service
+     * @param context pass "this"
+     * @param elRef pass the ElementRef for the component
+     *
+     *  onTabClose {@link OnTabClose}, optional, can be used to prevent closing of a tab or close async
+     *  onAttachTab {@link OnAttachTab}, will always trigger when currentNavigationBarTab has set
+     *  onAttachToolbar {@link TabWithToolbar}, optional, will set currentToolbar if there was a toolbar in the VI Router
+     *  onTabEnter {@link OnTabEnter}, optional, will trigger when tab is entered
+     *  onTabLeave {@link OnTabLeave}, optional, will trigger when tab is left
+     *  onTabSaveConfirm {@link OnTabSaveConfirm}, optional, basic dialog can be created whe closing a dirty tab
+     */
+    createTabApiForElement: (context: any, nativeElement: HTMLElement) => void;
+    /**
+     * Use this function to register new routes for tabs
+     * @param tabsToAdd - see {@link ExternalTabConfig}
+     */
+    registerExternalTabs: (tab: ExternalTabConfig[]) => void;
+    /**
+     * Use this function to remove routes added via registerTabFn
+     * @param tabsToAdd - see {@link ExternalTabConfig}
+     */
+    unregisterExternalTabs: (tabsToRemove: ExternalTabConfig[]) => void;
+    /**
+     * this will return the current primary and secondary tabs
+     */
+    getSelectedTab: () => {
+        primaryTab: INavigationBarTab;
+        secondaryTab?: INavigationBarTab;
+    };
+    /**
+     * this stream will track the current top level tab
+     */
+    selectedPrimaryTabChanged$: Observable<INavigationBarTab>;
+    /**
+     * this stream will track the current second level tab
+     */
+    selectedSecondaryTabChanged$: Observable<INavigationBarTab | undefined>;
+    /**
+     * this stream will update after any additions/removals to either system or application tabs
+     */
+    openTabsChanged$: Observable<{
+        systemTabs: INavigationBarTab[];
+        applicationTabs: INavigationBarTab[];
+    }>;
+    /**
+     * this stream will emit any removed tabs
+     */
+    tabRemoved$: Observable<INavigationBarTab>;
+    /**
+     * @param tabId will be ID of an existing tab
+     */
+    getTabById: (tabId: string) => INavigationBarTab | undefined;
+    /**
+     * will return a slice of the current system and application tabs
+     */
+    getAllTabs: () => {
+        system: INavigationBarTab[];
+        application: INavigationBarTab[];
+    };
+    /**
+     * will move user to the default tab
+     */
+    selectDefaultTab: () => Promise<boolean>;
+    /**
+     * will attempt to open+select a matching INavigationBarTab and optional secondaryTab, returning false on failure
+     * in the event the tab doesn't exist already, it will add the tab assuming an appropriate route has been registered for it
+     * @param tabToSelect {@link INavigationBarTab}
+     * @param secondaryTab {@link INavigationBarTab} if left undefined, this will select the previously
+     * selected secondary tab of the primary tab or it's first index secondary tab
+     */
+    openTab: (tabToSelect: INavigationBarTab, secondaryTab?: INavigationBarTab) => Promise<boolean>;
+    /**
+     * will attempt to select a tab by its id, returning false on failure
+     * @param tabId will be ID of an existing tab
+     */
+    selectTabById: (tabId: string) => Promise<boolean>;
+    /**
+     * will remove an application tab, if allowed, and will trigger any closing and saving logic beforehand
+     * @param tabIdToRemove will be ID of an existing tab
+     * @param suppressNavigation if you are closing a tab that isn't open, you want to supressNavigation=true
+     */
+    removeApplicationTabById: (tabIdToRemove: string, suppressNavigation?: boolean) => Promise<boolean>;
+    /**
+     * will remove an existing application tab then replace with another, if {@link removeApplicationTabById} is unsuccessful this will fail
+     * use case can be saving a tab which has a temporary ID, and reopening it with a saved payload.
+     * @param tabId will be ID of an existing tab
+     * @param newTab {@link INavigationBarTab}
+     *
+     */
+    replaceApplicationTab: (tabId: string, newTab: INavigationBarTab) => Promise<boolean>;
+    /**
+     * will run {@link removeApplicationTabById} on all tabs, will stop if any fail to close, will wait for each close to complete
+     */
+    removeAllApplicationTabs: () => Promise<boolean>;
+    /**
+     * will run same as {@link removeAllApplicationTabs}, but not on the provided tabIdToKeep
+     * @param tabIdToKeep
+     */
+    removeOtherApplicationTabs: (tabIdToKeep?: string) => Promise<boolean>;
+};

package/shell-tabs/shell-tabs-api.js

@@ -0,0 +1,6 @@
+import { expectType } from "../../shared/util/helper-functions";
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);

package/shell-tabs/shell-tabs-lifecycle-api.d.ts

@@ -0,0 +1,69 @@
+import { OnDestroy } from "@angular/core";
+import { INavigationBarTab, INavigationBarTabs } from "./shell-tabs-api";
+import { Observable } from "rxjs";
+export declare type PotentialTabItem<T = any, U = any> = Partial<OnAttachTab<T> & OnTabEnter & OnTabLeave & OnTabSaveConfirm & OnTabClose & TabWithToolbar<U> & OnDestroy>;
+export interface OnAttachTab<T = any> {
+    currentNavigationBarTab?: INavigationBarTab<T>;
+    /**
+     * Runs when a navigation bar tab is first attached to the implementing component.
+     * If the tab is recycled, it will only run once.
+     */
+    onAttachTab?(): void;
+}
+export interface OnTabEnterParams {
+    from?: INavigationBarTab;
+    fromSecondary?: INavigationBarTab;
+    to: INavigationBarTab;
+    toSecondary?: INavigationBarTab;
+    recycled: boolean;
+}
+export declare type OnTabLeaveParams = Omit<OnTabEnterParams, "recycled">;
+export interface OnTabEnter {
+    /**
+     * Function to run when the Tab is entered, this happens on first load as well
+     * @param params - from is previous tab (possibly undefined on first load), to is always this tab;
+     *                 type {@link INavigationBarTab}, recycled is whether the component was recycled or not
+     */
+    onTabEnter(params: OnTabEnterParams): void;
+}
+export interface OnTabLeave {
+    /**
+     * Function to run when the Tab is left
+     * @param params - from is always this tab, to is where the user is going; type {@link INavigationBarTab}
+     */
+    onTabLeave(params: OnTabLeaveParams): void;
+}
+export interface TabToolbarFor<T = any> {
+    currentComponentAndTab?: {
+        tab: INavigationBarTabs;
+        component: T;
+    };
+    onAttachComponent?(): void;
+}
+export interface TabWithToolbar<T> {
+    currentToolbar?: T;
+    onAttachToolbar?(): void;
+}
+export interface OnTabClose {
+    /**
+     * @param tab the current tab model that is closing.
+     */
+    onTabClose(tab: INavigationBarTab): boolean | Promise<boolean> | Observable<boolean>;
+}
+export interface OnTabSaveConfirm {
+    /**
+     * @param tab the current tab model that is closing.
+     */
+    onTabSaveConfirm(tab: INavigationBarTab): INavigationBarTabSaveOptions | undefined;
+}
+export interface INavigationBarTabSaveOptions {
+    dialogTitle: string;
+    dialogMessage: string;
+    saveFunction(): Promise<boolean> | Observable<boolean> | boolean;
+}
+export declare type WebElementTabApi<NavBarDataType = any, ComponentType = any> = Omit<PotentialTabItem<NavBarDataType, ComponentType>, "onAttachTab" | keyof TabWithToolbar<ComponentType>> & {
+    onAttachTab?(tab: INavigationBarTab<NavBarDataType>): void;
+};
+export declare type WebTabApiElement = HTMLElement & {
+    tabApi?: WebElementTabApi;
+};

package/shell-tabs/shell-tabs-lifecycle-api.js

@@ -0,0 +1,14 @@
+import { expectType } from "../../shared/util/helper-functions";
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);
+expectType(true);