@angular-wave/angular.ts 0.0.38 → 0.0.39

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 (151) hide show
  1. package/Makefile +6 -5
  2. package/dist/angular-ts.esm.js +2 -1
  3. package/dist/angular-ts.umd.js +1 -1
  4. package/package.json +2 -4
  5. package/rollup.config.js +5 -1
  6. package/src/core/scope/scope.js +4 -7
  7. package/src/index.js +307 -1
  8. package/src/loader.js +13 -6
  9. package/src/public.js +7 -2
  10. package/src/src.test.js +10 -0
  11. package/tsconfig.json +1 -1
  12. package/tsconfig.types.json +11 -0
  13. package/types/animations/animate-cache.d.ts +7 -7
  14. package/types/animations/animate-children-directive.d.ts +3 -6
  15. package/types/animations/animate-swap.d.ts +7 -16
  16. package/types/animations/animation.d.ts +2 -11
  17. package/types/animations/raf-scheduler.d.ts +3 -3
  18. package/types/animations/shared.d.ts +8 -23
  19. package/types/core/{animate-css.d.ts → animate/animate-css.d.ts} +2 -8
  20. package/types/core/{cache.d.ts → cache/cache.d.ts} +5 -5
  21. package/types/core/compile/compile.d.ts +173 -0
  22. package/types/core/controller/controller.d.ts +32 -0
  23. package/types/core/exception-handler.d.ts +1 -1
  24. package/types/core/filter/filter.d.ts +9 -0
  25. package/types/core/{interpolate.d.ts → interpolate/interpolate.d.ts} +23 -39
  26. package/types/core/interval/interval-factory.d.ts +4 -0
  27. package/types/core/{interval.d.ts → interval/interval.d.ts} +1 -1
  28. package/types/core/location/location.d.ts +209 -0
  29. package/types/core/pubsub/pubsub.d.ts +156 -0
  30. package/types/core/q/q.d.ts +31 -0
  31. package/types/core/sanitize/sanitize-uri.d.ts +53 -0
  32. package/types/core/{sce.d.ts → sce/sce.d.ts} +80 -86
  33. package/types/core/scope/scope.d.ts +727 -0
  34. package/types/core/task-tracker-factory.d.ts +29 -29
  35. package/types/core/timeout/timeout.d.ts +20 -0
  36. package/types/core/{urlUtils.d.ts → url-utils/url-utils.d.ts} +2 -7
  37. package/types/directive/{bind.d.ts → bind/bind.d.ts} +4 -10
  38. package/types/directive/{class.d.ts → class/class.d.ts} +12 -21
  39. package/types/directive/controller/controller.d.ts +6 -0
  40. package/types/directive/events/events.d.ts +5 -0
  41. package/types/directive/form/form.d.ts +200 -0
  42. package/types/directive/if/if.d.ts +8 -0
  43. package/types/directive/include/include.d.ts +14 -0
  44. package/types/directive/{input.d.ts → input/input.d.ts} +20 -69
  45. package/types/directive/{model.d.ts → model/model.d.ts} +256 -279
  46. package/types/directive/options/options.d.ts +9 -0
  47. package/types/directive/ref/ref.d.ts +5 -0
  48. package/types/directive/repeat/repeat.d.ts +8 -0
  49. package/types/directive/{script.d.ts → script/script.d.ts} +5 -8
  50. package/types/directive/{show-hide.d.ts → show-hide/show-hide.d.ts} +10 -16
  51. package/types/directive/switch/switch.d.ts +17 -0
  52. package/types/directive/transclude/transclude.d.ts +4 -0
  53. package/types/directive/{validators.d.ts → validators/validators.d.ts} +20 -35
  54. package/types/filters/filters.d.ts +10 -16
  55. package/types/filters/order-by.d.ts +2 -4
  56. package/types/index.d.ts +117 -0
  57. package/types/injector.d.ts +12 -0
  58. package/types/public.d.ts +5 -0
  59. package/types/router/common/coreservices.d.ts +2 -2
  60. package/types/router/common/glob.d.ts +9 -9
  61. package/types/router/common/queue.d.ts +13 -13
  62. package/types/router/common/trace.d.ts +43 -43
  63. package/types/router/directives/view-directive.d.ts +13 -32
  64. package/types/router/globals.d.ts +20 -20
  65. package/types/router/hooks/lazy-load.d.ts +2 -11
  66. package/types/router/hooks/redirect-to.d.ts +1 -4
  67. package/types/router/hooks/url.d.ts +1 -5
  68. package/types/router/hooks/views.d.ts +1 -4
  69. package/types/router/params/param-factory.d.ts +5 -5
  70. package/types/router/params/param-type.d.ts +35 -35
  71. package/types/router/params/param-types.d.ts +11 -11
  72. package/types/router/params/param.d.ts +38 -38
  73. package/types/router/params/state-params.d.ts +10 -10
  74. package/types/router/path/path-node.d.ts +34 -34
  75. package/types/router/path/path-utils.d.ts +73 -77
  76. package/types/router/resolve/resolvable.d.ts +32 -32
  77. package/types/router/resolve/resolve-context.d.ts +84 -84
  78. package/types/router/services.d.ts +4 -9
  79. package/types/router/state/state-builder.d.ts +27 -27
  80. package/types/router/state/state-matcher.d.ts +5 -5
  81. package/types/router/state/state-object.d.ts +58 -58
  82. package/types/router/state/state-queue-manager.d.ts +10 -16
  83. package/types/router/state/state-registry.d.ts +100 -107
  84. package/types/router/state/state-service.d.ts +411 -411
  85. package/types/router/state/target-state.d.ts +64 -69
  86. package/types/router/state/views.d.ts +31 -37
  87. package/types/router/state-filters.d.ts +7 -7
  88. package/types/router/state-provider.d.ts +105 -105
  89. package/types/router/template-factory.d.ts +83 -112
  90. package/types/router/transition/hook-builder.d.ts +25 -25
  91. package/types/router/transition/hook-registry.d.ts +68 -83
  92. package/types/router/transition/interface.d.ts +7 -7
  93. package/types/router/transition/reject-factory.d.ts +34 -34
  94. package/types/router/transition/transition-event-type.d.ts +9 -18
  95. package/types/router/transition/transition-hook.d.ts +77 -82
  96. package/types/router/transition/transition-service.d.ts +82 -99
  97. package/types/router/transition/transition.d.ts +369 -377
  98. package/types/router/url/url-config.d.ts +84 -84
  99. package/types/router/url/url-matcher.d.ts +115 -119
  100. package/types/router/url/url-rule.d.ts +114 -124
  101. package/types/router/url/url-rules.d.ts +217 -217
  102. package/types/router/url/url-service.d.ts +264 -269
  103. package/types/router/view/view.d.ts +114 -117
  104. package/types/router/view-scroll.d.ts +2 -2
  105. package/types/services/anchor-scroll.d.ts +2 -8
  106. package/types/services/browser.d.ts +122 -130
  107. package/types/services/cache-factory.d.ts +25 -25
  108. package/types/services/cookie-reader.d.ts +2 -2
  109. package/types/services/document.d.ts +2 -2
  110. package/types/services/http/http.d.ts +145 -0
  111. package/types/services/{http-backend.d.ts → http-backend/http-backend.d.ts} +3 -35
  112. package/types/services/log.d.ts +49 -49
  113. package/types/services/template-request.d.ts +44 -53
  114. package/types/shared/common.d.ts +4 -19
  115. package/types/{constants.d.ts → shared/constants.d.ts} +6 -6
  116. package/types/shared/hof.d.ts +1 -1
  117. package/types/{jqLite.d.ts → shared/jqlite/jqlite.d.ts} +11 -11
  118. package/types/shared/test-utils.d.ts +11 -0
  119. package/types/shared/utils.d.ts +7 -24
  120. package/types-back/global.d.ts +3 -1
  121. package/types-back/index.d.ts +2 -221
  122. package/types/core/compile.d.ts +0 -206
  123. package/types/core/controller.d.ts +0 -42
  124. package/types/core/filter.d.ts +0 -9
  125. package/types/core/interval-factory.d.ts +0 -21
  126. package/types/core/location.d.ts +0 -234
  127. package/types/core/pubsub.d.ts +0 -164
  128. package/types/core/q.d.ts +0 -33
  129. package/types/core/root-scope.d.ts +0 -754
  130. package/types/core/sanitize-uri.d.ts +0 -57
  131. package/types/core/timeout.d.ts +0 -31
  132. package/types/directive/controller.d.ts +0 -6
  133. package/types/directive/events.d.ts +0 -12
  134. package/types/directive/form.d.ts +0 -230
  135. package/types/directive/if.d.ts +0 -17
  136. package/types/directive/include.d.ts +0 -33
  137. package/types/directive/options.d.ts +0 -16
  138. package/types/directive/ref.d.ts +0 -11
  139. package/types/directive/repeat.d.ts +0 -23
  140. package/types/directive/switch.d.ts +0 -23
  141. package/types/directive/transclude.d.ts +0 -15
  142. package/types/services/http.d.ts +0 -157
  143. /package/types/directive/{attrs.d.ts → attrs/attrs.d.ts} +0 -0
  144. /package/types/directive/{change.d.ts → change/change.d.ts} +0 -0
  145. /package/types/directive/{cloak.d.ts → cloak/cloak.d.ts} +0 -0
  146. /package/types/directive/{init.d.ts → init/init.d.ts} +0 -0
  147. /package/types/directive/{list.d.ts → list/list.d.ts} +0 -0
  148. /package/types/directive/{non-bindable.d.ts → non-bindable/non-bindable.d.ts} +0 -0
  149. /package/types/directive/{style.d.ts → style/style.d.ts} +0 -0
  150. /package/types/exts/{aria.d.ts → aria/aria.d.ts} +0 -0
  151. /package/types/exts/{messages.d.ts → messages/messages.d.ts} +0 -0
