@microsoft/windows-admin-center-sdk 4.167.0 → 4.232.0

package/angular/src/controls/accordion/accordion-panel/accordion-panel.component.d.ts

@@ -1,10 +1,14 @@
-import { EventEmitter } from '@angular/core';
+import { EventEmitter, OnInit } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class PanelControlComponent {
+    /**
+     * Best effort to make sure the buttons, texts can be focused.
+     */
+    defaultFocusZone: boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<PanelControlComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PanelControlComponent, "sme-panel-control", never, {}, {}, never, ["*"], false, never>;
 }
-export declare class AccordionPanelComponent {
+export declare class AccordionPanelComponent implements OnInit {
     /**
      * It determines the header for the panel.
      */
@@ -13,6 +17,11 @@ export declare class AccordionPanelComponent {
      * It indicates whether the panel is opened.
      */
     opened: boolean;
+    /**
+     * It indicates whether the panel is initially opened.
+     * This value will no longer be respected after the control fully loaded.
+     */
+    initialOpened: boolean;
     /**
      * It indicates whether the panel is expandable.
      */
@@ -31,12 +40,12 @@ export declare class AccordionPanelComponent {
      * It indicates whether the panel can be closed.
      */
     canClose: boolean;
-    constructor();
+    ngOnInit(): void;
     toggled: EventEmitter<AccordionPanelComponent>;
     /**
      * The on toggle function implementation.
      */
     onToggle(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AccordionPanelComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AccordionPanelComponent, "sme-accordion-panel", never, { "header": "header"; "opened": "opened"; "isExpandable": "isExpandable"; "borderRadius": "borderRadius"; "paddingInset": "paddingInset"; }, { "toggled": "toggled"; }, never, ["sme-panel-control", "*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AccordionPanelComponent, "sme-accordion-panel", never, { "header": "header"; "initialOpened": "initialOpened"; "isExpandable": "isExpandable"; "borderRadius": "borderRadius"; "paddingInset": "paddingInset"; }, { "toggled": "toggled"; }, never, ["sme-panel-control", "*"], false, never>;
 }

package/angular/src/controls/form/form-field/array/array-form-field-accessibility-manager.service.d.ts

@@ -0,0 +1,38 @@
+import { ElementRef } from '@angular/core';
+import { FormFieldAccessibilityManagerBaseService } from '../form-field-accessibility-manager-base.service';
+import * as i0 from "@angular/core";
+export declare class ArrayFormFieldAccessibilityManagerService {
+    protected formFieldAccessibilityManagerBaseService: FormFieldAccessibilityManagerBaseService;
+    private readonly firstFormFieldInArrayItemSelector;
+    constructor(formFieldAccessibilityManagerBaseService: FormFieldAccessibilityManagerBaseService);
+    /**
+     * It handles the focus when deleting an item from the list.
+     * @param value the value for the list.
+     * @param addButton the element reference for the add button.
+     * @param hostElement the element reference for the host element.
+     * @returns void
+     */
+    delete(value: any[], addButton: ElementRef, hostElement: ElementRef): void;
+    /**
+     * It handles the focus when adding an item to the list.
+     * @param value the value for the list.
+     * @param addButton the element reference for the add button.
+     * @param hostElement the element reference for the host element.
+     * @returns void
+     */
+    add(value: any[], addButton: ElementRef, hostElement: ElementRef): void;
+    /**
+     * It handles the focus when promoting an item in the list.
+     * @param hostElement The element reference for the host element.
+     * @param index the current index.
+     */
+    promote(value: any[], hostElement: ElementRef, index: number): void;
+    /**
+     * It handles the focus when demoting an item in the list.
+     * @param hostElement The element reference for the host element.
+     * @param index the current index.
+     */
+    demote(value: any[], hostElement: ElementRef, index: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ArrayFormFieldAccessibilityManagerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ArrayFormFieldAccessibilityManagerService>;
+}

package/angular/src/controls/form/form-field/array/array-form-field.component.d.ts

@@ -4,6 +4,7 @@ import { ValidationAlerts } from '../../../form/validation-alert/validation-aler
 import { ArrayPropertySchemaFieldLoaderComponent } from '../../../schema/schema-field-host.component';
 import { SmeInternalFormFieldComponent } from '../form-field.component';
 import { FormFieldIsolatorComponent } from '../isolator/isolator.component';
+import { ArrayFormFieldAccessibilityManagerService } from './array-form-field-accessibility-manager.service';
 import * as i0 from "@angular/core";
 export interface AskForNewItemEventArgs {
     item: any;
@@ -25,6 +26,7 @@ export declare class ArrayFormFieldLoaderComponent extends ArrayPropertySchemaFi
  * Accessible Implementation of a form field for .sme-array
  */
 export declare class ArrayFormFieldComponent extends SmeInternalFormFieldComponent<any[]> implements OnInit {
+    protected arrayFormFieldAccessibilityManagerService: ArrayFormFieldAccessibilityManagerService;
     private _itemTitle;
     /**
      * The source name to use for logging
@@ -88,7 +90,7 @@ export declare class ArrayFormFieldComponent extends SmeInternalFormFieldCompone
     /**
      * Initializes a new instance of the JsonFormFieldComponent
      */
-    constructor(injector: Injector);
+    constructor(injector: Injector, arrayFormFieldAccessibilityManagerService: ArrayFormFieldAccessibilityManagerService);
     /**
      * The method called after the component is initialized.
      */

package/angular/src/controls/form/form-field/form-field-accessibility-manager-base.service.d.ts

@@ -0,0 +1,37 @@
+import { ElementRef } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * A re-usable form field accessibility manager.
+ */
+export declare class FormFieldAccessibilityManagerBaseService {
+    /**
+     * The focus handler on delete/add if the form field is a list.
+     * @param value The value for the list form field.
+     * @param addButton The component reference for the add button.
+     * @param hostElement The host element reference.
+     * @param isDelete Determine if the action is delete.
+     * @returns void
+     */
+    listFormFieldFocusHandlerOnKeyboardAction(value: string[], addButton: ElementRef | undefined, hostElement: ElementRef, isDelete?: boolean): void;
+    /**
+     * The focus handler on delete/add if the form field is a list. And the list is built with a specific selector.
+     * @param value The value for the list form field.
+     * @param addButton The component reference for the add button.
+     * @param hostElement The host element reference.
+     * @param selector The selector for the input fields.
+     * @returns void
+     */
+    listFormFieldFocusHandlerOnKeyboardActionBySelector(value: string[], addButton: ElementRef | undefined, hostElement: ElementRef, selector: string): void;
+    /**
+     * It handles the focus on the input field by index if value is type of any[].
+     * @param hostElement the host form field element.
+     * @param index the index of the input field to focus on.
+     * @returns void.
+     */
+    focusOnInputByIndex(hostElement: ElementRef, index: number): void;
+    deferredFocusOnTargetBySelector(value: string[], hostElement: ElementRef, selector: string): void;
+    protected deferredFocusOnAddButton(addButton: ElementRef | undefined): void;
+    protected deferredFocusOnInputFields(hostElement: ElementRef, value: string[], isDelete?: boolean): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormFieldAccessibilityManagerBaseService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FormFieldAccessibilityManagerBaseService>;
+}

package/angular/src/controls/form/form-field/list/list-form-field-accessibility-manager.service.d.ts

@@ -0,0 +1,25 @@
+import { ElementRef } from '@angular/core';
+import { FormFieldAccessibilityManagerBaseService } from '../form-field-accessibility-manager-base.service';
+import * as i0 from "@angular/core";
+export declare class ListFormFieldAccessibilityManagerService {
+    protected formFieldAccessibilityManagerBaseService: FormFieldAccessibilityManagerBaseService;
+    constructor(formFieldAccessibilityManagerBaseService: FormFieldAccessibilityManagerBaseService);
+    /**
+     * It handles the focus when deleting an item from the list.
+     * @param value the value for the list.
+     * @param addButton the element reference for the add button.
+     * @param hostElement the element reference for the host element.
+     * @returns void
+     */
+    delete(value: string[] | any[], addButton: ElementRef | undefined, hostElement: ElementRef): void;
+    /**
+     * It handles the focus when adding an item to the list.
+     * @param value the value for the list.
+     * @param addButton the element reference for the add button.
+     * @param hostElement the element reference for the host element.
+     * @returns void
+     */
+    add(value: string[] | any[], addButton: ElementRef | undefined, hostElement: ElementRef): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ListFormFieldAccessibilityManagerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ListFormFieldAccessibilityManagerService>;
+}

package/angular/src/controls/form/form-field/list/list-form-field.component.d.ts

@@ -1,12 +1,18 @@
-import { Injector, OnInit } from '@angular/core';
+import { ElementRef, Injector, OnInit } from '@angular/core';
 import { FormControl } from '@angular/forms';
 import { ValidationAlerts } from '../../validation-alert/validation-alert';
 import { SmeInternalFormFieldComponent } from '../form-field.component';
+import { ListFormFieldAccessibilityManagerService } from './list-form-field-accessibility-manager.service';
 import * as i0 from "@angular/core";
 /**
  * Accessible Implementation of a form field for a string array
  */
 export declare class ListFormFieldComponent extends SmeInternalFormFieldComponent<string[]> implements OnInit {
+    protected listFormFieldAccessibilityManagerService: ListFormFieldAccessibilityManagerService;
+    /**
+     * The view child component for the add button
+     */
+    addButton: ElementRef;
     /**
      * The source name to use for logging
      */
@@ -18,7 +24,11 @@ export declare class ListFormFieldComponent extends SmeInternalFormFieldComponen
     /**
      * Initializes a new instance of the ListFormFieldComponent
      */
-    constructor(injector: Injector);
+    constructor(injector: Injector, listFormFieldAccessibilityManagerService: ListFormFieldAccessibilityManagerService);
+    /**
+     * It gets the aria label for the add button that can respect when the field is required.
+     */
+    get addButtonAriaLabel(): string;
     /**
      * The method called after the component is initialized.
      */

package/angular/src/controls/form/form-field/ordered-list/ordered-list-form-field-accessibility-manager.service.d.ts

@@ -0,0 +1,37 @@
+import { ElementRef } from '@angular/core';
+import { FormFieldAccessibilityManagerBaseService } from '../form-field-accessibility-manager-base.service';
+import * as i0 from "@angular/core";
+export declare class OrderedListFormFieldAccessibilityManagerService {
+    protected formFieldAccessibilityManagerBaseService: FormFieldAccessibilityManagerBaseService;
+    constructor(formFieldAccessibilityManagerBaseService: FormFieldAccessibilityManagerBaseService);
+    /**
+     * It handles the focus when deleting an item from the list.
+     * @param value the value for the list.
+     * @param addButton the element reference for the add button.
+     * @param hostElement the element reference for the host element.
+     * @returns void
+     */
+    delete(value: any[], addButton: ElementRef, hostElement: ElementRef): void;
+    /**
+     * It handles the focus when adding an item to the list.
+     * @param value the value for the list.
+     * @param addButton the element reference for the add button.
+     * @param hostElement the element reference for the host element.
+     * @returns void
+     */
+    add(value: any[], addButton: ElementRef, hostElement: ElementRef): void;
+    /**
+     * It handles the focus when promoting an item in the list.
+     * @param hostElement The element reference for the host element.
+     * @param index the current index.
+     */
+    promote(value: any[], hostElement: ElementRef, buttonId: string): void;
+    /**
+     * It handles the focus when demoting an item in the list.
+     * @param hostElement The element reference for the host element.
+     * @param index the current index.
+     */
+    demote(value: any[], hostElement: ElementRef, buttonId: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<OrderedListFormFieldAccessibilityManagerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<OrderedListFormFieldAccessibilityManagerService>;
+}

package/angular/src/controls/form/form-field/ordered-list/ordered-list-form-field.component.d.ts

@@ -1,8 +1,9 @@
-import { Injector, OnInit } from '@angular/core';
+import { ElementRef, Injector, OnInit } from '@angular/core';
 import { FormControl } from '@angular/forms';
 import { SimplePropertySchemaFieldLoaderComponent } from '../../../schema/schema-field-host.component';
 import { ValidationAlerts } from '../../validation-alert/validation-alert';
 import { SmeInternalOptionsFormFieldComponent } from '../options-form-field/options-form-field.component';
+import { OrderedListFormFieldAccessibilityManagerService } from './ordered-list-form-field-accessibility-manager.service';
 import * as i0 from "@angular/core";
 export declare class OrderedListFormFieldLoaderComponent extends SimplePropertySchemaFieldLoaderComponent {
     /**
@@ -19,6 +20,7 @@ export declare class OrderedListFormFieldLoaderComponent extends SimplePropertyS
  * Accessible Implementation of a form field combo box.
  */
 export declare class OrderedListFormFieldComponent<TValue> extends SmeInternalOptionsFormFieldComponent<Array<TValue>> implements OnInit {
+    protected orderedListFormFieldAccessibilityManagerService: OrderedListFormFieldAccessibilityManagerService;
     /**
      * The source name to use for logging
      */
@@ -27,6 +29,10 @@ export declare class OrderedListFormFieldComponent<TValue> extends SmeInternalOp
      * Single selection is not supported by ordered list
      */
     readonly multiple = true;
+    /**
+     * The view child component for the add button.
+     */
+    addButton: ElementRef;
     /**
      * Indicates if the add and remove actions should be shown
      */
@@ -60,13 +66,15 @@ export declare class OrderedListFormFieldComponent<TValue> extends SmeInternalOp
      */
     get ariaLabel(): string;
     /**
-     * Tracks when new item is added to place focus on.
+     * The aria label for the add/remove button when aria label is passed in.
+     * The aria label needs to be in sync with the add button text so that narrator can read the correct content.
+     * It should also respect the required state.
      */
-    private newItemAdded;
+    get addRemoveButtonArialLabel(): string;
     /**
      * Initializes a new instance of the OrderedListFormFieldComponent
      */
-    constructor(injector: Injector);
+    constructor(injector: Injector, orderedListFormFieldAccessibilityManagerService: OrderedListFormFieldAccessibilityManagerService);
     /**
      * The method called after the component is initialized.
      */
@@ -116,10 +124,6 @@ export declare class OrderedListFormFieldComponent<TValue> extends SmeInternalOp
      * @returns The original array with the specified element moved.
      */
     moveItem(startingIndex: number, destinationIndex: number): void;
-    /**
-     * Places focus on new item when it is added.
-     */
-    newItemCheck(): void;
     /**
      * The method called when a <select> element's value changes.
      */

package/angular/src/controls/wizard/models/wizard-step-snap-in-output.d.ts

@@ -1,4 +1,4 @@
-import { SnapInOutput } from '@microsoft/windows-admin-center-sdk/core/data/extension-broker/snap-in-listener';
+import { SnapInOutput } from '../../../data/extension-broker/snap-in-listener';
 /**
  * The model representation snap-in output that is specific to a wizard step.
  */

package/{core → angular/src}/data/extension-broker/snap-in-listener.d.ts

@@ -1,46 +1,49 @@
-import { AfterViewInit, ElementRef } from '@angular/core';
-import { Observable } from 'rxjs';
-import { Rpc } from '../../rpc/rpc';
-import { ExtensionBroker } from './extension-broker';
-import { ExtensionClientListener } from './extension-listener';
-/**
- * Extend this interface to define input structure
- */
-export interface SnapInInput {
-}
-/**
- * Extend this interface to define output structure
- */
-export interface SnapInOutput {
-    deltaY?: number;
-    focusedElementRect?: DOMRect;
-    snapInOutput?: any;
-}
-/**
- * Base class for snap in specific extension listeners
- */
-export declare abstract class SnapInListener<TInput extends SnapInInput, TOutput extends SnapInOutput> extends ExtensionClientListener implements AfterViewInit {
-    extensionBroker: ExtensionBroker;
-    hostElement?: ElementRef;
-    input: TInput;
-    /**
-     * Initializes a new instance of the SnapInListener class
-     * @param rpc The rpc context
-     */
-    constructor(rpc: Rpc, extensionBroker: ExtensionBroker, hostElement?: ElementRef);
-    ngAfterViewInit(): void;
-    /**
-     * Occurs when any method is called on this worker from another extension
-     */
-    protected onCall(method: string, version: number, ...args: any[]): Observable<any | void>;
-    /**
-     * Occurs when an input is received on this snap-in
-     * @param input the input object.
-     */
-    protected onInputReceived(input: TInput): void;
-    /**
-     * Emits an output to the consumer of this snap-in.
-     * @param output the output object.
-     */
-    protected emitOutput(output: TOutput | SnapInOutput): Observable<void>;
-}
+import { AfterViewInit, ElementRef } from '@angular/core';
+import { ExtensionBroker } from '@microsoft/windows-admin-center-sdk/core/data/extension-broker/extension-broker';
+import { ExtensionClientListener } from '@microsoft/windows-admin-center-sdk/core/data/extension-broker/extension-listener';
+import { Rpc } from '@microsoft/windows-admin-center-sdk/core/rpc/rpc';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+/**
+ * Extend this interface to define input structure
+ */
+export interface SnapInInput {
+}
+/**
+ * Extend this interface to define output structure
+ */
+export interface SnapInOutput {
+    deltaY?: number;
+    focusedElementRect?: DOMRect;
+    snapInOutput?: any;
+}
+/**
+ * Base class for snap in specific extension listeners
+ */
+export declare abstract class SnapInListener<TInput extends SnapInInput, TOutput extends SnapInOutput> extends ExtensionClientListener implements AfterViewInit {
+    extensionBroker: ExtensionBroker;
+    hostElement?: ElementRef;
+    input: TInput;
+    /**
+     * Initializes a new instance of the SnapInListener class
+     * @param rpc The rpc context
+     */
+    constructor(rpc: Rpc, extensionBroker: ExtensionBroker, hostElement?: ElementRef);
+    ngAfterViewInit(): void;
+    /**
+     * Occurs when any method is called on this worker from another extension
+     */
+    protected onCall(method: string, version: number, ...args: any[]): Observable<any | void>;
+    /**
+     * Occurs when an input is received on this snap-in
+     * @param input the input object.
+     */
+    protected onInputReceived(input: TInput): void;
+    /**
+     * Emits an output to the consumer of this snap-in.
+     * @param output the output object.
+     */
+    protected emitOutput(output: TOutput | SnapInOutput): Observable<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SnapInListener<any, any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SnapInListener<any, any>, never, never, {}, {}, never, never, false, never>;
+}

package/angular/src/data/index.d.ts

@@ -2,3 +2,4 @@ export { BaseFormData } from './forms/base-form-data';
 export { BasePropertiesForm, FormArrayValidationMessages, FormControlContainerValidationMessages, FormGroupValidationMessages } from './forms/base-properties-form';
 export { EditableCollectionItem } from './forms/editable-collection-item';
 export * from './routing/routing';
+export * from './extension-broker/snap-in-listener';