@angular-wave/angular.ts 0.9.4 → 0.9.5
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/@types/index.d.ts +1 -84
- package/{src/index.ts → @types/namespace.d.ts} +4 -24
- package/@types/router/template-factory.d.ts +2 -2
- package/dist/angular-ts.esm.js +3 -3
- package/dist/angular-ts.umd.js +3 -3
- package/dist/angular-ts.umd.min.js +1 -1
- package/package.json +8 -1
- package/.github/workflows/ci.yml +0 -104
- package/.github/workflows/gh-pages.yml +0 -75
- package/.husky/pre-commit +0 -5
- package/.prettierignore +0 -9
- package/CHANGELOG.md +0 -17667
- package/CODE_OF_CONDUCT.md +0 -3
- package/CONTRIBUTING.md +0 -247
- package/DEVELOPERS.md +0 -499
- package/Makefile +0 -60
- package/RELEASE.md +0 -86
- package/TRIAGING.md +0 -127
- package/docs/.cspell.yml +0 -8
- package/docs/.github/dependabot.yml +0 -14
- package/docs/.nvmrc +0 -1
- package/docs/CONTRIBUTING.md +0 -28
- package/docs/Dockerfile +0 -4
- package/docs/LICENSE +0 -201
- package/docs/README.md +0 -217
- package/docs/assets/icons/logo.svg +0 -1
- package/docs/assets/scss/_variables_project.scss +0 -12
- package/docs/assets/scss/_variables_project_after_bs.scss +0 -8
- package/docs/assets/scss/index.scss +0 -48
- package/docs/config.yaml +0 -15
- package/docs/content/_index.md +0 -28
- package/docs/content/docs/_index.md +0 -61
- package/docs/content/docs/directive/_index.md +0 -4
- package/docs/content/docs/directive/app.md +0 -11
- package/docs/content/docs/directive/aria.md +0 -0
- package/docs/content/docs/directive/bind.md +0 -72
- package/docs/content/docs/directive/blur.md +0 -38
- package/docs/content/docs/directive/channel.md +0 -37
- package/docs/content/docs/directive/class-even.md +0 -47
- package/docs/content/docs/directive/class-odd.md +0 -48
- package/docs/content/docs/directive/class.md +0 -64
- package/docs/content/docs/directive/click.md +0 -41
- package/docs/content/docs/directive/cloak.md +0 -74
- package/docs/content/docs/directive/copy.md +0 -38
- package/docs/content/docs/directive/cut.md +0 -40
- package/docs/content/docs/directive/dblclick.md +0 -41
- package/docs/content/docs/directive/focus.md +0 -38
- package/docs/content/docs/directive/get.md +0 -203
- package/docs/content/docs/directive/include.md +0 -7
- package/docs/content/docs/directive/keydown.md +0 -38
- package/docs/content/docs/directive/keyup.md +0 -38
- package/docs/content/docs/directive/load.md +0 -43
- package/docs/content/docs/directive/mousedown.md +0 -38
- package/docs/content/docs/directive/mouseenter.md +0 -38
- package/docs/content/docs/directive/mouseleave.md +0 -38
- package/docs/content/docs/directive/mousemove.md +0 -38
- package/docs/content/docs/directive/mouseout.md +0 -38
- package/docs/content/docs/directive/mouseover.md +0 -38
- package/docs/content/docs/directive/mouseup.md +0 -38
- package/docs/content/docs/directive/non-bindable.md +0 -28
- package/docs/content/docs/filter/_index.md +0 -4
- package/docs/content/docs/filter/filter.md +0 -78
- package/docs/content/docs/filter/json.md +0 -19
- package/docs/content/docs/filter/limit-to.md +0 -30
- package/docs/content/docs/filter/order-by.md +0 -123
- package/docs/content/docs/provider/_index.md +0 -4
- package/docs/content/docs/provider/eventBusProvider.md +0 -35
- package/docs/content/docs/provider/locationProvider.md +0 -26
- package/docs/content/docs/provider/logProvider.md +0 -59
- package/docs/content/docs/provider/sceProvider.md +0 -194
- package/docs/content/docs/provider/templateCacheProvider.md +0 -100
- package/docs/content/docs/provider/templateRequestProvider.md +0 -5
- package/docs/content/docs/service/_index.md +0 -4
- package/docs/content/docs/service/compile.md +0 -5
- package/docs/content/docs/service/controller.md +0 -5
- package/docs/content/docs/service/eventBus.md +0 -56
- package/docs/content/docs/service/http.md +0 -161
- package/docs/content/docs/service/interpolation.md +0 -5
- package/docs/content/docs/service/location.md +0 -57
- package/docs/content/docs/service/log.md +0 -113
- package/docs/content/docs/service/parse.md +0 -5
- package/docs/content/docs/service/rootElement.md +0 -5
- package/docs/content/docs/service/rootScope.md +0 -5
- package/docs/content/docs/service/sce.md +0 -194
- package/docs/content/docs/service/templateCache.md +0 -64
- package/docs/content/docs/service/templateRequest.md +0 -5
- package/docs/content/docs/service/url.md +0 -5
- package/docs/content/docs/values/_index.md +0 -4
- package/docs/content/docs/values/document.md +0 -29
- package/docs/content/docs/values/window.md +0 -29
- package/docs/docker-compose.yaml +0 -12
- package/docs/docsy.work +0 -5
- package/docs/docsy.work.sum +0 -0
- package/docs/go.mod +0 -5
- package/docs/go.sum +0 -6
- package/docs/hugo-disabled.toml +0 -220
- package/docs/hugo.yaml +0 -200
- package/docs/layouts/404.html +0 -13
- package/docs/layouts/_markup/render-heading.html +0 -1
- package/docs/layouts/partials/hooks/head-end.html +0 -3
- package/docs/layouts/shortcodes/showcss.html +0 -2
- package/docs/layouts/shortcodes/showhtml.html +0 -2
- package/docs/layouts/shortcodes/showjs.html +0 -2
- package/docs/layouts/shortcodes/showraw.html +0 -1
- package/docs/layouts/shortcodes/version.html +0 -1
- package/docs/package-lock.json +0 -2293
- package/docs/package.json +0 -53
- package/docs/static/examples/counter/counter-test.html +0 -13
- package/docs/static/examples/counter/counter.html +0 -5
- package/docs/static/examples/counter/counter.test.js +0 -28
- package/docs/static/examples/document/document.html +0 -3
- package/docs/static/examples/eventbus/eventbus-test.html +0 -15
- package/docs/static/examples/eventbus/eventbus.html +0 -13
- package/docs/static/examples/eventbus/eventbus.js +0 -15
- package/docs/static/examples/eventbus/eventbus.test.js +0 -19
- package/docs/static/examples/i18n/i18n.html +0 -77
- package/docs/static/examples/ng-bind/ng-bind.html +0 -9
- package/docs/static/examples/ng-blur/ng-blur.html +0 -9
- package/docs/static/examples/ng-channel/ng-channel-test.html +0 -17
- package/docs/static/examples/ng-channel/ng-channel.html +0 -24
- package/docs/static/examples/ng-channel/ng-channel.test.js +0 -31
- package/docs/static/examples/ng-class/ng-class.html +0 -71
- package/docs/static/examples/ng-class-even/ng-class-even.html +0 -8
- package/docs/static/examples/ng-class-odd/ng-class-odd.html +0 -8
- package/docs/static/examples/ng-click/ng-click.html +0 -6
- package/docs/static/examples/ng-copy/ng-copy.html +0 -6
- package/docs/static/examples/ng-cut/ng-cut.html +0 -6
- package/docs/static/examples/ng-dblclick/ng-dblclick.html +0 -10
- package/docs/static/examples/ng-focus/ng-focus.html +0 -9
- package/docs/static/examples/ng-keydown/ng-keydown.html +0 -9
- package/docs/static/examples/ng-keyup/ng-keyup.html +0 -9
- package/docs/static/examples/ng-load/ng-load.html +0 -8
- package/docs/static/examples/ng-mousedown/ng-mousedown.html +0 -6
- package/docs/static/examples/ng-mouseenter/ng-mouseenter.html +0 -4
- package/docs/static/examples/ng-mouseleave/ng-mouseleave.html +0 -4
- package/docs/static/examples/ng-mousemove/ng-mousemove.html +0 -4
- package/docs/static/examples/ng-mouseout/ng-mouseout.html +0 -4
- package/docs/static/examples/ng-mouseover/ng-mouseover.html +0 -4
- package/docs/static/examples/ng-mouseup/ng-mouseup.html +0 -4
- package/docs/static/examples/ng-non-bindable/ng-non-bindable-test.html +0 -13
- package/docs/static/examples/ng-non-bindable/ng-non-bindable.html +0 -3
- package/docs/static/examples/ng-non-bindable/ng-non-bindable.test.js +0 -11
- package/docs/static/examples/window/window.html +0 -4
- package/docs/static/typedoc/.nojekyll +0 -1
- package/docs/static/typedoc/assets/hierarchy.js +0 -1
- package/docs/static/typedoc/assets/highlight.css +0 -29
- package/docs/static/typedoc/assets/icons.js +0 -18
- package/docs/static/typedoc/assets/icons.svg +0 -1
- package/docs/static/typedoc/assets/main.js +0 -60
- package/docs/static/typedoc/assets/navigation.js +0 -1
- package/docs/static/typedoc/assets/search.js +0 -1
- package/docs/static/typedoc/assets/style.css +0 -1633
- package/docs/static/typedoc/classes/Location.html +0 -55
- package/docs/static/typedoc/classes/LocationProvider.html +0 -20
- package/docs/static/typedoc/classes/LogProvider.html +0 -6
- package/docs/static/typedoc/classes/PubSub.html +0 -71
- package/docs/static/typedoc/classes/PubSubProvider.html +0 -4
- package/docs/static/typedoc/classes/TemplateCacheProvider.html +0 -5
- package/docs/static/typedoc/hierarchy.html +0 -1
- package/docs/static/typedoc/index.html +0 -1
- package/docs/static/typedoc/interfaces/DefaultPorts.html +0 -5
- package/docs/static/typedoc/interfaces/Html5Mode.html +0 -23
- package/docs/static/typedoc/interfaces/HttpHeadersGetter.html +0 -1
- package/docs/static/typedoc/interfaces/HttpProviderDefaults.html +0 -31
- package/docs/static/typedoc/interfaces/HttpRequestConfigHeaders.html +0 -6
- package/docs/static/typedoc/interfaces/HttpRequestTransformer.html +0 -1
- package/docs/static/typedoc/interfaces/HttpResponse.html +0 -7
- package/docs/static/typedoc/interfaces/HttpResponseTransformer.html +0 -1
- package/docs/static/typedoc/interfaces/HttpService.html +0 -38
- package/docs/static/typedoc/interfaces/LogService.html +0 -12
- package/docs/static/typedoc/interfaces/RequestConfig.html +0 -48
- package/docs/static/typedoc/interfaces/RequestShortcutConfig.html +0 -38
- package/docs/static/typedoc/interfaces/ServiceProvider.html +0 -5
- package/docs/static/typedoc/interfaces/UrlParts.html +0 -9
- package/docs/static/typedoc/types/HttpParamSerializer.html +0 -2
- package/docs/static/typedoc/types/HttpParams.html +0 -2
- package/docs/static/typedoc/types/HttpPromise.html +0 -1
- package/docs/static/typedoc/types/HttpResponseStatus.html +0 -1
- package/docs/static/typedoc/types/LogCall.html +0 -2
- package/docs/static/typedoc/types/LogServiceFactory.html +0 -2
- package/docs/static/typedoc/types/UrlChangeListener.html +0 -5
- package/docs/static/typedoc/variables/EventBus.html +0 -1
- package/docs/static/version.js +0 -13
- package/docs/test-results/.last-run.json +0 -4
- package/docs/test-results/static-examples-counter-counter-counter-example/error-context.md +0 -50
- package/eslint.config.js +0 -26
- package/images/android-chrome-192x192.png +0 -0
- package/images/android-chrome-512x512.png +0 -0
- package/images/apple-touch-icon.png +0 -0
- package/images/favicon-16x16.png +0 -0
- package/images/favicon-32x32.png +0 -0
- package/images/favicon.ico +0 -0
- package/images/site.webmanifest +0 -19
- package/index.html +0 -86
- package/legacy.d.ts +0 -1678
- package/playwright.config.ts +0 -81
- package/public/jasmine/boot0.js +0 -66
- package/public/jasmine/boot1.js +0 -134
- package/public/jasmine/jasmine-html.js +0 -970
- package/public/jasmine/jasmine.css +0 -323
- package/public/jasmine/jasmine.js +0 -11406
- package/public/public/README.md +0 -1
- package/public/public/circle.html +0 -1
- package/public/public/jasmine-helper.css +0 -9
- package/public/public/my_child_directive.html +0 -1
- package/public/public/my_directive.html +0 -1
- package/public/public/my_other_directive.html +0 -1
- package/public/public/test.html +0 -1
- package/rollup.config.js +0 -51
- package/src/angular.js +0 -286
- package/src/angular.spec.js +0 -1191
- package/src/animations/animate-cache.js +0 -80
- package/src/animations/animate-children-directive.js +0 -32
- package/src/animations/animate-children-directive.md +0 -80
- package/src/animations/animate-css-driver.js +0 -284
- package/src/animations/animate-css.html +0 -58
- package/src/animations/animate-css.js +0 -915
- package/src/animations/animate-css.md +0 -263
- package/src/animations/animate-js-driver.js +0 -60
- package/src/animations/animate-js.html +0 -47
- package/src/animations/animate-js.js +0 -371
- package/src/animations/animate-queue.js +0 -859
- package/src/animations/animate-runner.js +0 -193
- package/src/animations/animate-swap.js +0 -33
- package/src/animations/animate-swap.md +0 -88
- package/src/animations/animate.html +0 -19
- package/src/animations/animate.js +0 -546
- package/src/animations/animate.md +0 -933
- package/src/animations/animate.spec.js +0 -490
- package/src/animations/animation.js +0 -519
- package/src/animations/animations.test.js +0 -10
- package/src/animations/interface.ts +0 -19
- package/src/animations/raf-scheduler.html +0 -19
- package/src/animations/raf-scheduler.js +0 -92
- package/src/animations/raf-scheduler.spec.js +0 -98
- package/src/animations/shared.js +0 -341
- package/src/binding.html +0 -19
- package/src/binding.spec.js +0 -474
- package/src/binding.test.js +0 -10
- package/src/core/compile/attributes.js +0 -337
- package/src/core/compile/compile.html +0 -19
- package/src/core/compile/compile.js +0 -3271
- package/src/core/compile/compile.md +0 -1128
- package/src/core/compile/compile.spec.js +0 -15574
- package/src/core/compile/compile.test.js +0 -12
- package/src/core/controller/controller.html +0 -22
- package/src/core/controller/controller.js +0 -193
- package/src/core/controller/controller.spec.js +0 -334
- package/src/core/controller/controller.test.js +0 -12
- package/src/core/controller/interface.ts +0 -6
- package/src/core/core.html +0 -20
- package/src/core/core.test.js +0 -12
- package/src/core/di/injector.html +0 -19
- package/src/core/di/injector.js +0 -307
- package/src/core/di/injector.md +0 -740
- package/src/core/di/injector.spec.js +0 -2310
- package/src/core/di/injector.test.js +0 -12
- package/src/core/di/internal-injector.js +0 -286
- package/src/core/di/ng-module.html +0 -19
- package/src/core/di/ng-module.js +0 -229
- package/src/core/di/ng-module.spec.js +0 -263
- package/src/core/di/ng-module.test.js +0 -12
- package/src/core/filter/filter.html +0 -19
- package/src/core/filter/filter.js +0 -55
- package/src/core/filter/filter.md +0 -132
- package/src/core/filter/filter.spec.js +0 -149
- package/src/core/filter/filter.test.js +0 -12
- package/src/core/interpolate/interface.ts +0 -14
- package/src/core/interpolate/interpolate.html +0 -22
- package/src/core/interpolate/interpolate.js +0 -410
- package/src/core/interpolate/interpolate.spec.js +0 -601
- package/src/core/interpolate/interpolate.test.js +0 -12
- package/src/core/parse/ast/ast-node.ts +0 -81
- package/src/core/parse/ast/ast.html +0 -19
- package/src/core/parse/ast/ast.js +0 -574
- package/src/core/parse/ast/ast.spec.js +0 -1453
- package/src/core/parse/ast/ast.test.js +0 -10
- package/src/core/parse/ast-type.js +0 -23
- package/src/core/parse/interface.ts +0 -84
- package/src/core/parse/interpreter.js +0 -915
- package/src/core/parse/lexer/lexer.html +0 -19
- package/src/core/parse/lexer/lexer.js +0 -338
- package/src/core/parse/lexer/lexer.spec.js +0 -303
- package/src/core/parse/lexer/lexer.test.js +0 -10
- package/src/core/parse/lexer/token.ts +0 -22
- package/src/core/parse/parse.html +0 -19
- package/src/core/parse/parse.js +0 -337
- package/src/core/parse/parse.md +0 -57
- package/src/core/parse/parse.spec.js +0 -2107
- package/src/core/parse/parse.test.js +0 -10
- package/src/core/parse/parser/parser.html +0 -19
- package/src/core/parse/parser/parser.js +0 -64
- package/src/core/parse/parser/parser.spec.js +0 -8
- package/src/core/parse/parser/parser.test.js +0 -10
- package/src/core/prop.spec.js +0 -775
- package/src/core/root-element.spec.js +0 -14
- package/src/core/sanitize/interface.ts +0 -10
- package/src/core/sanitize/sanitize-uri.js +0 -75
- package/src/core/sanitize/sanitize-uri.spec.js +0 -249
- package/src/core/sanitize/sanitize-uri.test.js +0 -12
- package/src/core/sanitize/sanitize.html +0 -22
- package/src/core/scope/scope.html +0 -19
- package/src/core/scope/scope.js +0 -1252
- package/src/core/scope/scope.spec.js +0 -3000
- package/src/core/scope/scope.test.js +0 -12
- package/src/directive/aria/aria.html +0 -19
- package/src/directive/aria/aria.js +0 -382
- package/src/directive/aria/aria.md +0 -145
- package/src/directive/aria/aria.spec.js +0 -1241
- package/src/directive/aria/aria.test.js +0 -12
- package/src/directive/attrs/attrs.html +0 -19
- package/src/directive/attrs/attrs.js +0 -106
- package/src/directive/attrs/attrs.md +0 -224
- package/src/directive/attrs/attrs.spec.js +0 -71
- package/src/directive/attrs/attrs.test.js +0 -12
- package/src/directive/attrs/boolean.html +0 -19
- package/src/directive/attrs/boolean.spec.js +0 -137
- package/src/directive/attrs/boolean.test.js +0 -12
- package/src/directive/attrs/element-style.html +0 -22
- package/src/directive/attrs/element-style.spec.js +0 -85
- package/src/directive/attrs/element-style.test.js +0 -12
- package/src/directive/attrs/src.html +0 -19
- package/src/directive/attrs/src.spec.js +0 -163
- package/src/directive/attrs/src.test.js +0 -12
- package/src/directive/bind/bind-html.spec.js +0 -36
- package/src/directive/bind/bind.html +0 -20
- package/src/directive/bind/bind.js +0 -78
- package/src/directive/bind/bind.md +0 -142
- package/src/directive/bind/bind.spec.js +0 -314
- package/src/directive/bind/bind.test.js +0 -12
- package/src/directive/channel/channel.html +0 -19
- package/src/directive/channel/channel.js +0 -30
- package/src/directive/channel/channel.spec.js +0 -67
- package/src/directive/channel/channel.test.js +0 -10
- package/src/directive/class/class-test.html +0 -23
- package/src/directive/class/class.html +0 -19
- package/src/directive/class/class.js +0 -184
- package/src/directive/class/class.spec.js +0 -704
- package/src/directive/class/class.test.js +0 -12
- package/src/directive/cloak/cloak.html +0 -19
- package/src/directive/cloak/cloak.js +0 -11
- package/src/directive/cloak/cloak.spec.js +0 -44
- package/src/directive/cloak/cloak.test.js +0 -12
- package/src/directive/controller/controller.html +0 -22
- package/src/directive/controller/controller.js +0 -11
- package/src/directive/controller/controller.md +0 -46
- package/src/directive/controller/controller.spec.js +0 -175
- package/src/directive/controller/controller.test.js +0 -12
- package/src/directive/events/click.spec.js +0 -35
- package/src/directive/events/event.spec.js +0 -267
- package/src/directive/events/events-test.html +0 -36
- package/src/directive/events/events.html +0 -20
- package/src/directive/events/events.js +0 -65
- package/src/directive/events/events.md +0 -125
- package/src/directive/events/events.test.js +0 -12
- package/src/directive/form/form.html +0 -19
- package/src/directive/form/form.js +0 -669
- package/src/directive/form/form.spec.js +0 -1515
- package/src/directive/form/form.test.js +0 -12
- package/src/directive/http/delete.spec.js +0 -23
- package/src/directive/http/form-router-test.html +0 -44
- package/src/directive/http/form-test.html +0 -18
- package/src/directive/http/get.spec.js +0 -488
- package/src/directive/http/http.html +0 -22
- package/src/directive/http/http.js +0 -342
- package/src/directive/http/http.test.js +0 -12
- package/src/directive/http/interface.ts +0 -36
- package/src/directive/http/post-example.html +0 -30
- package/src/directive/http/post.spec.js +0 -521
- package/src/directive/http/put.spec.js +0 -23
- package/src/directive/if/if-animate-css.html +0 -57
- package/src/directive/if/if-animate-svg.html +0 -25
- package/src/directive/if/if.html +0 -19
- package/src/directive/if/if.js +0 -72
- package/src/directive/if/if.md +0 -76
- package/src/directive/if/if.spec.js +0 -293
- package/src/directive/if/if.test.js +0 -114
- package/src/directive/include/include.html +0 -19
- package/src/directive/include/include.js +0 -151
- package/src/directive/include/include.md +0 -87
- package/src/directive/include/include.spec.js +0 -734
- package/src/directive/include/include.test.js +0 -12
- package/src/directive/init/init.html +0 -19
- package/src/directive/init/init.js +0 -22
- package/src/directive/init/init.md +0 -41
- package/src/directive/init/init.spec.js +0 -68
- package/src/directive/init/init.test.js +0 -12
- package/src/directive/inject/inject.html +0 -19
- package/src/directive/inject/inject.js +0 -35
- package/src/directive/inject/inject.spec.js +0 -108
- package/src/directive/inject/inject.test.js +0 -12
- package/src/directive/input/input-example.html +0 -15
- package/src/directive/input/input.html +0 -19
- package/src/directive/input/input.js +0 -1078
- package/src/directive/input/input.md +0 -706
- package/src/directive/input/input.spec.js +0 -3700
- package/src/directive/input/input.test.js +0 -12
- package/src/directive/messages/messages.html +0 -22
- package/src/directive/messages/messages.js +0 -349
- package/src/directive/messages/messages.md +0 -543
- package/src/directive/messages/messages.spec.js +0 -1083
- package/src/directive/messages/messages.test.js +0 -12
- package/src/directive/model/change.md +0 -25
- package/src/directive/model/model.html +0 -19
- package/src/directive/model/model.js +0 -1170
- package/src/directive/model/model.spec.js +0 -1976
- package/src/directive/model/model.test.js +0 -12
- package/src/directive/model-options/model-option.test.js +0 -12
- package/src/directive/model-options/model-options.html +0 -22
- package/src/directive/model-options/model-options.js +0 -142
- package/src/directive/model-options/model-options.md +0 -407
- package/src/directive/model-options/model-options.spec.js +0 -1022
- package/src/directive/non-bindable/non-bindable.html +0 -22
- package/src/directive/non-bindable/non-bindable.js +0 -9
- package/src/directive/non-bindable/non-bindable.spec.js +0 -59
- package/src/directive/non-bindable/non-bindable.test.js +0 -12
- package/src/directive/observe/observe-demo.html +0 -184
- package/src/directive/observe/observe.html +0 -19
- package/src/directive/observe/observe.js +0 -41
- package/src/directive/observe/observe.spec.js +0 -106
- package/src/directive/observe/observe.test.js +0 -10
- package/src/directive/on/on.html +0 -19
- package/src/directive/on/on.spec.js +0 -215
- package/src/directive/on/on.test.js +0 -12
- package/src/directive/options/options-example.html +0 -17
- package/src/directive/options/options.html +0 -22
- package/src/directive/options/options.js +0 -542
- package/src/directive/options/options.md +0 -179
- package/src/directive/options/options.spec.js +0 -3554
- package/src/directive/options/options.test.js +0 -12
- package/src/directive/ref/href.html +0 -19
- package/src/directive/ref/href.spec.js +0 -141
- package/src/directive/ref/href.test.js +0 -19
- package/src/directive/ref/ref.html +0 -19
- package/src/directive/ref/ref.js +0 -89
- package/src/directive/ref/ref.spec.js +0 -546
- package/src/directive/repeat/repeat.html +0 -19
- package/src/directive/repeat/repeat.js +0 -333
- package/src/directive/repeat/repeat.md +0 -330
- package/src/directive/repeat/repeat.spec.js +0 -1209
- package/src/directive/repeat/repeat.test.js +0 -12
- package/src/directive/script/script.html +0 -19
- package/src/directive/script/script.js +0 -17
- package/src/directive/script/script.md +0 -11
- package/src/directive/script/script.spec.js +0 -47
- package/src/directive/script/script.test.js +0 -12
- package/src/directive/select/select.html +0 -19
- package/src/directive/select/select.js +0 -594
- package/src/directive/select/select.md +0 -74
- package/src/directive/select/select.spec.js +0 -2566
- package/src/directive/select/select.test.js +0 -12
- package/src/directive/setter/setter.html +0 -19
- package/src/directive/setter/setter.js +0 -59
- package/src/directive/setter/setter.spec.js +0 -100
- package/src/directive/setter/setter.test.js +0 -12
- package/src/directive/show-hide/show-hide.html +0 -22
- package/src/directive/show-hide/show-hide.js +0 -65
- package/src/directive/show-hide/show-hide.md +0 -255
- package/src/directive/show-hide/show-hide.spec.js +0 -268
- package/src/directive/show-hide/show-hide.test.js +0 -12
- package/src/directive/style/style.html +0 -19
- package/src/directive/style/style.js +0 -27
- package/src/directive/style/style.md +0 -23
- package/src/directive/style/style.spec.js +0 -183
- package/src/directive/style/style.test.js +0 -12
- package/src/directive/switch/switch.html +0 -19
- package/src/directive/switch/switch.js +0 -133
- package/src/directive/switch/switch.md +0 -66
- package/src/directive/switch/switch.spec.js +0 -509
- package/src/directive/switch/switch.test.js +0 -12
- package/src/directive/transclude/transclude.js +0 -122
- package/src/directive/validators/validators.html +0 -22
- package/src/directive/validators/validators.js +0 -346
- package/src/directive/validators/validators.spec.js +0 -740
- package/src/directive/validators/validators.test.js +0 -12
- package/src/filters/filter.js +0 -213
- package/src/filters/filter.spec.js +0 -719
- package/src/filters/filters.html +0 -22
- package/src/filters/filters.js +0 -239
- package/src/filters/filters.spec.js +0 -36
- package/src/filters/filters.test.js +0 -12
- package/src/filters/interface.ts +0 -9
- package/src/filters/limit-to.js +0 -55
- package/src/filters/limit-to.spec.js +0 -252
- package/src/filters/order-by.js +0 -181
- package/src/filters/order-by.spec.js +0 -883
- package/src/index.js +0 -6
- package/src/index.spec.js +0 -11
- package/src/injection-tokens.js +0 -81
- package/src/interface.ts +0 -430
- package/src/ng.js +0 -291
- package/src/ng.spec.js +0 -45
- package/src/router/common/trace.js +0 -240
- package/src/router/directives/component-example.html +0 -37
- package/src/router/directives/state-directives.html +0 -22
- package/src/router/directives/state-directives.js +0 -393
- package/src/router/directives/state-directives.md +0 -435
- package/src/router/directives/state-directives.spec.js +0 -1091
- package/src/router/directives/state-directives.test.js +0 -10
- package/src/router/directives/view-directive.js +0 -489
- package/src/router/directives/view-directive.spec.js +0 -1921
- package/src/router/directives/view-directive.test.js +0 -10
- package/src/router/directives/view-directives.html +0 -22
- package/src/router/glob/glob.html +0 -19
- package/src/router/glob/glob.js +0 -102
- package/src/router/glob/glob.spec.js +0 -108
- package/src/router/glob/glob.test.js +0 -12
- package/src/router/hooks/core-resolvables.js +0 -38
- package/src/router/hooks/ignored-transition.js +0 -25
- package/src/router/hooks/invalid-transition.js +0 -14
- package/src/router/hooks/lazy-load.js +0 -104
- package/src/router/hooks/on-enter-exit-retain.js +0 -55
- package/src/router/hooks/redirect-to.js +0 -38
- package/src/router/hooks/resolve.js +0 -57
- package/src/router/hooks/update-globals.js +0 -34
- package/src/router/hooks/url.js +0 -34
- package/src/router/hooks/views.js +0 -41
- package/src/router/params/interface.ts +0 -626
- package/src/router/params/param-factory.js +0 -23
- package/src/router/params/param-type.js +0 -133
- package/src/router/params/param-types.js +0 -153
- package/src/router/params/param.js +0 -243
- package/src/router/params/state-params.js +0 -36
- package/src/router/path/path-node.js +0 -78
- package/src/router/path/path-utils.js +0 -207
- package/src/router/resolve/interface.ts +0 -208
- package/src/router/resolve/resolvable.js +0 -123
- package/src/router/resolve/resolve-context.js +0 -190
- package/src/router/router-test-hashbang.html +0 -45
- package/src/router/router-test.html +0 -41
- package/src/router/router.html +0 -22
- package/src/router/router.js +0 -54
- package/src/router/router.test.js +0 -12
- package/src/router/services.spec.js +0 -52
- package/src/router/state/interface.ts +0 -1007
- package/src/router/state/state-builder.js +0 -376
- package/src/router/state/state-builder.spec.js +0 -86
- package/src/router/state/state-matcher.js +0 -64
- package/src/router/state/state-object.js +0 -118
- package/src/router/state/state-queue-manager.js +0 -95
- package/src/router/state/state-registry.js +0 -262
- package/src/router/state/state-service.js +0 -687
- package/src/router/state/state.html +0 -23
- package/src/router/state/state.spec.js +0 -1002
- package/src/router/state/state.test.js +0 -12
- package/src/router/state/target-state.js +0 -162
- package/src/router/state/views.js +0 -195
- package/src/router/state-filter.spec.js +0 -139
- package/src/router/state-filters.js +0 -46
- package/src/router/template-factory.html +0 -19
- package/src/router/template-factory.js +0 -249
- package/src/router/template-factory.spec.js +0 -146
- package/src/router/template-factory.test.js +0 -12
- package/src/router/transition/hook-builder.js +0 -137
- package/src/router/transition/hook-registry.js +0 -181
- package/src/router/transition/interface.js +0 -18
- package/src/router/transition/interface.ts +0 -922
- package/src/router/transition/reject-factory.js +0 -122
- package/src/router/transition/transition-event-type.js +0 -26
- package/src/router/transition/transition-hook.js +0 -199
- package/src/router/transition/transition-service.js +0 -297
- package/src/router/transition/transition.js +0 -653
- package/src/router/url/url-config.js +0 -155
- package/src/router/url/url-matcher.js +0 -532
- package/src/router/url/url-rule.js +0 -231
- package/src/router/url/url-rules.js +0 -350
- package/src/router/url/url-service.js +0 -446
- package/src/router/url/url-service.spec.js +0 -1288
- package/src/router/url/url.html +0 -19
- package/src/router/url/url.test.js +0 -12
- package/src/router/view/interface.ts +0 -51
- package/src/router/view/view.html +0 -19
- package/src/router/view/view.js +0 -262
- package/src/router/view/view.spec.js +0 -100
- package/src/router/view/view.test.js +0 -12
- package/src/router/view-hook.spec.js +0 -215
- package/src/router/view-scroll.js +0 -33
- package/src/router/view-scroll.spec.js +0 -72
- package/src/services/anchor-scroll/anchor-scroll.html +0 -76
- package/src/services/anchor-scroll/anchor-scroll.js +0 -147
- package/src/services/exception/exception-handler.js +0 -75
- package/src/services/exception/interface.ts +0 -7
- package/src/services/http/http.html +0 -23
- package/src/services/http/http.js +0 -1109
- package/src/services/http/http.spec.js +0 -4320
- package/src/services/http/http.test.js +0 -11
- package/src/services/http/interface.ts +0 -256
- package/src/services/http/template-request.spec.js +0 -220
- package/src/services/location/interface.ts +0 -70
- package/src/services/location/location.html +0 -22
- package/src/services/location/location.js +0 -1006
- package/src/services/location/location.spec.js +0 -3792
- package/src/services/location/location.test.js +0 -12
- package/src/services/log/interface.ts +0 -39
- package/src/services/log/log.html +0 -19
- package/src/services/log/log.js +0 -74
- package/src/services/log/log.spec.js +0 -64
- package/src/services/log/log.test.js +0 -12
- package/src/services/pubsub/pubsub.html +0 -19
- package/src/services/pubsub/pubsub.js +0 -349
- package/src/services/pubsub/pubsub.spec.js +0 -400
- package/src/services/pubsub/pubsub.test.js +0 -12
- package/src/services/sce/sce.html +0 -19
- package/src/services/sce/sce.js +0 -852
- package/src/services/sce/sce.spec.js +0 -617
- package/src/services/sce/sce.test.js +0 -12
- package/src/services/template-cache/template-cache.html +0 -22
- package/src/services/template-cache/template-cache.js +0 -15
- package/src/services/template-cache/template-cache.spec.js +0 -134
- package/src/services/template-cache/template-cache.test.js +0 -12
- package/src/services/template-request/interface.ts +0 -23
- package/src/services/template-request/template-request.js +0 -142
- package/src/shared/cache.js +0 -7
- package/src/shared/common.js +0 -365
- package/src/shared/common.spec.js +0 -294
- package/src/shared/constants.js +0 -21
- package/src/shared/dom.js +0 -716
- package/src/shared/hof.js +0 -157
- package/src/shared/hof.spec.js +0 -60
- package/src/shared/interface.ts +0 -21
- package/src/shared/min-err.spec.js +0 -178
- package/src/shared/noderef.js +0 -225
- package/src/shared/predicates.js +0 -34
- package/src/shared/queue.js +0 -105
- package/src/shared/queue.spec.js +0 -80
- package/src/shared/shared.html +0 -24
- package/src/shared/shared.test.js +0 -12
- package/src/shared/strings.js +0 -142
- package/src/shared/strings.spec.js +0 -40
- package/src/shared/test-utils.js +0 -47
- package/src/shared/url-utils/interface.ts +0 -54
- package/src/shared/url-utils/url-utils.html +0 -22
- package/src/shared/url-utils/url-utils.js +0 -122
- package/src/shared/url-utils/url-utils.spec.js +0 -148
- package/src/shared/url-utils/url-utils.test.js +0 -12
- package/src/shared/utils.js +0 -1255
- package/src/shared/utils.spec.js +0 -178
- package/src/src.html +0 -21
- package/src/src.test.js +0 -10
- package/tsconfig.json +0 -19
- package/tsconfig.types.json +0 -14
- package/typedoc.json +0 -8
- package/utils/express.js +0 -203
- package/utils/version.cjs +0 -23
- package/vite.config.js +0 -14
package/DEVELOPERS.md
DELETED
|
@@ -1,499 +0,0 @@
|
|
|
1
|
-
# Developing AngularTS
|
|
2
|
-
|
|
3
|
-
- [Development Setup](#setup)
|
|
4
|
-
- [Running Tests](#tests)
|
|
5
|
-
- [Coding Rules](#rules)
|
|
6
|
-
- [Commit Message Guidelines](#commits)
|
|
7
|
-
- [Writing Documentation](#documentation)
|
|
8
|
-
|
|
9
|
-
## <a name="setup"> Development Setup
|
|
10
|
-
|
|
11
|
-
This document describes how to set up your development environment to build and test AngularTS, and
|
|
12
|
-
explains the basic mechanics of using `git`, `node`, `yarn` and `grunt`.
|
|
13
|
-
|
|
14
|
-
### Installing Dependencies
|
|
15
|
-
|
|
16
|
-
Before you can build AngularTS, you must install and configure the following dependencies on your
|
|
17
|
-
machine:
|
|
18
|
-
|
|
19
|
-
- [Git](http://git-scm.com/): The [Github Guide to
|
|
20
|
-
Installing Git][git-setup] is a good source of information.
|
|
21
|
-
|
|
22
|
-
- [Node.js v8.x (LTS)](http://nodejs.org): We use Node to generate the documentation, run a
|
|
23
|
-
development web server, run tests, and generate distributable files. Depending on your system,
|
|
24
|
-
you can install Node either from source or as a pre-packaged bundle.
|
|
25
|
-
|
|
26
|
-
We recommend using [nvm](https://github.com/creationix/nvm) (or
|
|
27
|
-
[nvm-windows](https://github.com/coreybutler/nvm-windows))
|
|
28
|
-
to manage and install Node.js, which makes it easy to change the version of Node.js per project.
|
|
29
|
-
|
|
30
|
-
- [Yarn](https://yarnpkg.com): We use Yarn to install our Node.js module dependencies
|
|
31
|
-
(rather than using npm). See the detailed [installation instructions][yarn-install].
|
|
32
|
-
|
|
33
|
-
- [Java](http://www.java.com): We minify JavaScript using
|
|
34
|
-
[Closure Tools](https://developers.google.com/closure/), which require Java (version 7 or higher)
|
|
35
|
-
to be installed and included in your
|
|
36
|
-
[PATH](http://docs.oracle.com/javase/tutorial/essential/environment/paths.html) variable.
|
|
37
|
-
|
|
38
|
-
- [Grunt](http://gruntjs.com): We use Grunt as our build system. We're using it as a local dependency,
|
|
39
|
-
but you can also add the grunt command-line tool globally (with `yarn global add grunt-cli`), which allows
|
|
40
|
-
you to leave out the `yarn` prefix for all our grunt commands.
|
|
41
|
-
|
|
42
|
-
### Forking AngularTS on Github
|
|
43
|
-
|
|
44
|
-
To contribute code to AngularTS, you must have a GitHub account so you can push code to your own
|
|
45
|
-
fork of AngularTS and open Pull Requests in the [GitHub Repository][github].
|
|
46
|
-
|
|
47
|
-
To create a Github account, follow the instructions [here](https://github.com/signup/free).
|
|
48
|
-
Afterwards, go ahead and [fork](http://help.github.com/forking) the
|
|
49
|
-
[main AngularTS repository][github].
|
|
50
|
-
|
|
51
|
-
### Building AngularTS
|
|
52
|
-
|
|
53
|
-
To build AngularTS, you clone the source code repository and use Grunt to generate the non-minified
|
|
54
|
-
and minified AngularTS files:
|
|
55
|
-
|
|
56
|
-
```shell
|
|
57
|
-
# Clone your Github repository:
|
|
58
|
-
git clone https://github.com/<github username>/angular.js.git
|
|
59
|
-
|
|
60
|
-
# Go to the AngularTS directory:
|
|
61
|
-
cd angular.js
|
|
62
|
-
|
|
63
|
-
# Add the main AngularTS repository as an upstream remote to your repository:
|
|
64
|
-
git remote add upstream "https://github.com/angular/angular.js.git"
|
|
65
|
-
|
|
66
|
-
# Install JavaScript dependencies:
|
|
67
|
-
yarn install
|
|
68
|
-
|
|
69
|
-
# Build AngularTS:
|
|
70
|
-
yarn grunt package
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
**Note:** If you're using Windows, you must use an elevated command prompt (right click, run as
|
|
74
|
-
Administrator). This is because `yarn grunt package` creates some symbolic links.
|
|
75
|
-
|
|
76
|
-
The build output is in the `build` directory. It consists of the following files and
|
|
77
|
-
directories:
|
|
78
|
-
|
|
79
|
-
- `angular-<version>.zip` — The complete zip file, containing all of the release build
|
|
80
|
-
artifacts.
|
|
81
|
-
|
|
82
|
-
- `angular.js` / `angular.min.js` — The regular and minified core AngularTS script file.
|
|
83
|
-
|
|
84
|
-
- `angular-*.js` / `angular-*.min.js` — All other AngularTS module script files.
|
|
85
|
-
|
|
86
|
-
- `docs/` — A directory that contains a standalone version of the docs
|
|
87
|
-
(same as served in `docs.angularjs.org`).
|
|
88
|
-
|
|
89
|
-
### <a name="local-server"></a> Running a Local Development Web Server
|
|
90
|
-
|
|
91
|
-
To debug code, run end-to-end tests, and serve the docs, it is often useful to have a local
|
|
92
|
-
HTTP server. For this purpose, we have made available a local web server based on Node.js.
|
|
93
|
-
|
|
94
|
-
1. To start the web server, run:
|
|
95
|
-
|
|
96
|
-
```shell
|
|
97
|
-
yarn grunt webserver
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
2. To access the local server, enter the following URL into your web browser:
|
|
101
|
-
|
|
102
|
-
```text
|
|
103
|
-
http://localhost:8000/
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
By default, it serves the contents of the AngularTS project directory.
|
|
107
|
-
|
|
108
|
-
3. To access the locally served docs, visit this URL:
|
|
109
|
-
```text
|
|
110
|
-
http://localhost:8000/build/docs/
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
## <a name="tests"> Running Tests
|
|
114
|
-
|
|
115
|
-
### <a name="unit-tests"></a> Running the Unit Test Suite
|
|
116
|
-
|
|
117
|
-
We write unit and integration tests with Jasmine and execute them with Karma. To run all of the
|
|
118
|
-
tests once on Chrome run:
|
|
119
|
-
|
|
120
|
-
```shell
|
|
121
|
-
yarn grunt test:unit
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
To run the tests on other browsers use the command line flag:
|
|
125
|
-
|
|
126
|
-
```shell
|
|
127
|
-
yarn grunt test:unit --browsers=Chrome,Firefox
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
**Note:** there should be _no spaces between browsers_. `Chrome, Firefox` is INVALID.
|
|
131
|
-
|
|
132
|
-
If you have a Saucelabs or Browserstack account, you can also run the unit tests on these services
|
|
133
|
-
via our pre-defined customLaunchers. See the [karma config file](/karma-shared.conf.js) for all pre-configured browsers.
|
|
134
|
-
|
|
135
|
-
For example, to run the whole unit test suite on selected browsers:
|
|
136
|
-
|
|
137
|
-
```shell
|
|
138
|
-
# Browserstack
|
|
139
|
-
yarn grunt test:unit --browsers=BS_Chrome,BS_Firefox,BS_Safari,BS_IE_9,BS_IE_10,BS_IE_11,BS_EDGE,BS_iOS_10
|
|
140
|
-
# Saucelabs
|
|
141
|
-
yarn grunt test:unit --browsers=SL_Chrome,SL_Firefox,SL_Safari,SL_IE_9,SL_IE_10,SL_IE_11,SL_EDGE,SL_iOS_10
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
Running these commands requires you to set up [Karma Browserstack][karma-browserstack] or
|
|
145
|
-
[Karma-Saucelabs][karma-saucelabs], respectively.
|
|
146
|
-
|
|
147
|
-
During development, however, it's more productive to continuously run unit tests every time the
|
|
148
|
-
source or test files change. To execute tests in this mode run:
|
|
149
|
-
|
|
150
|
-
1. To start the Karma server, capture Chrome browser and run unit tests, run:
|
|
151
|
-
|
|
152
|
-
```shell
|
|
153
|
-
yarn grunt autotest
|
|
154
|
-
```
|
|
155
|
-
|
|
156
|
-
2. To capture more browsers, open this URL in the desired browser (URL might be different if you
|
|
157
|
-
have multiple instance of Karma running, read Karma's console output for the correct URL):
|
|
158
|
-
|
|
159
|
-
```text
|
|
160
|
-
http://localhost:9876/
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
3. To re-run tests just change any source or test file.
|
|
164
|
-
|
|
165
|
-
To learn more about all of the preconfigured Grunt tasks run:
|
|
166
|
-
|
|
167
|
-
```shell
|
|
168
|
-
yarn grunt --help
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
### <a name="e2e-tests"></a> Running the End-to-end Test Suite
|
|
172
|
-
|
|
173
|
-
AngularTS's end to end tests are run with Protractor. Simply run:
|
|
174
|
-
|
|
175
|
-
```shell
|
|
176
|
-
yarn grunt test:e2e
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
This will start the webserver and run the tests on Chrome.
|
|
180
|
-
|
|
181
|
-
## <a name="rules"></a> Coding Rules
|
|
182
|
-
|
|
183
|
-
To ensure consistency throughout the source code, keep these rules in mind as you are working:
|
|
184
|
-
|
|
185
|
-
- All features or bug fixes **must be tested** by one or more [specs][unit-testing].
|
|
186
|
-
- All public API methods **must be documented** with ngdoc, an extended version of jsdoc (we added
|
|
187
|
-
support for markdown and templating via @ngdoc tag). To see how we document our APIs, please check
|
|
188
|
-
out the existing source code and see the section about [writing documentation](#documentation)
|
|
189
|
-
- With the exceptions listed below, we follow the rules contained in
|
|
190
|
-
[Google's JavaScript Style Guide][js-style-guide]:
|
|
191
|
-
- **Do not use namespaces**: Instead, wrap the entire AngularTS code base in an anonymous
|
|
192
|
-
closure and export our API explicitly rather than implicitly.
|
|
193
|
-
- Wrap all code at **100 characters**.
|
|
194
|
-
- Instead of complex inheritance hierarchies, we **prefer simple objects**. We use prototypal
|
|
195
|
-
inheritance only when absolutely necessary.
|
|
196
|
-
- We **love functions and closures** and, whenever possible, prefer them over objects.
|
|
197
|
-
- To write concise code that can be better minified, we **use aliases internally** that map to
|
|
198
|
-
the external API. See our existing code to see what we mean.
|
|
199
|
-
- We **don't go crazy with type annotations** for private internal APIs unless it's an internal
|
|
200
|
-
API that is used throughout AngularTS. The best guidance is to do what makes the most sense.
|
|
201
|
-
|
|
202
|
-
### Specific topics
|
|
203
|
-
|
|
204
|
-
#### Provider configuration
|
|
205
|
-
|
|
206
|
-
When adding configuration (options) to [providers][docs.provider], we follow a special pattern.
|
|
207
|
-
|
|
208
|
-
- for each option, add a `method` that ...
|
|
209
|
-
- works as a getter and returns the current value when called without argument
|
|
210
|
-
- works as a setter and returns itself for chaining when called with argument
|
|
211
|
-
- for boolean options, uses the naming scheme `<option>Enabled([enabled])`
|
|
212
|
-
- non-primitive options (e.g. objects) should be copied or the properties assigned explicitly to a
|
|
213
|
-
new object so that the configuration cannot be changed during runtime.
|
|
214
|
-
|
|
215
|
-
For a boolean config example, see [`$compileProvider#debugInfoEnabled`][code.debugInfoEnabled]
|
|
216
|
-
|
|
217
|
-
For an object config example, see [`$location.html5Mode`][code.html5Mode]
|
|
218
|
-
|
|
219
|
-
#### Throwing errors
|
|
220
|
-
|
|
221
|
-
User-facing errors should be thrown with [`minErr`][code.minErr], a special error function that provides
|
|
222
|
-
errors ids, templated error messages, and adds a link to a detailed error description.
|
|
223
|
-
|
|
224
|
-
The `$compile:badrestrict` error is a good example for a well-defined `minErr`:
|
|
225
|
-
[code][code.badrestrict] and [description][docs.badrestrict].
|
|
226
|
-
|
|
227
|
-
## <a name="commits"></a> Git Commit Guidelines
|
|
228
|
-
|
|
229
|
-
We have very precise rules over how our git commit messages can be formatted. This leads to **more
|
|
230
|
-
readable messages** that are easy to follow when looking through the **project history**. But also,
|
|
231
|
-
we use the git commit messages to **generate the AngularTS change log**.
|
|
232
|
-
|
|
233
|
-
The commit message formatting can be added using a typical git workflow or through the use of a CLI
|
|
234
|
-
wizard ([Commitizen](https://github.com/commitizen/cz-cli)). To use the wizard, run `yarn run commit`
|
|
235
|
-
in your terminal after staging your changes in git.
|
|
236
|
-
|
|
237
|
-
### Commit Message Format
|
|
238
|
-
|
|
239
|
-
Each commit message consists of a **header**, a **body** and a **footer**. The header has a special
|
|
240
|
-
format that includes a **type**, a **scope** and a **subject**:
|
|
241
|
-
|
|
242
|
-
```
|
|
243
|
-
<type>(<scope>): <subject>
|
|
244
|
-
<BLANK LINE>
|
|
245
|
-
<body>
|
|
246
|
-
<BLANK LINE>
|
|
247
|
-
<footer>
|
|
248
|
-
```
|
|
249
|
-
|
|
250
|
-
The **header** is mandatory and the **scope** of the header is optional.
|
|
251
|
-
|
|
252
|
-
Any line of the commit message cannot be longer than 100 characters! This allows the message to be easier
|
|
253
|
-
to read on GitHub as well as in various git tools.
|
|
254
|
-
|
|
255
|
-
### Revert
|
|
256
|
-
|
|
257
|
-
If the commit reverts a previous commit, it should begin with `revert: `, followed by the header
|
|
258
|
-
of the reverted commit.
|
|
259
|
-
In the body it should say: `This reverts commit <hash>.`, where the hash is the SHA of the commit
|
|
260
|
-
being reverted.
|
|
261
|
-
|
|
262
|
-
### Type
|
|
263
|
-
|
|
264
|
-
Must be one of the following:
|
|
265
|
-
|
|
266
|
-
- **feat**: A new feature
|
|
267
|
-
- **fix**: A bug fix
|
|
268
|
-
- **docs**: Documentation only changes
|
|
269
|
-
- **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing
|
|
270
|
-
semi-colons, etc)
|
|
271
|
-
- **refactor**: A code change that neither fixes a bug nor adds a feature
|
|
272
|
-
- **perf**: A code change that improves performance
|
|
273
|
-
- **test**: Adding missing or correcting existing tests
|
|
274
|
-
- **chore**: Changes to the build process or auxiliary tools and libraries such as documentation
|
|
275
|
-
generation
|
|
276
|
-
|
|
277
|
-
### Scope
|
|
278
|
-
|
|
279
|
-
The scope could be anything specifying place of the commit change. For example `$location`,
|
|
280
|
-
`$browser`, `$compile`, `$rootScope`, `ngHref`, `ngClick`, `ngView`, etc...
|
|
281
|
-
|
|
282
|
-
You can use `*` when the change affects more than a single scope.
|
|
283
|
-
|
|
284
|
-
### Subject
|
|
285
|
-
|
|
286
|
-
The subject contains succinct description of the change:
|
|
287
|
-
|
|
288
|
-
- use the imperative, present tense: "change" not "changed" nor "changes"
|
|
289
|
-
- don't capitalize first letter
|
|
290
|
-
- no dot (.) at the end
|
|
291
|
-
|
|
292
|
-
### Body
|
|
293
|
-
|
|
294
|
-
Just as in the **subject**, use the imperative, present tense: "change" not "changed" nor "changes".
|
|
295
|
-
The body should include the motivation for the change and contrast this with previous behavior.
|
|
296
|
-
|
|
297
|
-
### Footer
|
|
298
|
-
|
|
299
|
-
The footer should contain any information about **Breaking Changes** and is also the place to
|
|
300
|
-
[reference GitHub issues that this commit closes][closing-issues].
|
|
301
|
-
|
|
302
|
-
**Breaking Changes** should start with the word `BREAKING CHANGE:` with a space or two newlines.
|
|
303
|
-
The rest of the commit message is then used for this.
|
|
304
|
-
|
|
305
|
-
A detailed explanation can be found in this [document][commit-message-format].
|
|
306
|
-
|
|
307
|
-
## <a name="documentation"></a> Writing Documentation
|
|
308
|
-
|
|
309
|
-
The AngularTS project uses a form of [jsdoc](http://usejsdoc.org/) called ngdoc for all of its code
|
|
310
|
-
documentation.
|
|
311
|
-
|
|
312
|
-
This means that all the docs are stored inline in the source code and so are kept in sync as it
|
|
313
|
-
changes.
|
|
314
|
-
|
|
315
|
-
There is also extra content (the developer guide, error pages, the tutorial,
|
|
316
|
-
and misceallenous pages) that live inside the AngularTS repository as markdown files.
|
|
317
|
-
|
|
318
|
-
This means that since we generate the documentation from the source code, we can easily provide
|
|
319
|
-
version-specific documentation by simply checking out a version of AngularTS and running the build.
|
|
320
|
-
|
|
321
|
-
Extracting the source code documentation, processing and building the docs is handled by the
|
|
322
|
-
documentation generation tool [Dgeni][dgeni].
|
|
323
|
-
|
|
324
|
-
### Building and viewing the docs locally
|
|
325
|
-
|
|
326
|
-
The docs can be built from scratch using grunt:
|
|
327
|
-
|
|
328
|
-
```shell
|
|
329
|
-
yarn grunt docs
|
|
330
|
-
```
|
|
331
|
-
|
|
332
|
-
This defers the doc-building task to `gulp`.
|
|
333
|
-
|
|
334
|
-
Note that the docs app is using the local build files to run. This means you might first have to run
|
|
335
|
-
the build:
|
|
336
|
-
|
|
337
|
-
```shell
|
|
338
|
-
yarn grunt build
|
|
339
|
-
```
|
|
340
|
-
|
|
341
|
-
(This is also necessary if you are making changes to minErrors).
|
|
342
|
-
|
|
343
|
-
To view the docs, see [Running a Local Development Web Server](#local-server).
|
|
344
|
-
|
|
345
|
-
### Writing jsdoc
|
|
346
|
-
|
|
347
|
-
The ngdoc utility has basic support for many of the standard jsdoc directives. But in particular it
|
|
348
|
-
is interested in the following block tags:
|
|
349
|
-
|
|
350
|
-
- `@name name` - the name of the ngdoc document
|
|
351
|
-
- `@param {type} name description` - describes a parameter of a function
|
|
352
|
-
- `@returns {type} description` - describes what a function returns
|
|
353
|
-
- `@requires` - normally indicates that a JavaScript module is required; in an Angular service it is
|
|
354
|
-
used to describe what other services this service relies on
|
|
355
|
-
- `@property` - describes a property of an object
|
|
356
|
-
- `@description` - used to provide a description of a component in markdown
|
|
357
|
-
- `@link` - specifies a link to a URL or a type in the API reference.
|
|
358
|
-
Links to the API have the following structure:
|
|
359
|
-
- the module namespace, followed by `.` (optional, default `ng`)
|
|
360
|
-
- the `@ngdoc` type (see below), followed by `:` (optional, automatically inferred)
|
|
361
|
-
- the name
|
|
362
|
-
- the method, property, or anchor (optional)
|
|
363
|
-
- the display name
|
|
364
|
-
|
|
365
|
-
For example: `{@link ng.type:$rootScope.Scope#$new Scope.$new()}`.
|
|
366
|
-
|
|
367
|
-
- `@example` - specifies an example. This can be a simple code block, or a
|
|
368
|
-
[runnable example](#the-example-tag).
|
|
369
|
-
- `@deprecated` - specifies that the following code is deprecated and should not be used.
|
|
370
|
-
In The AngularTS docs, there are two specific patterns which can be used to further describe
|
|
371
|
-
the deprecation: `sinceVersion="<version>"` and `removeVersion="<version>"`
|
|
372
|
-
|
|
373
|
-
The `type` in `@param` and `@returns` must be wrapped in `{}` curly braces, e.g. `{Object|Array}`.
|
|
374
|
-
Parameters can be made optional by _either_ appending a `=` to the type, e.g. `{Object=}`, _or_ by
|
|
375
|
-
putting the `[name]` in square brackets.
|
|
376
|
-
Default values are only possible with the second syntax by appending `=<value>` to the parameter
|
|
377
|
-
name, e.g. `@param {boolean} [ownPropsOnly=false]`.
|
|
378
|
-
|
|
379
|
-
Descriptions can contain markdown formatting.
|
|
380
|
-
|
|
381
|
-
#### AngularTS-specific jsdoc directives
|
|
382
|
-
|
|
383
|
-
In addition to the standard jsdoc tags, there are a number that are specific to the Angular
|
|
384
|
-
code-base:
|
|
385
|
-
|
|
386
|
-
- `@ngdoc` - specifies the type of thing being documented. See below for more detail.
|
|
387
|
-
- `@eventType emit|broadcast` - specifies whether the event is emitted or broadcast
|
|
388
|
-
- `@usage` - shows how to use a `function` or `directive`. Is usually automatically generated.
|
|
389
|
-
- `@knownIssue` - adds info about known quirks, problems, or limitations with the API, and possibly,
|
|
390
|
-
workarounds. This section is not for bugs.
|
|
391
|
-
|
|
392
|
-
The following are specific to directives:
|
|
393
|
-
|
|
394
|
-
- `@animations` - specifies the animations a directive supports
|
|
395
|
-
- `@multiElement` - specifies if a directive can span over multiple elements
|
|
396
|
-
- `@priority` - specifies a directive's priority
|
|
397
|
-
- `@restrict` - is extracted to show the usage of a directive. For example, for [E]lement,
|
|
398
|
-
[A]ttribute, and [C]lass, use `@restrict ECA`
|
|
399
|
-
- `@scope` - specifies that a directive will create a new scope
|
|
400
|
-
|
|
401
|
-
### The `@ngdoc` Directive
|
|
402
|
-
|
|
403
|
-
This directive helps to specify the template used to render the item being documented. For instance,
|
|
404
|
-
a directive would have different properties to a filter and so would be documented differently. The
|
|
405
|
-
commonly used types are:
|
|
406
|
-
|
|
407
|
-
- `overview` - a general page (guide, api index)
|
|
408
|
-
- `provider` - AngularTS provider, such as `$compileProvider` or `$httpProvider`.
|
|
409
|
-
- `service` - injectable AngularTS service, such as `$compile` or `$http`.
|
|
410
|
-
- `object` - well defined object (often exposed as a service)
|
|
411
|
-
- `function` - function that will be available to other methods (such as a helper function within
|
|
412
|
-
the ng module)
|
|
413
|
-
- `method` - method on an object/service/controller
|
|
414
|
-
- `property` - property on an object/service/controller
|
|
415
|
-
- `event` - AngularTS event that will propagate through the `$scope` tree.
|
|
416
|
-
- `directive` - AngularTS directive
|
|
417
|
-
- `filter` - AngularTS filter
|
|
418
|
-
- `error` - minErr error description
|
|
419
|
-
|
|
420
|
-
### General documentation with Markdown
|
|
421
|
-
|
|
422
|
-
Any text in tags can contain markdown syntax for formatting. Generally, you can use any markdown
|
|
423
|
-
feature.
|
|
424
|
-
|
|
425
|
-
#### Headings
|
|
426
|
-
|
|
427
|
-
Only use _h2_ headings and lower, as the page title is set in _h1_. Also make sure you follow the
|
|
428
|
-
heading hierarchy. This ensures correct table of contents are created.
|
|
429
|
-
|
|
430
|
-
#### Code blocks
|
|
431
|
-
|
|
432
|
-
In line code can be specified by enclosing the code in back-ticks (\`).
|
|
433
|
-
A block of multi-line code can be enclosed in triple back-ticks (\`\`\`) but it is formatted better
|
|
434
|
-
if it is enclosed in <pre>...</pre> tags and the code lines themselves are indented.
|
|
435
|
-
|
|
436
|
-
### Writing runnable (live) examples and e2e tests
|
|
437
|
-
|
|
438
|
-
It is possible to embed examples in the documentation along with appropriate e2e tests. These
|
|
439
|
-
examples and scenarios will be converted to runnable code within the documentation. So it is
|
|
440
|
-
important that they work correctly. To ensure this, all these e2e scenarios are run as part of the
|
|
441
|
-
continuous integration tests.
|
|
442
|
-
|
|
443
|
-
If you are adding an example with an e2e test, you should [run the test locally](#e2e-tests) first
|
|
444
|
-
to ensure it passes. You can change `it(...)` to `it(...)` to run only your test,
|
|
445
|
-
but make sure you change it back to `it(...)` before committing.
|
|
446
|
-
|
|
447
|
-
#### The `<example>` tag
|
|
448
|
-
|
|
449
|
-
This tag identifies a block of HTML that will define a runnable example. It can take the following
|
|
450
|
-
attributes:
|
|
451
|
-
|
|
452
|
-
- `animations` - if set to `true` then this example uses ngAnimate.
|
|
453
|
-
- `deps` - Semicolon-separated list of additional angular module files to be loaded,
|
|
454
|
-
e.g. `angular-animate.js`
|
|
455
|
-
- `name` - every example should have a name. It should start with the component, e.g directive name,
|
|
456
|
-
and not contain whitespace
|
|
457
|
-
- `module` - the name of the app module as defined in the example's JavaScript
|
|
458
|
-
|
|
459
|
-
Within this tag we provide `<file>` tags that specify what files contain the example code.
|
|
460
|
-
|
|
461
|
-
```
|
|
462
|
-
<example
|
|
463
|
-
module="angularAppModule"
|
|
464
|
-
name="exampleName"
|
|
465
|
-
deps="angular-animate.js;angular-route.js"
|
|
466
|
-
animations="true">
|
|
467
|
-
...
|
|
468
|
-
<file name="index.html">...</file>
|
|
469
|
-
<file name="script.js">...</file>
|
|
470
|
-
<file name="animations.css">...</file>
|
|
471
|
-
<file name="protractor.js">...</file>
|
|
472
|
-
...
|
|
473
|
-
</example>
|
|
474
|
-
```
|
|
475
|
-
|
|
476
|
-
You can see an example of a well-defined example [in the `ngRepeat` documentation][code.ngRepeat-example].
|
|
477
|
-
|
|
478
|
-
[closing-issues]: https://help.github.com/articles/closing-issues-via-commit-messages/
|
|
479
|
-
[Closure guide to i18n changes]: https://github.com/google/closure-library/wiki/Internationalization-%28i18n%29-changes-in-Closure-Library
|
|
480
|
-
[code.badrestrict]: https://github.com/angular/angular.js/blob/202f1809ad14827a6ac6a125157c605d65e0b551/src/ng/compile.js#L1107-L1110
|
|
481
|
-
[code.debugInfoEnabled]: https://github.com/angular/angular.js/blob/32fbb2e78f53d765fbb170f7cf99e42e072d363b/src/ng/compile.js#L1378-L1413
|
|
482
|
-
[code.html5Mode]: https://github.com/angular/angular.js/blob/202f1809ad14827a6ac6a125157c605d65e0b551/src/ng/location.js#L752-L797
|
|
483
|
-
[code.minErr]: https://github.com/angular/angular.js/blob/202f1809ad14827a6ac6a125157c605d65e0b551/src/minErr.js#L53-L113
|
|
484
|
-
[code.ngRepeat-example]: https://github.com/angular/angular.js/blob/0822d34b10ea0371c260c80a1486a4d508ea5a91/src/ng/directive/ngRepeat.js#L249-L340
|
|
485
|
-
[commit-message-format]: https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#
|
|
486
|
-
[Common Locale Data Repository (CLDR)]: http://cldr.unicode.org
|
|
487
|
-
[corporate-cla]: http://code.google.com/legal/corporate-cla-v1.0.html
|
|
488
|
-
[dgeni]: https://github.com/angular/dgeni
|
|
489
|
-
[docs.badrestrict]: docs/content/error/$compile/badrestrict.ngdoc
|
|
490
|
-
[docs.provider]: https://code.angularjs.org/snapshot/docs/api/auto/service/$provide#provider
|
|
491
|
-
[git-revert]: https://git-scm.com/docs/git-revert
|
|
492
|
-
[git-setup]: https://help.github.com/articles/set-up-git
|
|
493
|
-
[github-issues]: https://github.com/angular/angular.js/issues
|
|
494
|
-
[github]: https://github.com/angular/angular.js
|
|
495
|
-
[js-style-guide]: https://google.github.io/styleguide/javascriptguide.xml
|
|
496
|
-
[karma-browserstack]: https://github.com/karma-runner/karma-browserstack-launcher
|
|
497
|
-
[karma-saucelabs]: https://github.com/karma-runner/karma-sauce-launcher
|
|
498
|
-
[unit-testing]: https://docs.angularjs.org/guide/unit-testing
|
|
499
|
-
[yarn-install]: https://yarnpkg.com/en/docs/install
|
package/Makefile
DELETED
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
.PHONY: build test types
|
|
2
|
-
|
|
3
|
-
setup:
|
|
4
|
-
@rm -r ./node_modules/
|
|
5
|
-
@npm i
|
|
6
|
-
@npx playwright install
|
|
7
|
-
|
|
8
|
-
BUILD_DIR = ./dist
|
|
9
|
-
build: version
|
|
10
|
-
@if [ -d "$(BUILD_DIR)" ]; then \
|
|
11
|
-
echo "Removing $(BUILD_DIR)..."; \
|
|
12
|
-
rm -r "$(BUILD_DIR)"; \
|
|
13
|
-
fi
|
|
14
|
-
@npm i
|
|
15
|
-
./node_modules/.bin/rollup -c
|
|
16
|
-
|
|
17
|
-
version:
|
|
18
|
-
@node utils/version.cjs
|
|
19
|
-
|
|
20
|
-
pretty:
|
|
21
|
-
@npx prettier ./ --write --cache --log-level=silent
|
|
22
|
-
|
|
23
|
-
lint:
|
|
24
|
-
@npx eslint ./src --fix
|
|
25
|
-
|
|
26
|
-
check:
|
|
27
|
-
@echo "Typechecking Js"
|
|
28
|
-
./node_modules/.bin/tsc
|
|
29
|
-
|
|
30
|
-
types:
|
|
31
|
-
@rm -rf @types
|
|
32
|
-
@echo "Generating *.d.ts"
|
|
33
|
-
@npx -p typescript tsc --project tsconfig.types.json
|
|
34
|
-
$(MAKE) pretty
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
TYPEDOC_DIR = docs/static/typedoc
|
|
38
|
-
doc:
|
|
39
|
-
@rm -rf $(TYPEDOC_DIR)
|
|
40
|
-
@npm run generate-docs
|
|
41
|
-
@npx prettier ./typedoc --write
|
|
42
|
-
mv typedoc $(TYPEDOC_DIR)
|
|
43
|
-
|
|
44
|
-
serve:
|
|
45
|
-
@npm run serve
|
|
46
|
-
|
|
47
|
-
prepare-release: test check types doc pretty build
|
|
48
|
-
|
|
49
|
-
PLAYWRIGHT_TEST := npx playwright test
|
|
50
|
-
|
|
51
|
-
test:
|
|
52
|
-
@echo $(INFO) "Playwright test JS"
|
|
53
|
-
@$(PLAYWRIGHT_TEST)
|
|
54
|
-
|
|
55
|
-
test-ui:
|
|
56
|
-
@echo $(INFO) "Playwright test JS with ui"
|
|
57
|
-
@$(PLAYWRIGHT_TEST) --ui
|
|
58
|
-
|
|
59
|
-
hugo:
|
|
60
|
-
hugo server --source=docs --disableFastRender
|
package/RELEASE.md
DELETED
|
@@ -1,86 +0,0 @@
|
|
|
1
|
-
# AngularTS Release instructions
|
|
2
|
-
|
|
3
|
-
## Compare the list of commits between stable and unstable
|
|
4
|
-
|
|
5
|
-
There is a script - compare-master-to-stable.js - that helps with this.
|
|
6
|
-
We just want to make sure that good commits (low risk fixes + docs fixes) got cherry-picked into stable branch and nothing interesting got merged only into stable branch.
|
|
7
|
-
|
|
8
|
-
## Pick a release name (for this version)
|
|
9
|
-
|
|
10
|
-
A super-heroic power (adverb-verb phrase).
|
|
11
|
-
|
|
12
|
-
## Generate release notes
|
|
13
|
-
|
|
14
|
-
Example Commit: https://github.com/angular/angular.js/commit/7ab5098c14ee4f195dbfe2681e402fe2dfeacd78
|
|
15
|
-
|
|
16
|
-
1. Run
|
|
17
|
-
|
|
18
|
-
```bash
|
|
19
|
-
node_modules/.bin/changez -o changes.md -v <new version> <base branch>
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
2. Review the generated file and manually fix typos, group and reorder stuff if needed.
|
|
23
|
-
3. Move the content into CHANGELOG.md add release code-names to headers.
|
|
24
|
-
4. Push the changes to your private github repo and review.
|
|
25
|
-
5. cherry-pick the release notes commit to the appropriate branches.
|
|
26
|
-
|
|
27
|
-
## Pick a commit to release (for this version)
|
|
28
|
-
|
|
29
|
-
Usually this will be the commit containing the release notes, but it may also be in the past.
|
|
30
|
-
|
|
31
|
-
## Run "release" script
|
|
32
|
-
|
|
33
|
-
```bash
|
|
34
|
-
scripts/release/release.sh --git-push-dryrun=false --commit-sha=8822a4f --version-number=1.7.6 --version-name=gravity-manipulation
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
1. The SHA is of the commit to release (could be in the past).
|
|
38
|
-
|
|
39
|
-
2. The version number and code-name that should be released, not the next version number (e.g. to release 1.2.12 you enter 1.2.12 as release version and the code-name that was picked for 1.2.12, cauliflower-eradication).
|
|
40
|
-
|
|
41
|
-
3. You will need to have write access to all the AngularTS github dist repositories and publish rights for the AngularTS packages on npm.
|
|
42
|
-
|
|
43
|
-
## Update GitHub milestones
|
|
44
|
-
|
|
45
|
-
1. Create the next milestone if it doesn't exist yet-giving ita due date.
|
|
46
|
-
2. Move all open issues and PRs for the current milestone to the next milestone<br>
|
|
47
|
-
You can do this by filtering the current milestone, selecting via checklist, and moving to the next milestone within the GH issues page.
|
|
48
|
-
|
|
49
|
-
3. Close the current milestone click the milestones tab and close from there.
|
|
50
|
-
4. Create a new holding milestone for the release after next-but don't give it a due date otherwise that will mess up the dashboard.
|
|
51
|
-
|
|
52
|
-
## Push build artifacts to CDN
|
|
53
|
-
|
|
54
|
-
Google CDNs are fed with data from google3 every day at 11:15am PT it takes only few minutes for the import to propagate).
|
|
55
|
-
If we want to make our files available, we need submit our CLs before this time on the day of the release.
|
|
56
|
-
|
|
57
|
-
## Don't update the package.json (branchVersion) until the CDN has updated
|
|
58
|
-
|
|
59
|
-
This is the version used to compute what version to link to in the CDN. If you update this too early then the CDN lookup fails and you end up with 'null, for the version, which breaks the docs.
|
|
60
|
-
|
|
61
|
-
## Verify angularjs.org download modal has latest version (updates via CI job)
|
|
62
|
-
|
|
63
|
-
The versions in the modal are updated (based on the versions available on CDN) as part of the CI deploy stage.
|
|
64
|
-
(You may need to explicitly trigger the CI job. e.g. re-running the last `deploy` job.)
|
|
65
|
-
|
|
66
|
-
## Announce the release (via official Google accounts)
|
|
67
|
-
|
|
68
|
-
Double check that angularjs.org is up to date with the new release version before sharing.
|
|
69
|
-
|
|
70
|
-
1. Collect a list of contributors
|
|
71
|
-
|
|
72
|
-
use: `git log --format='%aN' v1.2.12..v1.2.13 | sort -u`
|
|
73
|
-
|
|
74
|
-
2. Write a blog post (for minor releases, not patch releases) and publish it with the "release" tag
|
|
75
|
-
3. Post on twitter as yourself (tweet from your heart; there is no template for this), retweet as @AngularTS
|
|
76
|
-
|
|
77
|
-
## Party!
|
|
78
|
-
|
|
79
|
-
## Major Release Tasks
|
|
80
|
-
|
|
81
|
-
1. Update angularjs.org to use the latest branch.
|
|
82
|
-
2. Write up a migration document.
|
|
83
|
-
3. Create a new git branch for the version that has been released (e.g. 1.8.x).
|
|
84
|
-
4. Check that the build and release scripts still work.
|
|
85
|
-
5. Update the dist-tag of the old branch, see https://github.com/angular/angular.js/pull/12722.
|
|
86
|
-
6. Write a blog post.
|