@angular/material 2.0.0-beta.0 → 2.0.0-beta.12

package/select/typings/select-animations.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+import { AnimationTriggerMetadata } from '@angular/animations';
+/**
+ * The following are all the animations for the mat-select component, with each
+ * const containing the metadata for one animation.
+ *
+ * The values below match the implementation of the AngularJS Material mat-select animation.
+ */
+/**
+ * This animation transforms the select's overlay panel on and off the page.
+ *
+ * When the panel is attached to the DOM, it expands its width by the amount of padding, scales it
+ * up to 100% on the Y axis, fades in its border, and translates slightly up and to the
+ * side to ensure the option text correctly overlaps the trigger text.
+ *
+ * When the panel is removed from the DOM, it simply fades out linearly.
+ */
+export declare const transformPanel: AnimationTriggerMetadata;
+/**
+ * This animation fades in the background color and text content of the
+ * select's options. It is time delayed to occur 100ms after the overlay
+ * panel has transformed in.
+ */
+export declare const fadeInContent: AnimationTriggerMetadata;

package/select/typings/select-errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+/**
+ * Returns an exception to be thrown when attempting to change a select's `multiple` option
+ * after initialization.
+ * @docs-private
+ */
+export declare function getMatSelectDynamicMultipleError(): Error;
+/**
+ * Returns an exception to be thrown when attempting to assign a non-array value to a select
+ * in `multiple` mode. Note that `undefined` and `null` are still valid values to allow for
+ * resetting the value.
+ * @docs-private
+ */
+export declare function getMatSelectNonArrayValueError(): Error;
+/**
+ * Returns an exception to be thrown when assigning a non-function value to the comparator
+ * used to determine if a value corresponds to an option. Note that whether the function
+ * actually takes two values and returns a boolean is not checked.
+ */
+export declare function getMatSelectNonFunctionValueError(): Error;

package/select/typings/select-module.d.ts

@@ -0,0 +1,2 @@
+export declare class MatSelectModule {
+}

package/select/typings/select.d.ts

