@sassoftware/vi-api 1.40.4 → 1.44.0

package/elements/identity-select.d.ts

@@ -0,0 +1,274 @@
+import { SASInputBindings } from ".";
+import { IdentitySummary } from "../current-user";
+/**
+ * Properties for {@link SVICustomElement.IdentitySelect}.
+ *
+ * @category Properties
+ *
+ * @example HTML Example #1 - Provide a custom set of User/Group identities to display in dialog
+ * ```html
+ * <svi-identity-select
+ *   [model]="selectedIdentities"
+ *   [identities]="myIdentitiesList"
+ *   [selectionMode]="SelectionMode.UsersAndGroups"
+ *   [selfSelectBtn]="true"
+ *   [filter]="{ byGroups: ['alpha', 'bravo'] }"
+ *   (modelChanged)="onSelectionChange($event)"
+ * ></svi-identity-select>
+ * ```
+ *
+ *  @example HTML Example #2 - Retrieve a list of users from the identities service in dialog
+ * ```html
+ * <svi-identity-select
+ *   [model]="selectedIdentities"
+ *   [ariaLabel]="'Select Users'"
+ *   [selectionMode]="SelectionMode.Users"
+ *   [selfSelectBtn]="true"
+ *   (modelChanged)="onSelectionChange($event)"
+ * ></svi-identity-select>
+ * ```
+ *
+ * @example Create element via document.createElement:
+ * ```ts
+ * const identitySelect = document.createElement(SVICustomElement.IdentitySelect);
+ * identitySelect.identities = this.myIdentitiesList;
+ * identitySelect.ariaLabel = "My label";
+ * ```
+ */
+export interface IdentitySelectProperties extends SASInputBindings {
+    /** ARIA label for identifying the list. */
+    ariaLabel?: string;
+    /** The available users and groups to select from. If not provided, the identities are retrieved from the identities microservice. */
+    identities?: IIdentityOption[];
+    /** Does the input allow the selection of only a user, users, a group, groups, or both?  (default: {@link SelectionMode.UsersAndGroups}) */
+    selectionMode?: SelectionMode;
+    /** Determines whether the select current user button is displayed. (default: false) */
+    selfSelectBtn?: boolean;
+    /** Determines if the current user button is displayed above or to the left/right of the identity-select control. (default: false) */
+    inlineSelectCurrentUserBtn?: boolean;
+    /** The filtering options used when the available identities are retrieved from the identities microservice. (default: false) */
+    filter?: IIdentitySelectFilterOptions;
+    /**
+     * Only members of the given group will be valid and selectable. If inclusive if true,
+     * the group itself is treated as a valid selection.
+     *
+     * Accepts the group id as a string, or as part of configuration object.
+     */
+    limitSelectionToMembersOf?: string | ILimitSelectionToConfig;
+    /** Optional title that can be used to override the default dialog title. */
+    title?: string;
+}
+/**
+ * Properties for {@link SVICustomElement.IdentitySelectAction}.
+ *
+ * @category Properties
+ *
+ * @example HTML Example #1 - Select Users and Groups
+ * ```html
+ * <svi-identity-select-action
+ *   [model]="selectedIdentities"
+ *   [title]="'Multiple Users and Groups from Button'"
+ *   [hideLabel]="true"
+ *   (selectionDialogClose)="onDialogClose($event)"
+ *   (modelChanged)="onSelectionChange($event)"
+ * ></svi-identity-select-action>
+ * ```
+ *
+ * @example HTML Example #1 - Select Users Only
+ * ```html
+ * <svi-identity-select-action
+ *   [model]="selectedIdentities"
+ *   [title]="'Multiple Users from Button'"
+ *   [hideLabel]="true"
+ *   [selectionMode]="selectionMode.Users"
+ *   (selectionDialogClose)="onDialogClose($event)"
+ *   (modelChanged)="onSelectionChange($event)"
+ * ></svi-identity-select-action>
+ * ```
+ *
+ * @example Create element via document.createElement:
+ * ```ts
+ * const identityAvatar = document.createElement(SVICustomElement.IdentitySelectAction);
+ * identitySelect.title = this.title;
+ * identitySelect.actionMode = this.actionMode;
+ * ```
+ */
+export interface IdentitySelectActionProperties {
+    /** Determines if the action is rendered as a Button or MenuItem (default: {@link ActionMode.Button}). */
+    actionMode?: ActionMode;
+    /** The tabIndex for the button (default: {@link TabIndex.Tabbable}). */
+    tabIndex?: string;
+    /** Optional title that can be used to override the default dialog title. */
+    title?: string;
+    /** Optional label that can be used to override the default button label.  */
+    label?: string;
+    /** Defines if the label will be hidden. (default: false). */
+    hideLabel?: boolean;
+    /** Label for the identity select dialog "ok" button. (default: "ok") */
+    okButtonLabel?: string;
+    /** Optional icon class that can be used to override the default button icon. */
+    iconClass?: string;
+    /** Disables the component's controls. (default: false) */
+    disabled?: boolean;
+    /** The available users and groups to select from. If not provided, the identities are retrieved from the identities microservice. */
+    identities?: IIdentityOption[];
+    /** Does the input allow the selection of only a user, users, a group, groups, or both? (default: {@link SelectionMode.UsersAndGroups}) */
+    selectionMode?: SelectionMode;
+    /** Pre-select Identities. */
+    selectedIdentities?: IIdentityOption[];
+    /** The filtering options used when the available identities are retrieved from the identities microservice. */
+    filter?: IIdentitySelectFilterOptions;
+    /**
+     * Only members of the given group will be valid and selectable. If inclusive if true,
+     * the group itself is treated as a valid selection.
+     *
+     * Accepts the group id as a string, or as part of configuration object.
+     */
+    limitSelectionToMembersOf?: string | ILimitSelectionToConfig;
+    /** Emits the selected identities when the dialog's ok button is clicked. */
+    selectionDialogClose?: (event: CustomEvent) => void;
+}
+/**
+ * Properties for {@link SVICustomElement.Avatar}.
+ *
+ * @category Properties
+ *
+ * @example HTML Example
+ * ```html
+ * <svi-avatar
+ *   [identity]="identity"
+ *   [size]="SizeType.XLarge"
+ *   [isIcon]="true"
+ *   [isButton]="true"
+ * ></svi-avatar>
+ * ```
+ *
+ * @example Create element via document.createElement:
+ * ```ts
+ * const identityAvatar = document.createElement(SVICustomElement.IdentityAvatar);
+ * identitySelect.identity = this.identity;
+ * identitySelect.size = SizeType.XLarge;
+ * identitySelect.isButton = true;
+ * ```
+ */
+export interface AvatarProperties {
+    /** The identity of the user, including name, userID, user type, and any tooltips. (required) */
+    identity: AvatarData;
+    /** Specifies the size styling the avatar should use. */
+    size?: SizeType;
+    /** Specifies if the avatar is a clickable button. */
+    isButton?: boolean;
+    /** The user's photo, if provided. */
+    imgSrcUrl?: string;
+    /** Specifies whether the avatar displays an icon (user or group) or a non-icon (initial or image). */
+    isIcon?: boolean;
+}
+/** @category Identities Types */
+export declare enum SizeType {
+    Small = "small",
+    Medium = "medium",
+    XLarge = "x-large"
+}
+/** @category Identities Types */
+export declare enum TabIndex {
+    Tabbable = "0",
+    NotTabbable = "-1"
+}
+/** @category Identities Types */
+export declare enum IdentityType {
+    User = "user",
+    Group = "group"
+}
+/** @category Identities Types */
+export declare enum IdentityState {
+    Active = "active",
+    Inactive = "inactive",
+    Locked = "locked"
+}
+/** @category Identities Types */
+export interface GroupSummary extends IdentitySummary {
+    /** The value of "group" */
+    readonly type: IdentityType.Group;
+}
+/** @category Identities Types */
+export interface UserSummary extends IdentitySummary {
+    /** The value of "user" */
+    readonly type: IdentityType.User;
+}
+/** @category Identities Types */
+export interface AvatarData {
+    /** The name of the avatar file */
+    name?: string;
+    /** The content-type of the avatar file. */
+    type?: string;
+    /** Describes whether or not the avatar file for this identity is a default image. */
+    default?: boolean;
+    /** The uri location of the avatar file only if stored externally. */
+    uri?: string;
+    /** Timestamp of avatar data creation */
+    creationTimeStamp?: Date;
+    /** Timestamp of last avatar data modification */
+    modifiedTimeStamp?: Date;
+}
+/** @category Identities Types */
+export declare enum ActionMode {
+    Button = "button",
+    MenuItem = "menuItem"
+}
+/** @category Identities Types */
+export declare enum SelectionMode {
+    User = "user",
+    Group = "group",
+    Users = "users",
+    Groups = "groups",
+    UserOrGroup = "userOrGroup",
+    UsersAndGroups = "usersAndGroups"
+}
+/** @category Identities Types */
+export type IdentitySelection = Array<{
+    id: string;
+    type: IdentityType;
+}>;
+/** @category Identities Types */
+export interface IIdentitySelectDialogData {
+    identities?: IIdentityOption[];
+    selection?: IdentitySelection;
+    selectionMode: SelectionMode;
+    filter?: IIdentitySelectFilterOptions;
+    limitSelectionToMembersOf?: string | ILimitSelectionToConfig;
+    title?: string;
+    okButtonLabel?: string;
+    showSelectCurrentUserButton?: boolean;
+}
+/** @category Identities Types */
+export interface IIdentityOption {
+    label?: string;
+    icon?: string;
+}
+/** @category Identities Types */
+export declare const enum IdentityTypeIcon {
+    User = "userIcon",
+    Group = "userGroupIcon",
+    UserAndGroup = "userGroupLimitIcon"
+}
+/** @category Identities Types */
+export interface IIdentitySelectFilterOptions {
+    byGroups: string[];
+    includeNestedMembers?: boolean;
+    includeFilteredGroups?: boolean;
+    term?: string;
+    start?: number;
+    limit?: number;
+    cache?: number;
+}
+/** @category Identities Types */
+export interface IFilterGroup {
+    id: string;
+    name?: string;
+    members: IdentitySummary[];
+}
+/** @category Identities Types */
+export interface ILimitSelectionToConfig {
+    id: string;
+    inclusive?: boolean;
+}