@@ -15,123 +15,120 @@
15
15
  *
16
16
  */
17
17
  export class ViewService {
18
- _ngViews: any[];
19
- _viewConfigs: any[];
20
- _viewConfigFactories: {};
21
- _listeners: any[];
22
- _pluginapi: {
23
- _rootViewContext: any;
24
- _viewConfigFactory: any;
25
- _registeredUIView: (id: any) => undefined;
26
- _registeredUIViews: () => any[];
27
- _activeViewConfigs: () => any[];
28
- _onSync: (listener: any) => () => any;
29
- };
30
- $get: (() => this)[];
31
- _rootViewContext(context: any): any;
32
- _rootContext: any;
33
- _viewConfigFactory(viewType: any, factory: any): void;
34
- createViewConfig(path: any, decl: any): any[];
35
- /**
36
- * Deactivates a ViewConfig.
37
- *
38
- * This function deactivates a `ViewConfig`.
39
- * After calling [[sync]], it will un-pair from any `ui-view` with which it is currently paired.
40
- *
41
- * @param viewConfig The ViewConfig view to deregister.
42
- */
43
- deactivateViewConfig(viewConfig: any): void;
44
- activateViewConfig(viewConfig: any): void;
45
- sync(): void;
46
- /**
47
- * Registers a `ui-view` component
48
- *
49
- * When a `ui-view` component is created, it uses this method to register itself.
50
- * After registration the [[sync]] method is used to ensure all `ui-view` are configured with the proper [[ViewConfig]].
51
- *
52
- * Note: the `ui-view` component uses the `ViewConfig` to determine what view should be loaded inside the `ui-view`,
53
- * and what the view's state context is.
54
- *
55
- * Note: There is no corresponding `deregisterUIView`.
56
- * A `ui-view` should hang on to the return value of `registerUIView` and invoke it to deregister itself.
57
- *
58
- * @param ngView The metadata for a UIView
59
- * @return a de-registration function used when the view is destroyed.
60
- */
61
- registerUIView(ngView: any): () => void;
62
- /**
63
- * Returns the list of views currently available on the page, by fully-qualified name.
64
- *
65
- * @return {Array} Returns an array of fully-qualified view names.
66
- */
67
- available(): any[];
68
- /**
69
- * Returns the list of views on the page containing loaded content.
70
- *
71
- * @return {Array} Returns an array of fully-qualified view names.
72
- */
73
- active(): any[];
18
+ _ngViews: any[];
19
+ _viewConfigs: any[];
20
+ _viewConfigFactories: {};
21
+ _listeners: any[];
22
+ _pluginapi: {
23
+ _rootViewContext: any;
24
+ _viewConfigFactory: any;
25
+ _registeredUIView: (id: any) => undefined;
26
+ _registeredUIViews: () => any[];
27
+ _activeViewConfigs: () => any[];
28
+ _onSync: (listener: any) => () => any;
29
+ };
30
+ $get: (() => this)[];
31
+ _rootViewContext(context: any): any;
32
+ _rootContext: any;
33
+ _viewConfigFactory(viewType: any, factory: any): void;
34
+ createViewConfig(path: any, decl: any): any[];
35
+ /**
36
+ * Deactivates a ViewConfig.
37
+ *
38
+ * This function deactivates a `ViewConfig`.
39
+ * After calling [[sync]], it will un-pair from any `ui-view` with which it is currently paired.
40
+ *
41
+ * @param viewConfig The ViewConfig view to deregister.
42
+ */
43
+ deactivateViewConfig(viewConfig: any): void;
44
+ activateViewConfig(viewConfig: any): void;
45
+ sync(): void;
46
+ /**
47
+ * Registers a `ui-view` component
48
+ *
49
+ * When a `ui-view` component is created, it uses this method to register itself.
50
+ * After registration the [[sync]] method is used to ensure all `ui-view` are configured with the proper [[ViewConfig]].
51
+ *
52
+ * Note: the `ui-view` component uses the `ViewConfig` to determine what view should be loaded inside the `ui-view`,
53
+ * and what the view's state context is.
54
+ *
55
+ * Note: There is no corresponding `deregisterUIView`.
56
+ * A `ui-view` should hang on to the return value of `registerUIView` and invoke it to deregister itself.
57
+ *
58
+ * @param ngView The metadata for a UIView
59
+ * @return a de-registration function used when the view is destroyed.
60
+ */
61
+ registerUIView(ngView: any): () => void;
62
+ /**
63
+ * Returns the list of views currently available on the page, by fully-qualified name.
64
+ *
65
+ * @return {Array} Returns an array of fully-qualified view names.
66
+ */
67
+ available(): any[];
68
+ /**
69
+ * Returns the list of views on the page containing loaded content.
70
+ *
71
+ * @return {Array} Returns an array of fully-qualified view names.
72
+ */
73
+ active(): any[];
74
74
  }