@@ -0,0 +1,393 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+import { ActiveDescendantKeyManager } from '@angular/cdk/a11y';
+import { Directionality } from '@angular/cdk/bidi';
+import { SelectionModel } from '@angular/cdk/collections';
+import { ConnectedOverlayDirective, Overlay, RepositionScrollStrategy, ScrollStrategy, ViewportRuler } from '@angular/cdk/overlay';
+import { AfterContentInit, ChangeDetectorRef, ElementRef, EventEmitter, InjectionToken, NgZone, OnDestroy, OnInit, QueryList, Renderer2 } from '@angular/core';
+import { ControlValueAccessor, FormGroupDirective, NgControl, NgForm } from '@angular/forms';
+import { CanDisable, HasTabIndex, MatOptgroup, MatOption, MatOptionSelectionChange, ErrorStateMatcher } from '@angular/material/core';
+import { MatFormField, MatFormFieldControl } from '@angular/material/form-field';
+import { Observable } from 'rxjs/Observable';
+import { Subject } from 'rxjs/Subject';
+/**
+ * The following style constants are necessary to save here in order
+ * to properly calculate the alignment of the selected option over
+ * the trigger element.
+ */
+/** The max height of the select's overlay panel */
+export declare const SELECT_PANEL_MAX_HEIGHT = 256;
+/** The panel's padding on the x-axis */
+export declare const SELECT_PANEL_PADDING_X = 16;
+/** The panel's x axis padding if it is indented (e.g. there is an option group). */
+export declare const SELECT_PANEL_INDENT_PADDING_X: number;
+/** The height of the select items in `em` units. */
+export declare const SELECT_ITEM_HEIGHT_EM = 3;
+/**
+ * Distance between the panel edge and the option text in
+ * multi-selection mode.
+ *
+ * (SELECT_PANEL_PADDING_X * 1.5) + 20 = 44
+ * The padding is multiplied by 1.5 because the checkbox's margin is half the padding.
+ * The checkbox width is 20px.
+ */
+export declare const SELECT_MULTIPLE_PANEL_PADDING_X: number;
+/**
+ * The select panel will only "fit" inside the viewport if it is positioned at
+ * this value or more away from the viewport boundary.
+ */
+export declare const SELECT_PANEL_VIEWPORT_PADDING = 8;
+/** Injection token that determines the scroll handling while a select is open. */
+export declare const MAT_SELECT_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
+/** @docs-private */
+export declare function MAT_SELECT_SCROLL_STRATEGY_PROVIDER_FACTORY(overlay: Overlay): () => RepositionScrollStrategy;
+/** @docs-private */
+export declare const MAT_SELECT_SCROLL_STRATEGY_PROVIDER: {
+    provide: InjectionToken<() => ScrollStrategy>;
+    deps: typeof Overlay[];
+    useFactory: (overlay: Overlay) => () => RepositionScrollStrategy;
+};
+/** Change event object that is emitted when the select value has changed. */
+export declare class MatSelectChange {
+    source: MatSelect;
+    value: any;
+    constructor(source: MatSelect, value: any);
+}
+/** @docs-private */
+export declare class MatSelectBase {
+    _renderer: Renderer2;
+    _elementRef: ElementRef;
+    constructor(_renderer: Renderer2, _elementRef: ElementRef);
+}
+export declare const _MatSelectMixinBase: (new (...args: any[]) => HasTabIndex) & (new (...args: any[]) => CanDisable) & typeof MatSelectBase;
+/**
+ * Allows the user to customize the trigger that is displayed when the select has a value.
+ */
+export declare class MatSelectTrigger {
+}
+export declare class MatSelect extends _MatSelectMixinBase implements AfterContentInit, OnDestroy, OnInit, ControlValueAccessor, CanDisable, HasTabIndex, MatFormFieldControl<any> {
+    private _viewportRuler;
+    private _changeDetectorRef;
+    private _ngZone;
+    private _defaultErrorStateMatcher;
+    private _dir;
+    private _parentForm;
+    private _parentFormGroup;
+    private _parentFormField;
+    ngControl: NgControl;
+    private _scrollStrategyFactory;
+    /** Whether or not the overlay panel is open. */
+    private _panelOpen;
+    /** Subscriptions to option events. */
+    private _optionSubscription;
+    /** Subscription to changes in the option list. */
+    private _changeSubscription;
+    /** Subscription to tab events while overlay is focused. */
+    private _tabSubscription;
+    /** Whether filling out the select is required in the form.  */
+    private _required;
+    /** The scroll position of the overlay panel, calculated to center the selected option. */
+    private _scrollTop;
+    /** The placeholder displayed in the trigger of the select. */
+    private _placeholder;
+    /** Whether the component is in multiple selection mode. */
+    private _multiple;
+    /** Comparison function to specify which option is displayed. Defaults to object equality. */
+    private _compareWith;
+    /** Unique id for this input. */
+    private _uid;
+    /** The last measured value for the trigger's client bounding rect. */
+    _triggerRect: ClientRect;
+    /** The aria-describedby attribute on the select for improved a11y. */
+    _ariaDescribedby: string;
+    /** The cached font-size of the trigger element. */
+    _triggerFontSize: number;
+    /** Deals with the selection logic. */
+    _selectionModel: SelectionModel<MatOption>;
+    /** Manages keyboard events for options in the panel. */
+    _keyManager: ActiveDescendantKeyManager<MatOption>;
+    /** View -> model callback called when value changes */
+    _onChange: (value: any) => void;
+    /** View -> model callback called when select has been touched */
+    _onTouched: () => void;
+    /** The IDs of child options to be passed to the aria-owns attribute. */
+    _optionIds: string;
+    /** The value of the select panel's transform-origin property. */
+    _transformOrigin: string;
+    /** Whether the panel's animation is done. */
+    _panelDoneAnimating: boolean;
+    /** Strategy that will be used to handle scrolling while the select panel is open. */
+    _scrollStrategy: any;
+    /**
+     * The y-offset of the overlay panel in relation to the trigger's top start corner.
+     * This must be adjusted to align the selected option text over the trigger text.
+     * when the panel opens. Will change based on the y-position of the selected option.
+     */
+    _offsetY: number;
+    /**
+     * This position config ensures that the top "start" corner of the overlay
+     * is aligned with with the top "start" of the origin by default (overlapping
+     * the trigger completely). If the panel cannot fit below the trigger, it
+     * will fall back to a position above the trigger.
+     */
+    _positions: {
+        originX: string;
+        originY: string;
+        overlayX: string;
+        overlayY: string;
+    }[];
+    /**
+     * Stream that emits whenever the state of the select changes such that the wrapping
+     * `MatFormField` needs to run change detection.
+     */
+    stateChanges: Subject<void>;
+    /** Whether the select is focused. */
+    focused: boolean;
+    /** A name for this control that can be used by `mat-form-field`. */
+    controlType: string;
+    /** Trigger that opens the select. */
+    trigger: ElementRef;
+    /** Panel containing the select options. */
+    panel: ElementRef;
+    /** Overlay pane containing the options. */
+    overlayDir: ConnectedOverlayDirective;
+    /** All of the defined select options. */
+    options: QueryList<MatOption>;
+    /** All of the defined groups of options. */
+    optionGroups: QueryList<MatOptgroup>;
+    /** Classes to be passed to the select panel. Supports the same syntax as `ngClass`. */
+    panelClass: string | string[] | Set<string> | {
+        [key: string]: any;
+    };
+    /** User-supplied override of the trigger element. */
+    customTrigger: MatSelectTrigger;
+    /** Placeholder to be shown if no value has been selected. */
+    placeholder: string;
+    /** Whether the component is required. */
+    required: any;
+    /** Whether the user should be allowed to select multiple options. */
+    multiple: boolean;
+    /**
+     * A function to compare the option values with the selected values. The first argument
+     * is a value from an option. The second is a value from the selection. A boolean
+     * should be returned.
+     */
+    compareWith: (o1: any, o2: any) => boolean;
+    /** Value of the select control. */
+    value: any;
+    private _value;
+    /** Whether ripples for all options in the select are disabled. */
+    disableRipple: boolean;
+    private _disableRipple;
+    /** Aria label of the select. If not specified, the placeholder will be used as label. */
+    ariaLabel: string;
+    /** Input that can be used to specify the `aria-labelledby` attribute. */
+    ariaLabelledby: string;
+    /** An object used to control when error messages are shown. */
+    errorStateMatcher: ErrorStateMatcher;
+    /** Unique id of the element. */
+    id: string;
+    private _id;
+    /** Combined stream of all of the child options' change events. */
+    readonly optionSelectionChanges: Observable<MatOptionSelectionChange>;
+    /** Event emitted when the select has been opened. */
+    onOpen: EventEmitter<void>;
+    /** Event emitted when the select has been closed. */
+    onClose: EventEmitter<void>;
+    /** Event emitted when the selected value has been changed by the user. */
+    change: EventEmitter<MatSelectChange>;
+    /**
+     * Event that emits whenever the raw value of the select changes. This is here primarily
+     * to facilitate the two-way binding for the `value` input.
+     * @docs-private
+     */
+    valueChange: EventEmitter<any>;
+    constructor(_viewportRuler: ViewportRuler, _changeDetectorRef: ChangeDetectorRef, _ngZone: NgZone, _defaultErrorStateMatcher: ErrorStateMatcher, renderer: Renderer2, elementRef: ElementRef, _dir: Directionality, _parentForm: NgForm, _parentFormGroup: FormGroupDirective, _parentFormField: MatFormField, ngControl: NgControl, tabIndex: string, _scrollStrategyFactory: any);
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngOnDestroy(): void;
+    /** Toggles the overlay panel open or closed. */
+    toggle(): void;
+    /** Opens the overlay panel. */
+    open(): void;
+    /** Closes the overlay panel and focuses the host element. */
+    close(): void;
+    /**
+     * Sets the select's value. Part of the ControlValueAccessor interface
+     * required to integrate with Angular's core forms API.
+     *
+     * @param value New value to be written to the model.
+     */
+    writeValue(value: any): void;
+    /**
+     * Saves a callback function to be invoked when the select's value
+     * changes from user input. Part of the ControlValueAccessor interface
+     * required to integrate with Angular's core forms API.
+     *
+     * @param fn Callback to be triggered when the value changes.
+     */
+    registerOnChange(fn: (value: any) => void): void;
+    /**
+     * Saves a callback function to be invoked when the select is blurred
+     * by the user. Part of the ControlValueAccessor interface required
+     * to integrate with Angular's core forms API.
+     *
+     * @param fn Callback to be triggered when the component has been touched.
+     */
+    registerOnTouched(fn: () => {}): void;
+    /**
+     * Disables the select. Part of the ControlValueAccessor interface required
+     * to integrate with Angular's core forms API.
+     *
+     * @param isDisabled Sets whether the component is disabled.
+     */
+    setDisabledState(isDisabled: boolean): void;
+    /** Whether or not the overlay panel is open. */
+    readonly panelOpen: boolean;
+    /** The currently selected option. */
+    readonly selected: MatOption | MatOption[];
+    /** The value displayed in the trigger. */
+    readonly triggerValue: string;
+    /** Whether the element is in RTL mode. */
+    _isRtl(): boolean;
+    /** Handles all keydown events on the select. */
+    _handleKeydown(event: KeyboardEvent): void;
+    /** Handles keyboard events while the select is closed. */
+    private _handleClosedKeydown(event);
+    /** Handles keyboard events when the selected is open. */
+    private _handleOpenKeydown(event);
+    /**
+     * When the panel element is finished transforming in (though not fading in), it
+     * emits an event and focuses an option if the panel is open.
+     */
+    _onPanelDone(): void;
+    /**
+     * When the panel content is done fading in, the _panelDoneAnimating property is
+     * set so the proper class can be added to the panel.
+     */
+    _onFadeInDone(): void;
+    _onFocus(): void;
+    /**
+     * Calls the touched callback only if the panel is closed. Otherwise, the trigger will
+     * "blur" to the panel when it opens, causing a false positive.
+     */
+    _onBlur(): void;
+    /**
+     * Callback that is invoked when the overlay panel has been attached.
+     */
+    _onAttached(): void;
+    /** Returns the theme to be used on the panel. */
+    _getPanelTheme(): string;
+    /** Whether the select has a value. */
+    readonly empty: boolean;
+    /** Whether the select is in an error state. */
+    readonly errorState: boolean;
+    private _initializeSelection();
+    /**
+     * Sets the selected option based on a value. If no option can be
+     * found with the designated value, the select trigger is cleared.
+     */
+    private _setSelectionByValue(value, isUserInput?);
+    /**
+     * Finds and selects and option based on its value.
+     * @returns Option that has the corresponding value.
+     */
+    private _selectValue(value, isUserInput?);
+    /**
+     * Clears the select trigger and deselects every option in the list.
+     * @param skip Option that should not be deselected.
+     */
+    private _clearSelection(skip?);
+    /** Sets up a key manager to listen to keyboard events on the overlay panel. */
+    private _initKeyManager();
+    /** Drops current option subscriptions and IDs and resets from scratch. */
+    private _resetOptions();
+    /** Listens to user-generated selection events on each option. */
+    private _listenToOptions();
+    /** Invoked when an option is clicked. */
+    private _onSelect(option);
+    /**
+     * Sorts the model values, ensuring that they keep the same
+     * order that they have in the panel.
+     */
+    private _sortValues();
+    /** Unsubscribes from all option subscriptions. */
+    private _dropSubscriptions();
+    /** Emits change event to set the model value. */
+    private _propagateChanges(fallbackValue?);
+    /** Records option IDs to pass to the aria-owns property. */
+    private _setOptionIds();
+    /**
+     * Sets the `multiple` property on each option. The promise is necessary
+     * in order to avoid Angular errors when modifying the property after init.
+     */
+    private _setOptionMultiple();
+    /** Sets the `disableRipple` property on each option. */
+    private _setOptionDisableRipple();
+    /**
+     * Highlights the selected item. If no option is selected, it will highlight
+     * the first item instead.
+     */
+    private _highlightCorrectOption();
+    /** Scrolls the active option into view. */
+    private _scrollActiveOptionIntoView();
+    /** Focuses the select element. */
+    focus(): void;
+    /** Gets the index of the provided option in the option list. */
+    private _getOptionIndex(option);
+    /** Calculates the scroll position and x- and y-offsets of the overlay panel. */
+    private _calculateOverlayPosition();
+    /**
+     * Calculates the scroll position of the select's overlay panel.
+     *
+     * Attempts to center the selected option in the panel. If the option is
+     * too high or too low in the panel to be scrolled to the center, it clamps the
+     * scroll position to the min or max scroll positions respectively.
+     */
+    _calculateOverlayScroll(selectedIndex: number, scrollBuffer: number, maxScroll: number): number;
+    /** Returns the aria-label of the select component. */
+    readonly _ariaLabel: string | null;
+    /** Determines the `aria-activedescendant` to be set on the host. */
+    _getAriaActiveDescendant(): string | null;
+    /**
+     * Sets the x-offset of the overlay panel in relation to the trigger's top start corner.
+     * This must be adjusted to align the selected option text over the trigger text when
+     * the panel opens. Will change based on LTR or RTL text direction. Note that the offset
+     * can't be calculated until the panel has been attached, because we need to know the
+     * content width in order to constrain the panel within the viewport.
+     */
+    private _calculateOverlayOffsetX();
+    /**
+     * Calculates the y-offset of the select's overlay panel in relation to the
+     * top start corner of the trigger. It has to be adjusted in order for the
+     * selected option to be aligned over the trigger when the panel opens.
+     */
+    private _calculateOverlayOffsetY(selectedIndex, scrollBuffer, maxScroll);
+    /**
+     * Checks that the attempted overlay position will fit within the viewport.
+     * If it will not fit, tries to adjust the scroll position and the associated
+     * y-offset so the panel can open fully on-screen. If it still won't fit,
+     * sets the offset back to 0 to allow the fallback position to take over.
+     */
+    private _checkOverlayWithinViewport(maxScroll);
+    /** Adjusts the overlay panel up to fit in the viewport. */
+    private _adjustPanelUp(panelHeightBottom, bottomSpaceAvailable);
+    /** Adjusts the overlay panel down to fit in the viewport. */
+    private _adjustPanelDown(panelHeightTop, topSpaceAvailable, maxScroll);
+    /** Sets the transform origin point based on the selected option. */
+    private _getOriginBasedOnOption();
+    /** Handles the user pressing the arrow keys on a closed select.  */
+    private _handleClosedArrowKey(event);
+    /** Calculates the amount of items in the select. This includes options and group labels. */
+    private _getItemCount();
+    /** Calculates the height of the select's options. */
+    private _getItemHeight();
+    setDescribedByIds(ids: string[]): void;
+    onContainerClick(): void;
+    readonly shouldPlaceholderFloat: boolean;
+}