package/elements/identity-select.js

@@ -0,0 +1,24 @@
+import { expectType } from "../../shared/util/helper-functions";
+/** @category Identities Types */
+export var SizeType;
+(function (SizeType) {
+    SizeType["Small"] = "small";
+    SizeType["Medium"] = "medium";
+    SizeType["XLarge"] = "x-large";
+})(SizeType || (SizeType = {}));
+/** @category Identities Types */
+export var IdentityType;
+(function (IdentityType) {
+    IdentityType["User"] = "user";
+    IdentityType["Group"] = "group";
+})(IdentityType || (IdentityType = {}));
+/** @category Identities Types */
+export var IdentityState;
+(function (IdentityState) {
+    IdentityState["Active"] = "active";
+    IdentityState["Inactive"] = "inactive";
+    IdentityState["Locked"] = "locked";
+})(IdentityState || (IdentityState = {}));
+expectType(true);
+expectType(true);
+expectType(true);

package/elements/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * SAS Visual Investigator exposes a number of controls within the DOM as Custom Elements.
+ *
+ * See {@link SVICustomElement} for the list of available SVI Custom Elements.
+ */
+/**
+ * This enumeration list contains the tag names of all SVI custom elements.
+ *
+ * @category Properties
+ */
+export declare enum SVICustomElement {
+    /**
+     * Wrap a given control in an SVI control label.
+     *
+     * By default, the label will include a {@link MaskToggleButton | mask-toggle-button}
+     * for toggling the masked state of the control's dataSource, if configured for masking.
+     *
+     * See {@link LabelledControlProperties} for supported input bindings.
+     */
+    LabelledControl = "svi-labelled-control",
+    /**
+     * Toggle a given dataSource between it's masked and unmasked state, if configured for masking.
+     *
+     * See {@link MaskToggleButtonProperties} for supported input bindings.
+     */
+    MaskToggleButton = "svi-mask-toggle-button",
+    /**
+     * A token input that spawns a dialog for selecting a set of users, a set of groups, or a set of users and groups.
+     *
+     * See {@link IdentitySelectProperties} for supported input bindings.
+     */
+    IdentitySelect = "svi-identity-select",
+    /**
+     * A button for selecting a set of users, a set of groups, or a set of users and groups.
+     *
+     * See {@link IdentitySelectActionProperties} for supported input bindings.
+     */
+    IdentitySelectAction = "svi-identity-select-action",
+    /**
+     * An input to select a set of users, a set of groups, or a set of users and groups.
+     *
+     * See {@link AvatarProperties} for supported input bindings.
+     */
+    Avatar = "svi-avatar"
+}
+export * from "./bindings";
+export * from "./identity-select";
+export * from "./labelled-control";
+export * from "./mask-toggle-button";