75
75
  export namespace ViewService {
76
- /**
77
- * Given a ui-view and a ViewConfig, determines if they "match".
78
- *
79
- * A ui-view has a fully qualified name (fqn) and a context object. The fqn is built from its overall location in
80
- * the DOM, describing its nesting relationship to any parent ui-view tags it is nested inside of.
81
- *
82
- * A ViewConfig has a target ui-view name and a context anchor. The ui-view name can be a simple name, or
83
- * can be a segmented ui-view path, describing a portion of a ui-view fqn.
84
- *
85
- * In order for a ui-view to match ViewConfig, ui-view's $type must match the ViewConfig's $type
86
- *
87
- * If the ViewConfig's target ui-view name is a simple name (no dots), then a ui-view matches if:
88
- * - the ui-view's name matches the ViewConfig's target name
89
- * - the ui-view's context matches the ViewConfig's anchor
90
- *
91
- * If the ViewConfig's target ui-view name is a segmented name (with dots), then a ui-view matches if:
92
- * - There exists a parent ui-view where:
93
- * - the parent ui-view's name matches the first segment (index 0) of the ViewConfig's target name
94
- * - the parent ui-view's context matches the ViewConfig's anchor
95
- * - And the remaining segments (index 1..n) of the ViewConfig's target name match the tail of the ui-view's fqn
96
- *
97
- * Example:
98
- *
99
- * DOM:
100
- * <ui-view> <!-- created in the root context (name: "") -->
101
- * <ui-view name="foo"> <!-- created in the context named: "A" -->
102
- * <ui-view> <!-- created in the context named: "A.B" -->
103
- * <ui-view name="bar"> <!-- created in the context named: "A.B.C" -->
104
- * </ui-view>
105
- * </ui-view>
106
- * </ui-view>
107
- * </ui-view>
108
- *
109
- * ngViews: [
110
- * { fqn: "$default", creationContext: { name: "" } },
111
- * { fqn: "$default.foo", creationContext: { name: "A" } },
112
- * { fqn: "$default.foo.$default", creationContext: { name: "A.B" } }
113
- * { fqn: "$default.foo.$default.bar", creationContext: { name: "A.B.C" } }
114
- * ]
115
- *
116
- * These four view configs all match the ui-view with the fqn: "$default.foo.$default.bar":
117
- *
118
- * - ViewConfig1: { ngViewName: "bar", ngViewContextAnchor: "A.B.C" }
119
- * - ViewConfig2: { ngViewName: "$default.bar", ngViewContextAnchor: "A.B" }
120
- * - ViewConfig3: { ngViewName: "foo.$default.bar", ngViewContextAnchor: "A" }
121
- * - ViewConfig4: { ngViewName: "$default.foo.$default.bar", ngViewContextAnchor: "" }
122
- *
123
- * Using ViewConfig3 as an example, it matches the ui-view with fqn "$default.foo.$default.bar" because:
124
- * - The ViewConfig's segmented target name is: [ "foo", "$default", "bar" ]
125
- * - There exists a parent ui-view (which has fqn: "$default.foo") where:
126
- * - the parent ui-view's name "foo" matches the first segment "foo" of the ViewConfig's target name
127
- * - the parent ui-view's context "A" matches the ViewConfig's anchor context "A"
128
- * - And the remaining segments [ "$default", "bar" ].join("."_ of the ViewConfig's target name match
129
- * the tail of the ui-view's fqn "default.bar"
130
- *
131
- * @internal
132
- */
133
- function matches(
134
- ngViewsByFqn: any,
135
- ngView: any,
136
- ): (viewConfig: any) => boolean;
76
+ /**
77
+ * Given a ui-view and a ViewConfig, determines if they "match".
78
+ *
79
+ * A ui-view has a fully qualified name (fqn) and a context object. The fqn is built from its overall location in
80
+ * the DOM, describing its nesting relationship to any parent ui-view tags it is nested inside of.
81
+ *
82
+ * A ViewConfig has a target ui-view name and a context anchor. The ui-view name can be a simple name, or
83
+ * can be a segmented ui-view path, describing a portion of a ui-view fqn.
84
+ *
85
+ * In order for a ui-view to match ViewConfig, ui-view's $type must match the ViewConfig's $type
86
+ *
87
+ * If the ViewConfig's target ui-view name is a simple name (no dots), then a ui-view matches if:
88
+ * - the ui-view's name matches the ViewConfig's target name
89
+ * - the ui-view's context matches the ViewConfig's anchor
90
+ *
91
+ * If the ViewConfig's target ui-view name is a segmented name (with dots), then a ui-view matches if:
92
+ * - There exists a parent ui-view where:
93
+ * - the parent ui-view's name matches the first segment (index 0) of the ViewConfig's target name
94
+ * - the parent ui-view's context matches the ViewConfig's anchor
95
+ * - And the remaining segments (index 1..n) of the ViewConfig's target name match the tail of the ui-view's fqn
96
+ *
97
+ * Example:
98
+ *
99
+ * DOM:
100
+ * <ui-view> <!-- created in the root context (name: "") -->
101
+ * <ui-view name="foo"> <!-- created in the context named: "A" -->
102
+ * <ui-view> <!-- created in the context named: "A.B" -->
103
+ * <ui-view name="bar"> <!-- created in the context named: "A.B.C" -->
104
+ * </ui-view>
105
+ * </ui-view>
106
+ * </ui-view>
107
+ * </ui-view>
108
+ *
109
+ * ngViews: [
110
+ * { fqn: "$default", creationContext: { name: "" } },
111
+ * { fqn: "$default.foo", creationContext: { name: "A" } },
112
+ * { fqn: "$default.foo.$default", creationContext: { name: "A.B" } }
113
+ * { fqn: "$default.foo.$default.bar", creationContext: { name: "A.B.C" } }
114
+ * ]
115
+ *
116
+ * These four view configs all match the ui-view with the fqn: "$default.foo.$default.bar":
117
+ *
118
+ * - ViewConfig1: { ngViewName: "bar", ngViewContextAnchor: "A.B.C" }
119
+ * - ViewConfig2: { ngViewName: "$default.bar", ngViewContextAnchor: "A.B" }
120
+ * - ViewConfig3: { ngViewName: "foo.$default.bar", ngViewContextAnchor: "A" }
121
+ * - ViewConfig4: { ngViewName: "$default.foo.$default.bar", ngViewContextAnchor: "" }
122
+ *
123
+ * Using ViewConfig3 as an example, it matches the ui-view with fqn "$default.foo.$default.bar" because:
124
+ * - The ViewConfig's segmented target name is: [ "foo", "$default", "bar" ]
125
+ * - There exists a parent ui-view (which has fqn: "$default.foo") where:
126
+ * - the parent ui-view's name "foo" matches the first segment "foo" of the ViewConfig's target name
127
+ * - the parent ui-view's context "A" matches the ViewConfig's anchor context "A"
128
+ * - And the remaining segments [ "$default", "bar" ].join("."_ of the ViewConfig's target name match
129
+ * the tail of the ui-view's fqn "default.bar"
130
+ *
131
+ * @internal
132
+ */
133
+ function matches(ngViewsByFqn: any, ngView: any): (viewConfig: any) => boolean;
137
134
  }
