@thi.ng/api - npm Package Compare versions

Comparing version 6.10.5 to 6.11.0

api/deref.d.ts

@@ -11,2 +11,3 @@ import type { IObjectOf } from "./object";
 }
+export declare type MaybeDeref<T> = IDeref<T> | T;
 /**
@@ -38,2 +39,15 @@ * If `T` is a {@link IDeref}, returns its value type or else `T`.
 };
+/**
+ * Returns true iff `x` implements {@link IDeref}.
+ *
+ * @param x
+ */
+export declare const isDeref: (x: any) => x is IDeref<any>;
+/**
+ * If `x` implements {@link IDeref}, returns its wrapped value, else
+ * returns `x` itself.
+ *
+ * @param x -
+ */
+export declare const deref: <T>(x: MaybeDeref<T>) => T;
 //# sourceMappingURL=deref.d.ts.map

CHANGELOG.md

@@ -6,42 +6,13 @@ # Change Log
 
-## [6.10.5](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.10.5) (2020-05-14)
+# [6.11.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.11.0) (2020-06-01)
 
-**Note:** Version bump only for package @thi.ng/api
 
+### Features
 
+* **api:** add deref(), isDeref() fns & MaybeDeref ([722bf3e](https://github.com/thi-ng/umbrella/commit/722bf3e3a368c62575faff26695326dc72954d6d))
 
 
 
-## [6.10.4](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.10.4) (2020-05-03)
 
-**Note:** Version bump only for package @thi.ng/api
 
-
-
-
-
-## [6.10.3](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.10.3) (2020-04-28)
-
-**Note:** Version bump only for package @thi.ng/api
-
-
-
-
-
-## [6.10.2](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.10.2) (2020-04-27)
-
-**Note:** Version bump only for package @thi.ng/api
-
-
-
-
-
-## [6.10.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.10.1) (2020-04-11)
-
-**Note:** Version bump only for package @thi.ng/api
-
-
-
-
-
 # [6.10.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.10.0) (2020-04-06)
@@ -58,10 +29,2 @@
 
-## [6.9.1](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.9.1) (2020-04-05)
-
-**Note:** Version bump only for package @thi.ng/api
-
-
-
-
-
 # [6.9.0](https://github.com/thi-ng/umbrella/compare/@thi.ng/api@[e-mail]/api@6.9.0) (2020-03-28)
@@ -68,0 +31,0 @@

lib/index.js

@@ -5,2 +5,5 @@ 'use strict';
 
+const isDeref = (x) => x != null && typeof x["deref"] === "function";
+const deref = (x) => (isDeref(x) ? x.deref() : x);
+
 (function (LogLevel) {
@@ -347,5 +350,7 @@ LogLevel[LogLevel["FINE"] = 0] = "FINE";
 exports.deprecated = deprecated;
+exports.deref = deref;
 exports.exposeGlobal = exposeGlobal;
 exports.inotify_dispatch = inotify_dispatch;
 exports.intType = intType;
+exports.isDeref = isDeref;
 exports.iterable = iterable;
@@ -352,0 +357,0 @@ exports.mixin = mixin;

lib/index.umd.js

@@ -1,1 +0,1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t(((e=e||self).thi=e.thi||{},e.thi.ng=e.thi.ng||{},e.thi.ng.api={}))}(this,(function(e){"use strict";var t,n,i;(t=e.LogLevel||(e.LogLevel={}))[t.FINE=0]="FINE",t[t.DEBUG=1]="DEBUG",t[t.INFO=2]="INFO",t[t.WARN=3]="WARN",t[t.SEVERE=4]="SEVERE",t[t.NONE=5]="NONE",(n=e.Type||(e.Type={}))[n.U8=0]="U8",n[n.U8C=1]="U8C",n[n.I8=2]="I8",n[n.U16=3]="U16",n[n.I16=4]="I16",n[n.U32=5]="U32",n[n.I32=6]="I32",n[n.F32=7]="F32",n[n.F64=8]="F64",(i=e.GLType||(e.GLType={}))[i.I8=5120]="I8",i[i.U8=5121]="U8",i[i.I16=5122]="I16",i[i.U16=5123]="U16",i[i.I32=5124]="I32",i[i.U32=5125]="U32",i[i.F32=5126]="F32";const r={[e.GLType.I8]:e.Type.I8,[e.GLType.U8]:e.Type.U8,[e.GLType.I16]:e.Type.I16,[e.GLType.U16]:e.Type.U16,[e.GLType.I32]:e.Type.I32,[e.GLType.U32]:e.Type.U32,[e.GLType.F32]:e.Type.F32},o={[e.Type.I8]:e.GLType.I8,[e.Type.U8]:e.GLType.U8,[e.Type.U8C]:e.GLType.U8,[e.Type.I16]:e.GLType.I16,[e.Type.U16]:e.GLType.U16,[e.Type.I32]:e.GLType.I32,[e.Type.I32]:e.GLType.I32,[e.Type.U32]:e.GLType.U32,[e.Type.F32]:e.GLType.F32,[e.Type.F64]:void 0},s={[e.Type.U8]:1,[e.Type.U8C]:1,[e.Type.I8]:1,[e.Type.U16]:2,[e.Type.I16]:2,[e.Type.U32]:4,[e.Type.I32]:4,[e.Type.F32]:4,[e.Type.F64]:8},y={[e.Type.U8]:Uint8Array,[e.Type.U8C]:Uint8ClampedArray,[e.Type.I8]:Int8Array,[e.Type.U16]:Uint16Array,[e.Type.I16]:Int16Array,[e.Type.U32]:Uint32Array,[e.Type.I32]:Int32Array,[e.Type.F32]:Float32Array,[e.Type.F64]:Float64Array,[e.GLType.U8]:Uint8Array,[e.GLType.I8]:Int8Array,[e.GLType.U16]:Uint16Array,[e.GLType.I16]:Int16Array,[e.GLType.U32]:Uint32Array,[e.GLType.I32]:Int32Array,[e.GLType.F32]:Float32Array};const l=Symbol(),p=()=>{},a="undefined"==typeof process||"production"!==process.env.NODE_ENV||"1"===process.env.UMBRELLA_ASSERTS?(e,t="assertion failed")=>{if("function"==typeof e&&!e()||!e)throw new Error("function"==typeof t?t():t)}:p,T=Object.freeze({level:e.LogLevel.NONE,fine(){},debug(){},info(){},warn(){},severe(){}});const c=(e,t={})=>{const n=Reflect.ownKeys(e),i=Reflect.ownKeys(t),r=Symbol("isa");function o(t){for(let i of n){const n=Object.getOwnPropertyDescriptor(t.prototype,i);!n||n.configurable?Object.defineProperty(t.prototype,i,{value:e[i],writable:!0}):console.log(`not patching: ${t.name}.${i.toString()}`)}return Object.defineProperty(t.prototype,r,{value:!0}),t}for(let e of i)Object.defineProperty(o,e,{value:t[e],enumerable:t.propertyIsEnumerable(e)});return Object.defineProperty(o,Symbol.hasInstance,{value:e=>!!e[r]}),o},f=c({_enabled:!0,isEnabled(){return this._enabled},enable(){this._enabled=!0,this.notify&&this.notify({id:"enable",target:this})},disable(){this._enabled=!1,this.notify&&this.notify({id:"disable",target:this})},toggle(){return this._enabled?this.disable():this.enable(),this._enabled}}),h=(e,t)=>{if(e)for(let n,i=0,r=e.length;i<r;i++)if(n=e[i],n[0].call(n[1],t),t.canceled)return},d=c({addListener(e,t,n){let i=(this._listeners=this._listeners||{})[e];return!i&&(i=this._listeners[e]=[]),-1===this.__listener(i,t,n)&&(i.push([t,n]),!0)},removeListener(e,t,n){let i;if(!(i=this._listeners))return!1;const r=i[e];if(r){const o=this.__listener(r,t,n);if(-1!==o)return r.splice(o,1),!r.length&&delete i[e],!0}return!1},notify(e){let t;if(!(t=this._listeners))return!1;void 0===e.target&&(e.target=this),h(t[e.id],e),h(t["*"],e)},__listener(e,t,n){let i=e.length;for(;--i>=0;){const r=e[i];if(r[0]===t&&r[1]===n)break}return i}}),I=c({addWatch(e,t){return this._watches=this._watches||{},!this._watches[e]&&(this._watches[e]=t,!0)},removeWatch(e){if(this._watches)return!!this._watches[e]&&(delete this._watches[e],!0)},notifyWatches(e,t){if(!this._watches)return;const n=this._watches;for(let i in n)n[i](i,e,t)}});e.ConsoleLogger=class{constructor(t,n=e.LogLevel.FINE){this.id=t,this.level=n}fine(...t){this.level<=e.LogLevel.FINE&&this.log("FINE",t)}debug(...t){this.level<=e.LogLevel.DEBUG&&this.log("DEBUG",t)}info(...t){this.level<=e.LogLevel.INFO&&this.log("INFO",t)}warn(...t){this.level<=e.LogLevel.WARN&&this.log("WARN",t)}severe(...t){this.level<=e.LogLevel.SEVERE&&this.log("SEVERE",t)}log(e,t){console.log(`[${e}] ${this.id}:`,...t)}},e.DEFAULT_EPS=1e-6,e.EVENT_ALL="*",e.EVENT_DISABLE="disable",e.EVENT_ENABLE="enable",e.GL2TYPE=r,e.IEnableMixin=f,e.INotifyMixin=d,e.IWatchMixin=I,e.NO_OP=p,e.NULL_LOGGER=T,e.SEMAPHORE=l,e.SIZEOF=s,e.TYPE2GL=o,e.TYPEDARRAY_CTORS=y,e.assert=a,e.configurable=e=>function(t,n,i){i.configurable=e},e.deprecated=(e,t=console.log)=>function(n,i,r){const o=`${n.constructor.name}#${i.toString()}`,s=r.value;return a("function"==typeof s,o+" is not a function"),r.value=function(){return t(`DEPRECATED ${o}: ${e||"will be removed soon"}`),s.apply(this,arguments)},r},e.exposeGlobal=(e,t,n=!1)=>{const i="undefined"!=typeof global?global:"undefined"!=typeof window?window:void 0;i&&(n||"undefined"==typeof process||"production"!==process.env.NODE_ENV||"1"===process.env.UMBRELLA_ASSERTS)&&(i[e]=t)},e.inotify_dispatch=h,e.intType=t=>t>=-128&&t<128?e.Type.I8:t>=-32768&&t<32768?e.Type.I16:e.Type.I32,e.iterable=e=>c({*[Symbol.iterator](){yield*this[e]}}),e.mixin=c,e.nomixin=(e,t,n)=>{n.configurable=!1},e.sealed=e=>{Object.seal(e),Object.seal(e.prototype)},e.typedArray=function(e,...t){return new y[e](...t)},e.uintType=t=>t<=256?e.Type.U8:t<=65536?e.Type.U16:e.Type.U32,Object.defineProperty(e,"__esModule",{value:!0})}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t(((e=e||self).thi=e.thi||{},e.thi.ng=e.thi.ng||{},e.thi.ng.api={}))}(this,(function(e){"use strict";const t=e=>null!=e&&"function"==typeof e.deref;var n,i,r;(n=e.LogLevel||(e.LogLevel={}))[n.FINE=0]="FINE",n[n.DEBUG=1]="DEBUG",n[n.INFO=2]="INFO",n[n.WARN=3]="WARN",n[n.SEVERE=4]="SEVERE",n[n.NONE=5]="NONE",(i=e.Type||(e.Type={}))[i.U8=0]="U8",i[i.U8C=1]="U8C",i[i.I8=2]="I8",i[i.U16=3]="U16",i[i.I16=4]="I16",i[i.U32=5]="U32",i[i.I32=6]="I32",i[i.F32=7]="F32",i[i.F64=8]="F64",(r=e.GLType||(e.GLType={}))[r.I8=5120]="I8",r[r.U8=5121]="U8",r[r.I16=5122]="I16",r[r.U16=5123]="U16",r[r.I32=5124]="I32",r[r.U32=5125]="U32",r[r.F32=5126]="F32";const o={[e.GLType.I8]:e.Type.I8,[e.GLType.U8]:e.Type.U8,[e.GLType.I16]:e.Type.I16,[e.GLType.U16]:e.Type.U16,[e.GLType.I32]:e.Type.I32,[e.GLType.U32]:e.Type.U32,[e.GLType.F32]:e.Type.F32},s={[e.Type.I8]:e.GLType.I8,[e.Type.U8]:e.GLType.U8,[e.Type.U8C]:e.GLType.U8,[e.Type.I16]:e.GLType.I16,[e.Type.U16]:e.GLType.U16,[e.Type.I32]:e.GLType.I32,[e.Type.I32]:e.GLType.I32,[e.Type.U32]:e.GLType.U32,[e.Type.F32]:e.GLType.F32,[e.Type.F64]:void 0},y={[e.Type.U8]:1,[e.Type.U8C]:1,[e.Type.I8]:1,[e.Type.U16]:2,[e.Type.I16]:2,[e.Type.U32]:4,[e.Type.I32]:4,[e.Type.F32]:4,[e.Type.F64]:8},l={[e.Type.U8]:Uint8Array,[e.Type.U8C]:Uint8ClampedArray,[e.Type.I8]:Int8Array,[e.Type.U16]:Uint16Array,[e.Type.I16]:Int16Array,[e.Type.U32]:Uint32Array,[e.Type.I32]:Int32Array,[e.Type.F32]:Float32Array,[e.Type.F64]:Float64Array,[e.GLType.U8]:Uint8Array,[e.GLType.I8]:Int8Array,[e.GLType.U16]:Uint16Array,[e.GLType.I16]:Int16Array,[e.GLType.U32]:Uint32Array,[e.GLType.I32]:Int32Array,[e.GLType.F32]:Float32Array};const p=Symbol(),a=()=>{},T="undefined"==typeof process||"production"!==process.env.NODE_ENV||"1"===process.env.UMBRELLA_ASSERTS?(e,t="assertion failed")=>{if("function"==typeof e&&!e()||!e)throw new Error("function"==typeof t?t():t)}:a,c=Object.freeze({level:e.LogLevel.NONE,fine(){},debug(){},info(){},warn(){},severe(){}});const f=(e,t={})=>{const n=Reflect.ownKeys(e),i=Reflect.ownKeys(t),r=Symbol("isa");function o(t){for(let i of n){const n=Object.getOwnPropertyDescriptor(t.prototype,i);!n||n.configurable?Object.defineProperty(t.prototype,i,{value:e[i],writable:!0}):console.log(`not patching: ${t.name}.${i.toString()}`)}return Object.defineProperty(t.prototype,r,{value:!0}),t}for(let e of i)Object.defineProperty(o,e,{value:t[e],enumerable:t.propertyIsEnumerable(e)});return Object.defineProperty(o,Symbol.hasInstance,{value:e=>!!e[r]}),o},h=f({_enabled:!0,isEnabled(){return this._enabled},enable(){this._enabled=!0,this.notify&&this.notify({id:"enable",target:this})},disable(){this._enabled=!1,this.notify&&this.notify({id:"disable",target:this})},toggle(){return this._enabled?this.disable():this.enable(),this._enabled}}),d=(e,t)=>{if(e)for(let n,i=0,r=e.length;i<r;i++)if(n=e[i],n[0].call(n[1],t),t.canceled)return},u=f({addListener(e,t,n){let i=(this._listeners=this._listeners||{})[e];return!i&&(i=this._listeners[e]=[]),-1===this.__listener(i,t,n)&&(i.push([t,n]),!0)},removeListener(e,t,n){let i;if(!(i=this._listeners))return!1;const r=i[e];if(r){const o=this.__listener(r,t,n);if(-1!==o)return r.splice(o,1),!r.length&&delete i[e],!0}return!1},notify(e){let t;if(!(t=this._listeners))return!1;void 0===e.target&&(e.target=this),d(t[e.id],e),d(t["*"],e)},__listener(e,t,n){let i=e.length;for(;--i>=0;){const r=e[i];if(r[0]===t&&r[1]===n)break}return i}}),I=f({addWatch(e,t){return this._watches=this._watches||{},!this._watches[e]&&(this._watches[e]=t,!0)},removeWatch(e){if(this._watches)return!!this._watches[e]&&(delete this._watches[e],!0)},notifyWatches(e,t){if(!this._watches)return;const n=this._watches;for(let i in n)n[i](i,e,t)}});e.ConsoleLogger=class{constructor(t,n=e.LogLevel.FINE){this.id=t,this.level=n}fine(...t){this.level<=e.LogLevel.FINE&&this.log("FINE",t)}debug(...t){this.level<=e.LogLevel.DEBUG&&this.log("DEBUG",t)}info(...t){this.level<=e.LogLevel.INFO&&this.log("INFO",t)}warn(...t){this.level<=e.LogLevel.WARN&&this.log("WARN",t)}severe(...t){this.level<=e.LogLevel.SEVERE&&this.log("SEVERE",t)}log(e,t){console.log(`[${e}] ${this.id}:`,...t)}},e.DEFAULT_EPS=1e-6,e.EVENT_ALL="*",e.EVENT_DISABLE="disable",e.EVENT_ENABLE="enable",e.GL2TYPE=o,e.IEnableMixin=h,e.INotifyMixin=u,e.IWatchMixin=I,e.NO_OP=a,e.NULL_LOGGER=c,e.SEMAPHORE=p,e.SIZEOF=y,e.TYPE2GL=s,e.TYPEDARRAY_CTORS=l,e.assert=T,e.configurable=e=>function(t,n,i){i.configurable=e},e.deprecated=(e,t=console.log)=>function(n,i,r){const o=`${n.constructor.name}#${i.toString()}`,s=r.value;return T("function"==typeof s,o+" is not a function"),r.value=function(){return t(`DEPRECATED ${o}: ${e||"will be removed soon"}`),s.apply(this,arguments)},r},e.deref=e=>t(e)?e.deref():e,e.exposeGlobal=(e,t,n=!1)=>{const i="undefined"!=typeof global?global:"undefined"!=typeof window?window:void 0;i&&(n||"undefined"==typeof process||"production"!==process.env.NODE_ENV||"1"===process.env.UMBRELLA_ASSERTS)&&(i[e]=t)},e.inotify_dispatch=d,e.intType=t=>t>=-128&&t<128?e.Type.I8:t>=-32768&&t<32768?e.Type.I16:e.Type.I32,e.isDeref=t,e.iterable=e=>f({*[Symbol.iterator](){yield*this[e]}}),e.mixin=f,e.nomixin=(e,t,n)=>{n.configurable=!1},e.sealed=e=>{Object.seal(e),Object.seal(e.prototype)},e.typedArray=function(e,...t){return new l[e](...t)},e.uintType=t=>t<=256?e.Type.U8:t<=65536?e.Type.U16:e.Type.U32,Object.defineProperty(e,"__esModule",{value:!0})}));

package.json

 {
     "name": "@thi.ng/api",
-    "version": "6.10.5",
+    "version": "6.11.0",
     "description": "Common, generic types, interfaces & mixins",
@@ -74,3 +74,3 @@ "module": "./index.js",
     "sideEffects": false,
-    "gitHead": "97c301379d830c1982c364cfbec8766ff14f73f5"
+    "gitHead": "a25c4eed5fba2c7d1fddb02dd706bae534affc93"
 }

README.md

@@ -55,3 +55,3 @@ <!-- This file is generated - DO NOT EDIT! -->
 
-Package sizes (gzipped, pre-treeshake): ESM: 2.01 KB / CJS: 2.14 KB / UMD: 2.12 KB
+Package sizes (gzipped, pre-treeshake): ESM: 2.05 KB / CJS: 2.19 KB / UMD: 2.16 KB
 
@@ -58,0 +58,0 @@ ## Dependencies

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

133135

increased by0.47%

Lines of code

2064

increased by1.52%

No dependency changes