package/elements/index.js

@@ -0,0 +1,50 @@
+/**
+ * SAS Visual Investigator exposes a number of controls within the DOM as Custom Elements.
+ *
+ * See {@link SVICustomElement} for the list of available SVI Custom Elements.
+ */
+/**
+ * This enumeration list contains the tag names of all SVI custom elements.
+ *
+ * @category Properties
+ */
+export var SVICustomElement;
+(function (SVICustomElement) {
+    /**
+     * Wrap a given control in an SVI control label.
+     *
+     * By default, the label will include a {@link MaskToggleButton | mask-toggle-button}
+     * for toggling the masked state of the control's dataSource, if configured for masking.
+     *
+     * See {@link LabelledControlProperties} for supported input bindings.
+     */
+    SVICustomElement["LabelledControl"] = "svi-labelled-control";
+    /**
+     * Toggle a given dataSource between it's masked and unmasked state, if configured for masking.
+     *
+     * See {@link MaskToggleButtonProperties} for supported input bindings.
+     */
+    SVICustomElement["MaskToggleButton"] = "svi-mask-toggle-button";
+    /**
+     * A token input that spawns a dialog for selecting a set of users, a set of groups, or a set of users and groups.
+     *
+     * See {@link IdentitySelectProperties} for supported input bindings.
+     */
+    SVICustomElement["IdentitySelect"] = "svi-identity-select";
+    /**
+     * A button for selecting a set of users, a set of groups, or a set of users and groups.
+     *
+     * See {@link IdentitySelectActionProperties} for supported input bindings.
+     */
+    SVICustomElement["IdentitySelectAction"] = "svi-identity-select-action";
+    /**
+     * An input to select a set of users, a set of groups, or a set of users and groups.
+     *
+     * See {@link AvatarProperties} for supported input bindings.
+     */
+    SVICustomElement["Avatar"] = "svi-avatar";
+})(SVICustomElement || (SVICustomElement = {}));
+export * from "./bindings";
+export * from "./identity-select";
+export * from "./labelled-control";
+export * from "./mask-toggle-button";

