arthur/portfolio2023
1
0
Fork 0
mirror of https://github.com/arthur-pbty/portfolio2023.git synced 2026-06-15 00:02:54 +02:00
Code Issues Packages Projects Releases Wiki Activity

modified

Browse Source
This commit is contained in:
Tutur33
2023-11-24 23:58:26 +01:00
parent 25395c0ee1
commit 938ad9d309
4191 changed files with 41 additions and 518781 deletions
Download Patch File Download Diff File Expand all files Collapse all files
build/node_modules/fast-copy/.release-it.beta.json
Generated Vendored
-9
View File
@@ -1,9 +0,0 @@
{
"github": {
"release": true
},
"npm": {
"tag": "next"
},
"preReleaseId": "beta"
}
build/node_modules/fast-copy/.release-it.json
Generated Vendored
-6
View File
@@ -1,6 +0,0 @@
{
"github": {
"release": true,
"tagName": "v${version}"
}
}
build/node_modules/fast-copy/CHANGELOG.md
Generated Vendored
-135
View File
@@ -1,135 +0,0 @@
# fast-copy CHANGELOG
## 3.0.1
- [#78](https://github.com/planttheidea/fast-copy/pull/78) - Work when running Node process with `--disable-proto=throw` (thanks [@castarco](https://github.com/castarco))
## 3.0.0
**Breaking changes**
- Exports are now always named, so the `.default` suffix is required when accessing
- CommonJS in Node => `const copy = require('fast-copy').default;`
- UMD global via CDN => `const copy = globalThis['fast-copy'].default;`
- `copy.strict` is no longer available; it is now available as the explicit `copyStrict` named import
- Options have been removed
- `isStrict` option has been replaced with importing the separate `copyStrict` method
- `realm` has been removed entirely, as `instanceof` is no longer used internally
- The `FastCopy` namespace in typings has been removed in favor of explicit import of available types
**Enhancements**
- Support `exports` option, to have bettern handling for different environments (ESM vs CJS vs UMD) and improve tree-shaking when supported
- Can now create a custom copier (either standard or strict), allowing maximum performance for specific use-cases
- Small speed improvements when handling certain object types
**Bug fixes**
- Correctly handle primitive wrappers, e.g. `new String('foo')`
## 2.1.7
- Republish of [`2.1.6`](#216), as the release process failed mid-publish
## 2.1.6
- Revert [#69](https://github.com/planttheidea/fast-copy/pull/69) and [#71](https://github.com/planttheidea/fast-copy/pull/71), as they broke the package for NodeJS consumption (will be reintroduced in v3, as breaking changes are required)
## 2.1.5 - DO NOT USE
- Ensure `"type": "module"` is set to allow ESM in NodeJS to work [#71](https://github.com/planttheidea/fast-copy/pull/71)
## 2.1.4 - DO NOT USE
- Provide `"exports"` definition in `package.json` [#69](https://github.com/planttheidea/fast-copy/pull/69) (thanks [@liteoood](https://github.com/ilteoood))
## 2.1.3
- Fix source maps not referencing source code [#65](https://github.com/planttheidea/fast-copy/pull/65)
## 2.1.2
- Support `constructor` property override on object [#60](https://github.com/planttheidea/fast-copy/pull/60)
- Provide better support for `constructor` override on non-plain object types [#61](https://github.com/planttheidea/fast-copy/pull/61)
- Remove `tslint` in favor of `@typescript-eslint` [#62](https://github.com/planttheidea/fast-copy/pull/62)
## 2.1.1
- Fix ESM-to-CommonJS issue when using TSC to consume [#37](https://github.com/planttheidea/fast-copy/issues/37)
- Modify `Blob` cloning to use `blob.slice()` instead of `new Blob()` for speed
## 2.1.0
- Support cloning `Blob` [#31](https://github.com/planttheidea/fast-copy/pull/31) (thanks [@fratzigner](https://github.com/fratzinger))
- Fix cloning descriptors that only are getters / setters in strict mode
- Handle errors when defining properties in strict mode
## 2.0.5
- Fix issue copying objects referenced multiple times in source [#28](https://github.com/planttheidea/fast-copy/pull/28) (thanks [@darkowic](https://github.com/darkowic))
## 2.0.4
- Cache length of arrays for faster iteration [#22](https://github.com/planttheidea/fast-copy/pull/22)
- Update dev dependencies and types
## 2.0.3
- Add safety to constructing native objects (fixes #19)
## 2.0.2
- Manually coalesce options instead of use destructuring (performance)
## 2.0.1
- Fix typings declarations - [#17](https://github.com/planttheidea/fast-copy/pull/17)
## 2.0.0
- Rewrite in TypeScript
- Add strict mode (for more accurate and thorough copying, at the expense of less performance)
#### BREAKING CHANGES
- Second parameter is now an object of [options](README.md#options)
## 1.2.4
- Ensure `Date` copy uses realm-specific constructor
## 1.2.3
- Support custom prototype applied to plain object via `Object.create()`
## 1.2.2
- Support copy of extensions of native `Array` with alternative `push()` method
## 1.2.1
- Under-the-hood optimizations per recommendations from #7
## 1.2.0
- Add support for multiple realms
## 1.1.2
- Optimize order of operations for common use cases
## 1.1.1
- Fix cache using `WeakSet` when there was support for `WeakMap`s instead of `WeakSet`s (in case one was polyfilled but not the other)
## 1.1.0
- Add TypeScript and FlowType bindings
## 1.0.1
- Activate tree-shaking
## 1.0.0
- Initial release
build/node_modules/fast-copy/LICENSE
Generated Vendored
-21
View File
@@ -1,21 +0,0 @@
MIT License
Copyright (c) 2018 Tony Quetano
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.
build/node_modules/fast-copy/README.md
Generated Vendored
-395
View File
@@ -1,395 +0,0 @@
# fast-copy
<img src="https://img.shields.io/badge/build-passing-brightgreen.svg"/>
<img src="https://img.shields.io/badge/coverage-100%25-brightgreen.svg"/>
<img src="https://img.shields.io/badge/license-MIT-blue.svg"/>
A [blazing fast](#benchmarks) deep object copier
## Table of contents
- [fast-copy](#fast-copy)
- [Table of contents](#table-of-contents)
- [Usage](#usage)
- [API](#api)
- [`copy`](#copy)
- [`copyStrict`](#copystrict)
- [`createCopier`](#createcopier)
- [Copier methods](#copier-methods)
- [Copier state](#copier-state)
- [`cache`](#cache)
- [`copier`](#copier)
- [`Constructor` / `prototype`](#constructor--prototype)
- [`createStrictCopier`](#createstrictcopier)
- [Types supported](#types-supported)
- [Aspects of default copiers](#aspects-of-default-copiers)
- [Error references are copied directly, instead of creating a new `*Error` object](#error-references-are-copied-directly-instead-of-creating-a-new-error-object)
- [The constructor of the original object is used, instead of using known globals](#the-constructor-of-the-original-object-is-used-instead-of-using-known-globals)
- [Generator objects are copied, but still reference the original generator's state](#generator-objects-are-copied-but-still-reference-the-original-generators-state)
- [Benchmarks](#benchmarks)
- [Simple objects](#simple-objects)
- [Complex objects](#complex-objects)
- [Big data](#big-data)
- [Circular objects](#circular-objects)
- [Special objects](#special-objects)
- [Development](#development)
## Usage
```js
import copy from 'fast-copy';
import { deepEqual } from 'fast-equals';
const object = {
array: [123, { deep: 'value' }],
map: new Map([
['foo', {}],
[{ bar: 'baz' }, 'quz'],
]),
};
const copiedObject = copy(object);
console.log(copiedObject === object); // false
console.log(deepEqual(copiedObject, object)); // true
```
## API
### `copy`
Deeply copy the object passed.
```js
import copy from 'fast-copy';
const copied = copy({ foo: 'bar' });
```
### `copyStrict`
Deeply copy the object passed, but with additional strictness when replicating the original object:
- Properties retain their original property descriptor
- Non-enumerable keys are copied
- Non-standard properties (e.g., keys on arrays / maps / sets) are copied
```js
import { copyStrict } from 'fast-copy';
const object = { foo: 'bar' };
object.nonEnumerable = Object.defineProperty(object, 'bar', {
enumerable: false,
value: 'baz',
});
const copied = copy(object);
```
**NOTE**: This method is significantly slower than [`copy`](#copy), so it is recommended to only use this when you have specific use-cases that require it.
### `createCopier`
Create a custom copier based on the type-specific methods passed. This is useful if you want to squeeze out maximum performance, or perform something other than a standard deep copy.
```js
import { createCopier } from 'fast-copy';
const copyShallow = createCopier({
array: (array) => [...array],
map: (map) => new Map(map.entries()),
object: (object) => ({ ...object }),
set: (set) => new Set(set.values()),
});
```
Each internal copier method has the following contract:
```js
type InternalCopier<Value> = (value: Value, state: State) => Value;
interface State {
Constructor: any;
cache: WeakMap;
copier: InternalCopier<any>;
prototype: any;
}
```
Any method overriding the defaults must maintain this contract.
#### Copier methods
- `array` => `Array`
- `arrayBuffer`=> `ArrayBuffer`, `Float32Array`, `Float64Array`, `Int8Array`, `Int16Array`, `Int32Array`, `Uint8Array`, `Uint8ClampedArray`, `Uint16Array`, `Uint32Array`, `Uint64Array`
- `blob` => `Blob`
- `dataView` => `DataView`
- `date` => `Date`
- `error` => `Error`, `AggregateError`, `EvalError`, `RangeError`, `ReferenceError`, `SyntaxError`, `TypeError`, `URIError`
- `map` => `Map`
- `object` => `Object`, or any custom constructor
- `regExp` => `RegExp`
- `set` => `Set`
#### Copier state
##### `cache`
If you want to maintain circular reference handling, then you'll need the methods to handle cache population for future lookups:
```js
function shallowlyCloneArray<Value extends any[]>(
value: Value,
state: State
): Value {
const clone = [...value];
state.cache.set(value, clone);
return clone;
}
```
##### `copier`
`copier` is provided for recursive calls with deeply-nested objects.
```js
function deeplyCloneArray<Value extends any[]>(
value: Value,
state: State
): Value {
const clone = [];
state.cache.set(value, clone);
value.forEach((item) => state.copier(item, state));
return clone;
}
```
Note above I am using `forEach` instead of a simple `map`. This is because it is highly recommended to store the clone in [`cache`](#cache) eagerly when deeply copying, so that nested circular references are handled correctly.
##### `Constructor` / `prototype`
Both `Constructor` and `prototype` properties are only populated with complex objects that are not standard objects or arrays. This is mainly useful for custom subclasses of these globals, or maintaining custom prototypes of objects.
```js
function deeplyCloneSubclassArray<Value extends CustomArray>(
value: Value,
state: State
): Value {
const clone = new state.Constructor();
state.cache.set(value, clone);
value.forEach((item) => clone.push(item));
return clone;
}
function deeplyCloneCustomObject<Value extends CustomObject>(
value: Value,
state: State
): Value {
const clone = Object.create(state.prototype);
state.cache.set(value, clone);
Object.entries(value).forEach(([k, v]) => (clone[k] = v));
return clone;
}
```
### `createStrictCopier`
Create a custom copier based on the type-specific methods passed, but defaulting to the same functions normally used for `copyStrict`. This is useful if you want to squeeze out better performance while maintaining strict requirements, or perform something other than a strict deep copy.
```js
const createStrictClone = (value, clone) =>
Object.getOwnPropertyNames(value).reduce(
(clone, property) =>
Object.defineProperty(
clone,
property,
Object.getOwnPropertyDescriptor(value, property) || {
configurable: true,
enumerable: true,
value: clone[property],
writable: true,
}
),
clone
);
const copyStrictShallow = createStrictCopier({
array: (array) => createStrictClone(array, []),
map: (map) => createStrictClone(map, new Map(map.entries())),
object: (object) => createStrictClone(object, {}),
set: (set) => createStrictClone(set, new Set(set.values())),
});
```
**NOTE**: This method creates a copier that is significantly slower than [`copy`](#copy), as well as likely a copier created by [`createCopier`](#createcopier), so it is recommended to only use this when you have specific use-cases that require it.
## Types supported
The following object types are deeply cloned when they are either properties on the object passed, or the object itself:
- `Array`
- `ArrayBuffer`
- `Boolean` primitive wrappers (e.g., `new Boolean(true)`)
- `Blob`
- `Buffer`
- `DataView`
- `Date`
- `Float32Array`
- `Float64Array`
- `Int8Array`
- `Int16Array`
- `Int32Array`
- `Map`
- `Number` primitive wrappers (e.g., `new Number(123)`)
- `Object`
- `RegExp`
- `Set`
- `String` primitive wrappers (e.g., `new String('foo')`)
- `Uint8Array`
- `Uint8ClampedArray`
- `Uint16Array`
- `Uint32Array`
- `React` components
- Custom constructors
The following object types are copied directly, as they are either primitives, cannot be cloned, or the common use-case implementation does not expect cloning:
- `AsyncFunction`
- `Boolean` primitives
- `Error`
- `Function`
- `GeneratorFunction`
- `Number` primitives
- `Null`
- `Promise`
- `String` primitives
- `Symbol`
- `Undefined`
- `WeakMap`
- `WeakSet`
Circular objects are supported out of the box. By default, a cache based on `WeakSet` is used, but if `WeakSet` is not available then a fallback is used. The benchmarks quoted below are based on use of `WeakSet`.
## Aspects of default copiers
Inherently, what is considered a valid copy is subjective because of different requirements and use-cases. For this library, some decisions were explicitly made for the default copiers of specific object types, and those decisions are detailed below. If your use-cases require different handling, you can always create your own custom copier with [`createCopier`](#createcopier) or [`createStrictCopier`](#createstrictcopier).
### Error references are copied directly, instead of creating a new `*Error` object
While it would be relatively trivial to copy over the message and stack to a new object of the same `Error` subclass, it is a common practice to "override" the message or stack, and copies would not retain this mutation. As such, the original reference is copied.
### The constructor of the original object is used, instead of using known globals
Starting in ES2015, native globals can be subclassed like any custom class. When copying, we explicitly reuse the constructor of the original object. However, the expectation is that these subclasses would have the same constructur signature as their native base class. This is a common community practice, but there is the possibility of inaccuracy if the contract differs.
### Generator objects are copied, but still reference the original generator's state
[Generator objects](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Generator) are specific types of iterators, but appear like standard objects that just have a few methods (`next`, `throw`, `return`). These methods are bound to the internal state of the generator, which cannot be copied effectively. Normally this would be treated like other "uncopiable" objects and simply pass the reference through, however the "validation" of whether it is a generator object or a standard object is not guaranteed (duck-typing) and there is a runtime cost associated with. Therefore, the simplest path of treating it like a standard object (copying methods to a new object) was taken.
## Benchmarks
#### Simple objects
_Small number of properties, all values are primitives_
| | Operations / second |
| ------------------ | ------------------- |
| **fast-copy** | **5,880,312** |
| lodash.cloneDeep | 2,706,261 |
| clone | 2,207,231 |
| deepclone | 1,274,810 |
| fast-clone | 1,239,952 |
| ramda | 1,146,152 |
| fast-copy (strict) | 852,382 |
#### Complex objects
_Large number of properties, values are a combination of primitives and complex objects_
| | Operations / second |
| ------------------ | ------------------- |
| **fast-copy** | **162,858** |
| ramda | 142,104 |
| deepclone | 133,607 |
| fast-clone | 101,143 |
| clone | 70,872 |
| fast-copy (strict) | 62,961 |
| lodash.cloneDeep | 62,060 |
#### Big data
_Very large number of properties with high amount of nesting, mainly objects and arrays_
| | Operations / second |
| ------------------ | ------------------- |
| **fast-copy** | **303** |
| fast-clone | 245 |
| deepclone | 151 |
| lodash.cloneDeep | 150 |
| clone | 93 |
| fast-copy (strict) | 90 |
| ramda | 42 |
#### Circular objects
_Objects that deeply reference themselves_
| | Operations / second |
| ------------------ | ------------------- |
| **fast-copy** | **2,420,466** |
| deepclone | 1,386,896 |
| ramda | 1,024,108 |
| lodash.cloneDeep | 989,796 |
| clone | 987,721 |
| fast-copy (strict) | 617,602 |
| fast-clone | 0 (not supported) |
#### Special objects
_Custom constructors, React components, etc_
| | Operations / second |
| ------------------ | ------------------- |
| **fast-copy** | **152,792** |
| clone | 74,347 |
| fast-clone | 66,576 |
| lodash.cloneDeep | 64,760 |
| ramda | 53,542 |
| deepclone | 28,823 |
| fast-copy (strict) | 21,362 |
## Development
Standard practice, clone the repo and `yarn` (or `npm i`) to get the dependencies. The following npm scripts are available:
- benchmark => run benchmark tests against other equality libraries
- build => run `build:esm`, `build:cjs`, `build:umd`, and `build:min` scripts
- build:cjs => build CJS files and types
- build:esm => build ESM files and types
- build:min => build minified files and types
- build:umd => build UMD files and types
- clean => run `rimraf` on the `dist` folder
- dev => start webpack playground App
- dist => run `clean` and `build` scripts
- lint => run ESLint on all files in `src` folder (also runs on `dev` script)
- lint:fix => run `lint` script, but with auto-fixer
- prepublishOnly => run `lint`, `test:coverage`, and `dist` scripts
- release => run `prepublishOnly` and release with new version
- release:beta => run `prepublishOnly` and release with new beta version
- release:dry => run `prepublishOnly` and simulate a new release
- start => run `dev`
- test => run AVA with NODE_ENV=test on all files in `test` folder
- test:coverage => run same script as `test` with code coverage calculation via `nyc`
- test:watch => run same script as `test` but keep persistent watcher
- typecheck => run `tsc` on the codebase
build/node_modules/fast-copy/index.d.ts
Generated Vendored
-55
View File
@@ -1,55 +0,0 @@
interface Cache {
_keys?: any[];
_values?: any[];
has: (value: any) => boolean;
set: (key: any, value: any) => void;
get: (key: any) => any;
}
export interface CreateCopierOptions {
array?: InternalCopier<any[]>;
arrayBuffer?: InternalCopier<ArrayBuffer>;
blob?: InternalCopier<Blob>;
dataView?: InternalCopier<DataView>;
date?: InternalCopier<Date>;
map?: InternalCopier<Map<any, any>>;
object?: InternalCopier<Record<string, any>>;
regExp?: InternalCopier<RegExp>;
set?: InternalCopier<Set<any>>;
}
type InternalCopier<Value> = (value: Value, state: State) => Value;
export interface State {
Constructor: any;
cache: Cache;
copier: InternalCopier<any>;
prototype: any;
}
/**
* Copy an value deeply as much as possible.
*/
export default function copy<Value>(value: Value): Value;
/**
* Copy an value deeply as much as possible, where strict recreation of object properties
* are maintained. All properties (including non-enumerable ones) are copied with their
* original property descriptors on both objects and arrays.
*/
export function copyStrict<Value>(value: Value): Value;
/**
* Create a custom copier based on the object-specific copy methods passed.
*/
export function createCopier(
options: CreateCopierOptions
): <Value>(value: Value) => Value;
/**
* Create a custom copier based on the object-specific copy methods passed, defaulting to the
* same internals as `copyStrict`.
*/
export function createStrictCopier(
options: CreateCopierOptions
): <Value>(value: Value) => Value;
build/node_modules/fast-copy/package.json
Generated Vendored
-103
View File
@@ -1,103 +0,0 @@
{
"author": "tony_quetano@planttheidea.com",
"contributors": [
"Dariusz Rzepka <rzepkadarek@gmail.com>"
],
"browser": "dist/umd/index.js",
"bugs": {
"url": "https://github.com/planttheidea/fast-copy/issues"
},
"description": "A blazing fast deep object copier",
"devDependencies": {
"@rollup/plugin-node-resolve": "^15.0.1",
"@rollup/plugin-typescript": "^11.0.0",
"@types/eslint": "^8.21.1",
"@types/jest": "^29.4.0",
"@types/lodash": "^4.14.191",
"@types/node": "^18.14.0",
"@types/ramda": "^0.28.23",
"@types/react": "^18.0.28",
"@typescript-eslint/eslint-plugin": "^5.52.0",
"@typescript-eslint/parser": "^5.52.0",
"benchee": "^1.0.3",
"cli-table3": "^0.6.3",
"clone": "^2.1.2",
"deepclone": "^1.0.2",
"eslint": "^8.34.0",
"eslint-webpack-plugin": "^4.0.0",
"fast-clone": "^1.5.3",
"html-webpack-plugin": "^5.5.0",
"in-publish": "^2.0.1",
"jest": "^29.4.3",
"lodash": "^4.17.11",
"nyc": "^15.1.0",
"ramda": "^0.28.0",
"react": "^18.2.0",
"react-dom": "^18.2.0",
"release-it": "15.6.0",
"rollup": "^3.16.0",
"rollup-plugin-terser": "^7.0.2",
"ts-jest": "^29.0.5",
"ts-loader": "^9.4.2",
"typescript": "^4.9.5",
"webpack": "^5.75.0",
"webpack-cli": "^5.0.1",
"webpack-dev-server": "^4.11.1"
},
"exports": {
".": {
"import": {
"types": "./dist/esm/types/index.d.ts",
"default": "./dist/esm/index.mjs"
},
"require": {
"types": "./dist/cjs/types/index.d.ts",
"default": "./dist/cjs/index.cjs"
},
"default": {
"types": "./dist/umd/types/index.d.ts",
"default": "./dist/umd/index.js"
}
}
},
"homepage": "https://github.com/planttheidea/fast-copy#readme",
"keywords": [
"clone",
"deep",
"copy",
"fast"
],
"license": "MIT",
"main": "dist/cjs/index.cjs",
"module": "dist/esm/index.mjs",
"name": "fast-copy",
"repository": {
"type": "git",
"url": "git+https://github.com/planttheidea/fast-copy.git"
},
"scripts": {
"benchmark": "npm run clean && npm run build:cjs && node benchmark/index.cjs",
"build": "npm run build:esm && npm run build:cjs && npm run build:umd && npm run build:min",
"build:cjs": "NODE_ENV=production rollup -c rollup/config.cjs.js && tsc -p ./tsconfig/cjs.json",
"build:esm": "NODE_ENV=production rollup -c rollup/config.esm.js && tsc -p ./tsconfig/esm.json",
"build:min": "NODE_ENV=production rollup -c rollup/config.min.js && tsc -p ./tsconfig/min.json",
"build:umd": "NODE_ENV=production rollup -c rollup/config.umd.js && tsc -p ./tsconfig/umd.json",
"clean": "rimraf dist",
"dev": "NODE_ENV=development webpack-dev-server --config=webpack/webpack.config.js",
"dist": "npm run clean && npm run build",
"lint": "eslint 'src/*.ts' '__tests__/*.ts' 'DEV_ONLY/*.ts'",
"lint:fix": "npm run lint -- --fix",
"prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm run dist",
"release": "release-it",
"release:beta": "release-it --config=.release-it.beta.json",
"release:dry": "release-it --dry-run",
"start": "npm run dev",
"test": "NODE_PATH=. jest",
"test:coverage": "npm run test -- --coverage",
"test:watch": "npm run test -- --watch",
"typecheck": "tsc --noEmit"
},
"type": "module",
"types": "index.d.ts",
"version": "3.0.1"
}