@thi.ng/api 8.9.10 → 8.9.12

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-12-03T12:13:31Z
+- **Last updated**: 2023-12-11T10:07:09Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -56,7 +56,7 @@ For Node.js REPL:
 const api = await import("@thi.ng/api");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.39 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.37 KB
 
 ## Dependencies
 

package/api.js

@@ -1,17 +1,15 @@
-export const DEFAULT_EPS = 1e-6;
-/**
- * Internal use only. **Do NOT use in user land code!**
- *
- * @internal
- */
-export const SEMAPHORE = Symbol();
-/**
- * No-effect placeholder function.
- */
-export const NO_OP = () => { };
-/**
- * Catch-all event ID
- */
-export const EVENT_ALL = "*";
-export const EVENT_ENABLE = "enable";
-export const EVENT_DISABLE = "disable";
+const DEFAULT_EPS = 1e-6;
+const SEMAPHORE = Symbol();
+const NO_OP = () => {
+};
+const EVENT_ALL = "*";
+const EVENT_ENABLE = "enable";
+const EVENT_DISABLE = "disable";
+export {
+  DEFAULT_EPS,
+  EVENT_ALL,
+  EVENT_DISABLE,
+  EVENT_ENABLE,
+  NO_OP,
+  SEMAPHORE
+};

package/assoc.js

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

package/bind.js

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

package/buffered.js

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

package/clear.js

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

package/compare.js

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

package/contains.js

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

package/copy.js

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

package/decorators/configurable.js

