npm - @thi.ng/api - Versions diffs - 8.0.3 → 8.2.0 - Mend

@thi.ng/api 8.0.3 → 8.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -3,25 +3,29 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-## [8.0.3](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@8.0.2...@thi.ng/api@8.0.3) (2021-10-15)
+# [8.2.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@8.1.0...@thi.ng/api@8.2.0) (2021-11-10)
-**Note:** Version bump only for package @thi.ng/api
+### Bug Fixes
+* **api:** add missing module exports ([fc8805e](https://github.com/thi-ng/umbrella/commit/fc8805eb26a828d4ee9683c714a73a7ad35ef16c))
+### Features
+* **api:** update IGrid types, add mixins ([f0f3236](https://github.com/thi-ng/umbrella/commit/f0f3236448e7277e089654c725d2b9335bd4706a))
-## [8.0.2](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@8.0.1...@thi.ng/api@8.0.2) (2021-10-15)
-**Note:** Version bump only for package @thi.ng/api
+# [8.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@8.0.6...@thi.ng/api@8.1.0) (2021-11-03)
-## [8.0.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@8.0.0...@thi.ng/api@8.0.1) (2021-10-13)
+### Features
-**Note:** Version bump only for package @thi.ng/api
+* **api:** add asInt() coercion helper ([49cd772](https://github.com/thi-ng/umbrella/commit/49cd772a328b7c71fb16ed3041e03832ebd1f884))
+* **api:** add IGrid2D/3D interfaces ([e57ad7e](https://github.com/thi-ng/umbrella/commit/e57ad7e8139512bf4146c4c70ef693b810eee24a))
@@ -78,31 +82,31 @@ Also:
-#  [7.2.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@7.1.9...@thi.ng/api@7.2.0) (2021-09-03)
+#  [7.2.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@7.1.9...@thi.ng/api@7.2.0) (2021-09-03)
-###  Features
+###  Features
-- **api:** add DeepArrayValue type ([a309fac](https://github.com/thi-ng/umbrella/commit/a309faca831651f611b9b056d9c7587f85b60087))
+- **api:** add DeepArrayValue type ([a309fac](https://github.com/thi-ng/umbrella/commit/a309faca831651f611b9b056d9c7587f85b60087))
-#  [7.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@7.0.0...@thi.ng/api@7.1.0) (2021-03-03)
+#  [7.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@7.0.0...@thi.ng/api@7.1.0) (2021-03-03)
-###  Features
+###  Features
-- **api:** add StringOrSym type alias ([fb92c9d](https://github.com/thi-ng/umbrella/commit/fb92c9d93b4e795f60118e1167d5adb1bb108380))
+- **api:** add StringOrSym type alias ([fb92c9d](https://github.com/thi-ng/umbrella/commit/fb92c9d93b4e795f60118e1167d5adb1bb108380))
-#  [7.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@6.13.6...@thi.ng/api@7.0.0) (2021-02-20)
+#  [7.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@6.13.6...@thi.ng/api@7.0.0) (2021-02-20)
-###  Features
+###  Features
-- **api:** add Range type ([5d94974](https://github.com/thi-ng/umbrella/commit/5d94974c34ca81513d40743f2a9b9a3ed20146d3))
-- **api:** add typedArrayType() classifier ([5c81fd8](https://github.com/thi-ng/umbrella/commit/5c81fd859514401c2c419b2ed3ec0f12025356c3))
-- **api:** more finely grained typedarray types ([8316d05](https://github.com/thi-ng/umbrella/commit/8316d058f0b5f760afd89e8590619670210a970a))
-- **api:** replace Type enum w/ strings consts ([a333d41](https://github.com/thi-ng/umbrella/commit/a333d418222972373cc1f9b256def2f79610d3fa))
+- **api:** add Range type ([5d94974](https://github.com/thi-ng/umbrella/commit/5d94974c34ca81513d40743f2a9b9a3ed20146d3))
+- **api:** add typedArrayType() classifier ([5c81fd8](https://github.com/thi-ng/umbrella/commit/5c81fd859514401c2c419b2ed3ec0f12025356c3))
+- **api:** more finely grained typedarray types ([8316d05](https://github.com/thi-ng/umbrella/commit/8316d058f0b5f760afd89e8590619670210a970a))
+- **api:** replace Type enum w/ strings consts ([a333d41](https://github.com/thi-ng/umbrella/commit/a333d418222972373cc1f9b256def2f79610d3fa))
-###  BREAKING CHANGES
+###  BREAKING CHANGES
-- **api:** replace Type enum w/ string consts
-    - update Type, UintType, IntType, FloatType aliases
+- **api:** replace Type enum w/ string consts
+    - update Type, UintType, IntType, FloatType aliases
     - update GL2TYPE, TYPE2GL, SIZEOF, TYPEDARRAY_CTORS tables
 - add asNativeType(), asGLType() conversions
 - add sizeOf()
@@ -228,156 +232,156 @@ Also:
 ### Features
 - **api:** add common logging types & default impls ([4578604](https://github.com/thi-ng/umbrella/commit/4578604))
-- **api:** update ILogger, freeze NULL_LOGGER ([27ff8de](https://github.com/thi-ng/umbrella/commit/27ff8de))
+- **api:** update ILogger, freeze NULL_LOGGER ([27ff8de](https://github.com/thi-ng/umbrella/commit/27ff8de))
-#  [6.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@5.1.0...@thi.ng/api@6.0.0) (2019-03-28)
+#  [6.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@5.1.0...@thi.ng/api@6.0.0) (2019-03-28)
-###  Features
+###  Features
-- **api:** add new types, update existing ([560eb90](https://github.com/thi-ng/umbrella/commit/560eb90))
+- **api:** add new types, update existing ([560eb90](https://github.com/thi-ng/umbrella/commit/560eb90))
-###  BREAKING CHANGES
+###  BREAKING CHANGES
-- **api:** split up, remove & update various interfaces
-    - split IAssociative => IAssoc, IAssocIn
-    - update IDissoc, add IDissocIn
-    - split IGet => IGet, IGetIn
-    - update IInto generics & return type
-    - update ISet, remove IImmutableSet
-    - update IStack, remove IImmutableStack
+- **api:** split up, remove & update various interfaces
+    - split IAssociative => IAssoc, IAssocIn
+    - update IDissoc, add IDissocIn
+    - split IGet => IGet, IGetIn
+    - update IInto generics & return type
+    - update ISet, remove IImmutableSet
+    - update IStack, remove IImmutableStack
-#  [5.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@5.0.3...@thi.ng/api@5.1.0) (2019-03-10)
+#  [5.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@5.0.3...@thi.ng/api@5.1.0) (2019-03-10)
-###  Features
+###  Features
-- **api:** add additional Fn arities ([33c7dfe](https://github.com/thi-ng/umbrella/commit/33c7dfe))
-- **api:** add more Fn type aliases, update existing ([3707e61](https://github.com/thi-ng/umbrella/commit/3707e61))
+- **api:** add additional Fn arities ([33c7dfe](https://github.com/thi-ng/umbrella/commit/33c7dfe))
+- **api:** add more Fn type aliases, update existing ([3707e61](https://github.com/thi-ng/umbrella/commit/3707e61))
-#  [5.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@4.2.4...@thi.ng/api@5.0.0) (2019-01-21)
+#  [5.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@4.2.4...@thi.ng/api@5.0.0) (2019-01-21)
-###  Bug Fixes
+###  Bug Fixes
-- **api:** update assert(), re-export mixin() ([9f91cfa](https://github.com/thi-ng/umbrella/commit/9f91cfa))
+- **api:** update assert(), re-export mixin() ([9f91cfa](https://github.com/thi-ng/umbrella/commit/9f91cfa))
-###  Build System
+###  Build System
-- **api:** update package build scripts / outputs ([f913d7b](https://github.com/thi-ng/umbrella/commit/f913d7b))
+- **api:** update package build scripts / outputs ([f913d7b](https://github.com/thi-ng/umbrella/commit/f913d7b))
-###  Features
+###  Features
-- **api:** add assert() ([d381ace](https://github.com/thi-ng/umbrella/commit/d381ace))
+- **api:** add assert() ([d381ace](https://github.com/thi-ng/umbrella/commit/d381ace))
-###  BREAKING CHANGES
+###  BREAKING CHANGES
-- **api:** rename mixins to avoid name clashes, update decorators
-    - append `Mixin` suffix to all mixins (i.e. `INotify` => `INotifyMixin`)
-    - update re-exports of mixins & decorators (no more nested child namespace)
+- **api:** rename mixins to avoid name clashes, update decorators
+    - append `Mixin` suffix to all mixins (i.e. `INotify` => `INotifyMixin`)
+    - update re-exports of mixins & decorators (no more nested child namespace)
-#  [4.2.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@4.1.1...@thi.ng/api@4.2.0) (2018-09-22)
+#  [4.2.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@4.1.1...@thi.ng/api@4.2.0) (2018-09-22)
-###  Features
+###  Features
-- **api:** add `IToHiccup` interface ([e390a54](https://github.com/thi-ng/umbrella/commit/e390a54))
+- **api:** add `IToHiccup` interface ([e390a54](https://github.com/thi-ng/umbrella/commit/e390a54))
-#  [4.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@4.0.6...@thi.ng/api@4.1.0) (2018-08-24)
+#  [4.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@4.0.6...@thi.ng/api@4.1.0) (2018-08-24)
-###  Features
+###  Features
-- **api:** add new/move type aliases into api.ts ([cf30ba2](https://github.com/thi-ng/umbrella/commit/cf30ba2))
-- **api:** add NumericArray and TypedArray types ([519394b](https://github.com/thi-ng/umbrella/commit/519394b))
+- **api:** add new/move type aliases into api.ts ([cf30ba2](https://github.com/thi-ng/umbrella/commit/cf30ba2))
+- **api:** add NumericArray and TypedArray types ([519394b](https://github.com/thi-ng/umbrella/commit/519394b))
-#  [4.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@3.0.1...@thi.ng/api@4.0.0) (2018-05-12)
+#  [4.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@3.0.1...@thi.ng/api@4.0.0) (2018-05-12)
-###  Code Refactoring
+###  Code Refactoring
-- **api:** update interfaces, add docs ([9b38860](https://github.com/thi-ng/umbrella/commit/9b38860))
+- **api:** update interfaces, add docs ([9b38860](https://github.com/thi-ng/umbrella/commit/9b38860))
-###  BREAKING CHANGES
+###  BREAKING CHANGES
-- **api:** IBind, IEnable now include generics, update IIndexed, IMeta, ISet, IStack
-    - add IInto
-    - add IImmutableSet
-    - add IImmutableStack
-    - minor update IEnabled mixin
+- **api:** IBind, IEnable now include generics, update IIndexed, IMeta, ISet, IStack
+    - add IInto
+    - add IImmutableSet
+    - add IImmutableStack
+    - minor update IEnabled mixin
-#  [3.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.3.2...@thi.ng/api@3.0.0) (2018-05-10)
+#  [3.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.3.2...@thi.ng/api@3.0.0) (2018-05-10)
-###  Code Refactoring
+###  Code Refactoring
-- **api:** remove obsolete files from package ([f051ca3](https://github.com/thi-ng/umbrella/commit/f051ca3))
+- **api:** remove obsolete files from package ([f051ca3](https://github.com/thi-ng/umbrella/commit/f051ca3))
-###  BREAKING CHANGES
+###  BREAKING CHANGES
-- **api:** @thi.ng/api now only contains type declarations, decorators and mixins. All other features have been moved to new dedicated packages:
-    - @thi.ng/bench
-    - @thi.ng/compare
-    - @thi.ng/equiv
-    - @thi.ng/errors
+- **api:** @thi.ng/api now only contains type declarations, decorators and mixins. All other features have been moved to new dedicated packages:
+    - @thi.ng/bench
+    - @thi.ng/compare
+    - @thi.ng/equiv
+    - @thi.ng/errors
-##  [2.3.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.3.0...@thi.ng/api@2.3.1) (2018-04-29)
+##  [2.3.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.3.0...@thi.ng/api@2.3.1) (2018-04-29)
-###  Performance Improvements
+###  Performance Improvements
-- **api:** major speedup equivObject(), update equivSet() ([7fdf172](https://github.com/thi-ng/umbrella/commit/7fdf172))
+- **api:** major speedup equivObject(), update equivSet() ([7fdf172](https://github.com/thi-ng/umbrella/commit/7fdf172))
-#  [2.3.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.2.0...@thi.ng/api@2.3.0) (2018-04-26)
+#  [2.3.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.2.0...@thi.ng/api@2.3.0) (2018-04-26)
-###  Features
+###  Features
-- **api:** support more types in equiv(), add tests ([2ac8bff](https://github.com/thi-ng/umbrella/commit/2ac8bff))
+- **api:** support more types in equiv(), add tests ([2ac8bff](https://github.com/thi-ng/umbrella/commit/2ac8bff))
-#  [2.2.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.1.3...@thi.ng/api@2.2.0) (2018-04-08)
+#  [2.2.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.1.3...@thi.ng/api@2.2.0) (2018-04-08)
-###  Features
+###  Features
-- **api:** add bench() & timed() utils ([d310345](https://github.com/thi-ng/umbrella/commit/d310345))
+- **api:** add bench() & timed() utils ([d310345](https://github.com/thi-ng/umbrella/commit/d310345))
-##  [2.1.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.1.0...@thi.ng/api@2.1.1) (2018-03-28)
+##  [2.1.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.1.0...@thi.ng/api@2.1.1) (2018-03-28)
-###  Bug Fixes
+###  Bug Fixes
-- **api:** illegalState() creates IllegalStateError ([2b7e99b](https://github.com/thi-ng/umbrella/commit/2b7e99b))
+- **api:** illegalState() creates IllegalStateError ([2b7e99b](https://github.com/thi-ng/umbrella/commit/2b7e99b))
-#  [2.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.0.4...@thi.ng/api@2.1.0) (2018-03-21)
+#  [2.1.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.0.4...@thi.ng/api@2.1.0) (2018-03-21)
-###  Features
+###  Features
-- **api:** add error types & ctor fns ([4d3785f](https://github.com/thi-ng/umbrella/commit/4d3785f))
+- **api:** add error types & ctor fns ([4d3785f](https://github.com/thi-ng/umbrella/commit/4d3785f))
-##  [2.0.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.0.0...@thi.ng/api@2.0.1) (2018-02-02)
+##  [2.0.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@2.0.0...@thi.ng/api@2.0.1) (2018-02-02)
-###  Bug Fixes
+###  Bug Fixes
-- **api:** update compare() & equiv() ([110a9de](https://github.com/thi-ng/umbrella/commit/110a9de))
+- **api:** update compare() & equiv() ([110a9de](https://github.com/thi-ng/umbrella/commit/110a9de))
-#  [2.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@1.5.0...@thi.ng/api@2.0.0) (2018-02-01)
+#  [2.0.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@1.5.0...@thi.ng/api@2.0.0) (2018-02-01)
-###  Bug Fixes
+###  Bug Fixes
-- **api:** fix equiv string handling, update tests ([1354e29](https://github.com/thi-ng/umbrella/commit/1354e29))
+- **api:** fix equiv string handling, update tests ([1354e29](https://github.com/thi-ng/umbrella/commit/1354e29))
-###  Features
+###  Features
-- **api:** update equiv() null handling, add tests ([878520e](https://github.com/thi-ng/umbrella/commit/878520e))
+- **api:** update equiv() null handling, add tests ([878520e](https://github.com/thi-ng/umbrella/commit/878520e))
-###  BREAKING CHANGES
+###  BREAKING CHANGES
-- **api:** equiv now treats null & undefined as equal
+- **api:** equiv now treats null & undefined as equal
-#  [1.5.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@1.4.2...@thi.ng/api@1.5.0) (2018-01-31)
+#  [1.5.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@1.4.2...@thi.ng/api@1.5.0) (2018-01-31)
-###  Features
+###  Features
-- **api:** add Predicate2 & StatefulPredicate2 types ([fbf8453](https://github.com/thi-ng/umbrella/commit/fbf8453))
+- **api:** add Predicate2 & StatefulPredicate2 types ([fbf8453](https://github.com/thi-ng/umbrella/commit/fbf8453))
-#  [1.4.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@1.3.0...@thi.ng/api@1.4.0) (2018-01-29)
+#  [1.4.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@1.3.0...@thi.ng/api@1.4.0) (2018-01-29)
-###  Features
+###  Features
-- **api:** update IWatch & mixin, boolean returns ([bddd5ce](https://github.com/thi-ng/umbrella/commit/bddd5ce))
+- **api:** update IWatch & mixin, boolean returns ([bddd5ce](https://github.com/thi-ng/umbrella/commit/bddd5ce))
-#  [1.3.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@1.2.1...@thi.ng/api@1.3.0) (2018-01-28)
+#  [1.3.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@1.2.1...@thi.ng/api@1.3.0) (2018-01-28)
-###  Features
+###  Features
 - **api:** add StatefulPredicate ([c74353b](https://github.com/thi-ng/umbrella/commit/c74353b))

package/README.md CHANGED Viewed

@@ -60,7 +60,7 @@ node --experimental-repl-await
 > const api = await import("@thi.ng/api");
 ```
-Package sizes (gzipped, pre-treeshake): ESM: 1.73 KB
+Package sizes (gzipped, pre-treeshake): ESM: 2.27 KB
 ## Dependencies

package/grid.d.ts ADDED Viewed

@@ -0,0 +1,351 @@
+import type { NumericArray, TypedArray } from "./typedarray.js";
+export interface INDBase<BUF extends any[] | TypedArray = any[]> {
+    size: NumericArray;
+    stride: NumericArray;
+    offset: number;
+    data: BUF;
+    readonly dim: number;
+    order(): number[];
+}
+/**
+ * Semi-typechecked interface for cases accepting 1D-4D grids, i.e.
+ * {@link IGrid1D} - {@link IGrid4D}.
+ */
+export interface IGridND<BUF extends any[] | TypedArray = any[], T = any> extends INDBase<BUF> {
+    /**
+     * Returns true if given position is valid (i.e. within grid bounds).
+     *
+     * @param pos -
+     */
+    includes(...pos: [number] | [number, number] | [number, number, number] | [number, number, number, number]): boolean;
+    /**
+     * Returns index for given position. Returns negative value if outside the
+     * grid's defined region.
+     *
+     * @param pos -
+     */
+    indexAt(...pos: [number] | [number, number] | [number, number, number] | [number, number, number, number]): number;
+    /**
+     * Non-boundschecked version of {@link IGridND.indexAt}. Assumes given
+     * position is valid.
+     *
+     * @param pos -
+     */
+    indexAtUnsafe(...pos: [number] | [number, number] | [number, number, number] | [number, number, number, number]): number;
+    /**
+     * Returns value at given position. If outside the grid's defined region,
+     * returns a suitable zero value.
+     *
+     * @param pos -
+     */
+    getAt(...pos: [number] | [number, number] | [number, number, number] | [number, number, number, number]): T;
+    /**
+     * Non-boundschecked version of {@link IGridND.getAt}. Assumes given
+     * position is valid.
+     *
+     * @param pos -
+     */
+    getAtUnsafe(...pos: [number] | [number, number] | [number, number, number] | [number, number, number, number]): T;
+    /**
+     * Writes value at given position. Has no effect if outside of the defined
+     * region. Returns true, if succeeded.
+     *
+     * @param args -
+     */
+    setAt(...args: [number, T] | [number, number, T] | [number, number, number, T] | [number, number, number, number, T]): boolean;
+    /**
+     * Non-boundschecked version of {@link IGridND.setAt}. Assumes given
+     * position is valid. Returns true, if succeeded.
+     *
+     * @param args -
+     */
+    setAtUnsafe(...args: [number, T] | [number, number, T] | [number, number, number, T] | [number, number, number, number, T]): boolean;
+}
+/**
+ * Gridlike container for 1D accessible data.
+ *
+ * @remarks
+ * See {@link IGrid1DMixin} for mixin implementation.
+ */
+export interface IGrid1D<BUF extends any[] | TypedArray = any[], T = any> extends INDBase<BUF> {
+    readonly dim: 1;
+    /**
+     * Returns true if given position is valid (i.e. within grid bounds).
+     *
+     * @param d0 -
+     */
+    includes(d0: number): boolean;
+    /**
+     * Returns index for given position. Returns negative value if outside the
+     * grid's defined region.
+     *
+     * @param d0 -
+     */
+    indexAt(d0: number): number;
+    /**
+     * Non-boundschecked version of {@link IGrid1D.indexAt}. Assumes given
+     * position is valid.
+     *
+     * @param d0 -
+     */
+    indexAtUnsafe(d0: number): number;
+    /**
+     * Returns value at given position. If outside the grid's defined region,
+     * returns a suitable zero value.
+     *
+     * @param d0 -
+     */
+    getAt(d0: number): T;
+    /**
+     * Non-boundschecked version of {@link IGrid1D.getAt}. Assumes given
+     * position is valid.
+     *
+     * @param d0 -
+     */
+    getAtUnsafe(d0: number): T;
+    /**
+     * Writes value at given position. Has no effect if outside of the defined
+     * region. Returns true, if succeeded.
+     *
+     * @param d0 -
+     * @param value -
+     */
+    setAt(d0: number, value: T): boolean;
+    /**
+     * Non-boundschecked version of {@link IGrid1D.setAt}. Assumes given
+     * position is valid. Returns true, if succeeded.
+     *
+     * @param d0 -
+     * @param value -
+     */
+    setAtUnsafe(d0: number, value: T): boolean;
+}
+/**
+ * Gridlike container for 2D accessible data.
+ *
+ * @remarks
+ * See {@link IGrid2DMixin} for mixin implementation.
+ */
+export interface IGrid2D<BUF extends any[] | TypedArray = any[], T = any> extends INDBase<BUF> {
+    readonly dim: 2;
+    /**
+     * Returns true if given position is valid (i.e. within grid bounds).
+     *
+     * @param d0 -
+     * @param d1 -
+     */
+    includes(d0: number, d1: number): boolean;
+    /**
+     * Returns index for given position (stated in same order as
+     * {@link IGrid2D.size} and {@link IGrid2D.stride}). Returns negative value
+     * if outside the grid's defined region.
+     *
+     * @param d0 -
+     * @param d1 -
+     */
+    indexAt(d0: number, d1: number): number;
+    /**
+     * Non-boundschecked version of {@link IGrid2D.indexAt}. Assumes given
+     * position is valid.
+     *
+     * @param d0 -
+     * @param d1 -
+     */
+    indexAtUnsafe(d0: number, d1: number): number;
+    /**
+     * Returns value at given position (given in same order as
+     * {@link IGrid2D.size} and {@link IGrid2D.stride}). If outside the grid's
+     * defined region, returns a suitable zero value.
+     *
+     * @param d0 -
+     * @param d1 -
+     */
+    getAt(d0: number, d1: number): T;
+    /**
+     * Non-boundschecked version of {@link IGrid2D.getAt}. Assumes given
+     * position is valid.
+     *
+     * @param d0 -
+     * @param d1 -
+     */
+    getAtUnsafe(d0: number, d1: number): T;
+    /**
+     * Writes value at given position (given in same order as
+     * {@link IGrid2D.size} and {@link IGrid2D.stride}). Has no effect if
+     * outside of the defined region. Returns true, if succeeded.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param value -
+     */
+    setAt(d0: number, d1: number, value: T): boolean;
+    /**
+     * Non-boundschecked version of {@link IGrid2D.setAt}. Assumes given
+     * position is valid. Returns true, if succeeded.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param value -
+     */
+    setAtUnsafe(d0: number, d1: number, value: T): boolean;
+}
+/**
+ * Gridlike container for 3D accessible data.
+ *
+ * @remarks
+ * See {@link IGrid3DMixin} for mixin implementation.
+ */
+export interface IGrid3D<BUF extends any[] | TypedArray = any[], T = any> extends INDBase<BUF> {
+    readonly dim: 3;
+    /**
+     * Returns true if given position is valid (i.e. within grid bounds).
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     */
+    includes(d0: number, d1: number, d2: number): boolean;
+    /**
+     * Returns index for given position (stated in same order as
+     * {@link IGrid3D.size} and {@link IGrid3D.stride}). Returns negative value
+     * if outside the grid's defined region.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     */
+    indexAt(d0: number, d1: number, d2: number): number;
+    /**
+     * Non-boundschecked version of {@link IGrid3D.indexAt}. Assumes given
+     * position is valid.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     */
+    indexAtUnsafe(d0: number, d1: number, d2: number): number;
+    /**
+     * Returns value at given position (given in same order as
+     * {@link IGrid3D.size} and {@link IGrid3D.stride}). If outside the grid's
+     * defined region, returns a suitable zero value.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     */
+    getAt(d0: number, d1: number, d2: number): T;
+    /**
+     * Non-boundschecked version of {@link IGrid3D.getAt}. Assumes given
+     * position is valid.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     */
+    getAtUnsafe(d0: number, d1: number, d2: number): T;
+    /**
+     * Writes value at given position (given in same order as
+     * {@link IGrid3D.size} and {@link IGrid3D.stride}). Has no effect if
+     * outside of the defined region. Returns true, if succeeded.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param value -
+     */
+    setAt(d0: number, d1: number, d2: number, value: T): boolean;
+    /**
+     * Non-boundschecked version of {@link IGrid3D.setAt}. Assumes given
+     * position is valid. Returns true, if succeeded.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param value -
+     */
+    setAtUnsafe(d0: number, d1: number, d2: number, value: T): boolean;
+}
+/**
+ * Gridlike container for 4D accessible data.
+ *
+ * @remarks
+ * See {@link IGrid4DMixin} for mixin implementation.
+ */
+export interface IGrid4D<BUF extends any[] | TypedArray = any[], T = any> extends INDBase<BUF> {
+    readonly dim: 4;
+    /**
+     * Returns true if given position is valid (i.e. within grid bounds).
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param d3 -
+     */
+    includes(d0: number, d1: number, d2: number, d3: number): boolean;
+    /**
+     * Returns index for given position (stated in same order as
+     * {@link IGrid4D.size} and {@link IGrid4D.stride}). Returns negative value
+     * if outside the grid's defined region.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param d3 -
+     */
+    indexAt(d0: number, d1: number, d2: number, d3: number): number;
+    /**
+     * Non-boundschecked version of {@link IGrid4D.indexAt}. Assumes given
+     * position is valid.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param d3 -
+     */
+    indexAtUnsafe(d0: number, d1: number, d2: number, d3: number): number;
+    /**
+     * Returns value at given position (given in same order as
+     * {@link IGrid4D.size} and {@link IGrid4D.stride}). If outside the grid's
+     * defined region, returns a suitable zero value.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param d3 -
+     */
+    getAt(d0: number, d1: number, d2: number, d3: number): T;
+    /**
+     * Non-boundschecked version of {@link IGrid4D.getAt}. Assumes given
+     * position is valid.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param d3 -
+     */
+    getAtUnsafe(d0: number, d1: number, d2: number, d3: number): T;
+    /**
+     * Writes value at given position (given in same order as
+     * {@link IGrid4D.size} and {@link IGrid4D.stride}). Has no effect if
+     * outside of the defined region. Returns true, if succeeded.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param d3 -
+     * @param value -
+     */
+    setAt(d0: number, d1: number, d2: number, d3: number, value: T): boolean;
+    /**
+     * Non-boundschecked version of {@link IGrid4D.setAt}. Assumes given
+     * position is valid. Returns true, if succeeded.
+     *
+     * @param d0 -
+     * @param d1 -
+     * @param d2 -
+     * @param d3 -
+     * @param value -
+     */
+    setAtUnsafe(d0: number, d1: number, d2: number, d3: number, value: T): boolean;
+}
+//# sourceMappingURL=grid.d.ts.map

package/grid.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/index.d.ts CHANGED Viewed

@@ -13,6 +13,7 @@ export * from "./equiv.js";
 export * from "./event.js";
 export * from "./fn.js";
 export * from "./get.js";
+export * from "./grid.js";
 export * from "./hash.js";
 export * from "./hiccup.js";
 export * from "./id.js";
@@ -43,6 +44,7 @@ export * from "./decorators/deprecated.js";
 export * from "./decorators/nomixin.js";
 export * from "./decorators/sealed.js";
 export * from "./mixins/ienable.js";
+export * from "./mixins/igrid.js";
 export * from "./mixins/inotify.js";
 export * from "./mixins/iterable.js";
 export * from "./mixins/iwatch.js";

package/index.js CHANGED Viewed

@@ -13,6 +13,7 @@ export * from "./equiv.js";
 export * from "./event.js";
 export * from "./fn.js";
 export * from "./get.js";
+export * from "./grid.js";
 export * from "./hash.js";
 export * from "./hiccup.js";
 export * from "./id.js";
@@ -43,6 +44,7 @@ export * from "./decorators/deprecated.js";
 export * from "./decorators/nomixin.js";
 export * from "./decorators/sealed.js";
 export * from "./mixins/ienable.js";
+export * from "./mixins/igrid.js";
 export * from "./mixins/inotify.js";
 export * from "./mixins/iterable.js";
 export * from "./mixins/iwatch.js";

package/mixins/igrid.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * Default implementation for {@link IGrid1D} methods.
+ */
+export declare const IGrid1DMixin: (clazz: any) => any;
+/**
+ * Default implementation for {@link IGrid2D} methods.
+ */
+export declare const IGrid2DMixin: (clazz: any) => any;
+/**
+ * Default implementation for {@link IGrid3D} methods.
+ */
+export declare const IGrid3DMixin: (clazz: any) => any;
+/**
+ * Default implementation for {@link IGrid4D} methods.
+ */
+export declare const IGrid4DMixin: (clazz: any) => any;
+//# sourceMappingURL=igrid.d.ts.map

package/mixins/igrid.js ADDED Viewed

@@ -0,0 +1,163 @@
+import { mixin } from "../mixin.js";
+/**
+ * Default implementation for {@link IGrid1D} methods.
+ */
+export const IGrid1DMixin = mixin({
+    order() {
+        return [0];
+    },
+    includes(x) {
+        return x >= 0 && x < this.size[0];
+    },
+    indexAt(x) {
+        return this.includes(x) ? this.indexAtUnsafe(x) : -1;
+    },
+    indexAtUnsafe(x) {
+        return this.offset + (x | 0) * this.stride[0];
+    },
+    getAt(x) {
+        return this.includes(x) ? this.data[this.indexAtUnsafe(x)] : 0;
+    },
+    getAtUnsafe(x) {
+        return this.data[this.indexAtUnsafe(x)];
+    },
+    setAt(x, val) {
+        return this.includes(x)
+            ? ((this.data[this.indexAtUnsafe(x)] = val), true)
+            : false;
+    },
+    setAtUnsafe(x, val) {
+        this.data[this.indexAtUnsafe(x)] = val;
+        return true;
+    },
+});
+/**
+ * Default implementation for {@link IGrid2D} methods.
+ */
+export const IGrid2DMixin = mixin({
+    order() {
+        return Math.abs(this.stride[1]) > Math.abs(this.stride[0])
+            ? [1, 0]
+            : [0, 1];
+    },
+    includes(x, y) {
+        const size = this.size;
+        return x >= 0 && x < size[0] && y >= 0 && y < size[1];
+    },
+    indexAt(x, y) {
+        return this.includes(x, y) ? this.indexAtUnsafe(x, y) : -1;
+    },
+    indexAtUnsafe(x, y) {
+        return (this.offset + (x | 0) * this.stride[0] + (y | 0) * this.stride[1]);
+    },
+    getAt(x, y) {
+        return this.includes(x, y) ? this.data[this.indexAtUnsafe(x, y)] : 0;
+    },
+    getAtUnsafe(x, y) {
+        return this.data[this.indexAtUnsafe(x, y)];
+    },
+    setAt(x, y, val) {
+        return this.includes(x, y)
+            ? ((this.data[this.indexAtUnsafe(x, y)] = val), true)
+            : false;
+    },
+    setAtUnsafe(x, y, val) {
+        this.data[this.indexAtUnsafe(x, y)] = val;
+        return true;
+    },
+});
+/**
+ * Default implementation for {@link IGrid3D} methods.
+ */
+export const IGrid3DMixin = mixin({
+    order() {
+        return strideOrder(this.stride);
+    },
+    includes(x, y, z) {
+        const size = this.size;
+        return (x >= 0 &&
+            x < size[0] &&
+            y >= 0 &&
+            y < size[1] &&
+            z >= 0 &&
+            z < size[2]);
+    },
+    indexAt(x, y, z) {
+        return this.includes(x, y, z) ? this.indexAtUnsafe(x, y, z) : -1;
+    },
+    indexAtUnsafe(x, y, z) {
+        const stride = this.stride;
+        return (this.offset +
+            (x | 0) * stride[0] +
+            (y | 0) * stride[1] +
+            (z | 0) * stride[2]);
+    },
+    getAt(x, y, z) {
+        return this.includes(x, y, z)
+            ? this.data[this.indexAtUnsafe(x, y, z)]
+            : 0;
+    },
+    getAtUnsafe(x, y, z) {
+        return this.data[this.indexAtUnsafe(x, y, z)];
+    },
+    setAt(x, y, z, val) {
+        return this.includes(x, y, z)
+            ? ((this.data[this.indexAtUnsafe(x, y, z)] = val), true)
+            : false;
+    },
+    setAtUnsafe(x, y, z, val) {
+        this.data[this.indexAtUnsafe(x, y, z)] = val;
+        return true;
+    },
+});
+/**
+ * Default implementation for {@link IGrid4D} methods.
+ */
+export const IGrid4DMixin = mixin({
+    order() {
+        return strideOrder(this.stride);
+    },
+    includes(x, y, z, w) {
+        const size = this.size;
+        return (x >= 0 &&
+            x < size[0] &&
+            y >= 0 &&
+            y < size[1] &&
+            z >= 0 &&
+            z < size[2] &&
+            w >= 0 &&
+            w < size[3]);
+    },
+    indexAt(x, y, z, w) {
+        return this.includes(x, y, z, w) ? this.indexAtUnsafe(x, y, z, w) : -1;
+    },
+    indexAtUnsafe(x, y, z, w) {
+        const stride = this.stride;
+        return (this.offset +
+            (x | 0) * stride[0] +
+            (y | 0) * stride[1] +
+            (z | 0) * stride[2] +
+            (w | 0) * stride[3]);
+    },
+    getAt(x, y, z, w) {
+        return this.includes(x, y, z, w)
+            ? this.data[this.indexAtUnsafe(x, y, z, w)]
+            : 0;
+    },
+    getAtUnsafe(x, y, z, w) {
+        return this.data[this.indexAtUnsafe(x, y, z, w)];
+    },
+    setAt(x, y, z, w, val) {
+        return this.includes(x, y, z, w)
+            ? ((this.data[this.indexAtUnsafe(x, y, z, w)] = val), true)
+            : false;
+    },
+    setAtUnsafe(x, y, z, w, val) {
+        this.data[this.indexAtUnsafe(x, y, z, w)] = val;
+        return true;
+    },
+});
+const strideOrder = (strides) => [...strides]
+    .map((x, i) => [x, i])
+    .sort((a, b) => Math.abs(b[0]) - Math.abs(a[0]))
+    .map((x) => x[1]);

package/mixins/inotify.js CHANGED Viewed

@@ -51,7 +51,7 @@ export const INotifyMixin = mixin({
     },
     __listener(listeners, f, scope) {
         let i = listeners.length;
-        while (--i >= 0) {
+        while (i-- > 0) {
             const l = listeners[i];
             if (l[0] === f && l[1] === scope) {
                 break;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "@thi.ng/api",
-    "version": "8.0.3",
+    "version": "8.2.0",
     "description": "Common, generic types, interfaces & mixins",
     "type": "module",
     "module": "./index.js",
@@ -34,7 +34,7 @@
         "test": "testament test"
     },
     "devDependencies": {
-        "@thi.ng/testament": "^0.1.3"
+        "@thi.ng/testament": "^0.1.6"
     },
     "keywords": [
         "assert",
@@ -126,6 +126,9 @@
         "./get": {
             "import": "./get.js"
         },
+        "./grid": {
+            "import": "./grid.js"
+        },
         "./hash": {
             "import": "./hash.js"
         },
@@ -156,6 +159,9 @@
         "./mixins/ienable": {
             "import": "./mixins/ienable.js"
         },
+        "./mixins/igrid": {
+            "import": "./mixins/igrid.js"
+        },
         "./mixins/inotify": {
             "import": "./mixins/inotify.js"
         },
@@ -211,5 +217,5 @@
             "import": "./watch.js"
         }
     },
-    "gitHead": "1fb38cac74d6c009d96855c28784a267a81badf1"
+    "gitHead": "5fe52419af63984ebe53032201b2a6174b9cb159"
 }

package/typedarray.d.ts CHANGED Viewed

@@ -108,6 +108,10 @@ export declare const asNativeType: (type: GLType | Type) => Type;
  * @param type -
  */
 export declare const asGLType: (type: GLType | Type) => GLType;
+/**
+ * Coerces given numeric args to integer values.
+ */
+export declare const asInt: (...args: number[]) => number[];
 /**
  * Returns byte size for given {@link Type} ID or {@link GLType} enum.
  *

package/typedarray.js CHANGED Viewed

@@ -111,6 +111,10 @@ export const asGLType = (type) => {
     const t = TYPE2GL[type];
     return t !== undefined ? t : type;
 };
+/**
+ * Coerces given numeric args to integer values.
+ */
+export const asInt = (...args) => args.map((x) => x | 0);
 /**
  * Returns byte size for given {@link Type} ID or {@link GLType} enum.
  *