@oliversalzburg/js-utils 0.0.6 → 0.0.8

package/package.json

@@ -1,20 +1,21 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@oliversalzburg/js-utils",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "license": "MIT",
   "author": "Oliver Salzburg <oliver.salzburg@gmail.com>",
   "type": "module",
   "exports": {
-    ".": {
-      "default": "./lib/index.js"
-    }
+    ".": "./lib/index.js",
+    "./lib": "./lib/index.js",
+    "./lib/*": "./lib/*.js",
+    "./lib/*.js": "./lib/*.js"
   },
   "scripts": {
     "build": "yarn run build:tsc",
     "build:esbuild": "node build.js",
     "build:tsc": "tsc",
-    "docs:typedoc": "typedoc --plugin typedoc-plugin-markdown",
+    "docs:typedoc": "typedoc",
     "lint": "yarn run lint:eslint && yarn run lint:prettier && yarn run lint:tsc",
     "lint:eslint": "eslint source ./*js",
     "lint:prettier": "prettier --check source ./*js",
@@ -30,14 +31,14 @@
   },
   "types": "./lib/index.d.ts",
   "devDependencies": {
-    "@types/chai": "4.3.9",
-    "@types/chai-as-promised": "7.1.7",
-    "@types/eslint": "8.44.6",
-    "@types/mocha": "10.0.3",
-    "@types/node": "20.8.10",
+    "@types/chai": "4.3.10",
+    "@types/chai-as-promised": "7.1.8",
+    "@types/eslint": "8.44.7",
+    "@types/mocha": "10.0.4",
+    "@types/node": "20.9.0",
     "@types/web": "0.0.119",
-    "@typescript-eslint/eslint-plugin": "6.9.1",
-    "@typescript-eslint/parser": "6.9.1",
+    "@typescript-eslint/eslint-plugin": "6.10.0",
+    "@typescript-eslint/parser": "6.10.0",
     "c8": "8.0.1",
     "chai": "4.3.10",
     "chai-as-promised": "7.1.1",
@@ -50,7 +51,6 @@
     "prettier-package-json": "2.8.0",
     "prettier-plugin-organize-imports": "3.2.3",
     "typedoc": "0.25.3",
-    "typedoc-plugin-markdown": "3.17.0",
     "typescript": "5.2.2"
   },
   "packageManager": "yarn@4.0.1"

package/docs/README.md

@@ -1,3 +0,0 @@
-@oliversalzburg/js-utils / [Exports](modules.md)
-
-# JS Utils

package/docs/classes/AbstractError.md