@@ -1,9 +1,6 @@
-/**
- * Property decorator factory. Sets `configurable` flag of PropertyDescriptor
- * to given state.
- *
- * @param state - true, if propoerty is configurable
- */
-export const configurable = (state) => function (_, __, descriptor) {
-    descriptor.configurable = state;
+const configurable = (state) => function(_, __, descriptor) {
+  descriptor.configurable = state;
+};
+export {
+  configurable
 };

package/decorators/deprecated.js

@@ -1,20 +1,15 @@
-/**
- * Method property decorator factory. Augments original method with
- * deprecation message (via console), shown when method is invoked.
- * Accepts optional message arg. Throws error if assigned property
- * is not a function.
- *
- * @param msg - deprecation message
- */
-export const deprecated = (msg, log = console.log) => function (target, prop, descriptor) {
-    const signature = `${target.constructor.name}#${prop.toString()}`;
-    const fn = descriptor.value;
-    if (typeof fn !== "function") {
-        throw new Error(`${signature} is not a function`);
-    }
-    descriptor.value = function () {
-        log(`DEPRECATED ${signature}: ${msg || "will be removed soon"}`);
-        return fn.apply(this, arguments);
-    };
-    return descriptor;
+const deprecated = (msg, log = console.log) => function(target, prop, descriptor) {
+  const signature = `${target.constructor.name}#${prop.toString()}`;
+  const fn = descriptor.value;
+  if (typeof fn !== "function") {
+    throw new Error(`${signature} is not a function`);
+  }
+  descriptor.value = function() {
+    log(`DEPRECATED ${signature}: ${msg || "will be removed soon"}`);
+    return fn.apply(this, arguments);
+  };
+  return descriptor;
+};
+export {
+  deprecated
 };

package/decorators/nomixin.js

@@ -1,10 +1,6 @@
-/**
- * Method property decorator. Sets `configurable` flag of
- * PropertyDescriptor to `false` (same as `@configurable(false)`).
- * Intended to be used in combination with mixin decorators to enable
- * partial implementations of mixed-in behaviors in target class and
- * avoid them being overidden by mixed-in behaviour.
- */
-export const nomixin = (_, __, descriptor) => {
-    descriptor.configurable = false;
+const nomixin = (_, __, descriptor) => {
+  descriptor.configurable = false;
+};
+export {
+  nomixin
 };

package/decorators/sealed.js

@@ -1,9 +1,7 @@
-/**
- * Class decorator. Seals both constructor and prototype.
- *
- * @param constructor - class ctor to seal
- */
-export const sealed = (constructor) => {
-    Object.seal(constructor);
-    Object.seal(constructor.prototype);
+const sealed = (constructor) => {
+  Object.seal(constructor);
+  Object.seal(constructor.prototype);
+};
+export {
+  sealed
 };

package/deref.js

@@ -1,13 +1,6 @@
-/**
- * Returns true iff `x` implements {@link IDeref}.
- *
- * @param x -
- */
-export const isDeref = (x) => x != null && typeof x["deref"] === "function";
-/**
- * If `x` implements {@link IDeref}, returns its wrapped value, else
- * returns `x` itself.
- *
- * @param x -
- */
-export const deref = (x) => (isDeref(x) ? x.deref() : x);
+const isDeref = (x) => x != null && typeof x["deref"] === "function";
+const deref = (x) => isDeref(x) ? x.deref() : x;
+export {
+  deref,
+  isDeref
+};

package/dissoc.js

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

package/empty.js

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

package/enable.js

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

package/equiv.js

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

package/event.js

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

package/fn.js

@@ -1,14 +1,8 @@
-/**
- * Identity function: `(x) => x`
- *
- * @param x
- */
-export const identity = (x) => x;
-/**
- * Zero-arg function always returning true.
- */
-export const always = () => true;
-/**
- * Zero-arg function always returning false.
- */
-export const never = () => false;
+const identity = (x) => x;
+const always = () => true;
+const never = () => false;
+export {
+  always,
+  identity,
+  never
+};

package/get.js

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

package/grid.js

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

package/hash.js

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

package/hiccup.js

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

package/id.js

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

package/indexed.js

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

package/into.js

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

package/keyval.js

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

package/length.js

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

package/meta.js

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

package/mixin.js

@@ -1,45 +1,35 @@
-/**
- * Class behavior mixin based on:
- * - http://raganwald.com/2015/06/26/decorators-in-es7.html
- *
- * Additionally only injects/overwrites properties in target, which are NOT
- * marked with
- * [`@nomixin`](https://docs.thi.ng/umbrella/api/functions/nomixin.html) (i.e.
- * those which haven't set their `configurable` property descriptor flag to
- * `false`)
- *
- * @param behaviour - to mixin
- * @param sharedBehaviour -
- * @returns decorator function
- */
-export const mixin = (behaviour, sharedBehaviour = {}) => {
-    const instanceKeys = Reflect.ownKeys(behaviour);
-    const sharedKeys = Reflect.ownKeys(sharedBehaviour);
-    const typeTag = Symbol("isa");
-    function _mixin(clazz) {
-        for (let key of instanceKeys) {
-            const existing = Object.getOwnPropertyDescriptor(clazz.prototype, key);
-            if (!existing || existing.configurable) {
-                Object.defineProperty(clazz.prototype, key, {
-                    value: behaviour[key],
-                    writable: true,
-                });
-            }
-            else {
-                // console.log(`not patching: ${clazz.name}.${key.toString()}`);
-            }
-        }
-        Object.defineProperty(clazz.prototype, typeTag, { value: true });
-        return clazz;
-    }
-    for (let key of sharedKeys) {
-        Object.defineProperty(_mixin, key, {
-            value: sharedBehaviour[key],
-            enumerable: sharedBehaviour.propertyIsEnumerable(key),
+const mixin = (behaviour, sharedBehaviour = {}) => {
+  const instanceKeys = Reflect.ownKeys(behaviour);
+  const sharedKeys = Reflect.ownKeys(sharedBehaviour);
+  const typeTag = Symbol("isa");
+  function _mixin(clazz) {
+    for (let key of instanceKeys) {
+      const existing = Object.getOwnPropertyDescriptor(
+        clazz.prototype,
+        key
+      );
+      if (!existing || existing.configurable) {
+        Object.defineProperty(clazz.prototype, key, {
+          value: behaviour[key],
+          writable: true
         });
+      } else {
+      }
     }
-    Object.defineProperty(_mixin, Symbol.hasInstance, {
-        value: (x) => !!x[typeTag],
+    Object.defineProperty(clazz.prototype, typeTag, { value: true });
+    return clazz;
+  }
+  for (let key of sharedKeys) {
+    Object.defineProperty(_mixin, key, {
+      value: sharedBehaviour[key],
+      enumerable: sharedBehaviour.propertyIsEnumerable(key)
     });
-    return _mixin;
+  }
+  Object.defineProperty(_mixin, Symbol.hasInstance, {
+    value: (x) => !!x[typeTag]
+  });
+  return _mixin;
+};
+export {
+  mixin
 };

package/mixins/ienable.js

@@ -1,30 +1,27 @@
 import { EVENT_DISABLE, EVENT_ENABLE } from "../api.js";
 import { mixin } from "../mixin.js";
-/**
- * Mixin class decorator, injects IEnable default implementation, incl. a
- * `_enabled` property. If the target also implements the {@link INotify}
- * interface, {@link IEnable.enable} and {@link IEnable.disable} will
- * automatically emit the respective events.
- */
-export const IEnableMixin = mixin({
-    _enabled: true,
-    isEnabled() {
-        return this._enabled;
-    },
-    enable() {
-        $enable(this, true, EVENT_ENABLE);
-    },
-    disable() {
-        $enable(this, false, EVENT_DISABLE);
-    },
-    toggle() {
-        this._enabled ? this.disable() : this.enable();
-        return this._enabled;
-    },
+const IEnableMixin = mixin({
+  _enabled: true,
+  isEnabled() {
+    return this._enabled;
+  },
+  enable() {
+    $enable(this, true, EVENT_ENABLE);
+  },
+  disable() {
+    $enable(this, false, EVENT_DISABLE);
+  },
+  toggle() {
+    this._enabled ? this.disable() : this.enable();
+    return this._enabled;
+  }
 });
 const $enable = (target, state, id) => {
-    target._enabled = state;
-    if (target.notify) {
-        target.notify({ id, target });
-    }
+  target._enabled = state;
+  if (target.notify) {
+    target.notify({ id, target });
+  }
+};
+export {
+  IEnableMixin
 };