package/elements/labelled-control.d.ts

@@ -0,0 +1,47 @@
+import { PageControlBindings } from ".";
+/**
+ * Properties for {@link SVICustomElement.LabelledControl}.
+ *
+ * @category Properties
+ *
+ * @example HTML Example:
+ * ```html
+ * <svi-labelled-control
+ *   [childNode]="childNode"
+ *   [pageModel]="pageModel"
+ * >
+ *   <!-- my control -->
+ * </svi-labelled-control>
+ * ```
+ *
+ * @example Create the element via document.createElement:
+ * ```ts
+ * const labelledControl = document.createElement(SVICustomElement.LabelledControl);
+ * labelledControl.pageModel = this.pageModel;
+ * labelledControl.childNode = this.childNode;
+ * labelledControl.appendChild(myControlElement)
+ * ```
+ */
+export interface LabelledControlProperties extends PageControlBindings {
+    /** Set the label as required. */
+    isRequired?: boolean;
+    /** Set the label as disabled. */
+    isDisabled?: boolean;
+    /** Override the text displayed in the label. */
+    overrideLabel?: string;
+    /** Add css classes to the label element. */
+    labelClass?: string;
+    /**
+     * Specify which dataSource the label's mask-toggle-button will toggle.
+     *
+     * If no {@link MaskToggleButtonProperties.dataSource | dataSource} is specified,
+     * the mask-toggle-button will toggle the dataSource(s) defined in the childNode's typeAttributes.
+     */
+    dataSource?: string;
+    /** Disable the label's mask toggle button. */
+    disableMaskToggle?: boolean;
+    /** Hide the label's mask toggle button. */
+    hideMaskToggle?: boolean;
+    /** Set the label's `for` attribute. */
+    for?: string;
+}