@@ -1,271 +0,0 @@
-[@oliversalzburg/js-utils](../README.md) / [Exports](../modules.md) / AbstractError
-
-# Class: AbstractError
-
-Base class for all errors.
-
-## Hierarchy
-
--   `Error`
-
-    ↳ **`AbstractError`**
-
-    ↳↳ [`InternalError`](InternalError.md)
-
-    ↳↳ [`InvalidArgumentError`](InvalidArgumentError.md)
-
-    ↳↳ [`InvalidOperationError`](InvalidOperationError.md)
-
-    ↳↳ [`NotImplementedError`](NotImplementedError.md)
-
-    ↳↳ [`PermissionViolationError`](PermissionViolationError.md)
-
-    ↳↳ [`ResourceConflictError`](ResourceConflictError.md)
-
-    ↳↳ [`UnknownError`](UnknownError.md)
-
-## Constructors
-
-### constructor
-
-• **new AbstractError**(`code`, `message`, `status`): [`AbstractError`](AbstractError.md)
-
-Constructs a new [AbstractError](AbstractError.md).
-
-#### Parameters
-
-| Name      | Type     | Description                                 |
-| :-------- | :------- | :------------------------------------------ |
-| `code`    | `string` | The main identification code for the error. |
-| `message` | `string` | The main error message.                     |
-| `status`  | `number` | The HTTP status code to return.             |
-
-#### Returns
-
-[`AbstractError`](AbstractError.md)
-
-#### Overrides
-
-Error.constructor
-
-#### Defined in
-
-[errors/AbstractError.ts:37](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/errors/AbstractError.ts#L37)
-
-## Properties
-
-### cause
-
-• `Optional` **cause**: `unknown`
-
-#### Inherited from
-
-Error.cause
-
-#### Defined in
-
-../node_modules/typescript/lib/lib.es2022.error.d.ts:24
-
----
-
-### code
-
-• **code**: `string`
-
-An application-unique, readable error code.
-
-#### Defined in
-
-[errors/AbstractError.ts:29](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/errors/AbstractError.ts#L29)
-
----
-
-### info
-
-• **info**: [`Maybe`](../modules.md#maybe)\<`string`\>
-
-A user-friendly error message that may be transported to the client.
-
-**`Deprecated`**
-
-User-friendly errors should be read from `extensions`.
-
-#### Defined in
-
-[errors/AbstractError.ts:24](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/errors/AbstractError.ts#L24)
-
----
-
-### inner
-
-• **inner**: [`Maybe`](../modules.md#maybe)\<`Error`\>
-
-Another error that should be transported with this error.
-
-**`Deprecated`**
-
-We don't make use of this or interpret nested errors at all.
-
-#### Defined in
-
-[errors/AbstractError.ts:18](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/errors/AbstractError.ts#L18)
-
----
-
-### message
-
-• **message**: `string`
-
-#### Inherited from
-
-Error.message
-
-#### Defined in
-
-../node_modules/typescript/lib/lib.es5.d.ts:1068
-
----
-
-### name
-
-• **name**: `string`
-
-#### Inherited from
-
-Error.name
-
-#### Defined in
-
-../node_modules/typescript/lib/lib.es5.d.ts:1067
-
----
-
-### stack
-
-• `Optional` **stack**: `string`
-
-#### Inherited from
-
-Error.stack
-
-#### Defined in
-
-../node_modules/typescript/lib/lib.es5.d.ts:1069
-
----
-
-### status
-
-• **status**: `number`
-
-The HTTP status code to associate with this error.
-
-**`Deprecated`**
-
-We no longer respond to HTTP requests with error-specifc
-status codes.
-
-#### Defined in
-
-[errors/AbstractError.ts:12](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/errors/AbstractError.ts#L12)
-
----
-
-### prepareStackTrace
-
-▪ `Static` `Optional` **prepareStackTrace**: (`err`: `Error`, `stackTraces`: `CallSite`[]) => `any`
-
-#### Type declaration
-
-▸ (`err`, `stackTraces`): `any`
-
-Optional override for formatting stack traces
-
-##### Parameters
-
-| Name          | Type         |
-| :------------ | :----------- |
-| `err`         | `Error`      |
-| `stackTraces` | `CallSite`[] |
-
-##### Returns
-
-`any`
-
-**`See`**
-
-https://v8.dev/docs/stack-trace-api#customizing-stack-traces
-
-#### Inherited from
-
-Error.prepareStackTrace
-
-#### Defined in
-
-../node_modules/@types/node/globals.d.ts:11
-
----
-
-### stackTraceLimit
-
-▪ `Static` **stackTraceLimit**: `number`
-
-#### Inherited from
-
-Error.stackTraceLimit
-
-#### Defined in
-
-../node_modules/@types/node/globals.d.ts:13
-
-## Methods
-
-### captureStackTrace
-
-▸ **captureStackTrace**(`targetObject`, `constructorOpt?`): `void`
-
-Create .stack property on a target object
-
-#### Parameters
-
-| Name              | Type       |
-| :---------------- | :--------- |
-| `targetObject`    | `object`   |
-| `constructorOpt?` | `Function` |
-
-#### Returns
-
-`void`
-
-#### Inherited from
-
-Error.captureStackTrace
-
-#### Defined in
-
-../node_modules/@types/node/globals.d.ts:4
-
----
-
-### isAbstractError
-
-▸ **isAbstractError**(`error`, `allowForeignModule?`): error is AbstractError
-
-Checks if an object is an instance of [AbstractError](AbstractError.md), or one of its subclasses.
-
-#### Parameters
-
-| Name                 | Type      | Default value | Description                                                                                                                                                 |
-| :------------------- | :-------- | :------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `error`              | `unknown` | `undefined`   | The object to check.                                                                                                                                        |
-| `allowForeignModule` | `boolean` | `true`        | Only check for similar looking error codes. You're going to want to use this if you're dealing with a setup where multiple versions of js-utils are loaded. |
-
-#### Returns
-
-error is AbstractError
-
-`true` if the object is an [AbstractError](AbstractError.md), `false` otherwise.
-
-#### Defined in
-
-[errors/AbstractError.ts:58](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/errors/AbstractError.ts#L58)

package/docs/classes/Canvas.md

@@ -1,177 +0,0 @@
-[@oliversalzburg/js-utils](../README.md) / [Exports](../modules.md) / Canvas
-
-# Class: Canvas
-
-A wrapper around [`HTMLCanvasElement`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement)
-to provide some convience for double-buffered drawing.
-
-## Constructors
-
-### constructor
-
-• **new Canvas**(`canvas`, `width`, `height`): [`Canvas`](Canvas.md)
-
-Constructs a new [Canvas](Canvas.md).
-
-#### Parameters
-
-| Name     | Type                | Description               |
-| :------- | :------------------ | :------------------------ |
-| `canvas` | `HTMLCanvasElement` | The canvas to wrap.       |
-| `width`  | `number`            | The width of the canvas.  |
-| `height` | `number`            | The height of the canvas. |
-
-#### Returns
-
-[`Canvas`](Canvas.md)
-
-#### Defined in
-
-[graphics/canvas.ts:22](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L22)
-
-## Properties
-
-### buffer
-
-• `Readonly` **buffer**: `Uint8ClampedArray`
-
-#### Defined in
-
-[graphics/canvas.ts:14](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L14)
-
----
-
-### canvas
-
-• `Readonly` **canvas**: `HTMLCanvasElement`
-
-#### Defined in
-
-[graphics/canvas.ts:9](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L9)
-
----
-
-### context
-
-• `Readonly` **context**: `CanvasRenderingContext2D`
-
-#### Defined in
-
-[graphics/canvas.ts:12](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L12)
-
----
-
-### height
-
-• `Readonly` **height**: `number`
-
-#### Defined in
-
-[graphics/canvas.ts:11](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L11)
-
----
-
-### pixMap
-
-• `Readonly` **pixMap**: `ImageData`
-
-#### Defined in
-
-[graphics/canvas.ts:13](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L13)
-
----
-
-### width
-
-• `Readonly` **width**: `number`
-
-#### Defined in
-
-[graphics/canvas.ts:10](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L10)
-
-## Methods
-
-### clearWith
-
-▸ **clearWith**(`color`): `void`
-
-Fills the entire backbuffer with the given color.
-
-#### Parameters
-
-| Name    | Type     | Description                            |
-| :------ | :------- | :------------------------------------- |
-| `color` | `number` | The color to fill the backbuffer with. |
-
-#### Returns
-
-`void`
-
-#### Defined in
-
-[graphics/canvas.ts:75](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L75)
-
----
-
-### getPixel32
-
-▸ **getPixel32**(`x`, `y`): `number`
-
-Returns the color of a pixel in the backbuffer.
-
-#### Parameters
-
-| Name | Type     | Description                   |
-| :--- | :------- | :---------------------------- |
-| `x`  | `number` | The X coordinate to retrieve. |
-| `y`  | `number` | The X coordinate to retrieve. |
-
-#### Returns
-
-`number`
-
-The color of the pixel at the given local.
-
-#### Defined in
-
-[graphics/canvas.ts:47](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L47)
-
----
-
-### setPixel32
-
-▸ **setPixel32**(`x`, `y`, `color`): `void`
-
-Colors a pixel in the backbuffer.
-
-#### Parameters
-
-| Name    | Type     | Description                           |
-| :------ | :------- | :------------------------------------ |
-| `x`     | `number` | The X coordinate to color.            |
-| `y`     | `number` | The Y coordinate to color.            |
-| `color` | `number` | The color to place at the coordinate. |
-
-#### Returns
-
-`void`
-
-#### Defined in
-
-[graphics/canvas.ts:63](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L63)
-
----
-
-### update
-
-▸ **update**(): `void`
-
-Draws the backbuffer onto the canvas.
-
-#### Returns
-
-`void`
-
-#### Defined in
-
-[graphics/canvas.ts:37](https://github.com/oliversalzburg/js-utils/blob/293b24f/source/graphics/canvas.ts#L37)