npm - @angular-wave/angular.ts - Versions diffs - 0.0.56 → 0.0.58 - Mend

@angular-wave/angular.ts 0.0.56 → 0.0.58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/dist/angular-ts.esm.js +2 -2
package/dist/angular-ts.umd.js +2 -2
package/package.json +1 -1
package/src/animations/animate-css.html +12 -2
package/src/animations/animate-css.js +0 -1
package/src/animations/raf-scheduler.js +37 -12
package/src/core/animate/animate.js +97 -195
package/src/directive/if/if-animate-css.html +65 -0
package/src/directive/if/if.js +33 -10
package/src/directive/if/if.md +2 -2
package/src/directive/if/if.spec.js +0 -123
package/src/directive/if/if.test.js +102 -0
package/src/directive/include/include.js +26 -11
package/src/directive/include/include.md +3 -2
package/src/directive/model/model.js +41 -10
package/src/shared/jqlite/jqlite.js +1 -1
package/src/shared/utils.js +23 -0
package/types/animations/raf-scheduler.d.ts +31 -2
package/types/core/animate/animate.d.ts +93 -172
package/types/directive/if/if.d.ts +10 -8
package/types/shared/jqlite/jqlite.d.ts +2 -2
package/types/shared/utils.d.ts +6 -0

package/types/core/animate/animate.d.ts CHANGED Viewed