package/elements/labelled-control.js

@@ -0,0 +1 @@
+export {};

package/elements/mask-toggle-button.d.ts

@@ -0,0 +1,37 @@
+import { PageControlBindings } from ".";
+/**
+ * Properties for {@link SVICustomElement.MaskToggleButton}.
+ *
+ * @category Properties
+ *
+ * @example HTML Example
+ * ```html
+ * <svi-mask-toggle-button
+ *   [childNode]="childNode"
+ *   [pageModel]="pageModel"
+ * >
+ * </svi-mask-toggle-button>
+ * ```
+ *
+ * @example Create element via document.createElement:
+ * ```ts
+ * const maskToggleBtn = document.createElement(SVICustomElement.MaskToggleButton);
+ * maskToggleBtn.pageModel = this.pageModel;
+ * maskToggleBtn.childNode = this.childNode;
+ * ```
+ */
+export interface MaskToggleButtonProperties extends PageControlBindings {
+    /**
+     * Specify which dataSource will be toggled.
+     *
+     * If no {@link MaskToggleButtonProperties.dataSource | dataSource} is specified,
+     * the mask-toggle-button will toggle the dataSource(s) defined in the childNode's typeAttributes.
+     */
+    dataSource?: string;
+    /** Disable the mask toggle button. */
+    disabled?: boolean;
+    /** Hide the mask toggle button. */
+    hidden?: boolean;
+    /** Override the control name displayed in the authorization dialog. */
+    controlName?: string;
+}

package/elements/mask-toggle-button.js

@@ -0,0 +1 @@
+export {};

package/elements/package.json

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

package/event/event-api.d.ts

@@ -17,8 +17,9 @@ export declare enum PageEvents {
     UpdateSubDocumentTypeEvent = "spb::updateSubDocumentType",
     TabSelectedEvent = "spb::tabSelected",
     VisitAllTabs = "spb::mark-all-tabs-visited",
-    MaskToggleEvent = "spb::mask-toggle",
-    MaskAllEvent = "spb::mask-all",
+    MaskEvent = "spb::mask",
+    UnmaskEvent = "spb::unmask",
+    MaskResetEvent = "spb::mask-reset",
     ClearDateFieldEvent = "spb::clear-date-field"
 }
 export declare enum DocumentGeneratorEvents {
@@ -29,7 +30,11 @@ export interface Subscription {
 }
 /**
  * This API provides the  details and functionality associated with publishing and subscribing to events.
- * Accessed from the window at window.sas.vi.event.
+ *
+ * Accessed from the window at `window.sas.vi.event`.
+ *
+ * @example window.sas.vi.event.publish("eventName", payload);
+ * @category API
  */
 export interface EventApi {
     /**
@@ -43,8 +48,8 @@ export interface EventApi {
      * @method
      * @description Subscribes to an event and registers a function to be called on any future published events.
      * If the eventName does not exist, it is created.
-     * @param eventName {string} Name of the event to subscribe to.
-     * @param {EventApi~subscriptionCallback} Function Invoked when the subscription is triggered by an event.
+     * @param {string} eventName Name of the event to subscribe to.
+     * @param {EventApi~subscriptionCallback} observer Invoked when the subscription is triggered by an event.
      * Has access to the event's payload.
      * @returns The subscription being made to the event.
      */

package/event/event-api.js

@@ -18,8 +18,9 @@ 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["MaskEvent"] = "spb::mask";
+    PageEvents["UnmaskEvent"] = "spb::unmask";
+    PageEvents["MaskResetEvent"] = "spb::mask-reset";
     PageEvents["ClearDateFieldEvent"] = "spb::clear-date-field";
 })(PageEvents || (PageEvents = {}));
 export var DocumentGeneratorEvents;

package/event/package.json