@@ -1,5 +1,5 @@
1
1
  export function $ViewScrollProvider(): void;
2
2
  export class $ViewScrollProvider {
3
- useAnchorScroll: () => void;
4
- $get: (string | (($anchorScroll: any, $timeout: any) => any))[];
3
+ useAnchorScroll: () => void;
4
+ $get: (string | (($anchorScroll: any, $timeout: any) => any))[];
5
5
  }
@@ -1,11 +1,5 @@
1
1
  export function AnchorScrollProvider(): void;
2
2
  export class AnchorScrollProvider {
3
- disableAutoScrolling: () => void;
4
- $get: (
5
- | string
6
- | ((
7
- $location: angular.IRootScopeService,
8
- $rootScope: any,
9
- ) => (hash: any) => void)
10
- )[];
3
+ disableAutoScrolling: () => void;
4
+ $get: (string | (($location: angular.IRootScopeService, $rootScope: any) => (hash: any) => void))[];
11
5
  }
@@ -14,137 +14,129 @@ export function trimEmptyHash(url: any): any;
14
14
  */
15
15
  export function Browser($log: object, $$taskTrackerFactory: any): void;
16
16
  export class Browser {
17
- /**
18
- * @name $browser
19
- * @requires $log
20
- * @description
21
- * This object has two goals:
22
- *
23
- * - hide all the global state in the browser caused by the window object
24
- * - abstract away all the browser specific features and inconsistencies
25
- *
26
- */
27
- /**
28
- * @param {object} $log window.console or an object with the same interface.
29
- */
30
- constructor($log: object, $$taskTrackerFactory: any);
31
- $$completeOutstandingRequest: any;
32
- $$incOutstandingRequestCount: any;
33
- notifyWhenNoOutstandingRequests: any;
34
- /**
35
- * @name $browser#url
36
- *
37
- * @description
38
- * GETTER:
39
- * Without any argument, this method just returns current value of `location.href` (with a
40
- * trailing `#` stripped of if the hash is empty).
41
- *
42
- * SETTER:
43
- * With at least one argument, this method sets url to new value.
44
- * If html5 history api supported, `pushState`/`replaceState` is used, otherwise
45
- * `location.href`/`location.replace` is used.
46
- * Returns its own instance to allow chaining.
47
- *
48
- * NOTE: this api is intended for use only by the `$location` service. Please use the
49
- * {@link ng.$location $location service} to change url.
50
- *
51
- * @param {string} url New url (when used as setter)
52
- * @param {boolean=} replace Should new url replace current history record?
53
- * @param {object=} state State object to use with `pushState`/`replaceState`
54
- */
55
- url: (
56
- url: string,
57
- replace?: boolean | undefined,
58
- state?: object | undefined,
59
- ) => any;
60
- /**
61
- * @name $browser#state
62
- *
63
- * @description
64
- * This method is a getter.
65
- *
66
- * Return history.state or null if history.state is undefined.
67
- *
68
- * @returns {object} state
69
- */
70
- state: () => object;
71
- /**
72
- * @name $browser#onUrlChange
73
- *
74
- * @description
75
- * Register callback function that will be called, when url changes.
76
- *
77
- * It's only called when the url is changed from outside of AngularJS:
78
- * - user types different url into address bar
79
- * - user clicks on history (forward/back) button
80
- * - user clicks on a link
81
- *
82
- * It's not called when url is changed by $browser.url() method
83
- *
84
- * The listener gets called with new url as parameter.
85
- *
86
- * NOTE: this api is intended for use only by the $location service. Please use the
87
- * {@link ng.$location $location service} to monitor url changes in AngularJS apps.
88
- *
89
- * @param {function(string)} listener Listener function to be called when url changes.
90
- * @return {function(string)} Returns the registered listener fn - handy if the fn is anonymous.
91
- */
92
- onUrlChange: (callback: any) => (arg0: string) => any;
93
- /**
94
- * Remove popstate and hashchange handler from window.
95
- *
96
- * NOTE: this api is intended for use only by $rootScope.
97
- */
98
- $$applicationDestroyed: () => void;
99
- /**
100
- * Checks whether the url has changed outside of AngularJS.
101
- * Needs to be exported to be able to check for changes that have been done in sync,
102
- * as hashchange/popstate events fire in async.
103
- */
104
- $$checkUrlChange: () => void;
105
- /**
106
- * @name $browser#baseHref
107
- *
108
- * @description
109
- * Returns current <base href>
110
- * (always relative - without domain)
111
- *
112
- * @returns {string} The current base href
113
- */
114
- baseHref: () => string;
115
- /**
116
- * @name $browser#defer
117
- * @param {function()} fn A function, who's execution should be deferred.
118
- * @param {number=} [delay=0] Number of milliseconds to defer the function execution.
119
- * @param {string=} [taskType=DEFAULT_TASK_TYPE] The type of task that is deferred.
120
- * @returns {*} DeferId that can be used to cancel the task via `$browser.cancel()`.
121
- *
122
- * @description
123
- * Executes a fn asynchronously via `setTimeout(fn, delay)`.
124
- *
125
- * Unlike when calling `setTimeout` directly, in test this function is mocked and instead of using
126
- * `setTimeout` in tests, the fns are queued in an array, which can be programmatically flushed
127
- * via `$browser.defer.flush()`.
128
- *
129
- */
130
- defer: (
131
- fn: () => any,
132
- delay?: number | undefined,
133
- taskType?: string | undefined,
134
- ) => any;
135
- /**
136
- * @name $browser#cancel
137
- *
138
- * @description
139
- * Cancels a deferred task identified with `deferId`.
140
- *
141
- * @param {*} deferId Token returned by the `$browser.defer` function.
142
- * @returns {boolean} Returns `true` if the task hasn't executed yet and was successfully
143
- * canceled.
144
- */
145
- cancel: (deferId: any) => boolean;
17
+ /**
18
+ * @name $browser
19
+ * @requires $log
20
+ * @description
21
+ * This object has two goals:
22
+ *
23
+ * - hide all the global state in the browser caused by the window object
24
+ * - abstract away all the browser specific features and inconsistencies
25
+ *
26
+ */
27
+ /**
28
+ * @param {object} $log window.console or an object with the same interface.
29
+ */
30
+ constructor($log: object, $$taskTrackerFactory: any);
31
+ $$completeOutstandingRequest: any;
32
+ $$incOutstandingRequestCount: any;
33
+ notifyWhenNoOutstandingRequests: any;
34
+ /**
35
+ * @name $browser#url
36
+ *
37
+ * @description
38
+ * GETTER:
39
+ * Without any argument, this method just returns current value of `location.href` (with a
40
+ * trailing `#` stripped of if the hash is empty).
41
+ *
42
+ * SETTER:
43
+ * With at least one argument, this method sets url to new value.
44
+ * If html5 history api supported, `pushState`/`replaceState` is used, otherwise
45
+ * `location.href`/`location.replace` is used.
46
+ * Returns its own instance to allow chaining.
47
+ *
48
+ * NOTE: this api is intended for use only by the `$location` service. Please use the
49
+ * {@link ng.$location $location service} to change url.
50
+ *
51
+ * @param {string} url New url (when used as setter)
52
+ * @param {boolean=} replace Should new url replace current history record?
53
+ * @param {object=} state State object to use with `pushState`/`replaceState`
54
+ */
55
+ url: (url: string, replace?: boolean | undefined, state?: object | undefined) => any;
56
+ /**
57
+ * @name $browser#state
58
+ *
59
+ * @description
60
+ * This method is a getter.
61
+ *
62
+ * Return history.state or null if history.state is undefined.
63
+ *
64
+ * @returns {object} state
65
+ */
66
+ state: () => object;
67
+ /**
68
+ * @name $browser#onUrlChange
69
+ *
70
+ * @description
71
+ * Register callback function that will be called, when url changes.
72
+ *
73
+ * It's only called when the url is changed from outside of AngularJS:
74
+ * - user types different url into address bar
75
+ * - user clicks on history (forward/back) button
76
+ * - user clicks on a link
77
+ *
78
+ * It's not called when url is changed by $browser.url() method
79
+ *
80
+ * The listener gets called with new url as parameter.
81
+ *
82
+ * NOTE: this api is intended for use only by the $location service. Please use the
83
+ * {@link ng.$location $location service} to monitor url changes in AngularJS apps.
84
+ *
85
+ * @param {function(string)} listener Listener function to be called when url changes.
86
+ * @return {function(string)} Returns the registered listener fn - handy if the fn is anonymous.
87
+ */
88
+ onUrlChange: (callback: any) => (arg0: string) => any;
89
+ /**
90
+ * Remove popstate and hashchange handler from window.
91
+ *
92
+ * NOTE: this api is intended for use only by $rootScope.
93
+ */
94
+ $$applicationDestroyed: () => void;
95
+ /**
96
+ * Checks whether the url has changed outside of AngularJS.
97
+ * Needs to be exported to be able to check for changes that have been done in sync,
98
+ * as hashchange/popstate events fire in async.
99
+ */
100
+ $$checkUrlChange: () => void;
101
+ /**
102
+ * @name $browser#baseHref
103
+ *
104
+ * @description
105
+ * Returns current <base href>
106
+ * (always relative - without domain)
107
+ *
108
+ * @returns {string} The current base href
109
+ */
110
+ baseHref: () => string;
111
+ /**
112
+ * @name $browser#defer
113
+ * @param {function()} fn A function, who's execution should be deferred.
114
+ * @param {number=} [delay=0] Number of milliseconds to defer the function execution.
115
+ * @param {string=} [taskType=DEFAULT_TASK_TYPE] The type of task that is deferred.
116
+ * @returns {*} DeferId that can be used to cancel the task via `$browser.cancel()`.
117
+ *
118
+ * @description
119
+ * Executes a fn asynchronously via `setTimeout(fn, delay)`.
120
+ *
121
+ * Unlike when calling `setTimeout` directly, in test this function is mocked and instead of using
122
+ * `setTimeout` in tests, the fns are queued in an array, which can be programmatically flushed
123
+ * via `$browser.defer.flush()`.
124
+ *
125
+ */
126
+ defer: (fn: () => any, delay?: number | undefined, taskType?: string | undefined) => any;
127
+ /**
128
+ * @name $browser#cancel
129
+ *
130
+ * @description
131
+ * Cancels a deferred task identified with `deferId`.
132
+ *
133
+ * @param {*} deferId Token returned by the `$browser.defer` function.
134
+ * @returns {boolean} Returns `true` if the task hasn't executed yet and was successfully
135
+ * canceled.
136
+ */
137
+ cancel: (deferId: any) => boolean;
146
138
  }
