@danielsimonjr/mathts-core 0.14.3 → 0.15.1

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASpD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAU7C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAoBrE,cAAc,cAAc,CAAC;AAM7B,OAAO,EACL,MAAM,IAAI,aAAa,EACvB,SAAS,EACT,MAAM,EACN,WAAW,EACX,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,MAAM,IAAI,eAAe,EACzB,aAAa,IAAI,sBAAsB,EACvC,aAAa,IAAI,sBAAsB,EACvC,OAAO,IAAI,gBAAgB,EAC3B,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAIlC,mBAAmB,4BAA4B,CAAC;AAMhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAe5F,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EACL,SAAS,EACT,QAAQ,EACR,uBAAuB,EACvB,aAAa,EACb,YAAY,EACZ,MAAM,EACN,OAAO,EACP,oBAAoB,EACpB,OAAO,EACP,SAAS,EACT,OAAO,EACP,GAAG,EACH,OAAO,EACP,MAAM,EACN,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,IAAI,EACJ,OAAO,EACP,MAAM,EACN,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,eAAe,EACf,OAAO,EACP,GAAG,IAAI,eAAe,EACtB,OAAO,IAAI,YAAY,EACvB,WAAW,IAAI,gBAAgB,EAC/B,KAAK,IAAI,UAAU,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,SAAS,EACT,QAAQ,EACR,MAAM,IAAI,SAAS,EACnB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAOlB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAc3E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/internal.js