@@ -4,6 +4,6 @@
         "**/*.d.ts",
         "**/*.js"
     ],
-    "main": "public-api.js",
-    "types": "public-api.d.ts"
+    "main": "index.js",
+    "types": "index.d.ts"
 }

package/file/file-api.d.ts

@@ -30,7 +30,11 @@ export interface FileOperation {
 }
 /**
  * This API provides functionality related to uploading files.
- * Accessed from the window at window.sas.vi.file.
+ *
+ * Accessed from the window at `window.sas.vi.file`.
+ *
+ * @example window.sas.vi.file.uploadToVIFolder(file, "fileName")
+ * @category API
  */
 export interface FileApi {
     /**

package/file/package.json

@@ -4,6 +4,6 @@
         "**/*.d.ts",
         "**/*.js"
     ],
-    "main": "public-api.js",
-    "types": "public-api.d.ts"
+    "main": "index.js",
+    "types": "index.d.ts"
 }

package/http/index.d.ts

@@ -7,7 +7,11 @@ export interface HttpResponse<R> {
 }
 /**
  * This API provides functionality for making REST requests.
- * Accessed from the window at window.sas.vi.http.
+ *
+ * Accessed from the window at `window.sas.vi.http`
+ *
+ * @example window.sas.vi.http.get("example_url", {...})
+ * @category API
  */
 export interface HttpApi {
     /**

package/http/package.json

@@ -4,6 +4,6 @@
         "**/*.d.ts",
         "**/*.js"
     ],
-    "main": "public-api.js",
-    "types": "public-api.d.ts"
+    "main": "index.js",
+    "types": "index.d.ts"
 }

package/index.d.ts

@@ -24,7 +24,9 @@ import { ShellTabsApi } from "./shell-tabs/shell-tabs-api";
 import { PageTemplateApi } from "./page-template/page-template-api";
 import { InitApi } from "./init";
 /**
- * Common API Functions.
+ * The SVI API contains common API functions and can be accessed directly from the window via `window.sas.vi`
+ *
+ * @module
  */
 export interface SviCommonApi {
     component: ComponentApi;

package/init/index.d.ts

@@ -3,21 +3,25 @@ export declare const ERR_EXISTING_APP_DECLARED: (appName: string) => string;
 export declare const ERR_EXISTING_RESOURCE_BUNDLE_DECLARED: (appName: string) => string;
 export declare const ERR_INIT_TIMEOUT: (name: string, timeout?: number) => string;
 /**
- * An API to manage the asynchronous initialisation of solution applications
- * before the Visual Investigator application is fully initialised.
+ * An API to manage the asynchronous initialization of solution applications before the
+ * Visual Investigator application is fully initialized.
+ *
+ * Accessed from the window at `window.sas.viInit`
+ * @example window.sas.viInit.registerResourceBundle(bundleName, resources);
+ * @category API
  */
 export interface InitApi {
     /**
      * Declare an application.
-     * Visual Investigator will await whenReady for each before continuing its own app initialisation.
-     * notifyAppReady should be called to indicate when the app initialisation is complete.
+     * Visual Investigator will await whenReady for each before continuing its own app initialization.
+     * notifyAppReady should be called to indicate when the app initialization is complete.
      * if provided, registerResourceBundle should be called to indicate when the I18n resource bundle is ready.
      * @param appName appName of the app configuration.
      * @param i18nResourceBundleName I18n resource bundle name of the app configuration.
      */
     declareApp(appName: string, i18nResourceBundleName?: string): void;
     /**
-     * Notify listeners that the app has been initialised.
+     * Notify listeners that the app has been initialized.
      * @param appName appName of the app configuration.
      */
     notifyAppReady(appName: string): void;
@@ -38,8 +42,9 @@ export interface InitApi {
     registerResourceBundle(bundleName: string, resources: I18nResources): void;
 }
 /**
- * Initialisation events for the Visual Investigator application.
- * These can be awaited using window.sas.viInit.whenReady
+ * Initialization events for the Visual Investigator application.
+ *
+ * These can be awaited using `window.sas.viInit.whenReady`
  */
 export declare enum SviInitEvent {
     /** all apps which were declared through window.sas.viInit */