@@ -1,7 +1,3 @@
-export function CoreAnimateJsProvider(): void;
-export class CoreAnimateJsProvider {
-    $get: () => void;
-}
 export function CoreAnimateQueueProvider(): void;
 export class CoreAnimateQueueProvider {
     $get: (string | (($$AnimateRunner: any, $rootScope: any) => {
@@ -12,6 +8,7 @@ export class CoreAnimateQueueProvider {
         push(element: any, event: any, options: any, domOperation: any): any;
     }))[];
 }
+export function domInsert(element: any, parentElement: any, afterElement: any): void;
 export function AnimateProvider($provide: any): void;
 export class AnimateProvider {
     constructor($provide: any);
@@ -117,10 +114,7 @@ export class AnimateProvider {
     $get: (string | (($$animateQueue: any) => {
         /**
          *
-         * @ngdoc method
-         * @name $animate#on
-         * @kind function
-         * @description Sets up an event listener to fire whenever the animation event (enter, leave, move, etc...)
+         * Sets up an event listener to fire whenever the animation event (enter, leave, move, etc...)
          *    has fired on the given element or among any of its children. Once the listener is fired, the provided callback
          *    is fired with the following params:
          *
@@ -168,11 +162,7 @@ export class AnimateProvider {
          */
         on: any;
         /**
-         *
-         * @ngdoc method
-         * @name $animate#off
-         * @kind function
-         * @description Deregisters an event listener based on the event which has been associated with the provided element. This method
+         * Deregisters an event listener based on the event which has been associated with the provided element. This method
          * can be used in three different ways depending on the arguments:
          *
          * ```js
@@ -198,17 +188,14 @@ export class AnimateProvider {
          */
         off: any;
         /**
-         * @ngdoc method
-         * @name $animate#pin
-         * @kind function
-         * @description Associates the provided element with a host parent element to allow the element to be animated even if it exists
-         *    outside of the DOM structure of the AngularJS application. By doing so, any animation triggered via `$animate` can be issued on the
-         *    element despite being outside the realm of the application or within another application. Say for example if the application
-         *    was bootstrapped on an element that is somewhere inside of the `<body>` tag, but we wanted to allow for an element to be situated
-         *    as a direct child of `document.body`, then this can be achieved by pinning the element via `$animate.pin(element)`. Keep in mind
-         *    that calling `$animate.pin(element, parentElement)` will not actually insert into the DOM anywhere; it will just create the association.
+         *  Associates the provided element with a host parent element to allow the element to be animated even if it exists
+         *  outside of the DOM structure of the AngularJS application. By doing so, any animation triggered via `$animate` can be issued on the
+         *  element despite being outside the realm of the application or within another application. Say for example if the application
+         *  was bootstrapped on an element that is somewhere inside of the `<body>` tag, but we wanted to allow for an element to be situated
+         *  as a direct child of `document.body`, then this can be achieved by pinning the element via `$animate.pin(element)`. Keep in mind
+         *  that calling `$animate.pin(element, parentElement)` will not actually insert into the DOM anywhere; it will just create the association.
          *
-         *    Note that this feature is only active when the `ngAnimate` module is used.
+         *  Note that this feature is only active when the `ngAnimate` module is used.
          *
          * @param {Element} element the external element that will be pinned
          * @param {Element} parentElement the host parent element that will be associated with the external element
@@ -245,14 +232,11 @@ export class AnimateProvider {
          */
         enabled: any;
         /**
-       * @ngdoc method
-       * @name $animate#cancel
-       * @kind function
-       * @description Cancels the provided animation and applies the end state of the animation.
+       * Cancels the provided animation and applies the end state of the animation.
        * Note that this does not cancel the underlying operation, e.g. the setting of classes or
        * adding the element to the DOM.
        *
-       * @param {animationRunner} animationRunner An animation runner returned by an $animate function.
+       * @param {import('./animate-runner').AnimateRunner} runner An animation runner returned by an $animate function.
        *
        * @example
         <example module="animationExample" deps="angular-animate.js" animations="true" name="animate-cancel">
@@ -316,157 +300,89 @@ export class AnimateProvider {
           </file>
         </example>
        */
-        cancel(runner: any): void;
+        cancel(runner: import("./animate-runner").AnimateRunner): void;
         /**
-         *
-         * @ngdoc method
-         * @name $animate#enter
-         * @kind function
-         * @description Inserts the element into the DOM either after the `after` element (if provided) or
-         *   as the first child within the `parent` element and then triggers an animation.
-         *   A promise is returned that will be resolved during the next digest once the animation
-         *   has completed.
-         *
-         * @param {Element} element the element which will be inserted into the DOM
-         * @param {Element} parent the parent element which will append the element as
-         *   a child (so long as the after element is not present)
-         * @param {Element=} after the sibling element after which the element will be appended
-         * @param {object=} options an optional collection of options/styles that will be applied to the element.
-         *   The object can have the following properties:
-         *
-         *   - **addClass** - `{string}` - space-separated CSS classes to add to element
-         *   - **from** - `{Object}` - CSS properties & values at the beginning of animation. Must have matching `to`
-         *   - **removeClass** - `{string}` - space-separated CSS classes to remove from element
-         *   - **to** - `{Object}` - CSS properties & values at end of animation. Must have matching `from`
-         *
-         * @return {Runner} the animation runner
+         * Inserts the element into the DOM either after the `after` element (if provided) or
+         * as the first child within the `parent` element and then triggers an animation.
+         * A promise is returned that will be resolved during the next digest once the animation
+         * has completed.
+         *
+         * @param {JQLite} element - the element which will be inserted into the DOM
+         * @param {JQLite} parent - the parent element which will append the element as a child (so long as the after element is not present)
+         * @param {JQLite} after - after the sibling element after which the element will be appended
+         * @param {AnimationOptions} [options] - an optional collection of options/styles that will be applied to the element.
+         * @returns {import('./animate-runner').AnimateRunner} the animation runner
          */
-        enter(element: Element, parent: Element, after?: Element | undefined, options?: object | undefined): Runner;
+        enter(element: JQLite, parent: JQLite, after: JQLite, options?: AnimationOptions): import("./animate-runner").AnimateRunner;
         /**
-         *
-         * @ngdoc method
-         * @name $animate#move
-         * @kind function
-         * @description Inserts (moves) the element into its new position in the DOM either after
-         *   the `after` element (if provided) or as the first child within the `parent` element
-         *   and then triggers an animation. A promise is returned that will be resolved
-         *   during the next digest once the animation has completed.
-         *
-         * @param {Element} element the element which will be moved into the new DOM position
-         * @param {Element} parent the parent element which will append the element as
-         *   a child (so long as the after element is not present)
-         * @param {Element=} after the sibling element after which the element will be appended
-         * @param {object=} options an optional collection of options/styles that will be applied to the element.
-         *   The object can have the following properties:
-         *
-         *   - **addClass** - `{string}` - space-separated CSS classes to add to element
-         *   - **from** - `{Object}` - CSS properties & values at the beginning of animation. Must have matching `to`
-         *   - **removeClass** - `{string}` - space-separated CSS classes to remove from element
-         *   - **to** - `{Object}` - CSS properties & values at end of animation. Must have matching `from`
-         *
-         * @return {Runner} the animation runner
+         * Inserts (moves) the element into its new position in the DOM either after
+         * the `after` element (if provided) or as the first child within the `parent` element
+         * and then triggers an animation. A promise is returned that will be resolved
+         * during the next digest once the animation has completed.
+         *
+         * @param {JQLite} element - the element which will be inserted into the DOM
+         * @param {JQLite} parent - the parent element which will append the element as a child (so long as the after element is not present)
+         * @param {JQLite} after - after the sibling element after which the element will be appended
+         * @param {AnimationOptions} [options] - an optional collection of options/styles that will be applied to the element.
+         * @returns {import('./animate-runner').AnimateRunner} the animation runner
          */
-        move(element: Element, parent: Element, after?: Element | undefined, options?: object | undefined): Runner;
+        move(element: JQLite, parent: JQLite, after: JQLite, options?: AnimationOptions): import("./animate-runner").AnimateRunner;
         /**
-         * @ngdoc method
-         * @name $animate#leave
-         * @kind function
-         * @description Triggers an animation and then removes the element from the DOM.
+         * Triggers an animation and then removes the element from the DOM.
          * When the function is called a promise is returned that will be resolved during the next
          * digest once the animation has completed.
          *
-         * @param {Element} element the element which will be removed from the DOM
-         * @param {object=} options an optional collection of options/styles that will be applied to the element.
-         *   The object can have the following properties:
-         *
-         *   - **addClass** - `{string}` - space-separated CSS classes to add to element
-         *   - **from** - `{Object}` - CSS properties & values at the beginning of animation. Must have matching `to`
-         *   - **removeClass** - `{string}` - space-separated CSS classes to remove from element
-         *   - **to** - `{Object}` - CSS properties & values at end of animation. Must have matching `from`
-         *
-         * @return {Runner} the animation runner
+         * @param {JQLite} element the element which will be removed from the DOM
+         * @param {AnimationOptions} [options] an optional collection of options/styles that will be applied to the element.
+         * @returns {import('./animate-runner').AnimateRunner} the animation runner
          */
-        leave(element: Element, options?: object | undefined): Runner;
+        leave(element: JQLite, options?: AnimationOptions): import("./animate-runner").AnimateRunner;
         /**
-         * @ngdoc method
-         * @name $animate#addClass
-         * @kind function
-         *
-         * @description Triggers an addClass animation surrounding the addition of the provided CSS class(es). Upon
-         *   execution, the addClass operation will only be handled after the next digest and it will not trigger an
-         *   animation if element already contains the CSS class or if the class is removed at a later step.
-         *   Note that class-based animations are treated differently compared to structural animations
-         *   (like enter, move and leave) since the CSS classes may be added/removed at different points
-         *   depending if CSS or JavaScript animations are used.
-         *
-         * @param {Element} element the element which the CSS classes will be applied to
+         * Triggers an addClass animation surrounding the addition of the provided CSS class(es). Upon
+         * execution, the addClass operation will only be handled after the next digest and it will not trigger an
+         * animation if element already contains the CSS class or if the class is removed at a later step.
+         * Note that class-based animations are treated differently compared to structural animations
+         * (like enter, move and leave) since the CSS classes may be added/removed at different points
+         * depending if CSS or JavaScript animations are used.
+         *
+         * @param {JQLite} element the element which the CSS classes will be applied to
          * @param {string} className the CSS class(es) that will be added (multiple classes are separated via spaces)
-         * @param {object=} options an optional collection of options/styles that will be applied to the element.
-         *   The object can have the following properties:
-         *
-         *   - **removeClass** - `{string}` - space-separated CSS classes to remove from element
-         *   - **from** - `{Object}` - CSS properties & values at the beginning of animation. Must have matching `to`
-         *   - **to** - `{Object}` - CSS properties & values at end of animation. Must have matching `from`
-         *
-         * @return {Runner} animationRunner the animation runner
+         * @param {AnimationOptions} [options] an optional collection of options/styles that will be applied to the element.
+         * @return {import('./animate-runner').AnimateRunner}} animationRunner the animation runner
          */
-        addClass(element: Element, className: string, options?: object | undefined): Runner;
+        addClass(element: JQLite, className: string, options?: AnimationOptions): import("./animate-runner").AnimateRunner;
         /**
-         * @ngdoc method
-         * @name $animate#removeClass
-         * @kind function
-         *
-         * @description Triggers a removeClass animation surrounding the removal of the provided CSS class(es). Upon
-         *   execution, the removeClass operation will only be handled after the next digest and it will not trigger an
-         *   animation if element does not contain the CSS class or if the class is added at a later step.
-         *   Note that class-based animations are treated differently compared to structural animations
-         *   (like enter, move and leave) since the CSS classes may be added/removed at different points
-         *   depending if CSS or JavaScript animations are used.
-         *
-         * @param {Element} element the element which the CSS classes will be applied to
+         * Triggers a removeClass animation surrounding the removal of the provided CSS class(es). Upon
+         * execution, the removeClass operation will only be handled after the next digest and it will not trigger an
+         * animation if element does not contain the CSS class or if the class is added at a later step.
+         * Note that class-based animations are treated differently compared to structural animations
+         * (like enter, move and leave) since the CSS classes may be added/removed at different points
+         * depending if CSS or JavaScript animations are used.
+         *
+         * @param {JQLite} element the element which the CSS classes will be applied to
          * @param {string} className the CSS class(es) that will be removed (multiple classes are separated via spaces)
-         * @param {object=} options an optional collection of options/styles that will be applied to the element.
-         *   The object can have the following properties:
-         *
-         *   - **addClass** - `{string}` - space-separated CSS classes to add to element
-         *   - **from** - `{Object}` - CSS properties & values at the beginning of animation. Must have matching `to`
-         *   - **to** - `{Object}` - CSS properties & values at end of animation. Must have matching `from`
-         *
-         * @return {Runner} the animation runner
+         * @param {AnimationOptions} [options] an optional collection of options/styles that will be applied to the element.         *
+         * @return {import('./animate-runner').AnimateRunner} animationRunner the animation runner
          */
-        removeClass(element: Element, className: string, options?: object | undefined): Runner;
+        removeClass(element: JQLite, className: string, options?: AnimationOptions): import("./animate-runner").AnimateRunner;
         /**
-         * @ngdoc method
-         * @name $animate#setClass
-         * @kind function
-         *
-         * @description Performs both the addition and removal of a CSS classes on an element and (during the process)
-         *    triggers an animation surrounding the class addition/removal. Much like `$animate.addClass` and
-         *    `$animate.removeClass`, `setClass` will only evaluate the classes being added/removed once a digest has
-         *    passed. Note that class-based animations are treated differently compared to structural animations
-         *    (like enter, move and leave) since the CSS classes may be added/removed at different points
-         *    depending if CSS or JavaScript animations are used.
+         * Performs both the addition and removal of a CSS classes on an element and (during the process)
+         * triggers an animation surrounding the class addition/removal. Much like `$animate.addClass` and
+         * `$animate.removeClass`, `setClass` will only evaluate the classes being added/removed once a digest has
+         * passed. Note that class-based animations are treated differently compared to structural animations
+         * (like enter, move and leave) since the CSS classes may be added/removed at different points
+         * depending if CSS or JavaScript animations are used.
          *
          * @param {Element} element the element which the CSS classes will be applied to
          * @param {string} add the CSS class(es) that will be added (multiple classes are separated via spaces)
          * @param {string} remove the CSS class(es) that will be removed (multiple classes are separated via spaces)
          * @param {object=} options an optional collection of options/styles that will be applied to the element.
-         *   The object can have the following properties:
-         *
-         *   - **addClass** - `{string}` - space-separated CSS classes to add to element
-         *   - **removeClass** - `{string}` - space-separated CSS classes to remove from element
-         *   - **from** - `{Object}` - CSS properties & values at the beginning of animation. Must have matching `to`
-         *   - **to** - `{Object}` - CSS properties & values at end of animation. Must have matching `from`
          *
-         * @return {Runner} the animation runner
+         * @return {import('./animate-runner').AnimateRunner} the animation runner
          */
-        setClass(element: Element, add: string, remove: string, options?: object | undefined): Runner;
+        setClass(element: Element, add: string, remove: string, options?: object | undefined): import("./animate-runner").AnimateRunner;
         /**
-         * @ngdoc method
-         * @name $animate#animate
-         * @kind function
-         *
-         * @description Performs an inline animation on the element which applies the provided to and from CSS styles to the element.
+         * Performs an inline animation on the element which applies the provided to and from CSS styles to the element.
          * If any detected CSS transition, keyframe or JavaScript matches the provided className value, then the animation will take
          * on the provided styles. For example, if a transition animation is set for the given className, then the provided `from` and
          * `to` styles will be applied alongside the given transition. If the CSS style provided in `from` does not have a corresponding
@@ -484,26 +400,31 @@ export class AnimateProvider {
          *   }
          * });
          * ```
-         *
-         * @param {Element} element the element which the CSS styles will be applied to
-         * @param {object} from the from (starting) CSS styles that will be applied to the element and across the animation.
-         * @param {object} to the to (destination) CSS styles that will be applied to the element and across the animation.
-         * @param {string=} className an optional CSS class that will be applied to the element for the duration of the animation. If
-         *    this value is left as empty then a CSS class of `ng-inline-animate` will be applied to the element.
-         *    (Note that if no animation is detected then this value will not be applied to the element.)
-         * @param {object=} options an optional collection of options/styles that will be applied to the element.
-         *   The object can have the following properties:
-         *
-         *   - **addClass** - `{string}` - space-separated CSS classes to add to element
-         *   - **from** - `{Object}` - CSS properties & values at the beginning of animation. Must have matching `to`
-         *   - **removeClass** - `{string}` - space-separated CSS classes to remove from element
-         *   - **to** - `{Object}` - CSS properties & values at end of animation. Must have matching `from`
-         *
-         * @return {Runner} the animation runner
+         *  @return {import('./animate-runner').AnimateRunner} the animation runner
          */
-        animate(element: Element, from: object, to: object, className?: string | undefined, options?: object | undefined): Runner;
+        animate(element: any, from: any, to: any, className: any, options: any): import("./animate-runner").AnimateRunner;
     }))[];
 }
 export namespace AnimateProvider {
     let $inject: string[];
 }
+export type AnimationMethod = "enter" | "leave" | "move" | "addClass" | "setClass" | "removeClass";
+export type AnimationOptions = {
+    /**
+     * - space-separated CSS classes to add to element
+     */
+    addClass: string;
+    /**
+     * - CSS properties & values at the beginning of animation. Must have matching `to`
+     */
+    from: any;
+    /**
+     * - space-separated CSS classes to remove from element
+     */
+    removeClass: string;
+    /**
+     * - CSS properties & values at end of animation. Must have matching `from`
+     */
+    to: string;
+};
+import { JQLite } from "../../shared/jqlite/jqlite";

package/types/directive/if/if.d.ts CHANGED Viewed

@@ -1,8 +1,10 @@
-export const ngIfDirective: (string | (($animate: any) => {
-    multiElement: boolean;
-    transclude: string;
-    priority: number;
-    terminal: boolean;
-    restrict: string;
-    link($scope: any, $element: any, $attr: any, ctrl: any, $transclude: any): void;
-}))[];
+/**
+ *
+ * TODO // Add type for animate service
+ * @param {*}  $animate
+ * @returns {import("../../types").Directive}
+ */
+export function ngIfDirective($animate: any): import("../../types").Directive;
+export namespace ngIfDirective {
+    let $inject: string[];
+}

package/types/shared/jqlite/jqlite.d.ts CHANGED Viewed

@@ -193,10 +193,10 @@ export function removeElement(element: Element, keepData?: boolean): void;
 export function startingTag(elementStr: string): string;
 /**
  * Return the DOM siblings between the first and last node in the given array.
- * @param {Array} nodes An array-like object
+ * @param {JQLite|Array} nodes An array-like object
  * @returns {JQLite} the inputted object or a JQLite collection containing the nodes
  */
-export function getBlockNodes(nodes: any[]): JQLite;
+export function getBlockNodes(nodes: JQLite | any[]): JQLite;
 export function getBooleanAttrName(element: any, name: any): any;
 /**
  * Takes an array of elements, calls any `$destroy` event handlers, removes any data in cache, and finally removes any

package/types/shared/utils.d.ts CHANGED Viewed

@@ -542,5 +542,11 @@ export function mergeClasses(a: any, b: any): any;
  * @param name Name to normalize
  */
 export function directiveNormalize(name: any): any;
+/**
+ * Whether element should be animated
+ * @param {Node} node
+ * @returns {boolean}
+ */
+export function hasAnimate(node: Node): boolean;
 export const ngAttrPrefixes: string[];
 export const minErrConfig: {};