@checkdigit/time 1.1.0 → 2.0.0-PR.14-c36c

package/src/date-fns/CONTRIBUTING.md

@@ -0,0 +1,170 @@
+# Contributing Guide
+
+**⚠⚠⚠ Please contribute new code in TypeScript ⚠⚠⚠**
+
+[Read more about migration to TypeScript](https://github.com/date-fns/date-fns/discussions/1932)
+
+## Table of Contents
+
+- [How to Help?](#how-to-help)
+
+- [Contribution Guidelines](#contribution-guidelines)
+
+- [Getting Started](#getting-started)
+
+- [Testing](#testing)
+
+  - [Unit tests](#unit-tests)
+  - [REPL](#repl)
+  - [Test build](#test-build)
+
+- [Code Style Guide](#code-style-guide)
+
+  - [Lint the Code](#lint-the-code)
+
+- [Documentation](#documentation)
+
+  - [JSDoc](#jsdoc)
+
+## How to Help?
+
+Help is always welcome. There are areas where you can help:
+
+- The core functionality (performance improvements, bug fixes,
+  new features, etc.).
+
+- Documentation ([markdown documents](https://github.com/date-fns/date-fns/tree/master/docs),
+  [JSDoc annotations in source code](https://github.com/date-fns/date-fns/blob/master/src/toDate/index.ts)).
+
+- Test suite & development environment improvements.
+
+- The [website](https://github.com/date-fns/date-fns.org).
+
+If you see a gap, but don't have time, experience, or you just need help
+with the library, don't hesitate to [start a discussion](https://github.com/date-fns/date-fns/discussions/new) or
+[open a new issue](https://github.com/date-fns/date-fns/issues/new).
+
+The date-fns functionality is comprehensive and covers most of the use cases,
+however it doesn't have an extended time zone support. Please leave a comment
+to the [Extended time zones support issue](https://github.com/date-fns/date-fns/issues/180)
+if you are interested in the functionality or want to help with development.
+
+If you are interested in Elm/ClojureScript/etc. wrappers,
+please [file an issue](https://github.com/date-fns/date-fns/issues/new).
+
+## Contribution Guidelines
+
+Due to the modular nature of date-fns, it's more than open to new features.
+However, when a new function duplicates the existing functionality, native API
+or causes significant build size increase, a PR might be rejected or
+the author can be asked to move the code to a new or another package.
+
+Please follow the main contributing rules, to maintain date-fns' top quality:
+
+- Follow style guides:
+
+  - [Lint the code](#lint-the-code).
+
+- Write tests.
+
+- [Write documentation](#documentation).
+
+- Don't update the changelog.
+
+- Don't change the library version.
+
+## Getting Started
+
+1. Install [Node.js 14 or greater (LTS recommended)](https://nodejs.org/en/download/)
+
+2. Install or upgrade to the latest [Yarn classic (v1)](https://classic.yarnpkg.com/en/docs/install) by running `npm install -g yarn@latest`
+
+3. Fork the project, and clone your fork of the repo
+
+4. Run `yarn` to install the dev dependencies
+
+## Testing
+
+### Unit tests
+
+Karma + Mocha (Chrome):
+
+```sh
+# all tests in watch mode
+yarn test
+
+# all tests once
+yarn test --single-run
+```
+
+Jest (Node.js):
+
+```sh
+# all tests in watch mode
+yarn jest --watch
+
+# all tests once
+yarn jest
+```
+
+### REPL
+
+To test functions in a REPL, use `babel-node` located in `./node_modules/.bin` (mind the `-x` flag to also support TypeScript files):
+
+```sh
+yarn babel-node -x .ts,.js
+```
+
+and then require invididual functions:
+
+```sh
+> const toDate = require('./src/toDate')
+undefined
+> toDate(1392098430000).toString()
+'Tue Feb 11 2014 01:00:30 GMT-0500 (Eastern Standard Time)'
+>
+```
+
+or all functions (slower):
+
+```sh
+> const fns = require('./src')
+undefined
+> fns.toDate(1392098430000).toString()
+'Tue Feb 11 2014 01:00:30 GMT-0500 (Eastern Standard Time)'
+>
+```
+
+### Test build
+
+Build date-fns from source to test in your project. The ouput is equivalent to what gets published on npm with each release.
+
+```sh
+# replace {YOUR-PROJECT-PATH} with an absolute or relative path to your project root
+env PACKAGE_OUTPUT_PATH="{YOUR-PROJECT-PATH}/node_modules/date-fns" ./scripts/build/package.sh
+```
+
+## Code Style Guide
+
+### Lint the Code
+
+The project follows [Prettier] code style and uses [ESLint] as the linter.
+To lint the code, run:
+
+```bash
+yarn lint
+```
+
+[prettier]: https://prettier.io/
+[eslint]: https://eslint.org/
+
+## Documentation
+
+### JSDoc
+
+- [JSDoc](https://jsdoc.app/) is used for the code documentation. Along with the
+  standard JSDoc tags, date-fns uses `@category` tag that allows
+  to group functions.
+
+- [jsdoc-to-markdown](https://github.com/jsdoc2md/jsdoc-to-markdown/) is used to parse
+  JSDoc annotations.

package/src/date-fns/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Sasha Koss and Lesha Koss https://kossnocorp.mit-license.org
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/src/date-fns/_lib/addLeadingZeros/index.ts

@@ -0,0 +1,8 @@
+export default function addLeadingZeros(number: number, targetLength: number): string {
+  const sign = number < 0 ? '-' : '';
+  let output = Math.abs(number).toString();
+  while (output.length < targetLength) {
+    output = '0' + output;
+  }
+  return sign + output;
+}

package/src/date-fns/_lib/assign/index.ts

@@ -0,0 +1,13 @@
+export default function assign<T, U>(target: T, object: U): T & U {
+  if (target == null) {
+    throw new TypeError('assign requires that input parameter not be null or undefined');
+  }
+
+  for (const property in object) {
+    if (Object.prototype.hasOwnProperty.call(object, property)) {
+      (target as any)[property] = object[property];
+    }
+  }
+
+  return target as T & U;
+}

package/src/date-fns/_lib/cloneObject/index.ts

@@ -0,0 +1,5 @@
+import assign from '../assign/index';
+
+export default function cloneObject<T>(object: T): T {
+  return assign({}, object);
+}

package/src/date-fns/_lib/defaultLocale/index.ts

@@ -0,0 +1,2 @@
+import defaultLocale from '../../locale/en-US/index';
+export default defaultLocale;

package/src/date-fns/_lib/defaultOptions/index.ts

@@ -0,0 +1,13 @@
+import type { FirstWeekContainsDateOptions, LocaleOptions, WeekStartOptions } from '../../types';
+
+export type DefaultOptions = LocaleOptions & WeekStartOptions & FirstWeekContainsDateOptions;
+
+let defaultOptions: DefaultOptions = {};
+
+export function getDefaultOptions(): DefaultOptions {
+  return defaultOptions;
+}
+
+export function setDefaultOptions(newOptions: DefaultOptions): void {
+  defaultOptions = newOptions;
+}