@js-joda/core 3.2.0 → 4.2.1

package/CHANGELOG.md

@@ -3,6 +3,37 @@ Changelog
 
 ### next (upcoming)
 
+### 4.2.1
+
+* [#559](https://github.com/js-joda/js-joda/pull/559) Fix references to deprecated single repos ([@pithu](https://github.com/pithu))
+
+### 4.2.0
+
+* Upgrade dependencies #555 by @pithu
+* Change @babel/preset-env targets, fix IE11 issues #555 by @pithu
+* Improve documentation  #556 by @pithu
+
+### 4.1.0
+
+* Remove edge case handling for Temporal.minus #542 by @pithu
+* Improve docu #550 by @pithu
+
+### 4.0.0 
+
+Even this is a major release, there are no real breaking changes.
+The release contains typescript definition cleanup and some 
+"private" methods have been prefixed with "_". These methods are intended for internal use only.
+
+If you used the threeten API in the intended way, there shouldn't be any breaking changes. 
+If you used internal methods before, there is an replacement eg instead of `minusAmountUnit` use `minus`.
+
+* cleanup TS Typings in #456 by @InExtremaRes
+* cleanup private methods and Temporal class in #460 by @InExtremaRes
+* remove TS definitions from core, moved to locale TS definitions in #389 by @InExtremaRes
+* make .equals a type predicate in the TS typings in #457 by @InExtremaRes
+* add some ISO formatters in #455 by @akonior
+* several dependabot updates
+
 ### 3.2.0
 
 * add typescript definitions for OffsetDateTime and OffsetTime #448 by jonfreedman
@@ -290,7 +321,7 @@ Resolve those conflicts by using the 'public shorthand' methods, like instead of
 
 #### Add ZoneRulesProvider stub
 
-Add the ZoneRulesProvider. This should be the last step to enable js-joda for an external js-joda-timezone plugin.
+Add the ZoneRulesProvider. This should be the last step to enable js-joda for an external @js-joda/timezone plugin.
 
 #### Provide a way to extend js-joda
 

package/README.md

@@ -1,13 +1,12 @@
-# @js-joda/core
-
 # Immutable date and time library for JavaScript
 
 [![npm version](https://badge.fury.io/js/%40js-joda%2Fcore.svg)](https://badge.fury.io/js/%40js-joda%2Fcore)
-[![Travis Build Status](https://travis-ci.org/js-joda/js-joda.svg)](https://travis-ci.org/js-joda/js-joda)
+[![Travis Build Status](https://app.travis-ci.com/js-joda/js-joda.svg?branch=master)](https://app.travis-ci.com/js-joda/js-joda)
 [![Sauce Test Status](https://saucelabs.com/buildstatus/js-joda)](https://saucelabs.com/u/js-joda)
 [![Coverage Status](https://coveralls.io/repos/js-joda/js-joda/badge.svg?branch=master&service=github)](https://coveralls.io/github/js-joda/js-joda?branch=master)
-[![Tested node version](https://img.shields.io/badge/tested_with-current_node_LTS-blue.svg?style=flat)]()
-[![Sauce Test Status](https://saucelabs.com/browser-matrix/js-joda.svg)](https://saucelabs.com/u/js-joda)
+[![Downloads/Month](https://img.shields.io/npm/dm/%40js-joda%2Fcore.svg)](https://img.shields.io/npm/dm/%40js-joda%2Fcore.svg)
+
+[![Sauce Browser Matrix](https://saucelabs.com/browser-matrix/js-joda.svg?branch=master)](https://saucelabs.com/u/js-joda)
 
 ## Introduction
 
@@ -19,7 +18,7 @@
 
 - js-joda comes with built-in parsers/ formatters for ISO 8601 as specified in RFC 3339, that can be easily customized.
 
-- js-joda supports **ECMAScript 5** browsers down to IE9.
+- js-joda supports **ECMAScript 5** browsers down to IE11.
 
 - js-joda is a **port of the threeten** backport, which is the base for JSR-310 implementation of the Java SE 8 java.time package. Threeten is inspired by **Joda-Time**, having similar concepts and the same author.
 
@@ -95,11 +94,48 @@ To use js-joda from a browser, download either `dist/js-joda.min.js` or `dist/js
 </script>
 ```
 
+## js-joda packages
+
+js-joda consist of four packages:
+
+|  package name | description  |  path |
+|---|---|---|
+| `@js-joda/core` | Implementation of the ThreeTen Classes and API | [/packages/core](//github.com/js-joda/js-joda/tree/master/packages/core) |
+| `@js-joda/timezone` | Implementation of timezone calculation based on the iana Time Zone Database | [/packages/timezone](//github.com/js-joda/js-joda/tree/master/packages/timezone) |
+| `@js-joda/locale` | Implementation of locale specific functionality for js-joda, especially for formatting and parsing locale specific dates | [/packages/locale](//github.com/js-joda/js-joda/tree/master/packages/locale) |
+| `@js-joda/extra` | Implementation of the ThreeTen-Extra Classes and API |[/packages/extra](//github.com/js-joda/js-joda/tree/master/packages/extra) |
+
+The [@js-joda/examples](//github.com/js-joda/js-joda/tree/master/packages/examples) package is for testing the different build artifacts in different context, like webpack, browser node, etc.
+
 ## Documentation
 
 - [js-joda Quick start guide](//js-joda.github.io/js-joda/manual/getting-started.html) Quick start guide and examples
 - [API](//js-joda.github.io/js-joda/identifiers.html) ESDoc generated API documentation
 
+## Contributing
+
+Contributions are always welcome. Before contributing please read the [code of conduct](http://contributor-covenant.org/version/1/4/) &
+search the issue tracker. We use GitHub issues. Your issue may have already been discussed or fixed. To contribute, fork js-joda, commit your changes, & send a pull request.
+
+By contributing to js-joda, you agree that your contributions will be licensed under its BSD license.
+
+Note that only pull requests and issues that match the threeten backport API will be considered. Additional requested features will be rejected.
+
+## License
+
+- `js-joda` is released under the [BSD 3-clause license](//github.com/js-joda/js-joda/blob/master/LICENSE).
+
+- `js-joda` uses the ThreeTen-Backport implementation (http://www.threeten.org/threetenbp/) as a reference base for implementation. This allows us to release js-joda under the BSD License while the OpenJDK java.time implementation is under GNU GPL+linking exception. The API of the ThreeTen-Backport is mostly identical to the official Java SE 8 API from the view of our JavaScript port.
+
+- Our implementation reference base ThreeTen-Backport (http://www.threeten.org/threetenbp/) is also released under the BSD 3-clause license
+
+- `OpenJDK` is under GNU GPL+linking exception.
+
+- The author of `Joda-Time` and the lead architect of the JSR-310 is Stephen Colebourne.
+
+The API of this project (as far as possible with JavaScript), a lot of implementation details and documentation
+are just copied but never equalled.
+
 ## Roadmap
 
 ### Milestone 1: Core domains (reached with version v1.0.0)
@@ -112,7 +148,7 @@ To use js-joda from a browser, download either `dist/js-joda.min.js` or `dist/js
 - Add IANA timezone database support to js-joda. Implement handling of daylight saving transitions, mainly in `ZonedDateTime`.
 - For access to the IANA timezone database, the plugin [@js-joda/timezone](//github.com/js-joda/js-joda/tree/master/packages/timezone) is required. It provides an implementation of the [ZoneRulesProvider](//js-joda.github.io/js-joda/class/packages/core/src/zone/ZoneRulesProvider.js~ZoneRulesProvider.html) and contains the iana timezone database.
 
-### Milestone 3: Locale support (reached with v2.0.0 of js-joda-locale)
+### Milestone 3: Locale support (reached with v2.0.0 of @js-joda/locale)
 
 - Add locale support.
 - Extend pattern parser/ formatter for text with locale support.
@@ -124,32 +160,3 @@ see the plugin [@js-joda/locale](//github.com/js-joda/js-joda/tree/master/packag
 - Reduce library size by removing redundant code, especially by refactoring code for formatting/ parsing dates.
 - Increase test coverage (ongoing task)
 - Cleanup documentation (ongoing task)
-- Improve static factory API design and make it more JavaScript style. One idea is to remove static factory methods like parse, from, of and unify it to one factory method per domain. E.g. localDate(isoDate: string), localDate(year: number, month: number, dayOfMonth: number)
-- Merge methods get and getLong (difference between `int` and `long` values makes no sense with JavaScript)
-- Simplify temporal adjusters (amount, etc) by using functions instead of classes or objects
-
-## Contributing
-
-Contributions are always welcome. Before contributing please read the [code of conduct](http://contributor-covenant.org/version/1/4/) &
-search the issue tracker. We use GitHub issues. Your issue may have already been discussed or fixed. To contribute, fork js-joda, commit your changes, & send a pull request.
-
-By contributing to js-joda, you agree that your contributions will be licensed under its BSD license.
-
-Note that only pull requests and issues that match the threeten backport API will be considered. Additional requested features will be rejected.
-
-## License
-
-- `Joda-Time` is the base for JSR-310 that became part of Java SE 8 in the java.time package. JSR-310 is a new implementation with an API 'inspired by Joda-Time' but improves on some design flaws (see http://blog.joda.org/2009/11/why-jsr-310-isn-joda-time_4941.html) `Joda-Time` is under Apache 2.0 licence.
-
-`js-joda` uses the ThreeTen-Backport implementation (http://www.threeten.org/threetenbp/) as a reference base for implementation. This allows us to release js-joda under the BSD License while the OpenJDK java.time implementation is under GNU GPL+linking exception. The API of the ThreeTen-Backport is mostly identical to the official Java SE 8 API from the view of our JavaScript port.
-
-- `js-joda` is released under the [BSD 3-clause license](//github.com/js-joda/js-joda/blob/master/LICENSE).
-
-- Our implementation reference base ThreeTen-Backport (http://www.threeten.org/threetenbp/) is also released under the BSD 3-clause license
-
-- `OpenJDK` is under GNU GPL+linking exception.
-
-- The author of `Joda-Time` and the lead architect of the JSR-310 is Stephen Colebourne.
-
-The API of this project (as far as possible with JavaScript), a lot of implementation details and documentation
-are just copied but never equalled.