@@ -87,6 +87,8 @@ var DimensionError = class _DimensionError extends RangeError {
   relation;
   isDimensionError = true;
   /**
+   * Create a DimensionError. When `actual` is a string and `expected` is not given, the string is the message.
+   *
    * @param actual - The actual size or custom error message
    * @param expected - The expected size (optional if actual is a custom message)
    * @param relation - Optional relation between actual and expected size: '!=', '<', etc.
@@ -1196,7 +1198,6 @@ var ObjectWrappingMap = class {
   [Symbol.iterator]() {
     return this.entries();
   }
-  // @ts-expect-error: Implementation is compatible but TS can't infer it
   keys() {
     return Object.keys(this.wrappedObject).filter((key) => this.has(key)).values();
   }
@@ -1210,11 +1211,25 @@ var ObjectWrappingMap = class {
   has(key) {
     return isSafeProperty(this.wrappedObject, key) && key in this.wrappedObject;
   }
-  // @ts-expect-error: Implementation is compatible but TS can't infer it
+  /**
+   * Return the value for `key`; when the key is absent, set it to `defaultValue` first.
+   * Declared because the ESNext `Map` (TC39 upsert) has it, and `implements Map` requires it.
+   */
+  getOrInsert(key, defaultValue) {
+    if (!this.has(key)) this.set(key, defaultValue);
+    return this.get(key);
+  }
+  /**
+   * Return the value for `key`; when the key is absent, set it to `callback(key)` first.
+   * Declared because the ESNext `Map` (TC39 upsert) has it, and `implements Map` requires it.
+   */
+  getOrInsertComputed(key, callback) {
+    if (!this.has(key)) this.set(key, callback(key));
+    return this.get(key);
+  }
   entries() {
     return mapIterator(this.keys(), (key) => [key, this.get(key)]);
   }
-  // @ts-expect-error: Implementation is compatible but TS can't infer it
   *values() {
     for (const key of this.keys()) {
       yield this.get(key);
@@ -1247,6 +1262,8 @@ var PartitionedMap = class {
   bKeys;
   [Symbol.toStringTag] = "PartitionedMap";
   /**
+   * Create a PartitionedMap over two maps.
+   *
    * @param a - Primary map
    * @param b - Secondary map
    * @param bKeys - Set of keys that should be read/written to map b
@@ -1274,17 +1291,30 @@ var PartitionedMap = class {
   has(key) {
     return this.b.has(key) || this.a.has(key);
   }
-  // @ts-expect-error: Implementation is compatible but TS can't infer it
+  /**
+   * Return the value for `key`; when the key is absent, set it to `defaultValue` first.
+   * Declared because the ESNext `Map` (TC39 upsert) has it, and `implements Map` requires it.
+   */
+  getOrInsert(key, defaultValue) {
+    if (!this.has(key)) this.set(key, defaultValue);
+    return this.get(key);
+  }
+  /**
+   * Return the value for `key`; when the key is absent, set it to `callback(key)` first.
+   * Declared because the ESNext `Map` (TC39 upsert) has it, and `implements Map` requires it.
+   */
+  getOrInsertComputed(key, callback) {
+    if (!this.has(key)) this.set(key, callback(key));
+    return this.get(key);
+  }
   keys() {
     return (/* @__PURE__ */ new Set([...this.a.keys(), ...this.b.keys()]))[Symbol.iterator]();
   }
-  // @ts-expect-error: Implementation is compatible but TS can't infer it
   *values() {
     for (const key of this.keys()) {
       yield this.get(key);
     }
   }
-  // @ts-expect-error: Implementation is compatible but TS can't infer it
   entries() {
     return mapIterator(this.keys(), (key) => [key, this.get(key)]);
   }

package/dist/is.d.ts

@@ -0,0 +1,256 @@
+/**
+ * Shape of a BigNumber value that the duck-typing guards in this module read.
+ */
+export interface BigNumber {
+    isBigNumber: boolean;
+    constructor: {
+        prototype: {
+            isBigNumber: boolean;
+        };
+        isDecimal?: (x: unknown) => boolean;
+    };
+}
+/**
+ * Shape of a complex number: real part `re` and imaginary part `im`.
+ */
+export interface Complex {
+    re: number;
+    im: number;
+}
+/**
+ * Shape of a fraction: numerator `n` and denominator `d`.
+ */
+export interface Fraction {
+    n: number;
+    d: number;
+}
+/**
+ * Shape of a Unit value that the duck-typing guards in this module read.
+ */
+export interface Unit {
+    constructor: {
+        prototype: {
+            isUnit: boolean;
+        };
+    };
+}
+/**
+ * Shape of a Matrix value that the duck-typing guards in this module read.
+ */
+export interface Matrix {
+    isMatrix?: boolean;
+    _size?: number[];
+    constructor: {
+        prototype: {
+            isMatrix: boolean;
+        };
+    };
+}
+/**
+ * Shape of a Matrix that also has the `isDenseMatrix` flag.
+ */
+export interface DenseMatrix extends Matrix {
+    isDenseMatrix: boolean;
+}
+/**
+ * Shape of a Matrix that also has the `isSparseMatrix` flag.
+ */
+export interface SparseMatrix extends Matrix {
+    isSparseMatrix: boolean;
+}
+/**
+ * Shape of a Range value: start, end and step.
+ */
+export interface Range {
+    start: number;
+    end: number;
+    step: number;
+    constructor: {
+        prototype: {
+            isRange: boolean;
+        };
+    };
+}
+/**
+ * Shape of one dimension of an Index.
+ */
+export interface IndexDimension {
+    _data?: unknown[];
+    _size: number[];
+    isRange?: boolean;
+    start?: number;
+    end?: number;
+}
+/**
+ * Shape of an Index value: its dimensions and the optional source size.
+ */
+export interface Index {
+    _dimensions: (IndexDimension | string)[];
+    _sourceSize?: (number | null)[];
+    constructor: {
+        prototype: {
+            isIndex: boolean;
+        };
+    };
+}
+/**
+ * Test whether a value is a primitive number.
+ *
+ * @param x - The value to test.
+ * @returns True when `typeof x` is `'number'`.
+ */
+export declare function isNumber(x: unknown): x is number;
+/**
+ * Test whether a value is a BigNumber.
+ *
+ * @param x - The value to test.
+ * @returns True when `x` and its constructor prototype both have `isBigNumber === true`, or when `x.constructor.isDecimal(x)` returns true.
+ */
+export declare function isBigNumber(x: unknown): x is BigNumber;
+/**
+ * Test whether a value is a primitive bigint.
+ *
+ * @param x - The value to test.
+ * @returns True when `typeof x` is `'bigint'`.
+ */
+export declare function isBigInt(x: unknown): x is bigint;
+/**
+ * Test whether a value is a Complex number.
+ *
+ * @param x - The value to test.
+ * @returns True when `x` is an object whose prototype has `isComplex === true`.
+ */
+export declare function isComplex(x: unknown): x is Complex;
+/**
+ * Test whether a value is a Fraction.
+ *
+ * @param x - The value to test.
+ * @returns True when `x` is an object whose prototype has `isFraction === true`.
+ */
+export declare function isFraction(x: unknown): x is Fraction;
+/**
+ * Test whether a value is a Unit.
+ *
+ * @param x - The value to test.
+ * @returns True when the constructor prototype of `x` has `isUnit === true`.
+ */
+export declare function isUnit(x: unknown): x is Unit;
+/**
+ * Test whether a value is a primitive string.
+ *
+ * @param x - The value to test.
+ * @returns True when `typeof x` is `'string'`.
+ */
+export declare function isString(x: unknown): x is string;
+export declare const isArray: (arg: any) => arg is any[];
+/**
+ * Test whether a value is a Matrix of any storage type.
+ *
+ * @param x - The value to test.
+ * @returns True when the constructor prototype of `x` has `isMatrix === true`.
+ */
+export declare function isMatrix(x: unknown): x is Matrix;
+/**
+ * Test whether a value is a collection: an Array or Matrix
+ * @param x
+ * @returns {boolean} isCollection
+ */
+export declare function isCollection(x: unknown): x is unknown[] | Matrix;
+/**
+ * Test whether a value is a DenseMatrix.
+ *
+ * @param x - The value to test.
+ * @returns True when `x` has `isDenseMatrix === true` and its constructor prototype has `isMatrix === true`.
+ */
+export declare function isDenseMatrix(x: unknown): x is DenseMatrix;
+/**
+ * Test whether a value is a SparseMatrix.
+ *
+ * @param x - The value to test.
+ * @returns True when `x` has `isSparseMatrix === true` and its constructor prototype has `isMatrix === true`.
+ */
+export declare function isSparseMatrix(x: unknown): x is SparseMatrix;
+/**
+ * Test whether a value is a Range.
+ *
+ * @param x - The value to test.
+ * @returns True when the constructor prototype of `x` has `isRange === true`.
+ */
+export declare function isRange(x: unknown): x is Range;
+/**
+ * Test whether a value is an Index.
+ *
+ * @param x - The value to test.
+ * @returns True when the constructor prototype of `x` has `isIndex === true`.
+ */
+export declare function isIndex(x: unknown): x is Index;
+/**
+ * Test whether a value is a primitive boolean.
+ *
+ * @param x - The value to test.
+ * @returns True when `typeof x` is `'boolean'`.
+ */
+export declare function isBoolean(x: unknown): x is boolean;
+/**
+ * Test whether a value is a function.
+ *
+ * @param x - The value to test.
+ * @returns True when `typeof x` is `'function'`.
+ */
+export declare function isFunction(x: unknown): x is (...args: unknown[]) => unknown;
+/**
+ * Test whether a value is a Date.
+ *
+ * @param x - The value to test.
+ * @returns True when `x` is an `instanceof Date`.
+ */
+export declare function isDate(x: unknown): x is Date;
+/**
+ * Test whether a value is a regular expression.
+ *
+ * @param x - The value to test.
+ * @returns True when `x` is an `instanceof RegExp`.
+ */
+export declare function isRegExp(x: unknown): x is RegExp;
+/**
+ * Test whether a value is a plain object.
+ *
+ * @param x - The value to test.
+ * @returns True when the constructor of `x` is `Object` and `x` is not a Complex or a Fraction.
+ */
+export declare function isObject(x: unknown): x is Record<string, unknown>;
+/**
+ * Returns `true` if the passed object appears to be a Map (i.e. duck typing).
+ *
+ * Methods looked for are `get`, `set`, `keys` and `has`.
+ *
+ * @param object
+ * @returns
+ */
+export declare function isMap(object: unknown): object is Map<unknown, unknown>;
+/**
+ * Test whether a value is null.
+ *
+ * @param x - The value to test.
+ * @returns True when `x === null`.
+ */
+export declare function isNull(x: unknown): x is null;
+/**
+ * Test whether a value is undefined.
+ *
+ * @param x - The value to test.
+ * @returns True when `x === undefined`.
+ */
+export declare function isUndefined(x: unknown): x is undefined;
+/**
+ * Get the type name of a value.
+ *
+ * For an object, the result is `'null'`, `'BigNumber'`, `'Complex'`, `'Fraction'`,
+ * the constructor name, or `'Object'`, in that order of test.
+ * For other values, the result is the `typeof` string.
+ *
+ * @param x - The value to examine.
+ * @returns The type name.
+ */
+export declare function typeOf(x: unknown): string;
+//# sourceMappingURL=is.d.ts.map

package/dist/is.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is.d.ts","sourceRoot":"","sources":["../src/is.ts"],"names":[],"mappings":"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"}

package/dist/map.d.ts

@@ -0,0 +1,147 @@
+/**
+ * A map facade on a bare object.
+ *
+ * The small number of methods needed to implement a scope,
+ * forwarding on to the SafeProperty functions. Over time, the codebase
+ * will stop using this method, as all objects will be Maps, rather than
+ * more security prone objects.
+ */
+/**
+ * The iterator type `Map` itself declares, derived from the installed TS lib
+ * rather than hard-coded: older libs say `IterableIterator<[K, V]>`, TS >= 5.6
+ * says `MapIterator<[K, V]>` (which additionally requires `[Symbol.dispose]`).
+ * Deriving it keeps `implements Map<K, V>` honest on every TS version.
+ */
+type MapEntryIterator<K, V> = ReturnType<Map<K, V>[typeof Symbol.iterator]>;
+/** The iterator type `Map.prototype.keys` declares, derived like `MapEntryIterator`. */
+type MapKeyIterator<K, V> = ReturnType<Map<K, V>['keys']>;
+/** The iterator type `Map.prototype.values` declares, derived like `MapEntryIterator`. */
+type MapValueIterator<K, V> = ReturnType<Map<K, V>['values']>;
+/** The iterator type `Map.prototype.entries` declares, derived like `MapEntryIterator`. */
+type MapEntriesIterator<K, V> = ReturnType<Map<K, V>['entries']>;
+/**
+ * A Map view of a plain object.
+ *
+ * The map does not copy the object. Reads use `getSafeProperty` and writes use
+ * `setSafeProperty` on the wrapped object.
+ */
+export declare class ObjectWrappingMap<K = string, V = unknown> implements Map<K, V> {
+    wrappedObject: Record<string, V>;
+    readonly [Symbol.toStringTag]: string;
+    constructor(object: Record<string, V>);
+    /**
+     * Declared as a real method rather than assigned in the constructor through a
+     * cast. The old form satisfied the runtime but never appeared in the emitted
+     * type, so `implements Map<K, V>` was a lie that only surfaced downstream:
+     * consumers compiling with `skipLibCheck: false` got TS2420 ("incorrectly
+     * implements interface 'Map'... '[Symbol.iterator]' is missing").
+     */
+    [Symbol.iterator](): MapEntryIterator<K, V>;
+    keys(): MapKeyIterator<K, V>;
+    get(key: K): V | undefined;
+    set(key: K, value: V): this;
+    has(key: K): boolean;
+    /**
+     * Return the value for `key`; when the key is absent, set it to `defaultValue` first.
+     * Declared because the ESNext `Map` (TC39 upsert) has it, and `implements Map` requires it.
+     */
+    getOrInsert(key: K, defaultValue: V): V;
+    /**
+     * Return the value for `key`; when the key is absent, set it to `callback(key)` first.
+     * Declared because the ESNext `Map` (TC39 upsert) has it, and `implements Map` requires it.
+     */
+    getOrInsertComputed(key: K, callback: (key: K) => V): V;
+    entries(): MapEntriesIterator<K, V>;
+    values(): MapValueIterator<K, V>;
+    forEach(callback: (value: V, key: K, map: Map<K, V>) => void): void;
+    delete(key: K): boolean;
+    clear(): void;
+    get size(): number;
+}
+/**
+ * Create a map with two partitions: a and b.
+ * The set with bKeys determines which keys/values are read/written to map b,
+ * all other values are read/written to map a
+ *
+ * For example:
+ *
+ *   const a = new Map()
+ *   const b = new Map()
+ *   const p = new PartitionedMap(a, b, new Set(['x', 'y']))
+ *
+ * In this case, values `x` and `y` are read/written to map `b`,
+ * all other values are read/written to map `a`.
+ */
+export declare class PartitionedMap<K = unknown, V = unknown> implements Map<K, V> {
+    a: Map<K, V>;
+    b: Map<K, V>;
+    bKeys: Set<K>;
+    readonly [Symbol.toStringTag]: string;
+    /**
+     * Create a PartitionedMap over two maps.
+     *
+     * @param a - Primary map
+     * @param b - Secondary map
+     * @param bKeys - Set of keys that should be read/written to map b
+     */
+    constructor(a: Map<K, V>, b: Map<K, V>, bKeys: Set<K>);
+    /** See the note on `ObjectWrappingMap[Symbol.iterator]` — same fix. */
+    [Symbol.iterator](): MapEntryIterator<K, V>;
+    get(key: K): V | undefined;
+    set(key: K, value: V): this;
+    has(key: K): boolean;
+    /**
+     * Return the value for `key`; when the key is absent, set it to `defaultValue` first.
+     * Declared because the ESNext `Map` (TC39 upsert) has it, and `implements Map` requires it.
+     */
+    getOrInsert(key: K, defaultValue: V): V;
+    /**
+     * Return the value for `key`; when the key is absent, set it to `callback(key)` first.
+     * Declared because the ESNext `Map` (TC39 upsert) has it, and `implements Map` requires it.
+     */
+    getOrInsertComputed(key: K, callback: (key: K) => V): V;
+    keys(): MapKeyIterator<K, V>;
+    values(): MapValueIterator<K, V>;
+    entries(): MapEntriesIterator<K, V>;
+    forEach(callback: (value: V, key: K, map: Map<K, V>) => void): void;
+    delete(key: K): boolean;
+    clear(): void;
+    get size(): number;
+}
+/**
+ * Creates an empty map, or whatever your platform's polyfill is.
+ *
+ * @returns an empty Map or Map like object.
+ */
+export declare function createEmptyMap<K = string, V = unknown>(): Map<K, V>;
+/**
+ * Creates a Map from the given object.
+ *
+ * @param mapOrObject - Map or object to convert
+ * @returns Map instance
+ */
+export declare function createMap<K = string, V = unknown>(mapOrObject?: Map<K, V> | Record<string, V> | null): Map<K, V>;
+/**
+ * Unwraps a map into an object.
+ *
+ * @param map - Map to convert to object
+ * @returns Plain object
+ */
+export declare function toObject<V = unknown>(map: Map<unknown, V>): Record<string, V>;
+/**
+ * Copies the contents of key-value pairs from each `objects` in to `map`.
+ *
+ * Object is `objects` can be a `Map` or object.
+ *
+ * This is the `Map` analog to `Object.assign`.
+ */
+export declare function assign<K = unknown, V = unknown>(map: Map<K, V>, ...objects: (Map<K, V> | Record<string, V> | null | undefined)[]): Map<K, V>;
+/**
+ * Returns `true` if `object` is an {@link ObjectWrappingMap}.
+ *
+ * Defined here, next to the class it guards, so `is.ts` need not import
+ * `map.ts` — that import was the sole edge closing the `is`/`map` cycle.
+ */
+export declare function isObjectWrappingMap(object: unknown): object is ObjectWrappingMap;
+export {};
+//# sourceMappingURL=map.d.ts.map

package/dist/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../src/map.ts"],"names":[],"mappings":"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"}