@bespunky/angular-zen
Version:
The Angular tools you always wished were there.
145 lines • 20.5 kB
JavaScript
import { Observable } from 'rxjs';
import { Directive, Input } from '@angular/core';
import { OnObserverBaseDirective } from '../abstraction/on-observer-base.directive';
import * as i0 from "@angular/core";
/**
* Documentation in {@link OnObserverNextDirective.onObserverNext} to allow in-template tooltips.
*
* @export
* @class OnObserverNextDirective
* @extends {OnObserverBaseDirective<T>}
* @template T The type of value the observable emits.
*/
export class OnObserverNextDirective extends OnObserverBaseDirective {
constructor() {
super(...arguments);
this.selector = 'onObserverNext';
this.renderOnCallsTo = 'next';
}
/**
* Renders the template when the specified observable emits a value.
*
* ## Features
*
* #### View Context
* Use the microsyntax `as` keyword to assign resolved values to a variable.
* Use the microsyntax `let` keyword to assign the {@link OnObserverContext full context object} to a variable (e.g. `let context`).
*
* #### Delayed rendering
* Specify a value for {@link OnObserverBaseDirective.showAfter `showAfter`} to delay rendering.
*
* #### Auto destroy
* Specify {@link OnObserverBaseDirective.showFor `showFor`} to automatically destroy the view after a certain duration.
*
* #### Countdown updates
* When {@link OnObserverBaseDirective.showFor `showFor`} is specified, the view context will be updated with the time remaining until the view
* is destroyed and the time elapsed since it was rendered. This allows giving the user feedback in a progress bar, a spinner, a textual timer
* or any other UI component.
*
* Remaining is provided by the {@link OnObserverContext.remaining `remaining`} property. Elapsed time is provided by the {@link OnObserverContext.elapsed `elapsed`}
* property. Access it by assigning a variable using `let`, like so:
* `let remaining = remaining`
*
* #### Multi view mode
* Specify {@link OnObserverBaseDirective.viewMode `viewMode = 'multiple'`} to enable rendering a new view for each intercepted call
* instead of updating a single rendered view. This allows stacking logs, notification snackbars, or any other aggregation functionality.
* Combined with {@link OnObserverBaseDirective.showFor `showFor`}, this is great for disappearing messages/notifications.
*
* #### View index
* In multi-view mode, the context will contain the index of the view, which can be used for calculations and styling.
*/
set onObserverNext(value) { this.input.next(value); }
/**
* (Optional) The view mode the directive will operate in:
* `'single'` - A single view will be rendered on intercepted calls. If a view has already been rendered when a call is intercepted,
* the existing view will be updated with data from the new call.
*
* `'multiple'` - Every new intercepted call will render a new view with its own context and data encapsulated from the current call.
*
* Default is `'single'`.
*/
set onObserverNextViewMode(viewMode) { this.viewMode = viewMode; }
/**
* (Optional) The duration for which the directive should wait before rendering the view once an intercepted call is made.
*
* You can specify a number, which will be treated as milliseconds, or a string with the format of `<number><ms | s | ms>`.
* Numbers can be either integers or floats.
* For example:
* - `3000` - Wait for 3 seconds, then render the view.
* - `'10s'` - Wait for 10 seconds, then render the view.
* - `'0.5m'` - Wait for 30 seconds, then render the view.
* - `'100ms'` - Wait for 100 milliseconds, then render the view.
*
* Default is `0`, meaning immediately render the view.
*
* TODO: ADD LINK TO TOUR OR FULL WIKI PAGE
* Read more {@link OnObserverBaseDirective About render flow}.
**/
set onObserverNextShowAfter(duration) { this.showAfter = duration; }
/**
* (Optional) The duration for which the view should be rendered. When the duration passes, the view will be auto destroyed.
*
* You can specify a number, which will be treated as milliseconds, or a string with the format of `<number><ms | s | ms>`.
* Numbers can be either integers or floats.
* For example:
* - `3000` - The view will be destroyed after 3 seconds.
* - `'10s'` - The view will be destroyed after 10 seconds.
* - `'0.5m'` - The view will be destroyed after 30 seconds.
* - `'100ms'` - The view will be destroyed after 100 milliseconds.
*
* During the time the view is rendered, the context will be updated with a countdown object to facilitate any UI part used to
* indicate countdown to the user. The countdown will be exposed through the {@link OnObserverContext.remaining `remaining`}
* property and the elapsed time through {@link OnObserverContext.elapsed `elapsed`} property in the view context and can both
* be accessed be declaring a `let` variable (e.g. `let remaining = remaining`).
* See {@link OnObserverBaseDirective.countdownInterval `countdownInterval`} for changing the updates interval.
*
* When unspecified, the view will be destroyed immediately once the observer detects a call different to the intercepted ones.
*
* TODO: ADD LINK TO TOUR OR FULL WIKI PAGE
* Read more {@link OnObserverBaseDirective About render flow}.
**/
set onObserverNextShowFor(duration) { this.showFor = duration; }
;
/**
* ### Only used when passing a value to {@link OnObserverBaseDirective.showFor `showFor`}.
*
* (Optional) The interval with which countdown updates should be made to the view's context before it auto destroys.
* The lower the value, the more updates will be made to the context, but the more resources your directive will consume.
*
* You can specify a number, which will be treated as milliseconds, or a string with the format of `<number><ms | s | ms>`.
* Numbers can be either integers or floats.
* For example:
* - `3000` - 3 seconds between each update.
* - `'10s'` - 10 seconds between each update.
* - `'0.5m'` - 30 seconds between each update.
* - `'100ms'` - 100 milliseconds between each update.
*
* You can also specify `'animationFrames'` so the countdown gets updated each time the browser is working on animations.
*
* When unspecified, the total duration of the countdown will be divided by {@link DefaultCountdownUpdateCount `DefaultCountdownUpdateCount`}
* to get a fixed interval which will make for {@link DefaultCountdownUpdateCount `DefaultCountdownUpdateCount`} countdown updates.
*/
set onObserverNextCountdownInterval(duration) { this.countdownInterval = duration; }
;
static ngTemplateContextGuard(directive, context) { return true; }
}
OnObserverNextDirective.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "14.2.12", ngImport: i0, type: OnObserverNextDirective, deps: null, target: i0.ɵɵFactoryTarget.Directive });
OnObserverNextDirective.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "14.2.12", type: OnObserverNextDirective, selector: "[onObserverNext]", inputs: { onObserverNext: "onObserverNext", onObserverNextViewMode: "onObserverNextViewMode", onObserverNextShowAfter: "onObserverNextShowAfter", onObserverNextShowFor: "onObserverNextShowFor", onObserverNextCountdownInterval: "onObserverNextCountdownInterval" }, usesInheritance: true, ngImport: i0 });
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "14.2.12", ngImport: i0, type: OnObserverNextDirective, decorators: [{
type: Directive,
args: [{
// eslint-disable-next-line @angular-eslint/directive-selector
selector: '[onObserverNext]'
}]
}], propDecorators: { onObserverNext: [{
type: Input
}], onObserverNextViewMode: [{
type: Input
}], onObserverNextShowAfter: [{
type: Input
}], onObserverNextShowFor: [{
type: Input
}], onObserverNextCountdownInterval: [{
type: Input
}] } });
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib24tb2JzZXJ2ZXItbmV4dC5kaXJlY3RpdmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi8uLi9saWJzL2FuZ3VsYXItemVuL2NvcmUvc3JjL3J4anMvb24tb2JzZXJ2ZXIvZGlyZWN0aXZlcy9vbi1vYnNlcnZlci1uZXh0LmRpcmVjdGl2ZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFRLE1BQU0sTUFBTSxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxTQUFTLEVBQUUsS0FBSyxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBSWpELE9BQU8sRUFBRSx1QkFBdUIsRUFBcUIsTUFBTSwyQ0FBMkMsQ0FBQzs7QUFFdkc7Ozs7Ozs7R0FPRztBQUtILE1BQU0sT0FBTyx1QkFBMkIsU0FBUSx1QkFBMEI7SUFKMUU7O1FBTWMsYUFBUSxHQUF3QixnQkFBZ0IsQ0FBQztRQUNqRCxvQkFBZSxHQUFpQixNQUFNLENBQUM7S0E0R3BEO0lBMUdHOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O09BK0JHO0lBQ0gsSUFBb0IsY0FBYyxDQUFDLEtBQW9CLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBRXBGOzs7Ozs7OztPQVFHO0lBQ0gsSUFBb0Isc0JBQXNCLENBQVUsUUFBa0IsSUFBYyxJQUFJLENBQUMsUUFBUSxHQUFZLFFBQVEsQ0FBQyxDQUFDLENBQUM7SUFDeEg7Ozs7Ozs7Ozs7Ozs7OztRQWVJO0lBQ0osSUFBb0IsdUJBQXVCLENBQVMsUUFBNEIsSUFBSSxJQUFJLENBQUMsU0FBUyxHQUFXLFFBQVEsQ0FBQyxDQUFDLENBQUM7SUFDeEg7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztRQXFCSTtJQUNKLElBQW9CLHFCQUFxQixDQUFXLFFBQTRCLElBQUksSUFBSSxDQUFDLE9BQU8sR0FBYSxRQUFRLENBQUMsQ0FBQyxDQUFDO0lBQUEsQ0FBQztJQUN6SDs7Ozs7Ozs7Ozs7Ozs7Ozs7O09Ba0JHO0lBQ0gsSUFBb0IsK0JBQStCLENBQUMsUUFBZ0QsSUFBSSxJQUFJLENBQUMsaUJBQWlCLEdBQUcsUUFBUSxDQUFDLENBQUMsQ0FBQztJQUFBLENBQUM7SUFFN0ksTUFBTSxDQUFDLHNCQUFzQixDQUFJLFNBQXFDLEVBQUUsT0FBZ0IsSUFBcUMsT0FBTyxJQUFJLENBQUMsQ0FBQyxDQUFDOztxSEE5R2xJLHVCQUF1Qjt5R0FBdkIsdUJBQXVCOzRGQUF2Qix1QkFBdUI7a0JBSm5DLFNBQVM7bUJBQUM7b0JBQ1AsOERBQThEO29CQUM5RCxRQUFRLEVBQUUsa0JBQWtCO2lCQUMvQjs4QkFzQ3VCLGNBQWM7c0JBQWpDLEtBQUs7Z0JBV2Msc0JBQXNCO3NCQUF6QyxLQUFLO2dCQWlCYyx1QkFBdUI7c0JBQTFDLEtBQUs7Z0JBdUJjLHFCQUFxQjtzQkFBeEMsS0FBSztnQkFvQmMsK0JBQStCO3NCQUFsRCxLQUFLIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgT2JzZXJ2YWJsZSAgICAgICB9IGZyb20gJ3J4anMnO1xuaW1wb3J0IHsgRGlyZWN0aXZlLCBJbnB1dCB9IGZyb20gJ0Bhbmd1bGFyL2NvcmUnO1xuXG5pbXBvcnQgeyBEdXJhdGlvbkFubm90YXRpb24sIE9ic2VydmVyTmFtZSwgVmlld01vZGUgfSBmcm9tICcuLi9hYnN0cmFjdGlvbi90eXBlcy9nZW5lcmFsJztcbmltcG9ydCB7IE9uT2JzZXJ2ZXJDb250ZXh0ICAgICAgICAgICAgICAgICAgICAgICAgICB9IGZyb20gJy4uL2Fic3RyYWN0aW9uL3R5cGVzL29uLW9ic2VydmVyLWNvbnRleHQnO1xuaW1wb3J0IHsgT25PYnNlcnZlckJhc2VEaXJlY3RpdmUgICAgICAgICAgICAgICAgICAgIH0gZnJvbSAnLi4vYWJzdHJhY3Rpb24vb24tb2JzZXJ2ZXItYmFzZS5kaXJlY3RpdmUnO1xuXG4vKipcbiAqIERvY3VtZW50YXRpb24gaW4ge0BsaW5rIE9uT2JzZXJ2ZXJOZXh0RGlyZWN0aXZlLm9uT2JzZXJ2ZXJOZXh0fSB0byBhbGxvdyBpbi10ZW1wbGF0ZSB0b29sdGlwcy5cbiAqXG4gKiBAZXhwb3J0XG4gKiBAY2xhc3MgT25PYnNlcnZlck5leHREaXJlY3RpdmVcbiAqIEBleHRlbmRzIHtPbk9ic2VydmVyQmFzZURpcmVjdGl2ZTxUPn1cbiAqIEB0ZW1wbGF0ZSBUIFRoZSB0eXBlIG9mIHZhbHVlIHRoZSBvYnNlcnZhYmxlIGVtaXRzLlxuICovXG5ARGlyZWN0aXZlKHtcbiAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQGFuZ3VsYXItZXNsaW50L2RpcmVjdGl2ZS1zZWxlY3RvclxuICAgIHNlbGVjdG9yOiAnW29uT2JzZXJ2ZXJOZXh0XSdcbn0pXG5leHBvcnQgY2xhc3MgT25PYnNlcnZlck5leHREaXJlY3RpdmU8VD4gZXh0ZW5kcyBPbk9ic2VydmVyQmFzZURpcmVjdGl2ZTxUPlxue1xuICAgIHByb3RlY3RlZCBzZWxlY3RvciAgICAgICAgICAgICAgICAgICAgICA9ICdvbk9ic2VydmVyTmV4dCc7XG4gICAgcHJvdGVjdGVkIHJlbmRlck9uQ2FsbHNUbzogT2JzZXJ2ZXJOYW1lID0gJ25leHQnO1xuICAgIFxuICAgIC8qKlxuICAgICAqIFJlbmRlcnMgdGhlIHRlbXBsYXRlIHdoZW4gdGhlIHNwZWNpZmllZCBvYnNlcnZhYmxlIGVtaXRzIGEgdmFsdWUuXG4gICAgICogXG4gICAgICogIyMgRmVhdHVyZXNcbiAgICAgKiBcbiAgICAgKiAjIyMjIFZpZXcgQ29udGV4dFxuICAgICAqIFVzZSB0aGUgbWljcm9zeW50YXggYGFzYCBrZXl3b3JkIHRvIGFzc2lnbiByZXNvbHZlZCB2YWx1ZXMgdG8gYSB2YXJpYWJsZS5cbiAgICAgKiBVc2UgdGhlIG1pY3Jvc3ludGF4IGBsZXRgIGtleXdvcmQgdG8gYXNzaWduIHRoZSB7QGxpbmsgT25PYnNlcnZlckNvbnRleHQgZnVsbCBjb250ZXh0IG9iamVjdH0gdG8gYSB2YXJpYWJsZSAoZS5nLiBgbGV0IGNvbnRleHRgKS5cbiAgICAgKiAgXG4gICAgICogIyMjIyBEZWxheWVkIHJlbmRlcmluZ1xuICAgICAqIFNwZWNpZnkgYSB2YWx1ZSBmb3Ige0BsaW5rIE9uT2JzZXJ2ZXJCYXNlRGlyZWN0aXZlLnNob3dBZnRlciBgc2hvd0FmdGVyYH0gdG8gZGVsYXkgcmVuZGVyaW5nLlxuICAgICAqIFxuICAgICAqICMjIyMgQXV0byBkZXN0cm95XG4gICAgICogU3BlY2lmeSB7QGxpbmsgT25PYnNlcnZlckJhc2VEaXJlY3RpdmUuc2hvd0ZvciBgc2hvd0ZvcmB9IHRvIGF1dG9tYXRpY2FsbHkgZGVzdHJveSB0aGUgdmlldyBhZnRlciBhIGNlcnRhaW4gZHVyYXRpb24uXG4gICAgICogXG4gICAgICogIyMjIyBDb3VudGRvd24gdXBkYXRlc1xuICAgICAqIFdoZW4ge0BsaW5rIE9uT2JzZXJ2ZXJCYXNlRGlyZWN0aXZlLnNob3dGb3IgYHNob3dGb3JgfSBpcyBzcGVjaWZpZWQsIHRoZSB2aWV3IGNvbnRleHQgd2lsbCBiZSB1cGRhdGVkIHdpdGggdGhlIHRpbWUgcmVtYWluaW5nIHVudGlsIHRoZSB2aWV3XG4gICAgICogaXMgZGVzdHJveWVkIGFuZCB0aGUgdGltZSBlbGFwc2VkIHNpbmNlIGl0IHdhcyByZW5kZXJlZC4gVGhpcyBhbGxvd3MgZ2l2aW5nIHRoZSB1c2VyIGZlZWRiYWNrIGluIGEgcHJvZ3Jlc3MgYmFyLCBhIHNwaW5uZXIsIGEgdGV4dHVhbCB0aW1lclxuICAgICAqIG9yIGFueSBvdGhlciBVSSBjb21wb25lbnQuIFxuICAgICAqIFxuICAgICAqIFJlbWFpbmluZyBpcyBwcm92aWRlZCBieSB0aGUge0BsaW5rIE9uT2JzZXJ2ZXJDb250ZXh0LnJlbWFpbmluZyBgcmVtYWluaW5nYH0gcHJvcGVydHkuIEVsYXBzZWQgdGltZSBpcyBwcm92aWRlZCBieSB0aGUge0BsaW5rIE9uT2JzZXJ2ZXJDb250ZXh0LmVsYXBzZWQgYGVsYXBzZWRgfVxuICAgICAqIHByb3BlcnR5LiBBY2Nlc3MgaXQgYnkgYXNzaWduaW5nIGEgdmFyaWFibGUgdXNpbmcgYGxldGAsIGxpa2Ugc286ICBcbiAgICAgKiBgbGV0IHJlbWFpbmluZyA9IHJlbWFpbmluZ2BcbiAgICAgKiBcbiAgICAgKiAjIyMjIE11bHRpIHZpZXcgbW9kZVxuICAgICAqIFNwZWNpZnkge0BsaW5rIE9uT2JzZXJ2ZXJCYXNlRGlyZWN0aXZlLnZpZXdNb2RlIGB2aWV3TW9kZSA9ICdtdWx0aXBsZSdgfSB0byBlbmFibGUgcmVuZGVyaW5nIGEgbmV3IHZpZXcgZm9yIGVhY2ggaW50ZXJjZXB0ZWQgY2FsbFxuICAgICAqIGluc3RlYWQgb2YgdXBkYXRpbmcgYSBzaW5nbGUgcmVuZGVyZWQgdmlldy4gVGhpcyBhbGxvd3Mgc3RhY2tpbmcgbG9ncywgbm90aWZpY2F0aW9uIHNuYWNrYmFycywgb3IgYW55IG90aGVyIGFnZ3JlZ2F0aW9uIGZ1bmN0aW9uYWxpdHkuXG4gICAgICogQ29tYmluZWQgd2l0aCB7QGxpbmsgT25PYnNlcnZlckJhc2VEaXJlY3RpdmUuc2hvd0ZvciBgc2hvd0ZvcmB9LCB0aGlzIGlzIGdyZWF0IGZvciBkaXNhcHBlYXJpbmcgbWVzc2FnZXMvbm90aWZpY2F0aW9ucy5cbiAgICAgKiBcbiAgICAgKiAjIyMjIFZpZXcgaW5kZXhcbiAgICAgKiBJbiBtdWx0aS12aWV3IG1vZGUsIHRoZSBjb250ZXh0IHdpbGwgY29udGFpbiB0aGUgaW5kZXggb2YgdGhlIHZpZXcsIHdoaWNoIGNhbiBiZSB1c2VkIGZvciBjYWxjdWxhdGlvbnMgYW5kIHN0eWxpbmcuXG4gICAgICovXG4gICAgQElucHV0KCkgcHVibGljIHNldCBvbk9ic2VydmVyTmV4dCh2YWx1ZTogT2JzZXJ2YWJsZTxUPikgeyB0aGlzLmlucHV0Lm5leHQodmFsdWUpOyB9XG5cbiAgICAvKipcbiAgICAgKiAoT3B0aW9uYWwpIFRoZSB2aWV3IG1vZGUgdGhlIGRpcmVjdGl2ZSB3aWxsIG9wZXJhdGUgaW46ICBcbiAgICAgKiBgJ3NpbmdsZSdgIC0gQSBzaW5nbGUgdmlldyB3aWxsIGJlIHJlbmRlcmVkIG9uIGludGVyY2VwdGVkIGNhbGxzLiBJZiBhIHZpZXcgaGFzIGFscmVhZHkgYmVlbiByZW5kZXJlZCB3aGVuIGEgY2FsbCBpcyBpbnRlcmNlcHRlZCxcbiAgICAgKiB0aGUgZXhpc3RpbmcgdmlldyB3aWxsIGJlIHVwZGF0ZWQgd2l0aCBkYXRhIGZyb20gdGhlIG5ldyBjYWxsLlxuICAgICAqIFxuICAgICAqIGAnbXVsdGlwbGUnYCAtIEV2ZXJ5IG5ldyBpbnRlcmNlcHRlZCBjYWxsIHdpbGwgcmVuZGVyIGEgbmV3IHZpZXcgd2l0aCBpdHMgb3duIGNvbnRleHQgYW5kIGRhdGEgZW5jYXBzdWxhdGVkIGZyb20gdGhlIGN1cnJlbnQgY2FsbC5cbiAgICAgKiBcbiAgICAgKiBEZWZhdWx0IGlzIGAnc2luZ2xlJ2AuXG4gICAgICovXG4gICAgQElucHV0KCkgcHVibGljIHNldCBvbk9ic2VydmVyTmV4dFZpZXdNb2RlICAgICAgICAgKHZpZXdNb2RlOiBWaWV3TW9kZSAgICAgICAgICApIHsgdGhpcy52aWV3TW9kZSAgICAgICAgICA9IHZpZXdNb2RlOyB9XG4gICAgLyoqXG4gICAgICogKE9wdGlvbmFsKSBUaGUgZHVyYXRpb24gZm9yIHdoaWNoIHRoZSBkaXJlY3RpdmUgc2hvdWxkIHdhaXQgYmVmb3JlIHJlbmRlcmluZyB0aGUgdmlldyBvbmNlIGFuIGludGVyY2VwdGVkIGNhbGwgaXMgbWFkZS5cbiAgICAgKiBcbiAgICAgKiBZb3UgY2FuIHNwZWNpZnkgYSBudW1iZXIsIHdoaWNoIHdpbGwgYmUgdHJlYXRlZCBhcyBtaWxsaXNlY29uZHMsIG9yIGEgc3RyaW5nIHdpdGggdGhlIGZvcm1hdCBvZiBgPG51bWJlcj48bXMgfCBzIHwgbXM+YC5cbiAgICAgKiBOdW1iZXJzIGNhbiBiZSBlaXRoZXIgaW50ZWdlcnMgb3IgZmxvYXRzLlxuICAgICAqIEZvciBleGFtcGxlOlxuICAgICAqIC0gYDMwMDBgIC0gV2FpdCBmb3IgMyBzZWNvbmRzLCB0aGVuIHJlbmRlciB0aGUgdmlldy5cbiAgICAgKiAtIGAnMTBzJ2AgLSBXYWl0IGZvciAxMCBzZWNvbmRzLCB0aGVuIHJlbmRlciB0aGUgdmlldy5cbiAgICAgKiAtIGAnMC41bSdgIC0gV2FpdCBmb3IgMzAgc2Vjb25kcywgdGhlbiByZW5kZXIgdGhlIHZpZXcuXG4gICAgICogLSBgJzEwMG1zJ2AgLSBXYWl0IGZvciAxMDAgbWlsbGlzZWNvbmRzLCB0aGVuIHJlbmRlciB0aGUgdmlldy5cbiAgICAgKiBcbiAgICAgKiBEZWZhdWx0IGlzIGAwYCwgbWVhbmluZyBpbW1lZGlhdGVseSByZW5kZXIgdGhlIHZpZXcuXG4gICAgICpcbiAgICAgKiBUT0RPOiBBREQgTElOSyBUTyBUT1VSIE9SIEZVTEwgV0lLSSBQQUdFXG4gICAgICogUmVhZCBtb3JlIHtAbGluayBPbk9ic2VydmVyQmFzZURpcmVjdGl2ZSBBYm91dCByZW5kZXIgZmxvd30uXG4gICAgICoqL1xuICAgIEBJbnB1dCgpIHB1YmxpYyBzZXQgb25PYnNlcnZlck5leHRTaG93QWZ0ZXIgICAgICAgIChkdXJhdGlvbjogRHVyYXRpb25Bbm5vdGF0aW9uKSB7IHRoaXMuc2hvd0FmdGVyICAgICAgICAgPSBkdXJhdGlvbjsgfVxuICAgIC8qKlxuICAgICAqIChPcHRpb25hbCkgVGhlIGR1cmF0aW9uIGZvciB3aGljaCB0aGUgdmlldyBzaG91bGQgYmUgcmVuZGVyZWQuIFdoZW4gdGhlIGR1cmF0aW9uIHBhc3NlcywgdGhlIHZpZXcgd2lsbCBiZSBhdXRvIGRlc3Ryb3llZC5cbiAgICAgKlxuICAgICAqIFlvdSBjYW4gc3BlY2lmeSBhIG51bWJlciwgd2hpY2ggd2lsbCBiZSB0cmVhdGVkIGFzIG1pbGxpc2Vjb25kcywgb3IgYSBzdHJpbmcgd2l0aCB0aGUgZm9ybWF0IG9mIGA8bnVtYmVyPjxtcyB8IHMgfCBtcz5gLlxuICAgICAqIE51bWJlcnMgY2FuIGJlIGVpdGhlciBpbnRlZ2VycyBvciBmbG9hdHMuXG4gICAgICogRm9yIGV4YW1wbGU6XG4gICAgICogLSBgMzAwMGAgLSBUaGUgdmlldyB3aWxsIGJlIGRlc3Ryb3llZCBhZnRlciAzIHNlY29uZHMuXG4gICAgICogLSBgJzEwcydgIC0gVGhlIHZpZXcgd2lsbCBiZSBkZXN0cm95ZWQgYWZ0ZXIgMTAgc2Vjb25kcy5cbiAgICAgKiAtIGAnMC41bSdgIC0gVGhlIHZpZXcgd2lsbCBiZSBkZXN0cm95ZWQgYWZ0ZXIgMzAgc2Vjb25kcy5cbiAgICAgKiAtIGAnMTAwbXMnYCAtIFRoZSB2aWV3IHdpbGwgYmUgZGVzdHJveWVkIGFmdGVyIDEwMCBtaWxsaXNlY29uZHMuXG4gICAgICogXG4gICAgICogRHVyaW5nIHRoZSB0aW1lIHRoZSB2aWV3IGlzIHJlbmRlcmVkLCB0aGUgY29udGV4dCB3aWxsIGJlIHVwZGF0ZWQgd2l0aCBhIGNvdW50ZG93biBvYmplY3QgdG8gZmFjaWxpdGF0ZSBhbnkgVUkgcGFydCB1c2VkIHRvXG4gICAgICogaW5kaWNhdGUgY291bnRkb3duIHRvIHRoZSB1c2VyLiBUaGUgY291bnRkb3duIHdpbGwgYmUgZXhwb3NlZCB0aHJvdWdoIHRoZSB7QGxpbmsgT25PYnNlcnZlckNvbnRleHQucmVtYWluaW5nIGByZW1haW5pbmdgfVxuICAgICAqIHByb3BlcnR5IGFuZCB0aGUgZWxhcHNlZCB0aW1lIHRocm91Z2gge0BsaW5rIE9uT2JzZXJ2ZXJDb250ZXh0LmVsYXBzZWQgYGVsYXBzZWRgfSBwcm9wZXJ0eSBpbiB0aGUgdmlldyBjb250ZXh0IGFuZCBjYW4gYm90aFxuICAgICAqIGJlIGFjY2Vzc2VkIGJlIGRlY2xhcmluZyBhIGBsZXRgIHZhcmlhYmxlIChlLmcuIGBsZXQgcmVtYWluaW5nID0gcmVtYWluaW5nYCkuXG4gICAgICogU2VlIHtAbGluayBPbk9ic2VydmVyQmFzZURpcmVjdGl2ZS5jb3VudGRvd25JbnRlcnZhbCBgY291bnRkb3duSW50ZXJ2YWxgfSBmb3IgY2hhbmdpbmcgdGhlIHVwZGF0ZXMgaW50ZXJ2YWwuXG4gICAgICogXG4gICAgICogV2hlbiB1bnNwZWNpZmllZCwgdGhlIHZpZXcgd2lsbCBiZSBkZXN0cm95ZWQgaW1tZWRpYXRlbHkgb25jZSB0aGUgb2JzZXJ2ZXIgZGV0ZWN0cyBhIGNhbGwgZGlmZmVyZW50IHRvIHRoZSBpbnRlcmNlcHRlZCBvbmVzLlxuICAgICAqIFxuICAgICAqIFRPRE86IEFERCBMSU5LIFRPIFRPVVIgT1IgRlVMTCBXSUtJIFBBR0VcbiAgICAgKiBSZWFkIG1vcmUge0BsaW5rIE9uT2JzZXJ2ZXJCYXNlRGlyZWN0aXZlIEFib3V0IHJlbmRlciBmbG93fS5cbiAgICAgKiovXG4gICAgQElucHV0KCkgcHVibGljIHNldCBvbk9ic2VydmVyTmV4dFNob3dGb3IgICAgICAgICAgKGR1cmF0aW9uOiBEdXJhdGlvbkFubm90YXRpb24pIHsgdGhpcy5zaG93Rm9yICAgICAgICAgICA9IGR1cmF0aW9uOyB9O1xuICAgIC8qKlxuICAgICAqICMjIyBPbmx5IHVzZWQgd2hlbiBwYXNzaW5nIGEgdmFsdWUgdG8ge0BsaW5rIE9uT2JzZXJ2ZXJCYXNlRGlyZWN0aXZlLnNob3dGb3IgYHNob3dGb3JgfS5cbiAgICAgKiBcbiAgICAgKiAoT3B0aW9uYWwpIFRoZSBpbnRlcnZhbCB3aXRoIHdoaWNoIGNvdW50ZG93biB1cGRhdGVzIHNob3VsZCBiZSBtYWRlIHRvIHRoZSB2aWV3J3MgY29udGV4dCBiZWZvcmUgaXQgYXV0byBkZXN0cm95cy5cbiAgICAgKiBUaGUgbG93ZXIgdGhlIHZhbHVlLCB0aGUgbW9yZSB1cGRhdGVzIHdpbGwgYmUgbWFkZSB0byB0aGUgY29udGV4dCwgYnV0IHRoZSBtb3JlIHJlc291cmNlcyB5b3VyIGRpcmVjdGl2ZSB3aWxsIGNvbnN1bWUuXG4gICAgICogXG4gICAgICogWW91IGNhbiBzcGVjaWZ5IGEgbnVtYmVyLCB3aGljaCB3aWxsIGJlIHRyZWF0ZWQgYXMgbWlsbGlzZWNvbmRzLCBvciBhIHN0cmluZyB3aXRoIHRoZSBmb3JtYXQgb2YgYDxudW1iZXI+PG1zIHwgcyB8IG1zPmAuXG4gICAgICogTnVtYmVycyBjYW4gYmUgZWl0aGVyIGludGVnZXJzIG9yIGZsb2F0cy5cbiAgICAgKiBGb3IgZXhhbXBsZTpcbiAgICAgKiAtIGAzMDAwYCAtIDMgc2Vjb25kcyBiZXR3ZWVuIGVhY2ggdXBkYXRlLlxuICAgICAqIC0gYCcxMHMnYCAtIDEwIHNlY29uZHMgYmV0d2VlbiBlYWNoIHVwZGF0ZS5cbiAgICAgKiAtIGAnMC41bSdgIC0gMzAgc2Vjb25kcyBiZXR3ZWVuIGVhY2ggdXBkYXRlLlxuICAgICAqIC0gYCcxMDBtcydgIC0gMTAwIG1pbGxpc2Vjb25kcyBiZXR3ZWVuIGVhY2ggdXBkYXRlLlxuICAgICAqIFxuICAgICAqIFlvdSBjYW4gYWxzbyBzcGVjaWZ5IGAnYW5pbWF0aW9uRnJhbWVzJ2Agc28gdGhlIGNvdW50ZG93biBnZXRzIHVwZGF0ZWQgZWFjaCB0aW1lIHRoZSBicm93c2VyIGlzIHdvcmtpbmcgb24gYW5pbWF0aW9ucy5cbiAgICAgKiBcbiAgICAgKiBXaGVuIHVuc3BlY2lmaWVkLCB0aGUgdG90YWwgZHVyYXRpb24gb2YgdGhlIGNvdW50ZG93biB3aWxsIGJlIGRpdmlkZWQgYnkge0BsaW5rIERlZmF1bHRDb3VudGRvd25VcGRhdGVDb3VudCBgRGVmYXVsdENvdW50ZG93blVwZGF0ZUNvdW50YH1cbiAgICAgKiB0byBnZXQgYSBmaXhlZCBpbnRlcnZhbCB3aGljaCB3aWxsIG1ha2UgZm9yIHtAbGluayBEZWZhdWx0Q291bnRkb3duVXBkYXRlQ291bnQgYERlZmF1bHRDb3VudGRvd25VcGRhdGVDb3VudGB9IGNvdW50ZG93biB1cGRhdGVzLlxuICAgICAqL1xuICAgIEBJbnB1dCgpIHB1YmxpYyBzZXQgb25PYnNlcnZlck5leHRDb3VudGRvd25JbnRlcnZhbChkdXJhdGlvbjogRHVyYXRpb25Bbm5vdGF0aW9uIHwgJ2FuaW1hdGlvbkZyYW1lcycpIHsgdGhpcy5jb3VudGRvd25JbnRlcnZhbCA9IGR1cmF0aW9uOyB9O1xuIFxuICAgIHN0YXRpYyBuZ1RlbXBsYXRlQ29udGV4dEd1YXJkPFQ+KGRpcmVjdGl2ZTogT25PYnNlcnZlck5leHREaXJlY3RpdmU8VD4sIGNvbnRleHQ6IHVua25vd24pOiBjb250ZXh0IGlzIE9uT2JzZXJ2ZXJDb250ZXh0PFQ+IHsgcmV0dXJuIHRydWU7IH1cbn0iXX0=