@brickhouse-tech/angular-lts 1.8.4-0

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.
package/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ The MIT License
2
+
3
+ Copyright (c) 2010-2020 Google LLC. http://angularjs.org
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
22
+
@@ -0,0 +1,23 @@
1
+ Using AngularJS with the Closure Compiler
2
+ =========================================
3
+
4
+ The Closure Compiler project contains definitions for the AngularJS JavaScript
5
+ in its `contrib/externs` directory.
6
+
7
+ The definitions contain externs for use with the Closure compiler (aka
8
+ JSCompiler). Passing these files to the --externs parameter of a compiler
9
+ pass allows using type annotations for AngularJS objects. For example,
10
+ AngularJS's $scope objects can be annotated as:
11
+ ```js
12
+ /** @type {angular.Scope} */
13
+ var scope = $scope;
14
+ ```
15
+
16
+ This allows JSCompiler to type check accesses to scope, give warnings about
17
+ missing methods or incorrect arguments, and also prevents renaming of property
18
+ accesses with advanced compilation.
19
+
20
+ The externs are incomplete and maintained on an as-needed basis, but strive to
21
+ be correct. Externs for individual modules should be added in separate files.
22
+
23
+ See https://developers.google.com/closure/compiler/
package/README.md ADDED
@@ -0,0 +1,109 @@
1
+ AngularJS [![CircleCI](https://circleci.com/gh/angular/angular.js/tree/master.svg?style=shield)](https://circleci.com/gh/angular/workflows/angular.js/tree/master)
2
+ =========
3
+
4
+ AngularJS lets you write client-side web applications as if you had a smarter browser. It lets you
5
+ use good old HTML (or HAML, Jade/Pug and friends!) as your template language and lets you extend HTML’s
6
+ syntax to express your application’s components clearly and succinctly. It automatically
7
+ synchronizes data from your UI (view) with your JavaScript objects (model) through 2-way data
8
+ binding. To help you structure your application better and make it easy to test, AngularJS teaches
9
+ the browser how to do dependency injection and inversion of control.
10
+
11
+ It also helps with server-side communication, taming async callbacks with promises and deferred objects,
12
+ and it makes client-side navigation and deep linking with hashbang urls or HTML5 pushState a
13
+ piece of cake. Best of all? It makes development fun!
14
+
15
+ --------------------
16
+
17
+ **AngularJS support has officially ended as of January 2022.
18
+ [See what ending support means](https://docs.angularjs.org/misc/version-support-status)
19
+ and [read the end of life announcement](https://goo.gle/angularjs-end-of-life).**
20
+
21
+ **Visit [angular.io](https://angular.io) for the actively supported Angular.**
22
+
23
+ --------------------
24
+
25
+ * Web site: https://angularjs.org
26
+ * Tutorial: https://docs.angularjs.org/tutorial
27
+ * API Docs: https://docs.angularjs.org/api
28
+ * Developer Guide: https://docs.angularjs.org/guide
29
+ * Contribution guidelines: [CONTRIBUTING.md](CONTRIBUTING.md)
30
+ * Core Development: [DEVELOPERS.md](DEVELOPERS.md)
31
+ * Dashboard: https://dashboard.angularjs.org
32
+
33
+
34
+ Documentation
35
+ --------------------
36
+ Go to https://docs.angularjs.org
37
+
38
+ Contribute
39
+ --------------------
40
+
41
+ We've set up a separate document for our
42
+ [contribution guidelines](https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md).
43
+
44
+ Develop
45
+ --------------------
46
+
47
+ We've set up a separate document for
48
+ [developers](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md).
49
+
50
+
51
+ [![Analytics](https://ga-beacon.appspot.com/UA-8594346-11/angular.js/README.md?pixel)](https://github.com/igrigorik/ga-beacon)
52
+
53
+ What to use AngularJS for and when to use it
54
+ ---------
55
+ AngularJS is the next generation framework where each component is designed to work with every other
56
+ component in an interconnected way like a well-oiled machine. AngularJS is JavaScript MVC made easy
57
+ and done right. (Well it is not really MVC, read on, to understand what this means.)
58
+
59
+ #### MVC, no, MV* done the right way!
60
+ [MVC](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller), short for
61
+ Model-View-Controller, is a design pattern, i.e. how the code should be organized and how the
62
+ different parts of an application separated for proper readability and debugging. Model is the data
63
+ and the database. View is the user interface and what the user sees. Controller is the main link
64
+ between Model and View. These are the three pillars of major programming frameworks present on the
65
+ market today. On the other hand AngularJS works on MV*, short for Model-View-_Whatever_. The
66
+ _Whatever_ is AngularJS's way of telling that you may create any kind of linking between the Model
67
+ and the View here.
68
+
69
+ Unlike other frameworks in any programming language, where MVC, the three separate components, each
70
+ one has to be written and then connected by the programmer, AngularJS helps the programmer by asking
71
+ him/her to just create these and everything else will be taken care of by AngularJS.
72
+
73
+ #### Interconnection with HTML at the root level
74
+ AngularJS uses HTML to define the user's interface. AngularJS also enables the programmer to write
75
+ new HTML tags (AngularJS Directives) and increase the readability and understandability of the HTML
76
+ code. Directives are AngularJS’s way of bringing additional functionality to HTML. Directives
77
+ achieve this by enabling us to invent our own HTML elements. This also helps in making the code DRY
78
+ (Don't Repeat Yourself), which means once created, a new directive can be used anywhere within the
79
+ application.
80
+
81
+ HTML is also used to determine the wiring of the app. Special attributes in the HTML determine where
82
+ to load the app, which components or controllers to use for each element, etc. We specify "what"
83
+ gets loaded, but not "how". This declarative approach greatly simplifies app development in a sort
84
+ of WYSIWYG way. Rather than spending time on how the program flows and orchestrating the various
85
+ moving parts, we simply define what we want and AngularJS will take care of the dependencies.
86
+
87
+ #### Data Handling made simple
88
+ Data and Data Models in AngularJS are plain JavaScript objects and one can add and change properties
89
+ directly on it and loop over objects and arrays at will.
90
+
91
+ #### Two-way Data Binding
92
+ One of AngularJS's strongest features. Two-way Data Binding means that if something changes in the
93
+ Model, the change gets reflected in the View instantaneously, and the same happens the other way
94
+ around. This is also referred to as Reactive Programming, i.e. suppose `a = b + c` is being
95
+ programmed and after this, if the value of `b` and/or `c` is changed then the value of `a` will be
96
+ automatically updated to reflect the change. AngularJS uses its "scopes" as a glue between the Model
97
+ and View and makes these updates in one available for the other.
98
+
99
+ #### Less Written Code and Easily Maintainable Code
100
+ Everything in AngularJS is created to enable the programmer to end up writing less code that is
101
+ easily maintainable and readable by any other new person on the team. Believe it or not, one can
102
+ write a complete working two-way data binded application in less than 10 lines of code. Try and see
103
+ for yourself!
104
+
105
+ #### Testing Ready
106
+ AngularJS has Dependency Injection, i.e. it takes care of providing all the necessary dependencies
107
+ to its controllers and services whenever required. This helps in making the AngularJS code ready for
108
+ unit testing by making use of mock dependencies created and injected. This makes AngularJS more
109
+ modular and easily testable thus in turn helping a team create more robust applications.