package/select.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+export * from './select/index';

package/select.metadata.json

@@ -0,0 +1,12 @@
+{
+  "__symbolic": "module",
+  "version": 3,
+  "metadata": {},
+  "exports": [
+    {
+      "from": "./select/index"
+    }
+  ],
+  "flatModuleIndexRedirect": true,
+  "importAs": "@angular/material/select"
+}

package/sidenav/index.d.ts

@@ -1 +1,8 @@
-export * from './sidenav';
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+export * from './typings/index';

package/sidenav/index.metadata.json

@@ -1 +1,12 @@
-[{"__symbolic":"module","version":2,"metadata":{},"exports":[{"from":"./sidenav"}]},{"__symbolic":"module","exports":[{"from":"./sidenav"}],"metadata":{},"version":1}]
+{
+  "__symbolic": "module",
+  "version": 3,
+  "metadata": {},
+  "exports": [
+    {
+      "from": "./typings/index"
+    }
+  ],
+  "flatModuleIndexRedirect": true,
+  "importAs": "@angular/material/sidenav"
+}

package/sidenav/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@angular/material/sidenav",
+  "typings": "../sidenav.d.ts",
+  "main": "../bundles/material-sidenav.umd.js",
+  "module": "../esm5/sidenav.es5.js",
+  "es2015": "../esm2015/sidenav.js"
+}