147
139
  export function BrowserProvider(): void;
148
140
  export class BrowserProvider {
149
- $get: (string | (($log: any, $$taskTrackerFactory: any) => Browser))[];
141
+ $get: (string | (($log: any, $$taskTrackerFactory: any) => Browser))[];
150
142
  }
@@ -67,30 +67,30 @@
67
67
  */
68
68
  export function CacheFactoryProvider(): void;
69
69
  export class CacheFactoryProvider {
70
- $get: () => {
71
- (cacheId: string, options?: object | undefined): object;
72
- /**
73
- * @ngdoc method
74
- * @name $cacheFactory#info
75
- *
76
- * @description
77
- * Get information about all the caches that have been created
78
- *
79
- * @returns {Object} - key-value map of `cacheId` to the result of calling `cache#info`
80
- */
81
- info(): any;
82
- /**
83
- * @ngdoc method
84
- * @name $cacheFactory#get
85
- *
86
- * @description
87
- * Get access to a cache object by the `cacheId` used when it was created.
88
- *
89
- * @param {string} cacheId Name or id of a cache to access.
90
- * @returns {object} Cache object identified by the cacheId or undefined if no such cache.
91
- */
92
- get(cacheId: string): object;
93
- };
70
+ $get: () => {
71
+ (cacheId: string, options?: object | undefined): object;
72
+ /**
73
+ * @ngdoc method
74
+ * @name $cacheFactory#info
75
+ *
76
+ * @description
77
+ * Get information about all the caches that have been created
78
+ *
79
+ * @returns {Object} - key-value map of `cacheId` to the result of calling `cache#info`
80
+ */
81
+ info(): any;
82
+ /**
83
+ * @ngdoc method
84
+ * @name $cacheFactory#get
85
+ *
86
+ * @description
87
+ * Get access to a cache object by the `cacheId` used when it was created.
88
+ *
89
+ * @param {string} cacheId Name or id of a cache to access.
90
+ * @returns {object} Cache object identified by the cacheId or undefined if no such cache.
91
+ */
92
+ get(cacheId: string): object;
93
+ };
94
94
  }
95
95
  /**
96
96
  * @name $templateCache
@@ -139,5 +139,5 @@ export class CacheFactoryProvider {
139
139
  */
140
140
  export function TemplateCacheProvider(): void;
141
141
  export class TemplateCacheProvider {
142
- $get: (string | (($cacheFactory: any) => any))[];
142
+ $get: (string | (($cacheFactory: any) => any))[];
143
143
  }
@@ -9,9 +9,9 @@
9
9
  */
10
10
  export function $$CookieReader($document: any): any;
11
11
  export namespace $$CookieReader {
12
- let $inject: string[];
12
+ let $inject: string[];
13
13
  }
14
14
  export function CookieReaderProvider(): void;
15
15
  export class CookieReaderProvider {
16
- $get: typeof $$CookieReader;
16
+ $get: typeof $$CookieReader;
17
17
  }
@@ -25,7 +25,7 @@
25
25
  */
26
26
  export function $DocumentProvider(): void;
27
27
  export class $DocumentProvider {
28
- $get: (() => any)[];
28
+ $get: (() => any)[];
29
29
  }
30
30
  /**
31
31
  * @private
@@ -34,5 +34,5 @@ s * Listens for document visibility change and makes the current status accessib
34
34
  */
35
35
  export function $$IsDocumentHiddenProvider(): void;
36
36
  export class $$IsDocumentHiddenProvider {
37
- $get: (string | (($document: any, $rootScope: any) => () => any))[];
37
+ $get: (string | (($document: any, $rootScope: any) => () => any))[];
38
38
  }