@tko/lifecycle 4.0.0-alpha8.0 → 4.0.0-beta1.3

package/dist/LifeCycle.js

@@ -0,0 +1,84 @@
+"use strict";
+// @tko/lifecycle 🥊 4.0.0-beta1.3 ESM
+import {
+  addDisposeCallback,
+  createSymbolOrString
+} from "@tko/utils";
+import {
+  computed
+} from "@tko/computed";
+const SUBSCRIPTIONS = createSymbolOrString("LifeCycle Subscriptions List");
+const ANCHOR_NODE = createSymbolOrString("LifeCycle Anchor Node");
+export default class LifeCycle {
+  static mixInto(Constructor) {
+    const target = Constructor.prototype || Constructor;
+    const mixin = LifeCycle.prototype;
+    for (let prop of Object.getOwnPropertyNames(mixin)) {
+      target[prop] = mixin[prop];
+    }
+  }
+  subscribe(observable, action, subscriptionType) {
+    if (typeof action === "string") {
+      action = this[action];
+    }
+    this.addDisposable(observable.subscribe(action, this, subscriptionType));
+  }
+  computed(params) {
+    if (typeof params === "string") {
+      params = { read: this[params], write: this[params] };
+    }
+    if (typeof params === "object") {
+      params = Object.assign({ owner: this }, params);
+    } else if (typeof params === "function") {
+      const proto = Object.getPrototypeOf(this);
+      if (proto && proto[params.name] === params) {
+        params = params.bind(this);
+      }
+      params = { read: params, write: params };
+    } else {
+      throw new Error("LifeCycle::computed not given a valid type.");
+    }
+    params.disposeWhenNodeIsRemoved = this[ANCHOR_NODE];
+    return this.addDisposable(computed(params));
+  }
+  addEventListener(...args) {
+    const node = args[0].nodeType ? args.shift() : this[ANCHOR_NODE];
+    const [type, act, options] = args;
+    const handler = typeof act === "string" ? this[act].bind(this) : act;
+    this.__addEventListener(node, type, handler, options);
+  }
+  __addEventListener(node, eventType, handler, options) {
+    node.addEventListener(eventType, handler, options);
+    function dispose() {
+      node.removeEventListener(eventType, handler);
+    }
+    addDisposeCallback(node, dispose);
+    this.addDisposable({ dispose });
+  }
+  anchorTo(nodeOrLifeCycle) {
+    if ("addDisposable" in nodeOrLifeCycle) {
+      nodeOrLifeCycle.addDisposable(this);
+      this[ANCHOR_NODE] = null;
+    } else {
+      this[ANCHOR_NODE] = nodeOrLifeCycle;
+      addDisposeCallback(nodeOrLifeCycle, () => this[ANCHOR_NODE] === nodeOrLifeCycle && this.dispose());
+    }
+  }
+  dispose() {
+    const subscriptions = this[SUBSCRIPTIONS] || [];
+    subscriptions.forEach((s) => s.dispose());
+    this[SUBSCRIPTIONS] = [];
+    this[ANCHOR_NODE] = null;
+  }
+  addDisposable(subscription) {
+    const subscriptions = this[SUBSCRIPTIONS] || [];
+    if (!this[SUBSCRIPTIONS]) {
+      this[SUBSCRIPTIONS] = subscriptions;
+    }
+    if (typeof subscription.dispose !== "function") {
+      throw new Error("Lifecycle::addDisposable argument missing `dispose`.");
+    }
+    subscriptions.push(subscription);
+    return subscription;
+  }
+}

package/dist/LifeCycle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/LifeCycle.ts"],
+  "sourcesContent": ["'use strict'\n\nimport {\n    addDisposeCallback, createSymbolOrString\n} from '@tko/utils'\n\nimport {\n    computed\n} from '@tko/computed'\n\nconst SUBSCRIPTIONS = createSymbolOrString('LifeCycle Subscriptions List')\nconst ANCHOR_NODE = createSymbolOrString('LifeCycle Anchor Node')\n\nexport default class LifeCycle {\n  // NOTE: For more advanced integration as an ES6 mixin, see e.g.:\n  // http://justinfagnani.com/2015/12/21/real-mixins-with-javascript-classes/\n\n  /**\n   * Copy the properties of the LifeCycle class to the target (or its prototype)\n   *\n   * NOTE: getOwnPropertyNames is needed to copy the non-enumerable properties.\n   */\n  static mixInto (Constructor) {\n    const target = Constructor.prototype || Constructor\n    const mixin = LifeCycle.prototype\n    for (let prop of Object.getOwnPropertyNames(mixin)) {\n      target[prop] = mixin[prop]\n    }\n  }\n\n  subscribe (observable, action, subscriptionType) {\n    if (typeof action === 'string') { action = this[action] }\n    this.addDisposable(observable.subscribe(action, this, subscriptionType))\n  }\n\n  computed (params) {\n    if (typeof params === 'string') {\n      params = { read: this[params], write: this[params] }\n    }\n\n    if (typeof params === 'object') {\n      params = Object.assign({ owner: this }, params)\n    } else if (typeof params === 'function') {\n      const proto = Object.getPrototypeOf(this)\n      if (proto && proto[params.name] === params) { params = params.bind(this) }\n      params = { read: params, write: params }\n    } else {\n      throw new Error('LifeCycle::computed not given a valid type.')\n    }\n\n    params.disposeWhenNodeIsRemoved = this[ANCHOR_NODE]\n    return this.addDisposable(computed(params))\n  }\n\n  /**\n   * Add an event listener for the given or anchored node.\n   * @param {node} [node] (optional) The target node (otherwise the anchored node)\n   * @param {string} [type] Event type\n   * @param {function|string} [action] Either call the given function or `this[action]`\n   * @param {object} [options] (optional) Passed as `options` to `node.addEventListener`\n   */\n  addEventListener (...args) {\n    const node = args[0].nodeType ? args.shift() : this[ANCHOR_NODE]\n    const [type, act, options] = args\n    const handler = typeof act === 'string' ? this[act].bind(this) : act\n    this.__addEventListener(node, type, handler, options)\n  }\n\n  __addEventListener (node, eventType, handler, options) {\n    node.addEventListener(eventType, handler, options)\n    function dispose () { node.removeEventListener(eventType, handler) }\n    addDisposeCallback(node, dispose)\n    this.addDisposable({ dispose })\n  }\n\n  anchorTo (nodeOrLifeCycle) {\n    if ('addDisposable' in nodeOrLifeCycle) {\n      nodeOrLifeCycle.addDisposable(this)\n      this[ANCHOR_NODE] = null // re-anchor on `anchorTo` calls\n    } else {\n      this[ANCHOR_NODE] = nodeOrLifeCycle\n      addDisposeCallback(nodeOrLifeCycle, () => this[ANCHOR_NODE] === nodeOrLifeCycle && this.dispose())\n    }\n  }\n\n  dispose () {\n    const subscriptions = this[SUBSCRIPTIONS] || []\n    subscriptions.forEach(s => s.dispose())\n    this[SUBSCRIPTIONS] = []\n    this[ANCHOR_NODE] = null\n  }\n\n  addDisposable (subscription) {\n    const subscriptions = this[SUBSCRIPTIONS] || []\n    if (!this[SUBSCRIPTIONS]) { this[SUBSCRIPTIONS] = subscriptions }\n    if (typeof subscription.dispose !== 'function') {\n      throw new Error('Lifecycle::addDisposable argument missing `dispose`.')\n    }\n    subscriptions.push(subscription)\n    return subscription\n  }\n}\n"],
+  "mappings": ";;AAEA;AAAA;AAAA;AAAA;AAIA;AAAA;AAAA;AAIA,MAAM,gBAAgB,qBAAqB,8BAA8B;AACzE,MAAM,cAAc,qBAAqB,uBAAuB;AAEhE,qBAAqB,UAAU;AAAA,SAStB,QAAS,aAAa;AAC3B,UAAM,SAAS,YAAY,aAAa;AACxC,UAAM,QAAQ,UAAU;AACxB,aAAS,QAAQ,OAAO,oBAAoB,KAAK,GAAG;AAClD,aAAO,QAAQ,MAAM;AAAA,IACvB;AAAA,EACF;AAAA,EAEA,UAAW,YAAY,QAAQ,kBAAkB;AAC/C,QAAI,OAAO,WAAW,UAAU;AAAE,eAAS,KAAK;AAAA,IAAQ;AACxD,SAAK,cAAc,WAAW,UAAU,QAAQ,MAAM,gBAAgB,CAAC;AAAA,EACzE;AAAA,EAEA,SAAU,QAAQ;AAChB,QAAI,OAAO,WAAW,UAAU;AAC9B,eAAS,EAAE,MAAM,KAAK,SAAS,OAAO,KAAK,QAAQ;AAAA,IACrD;AAEA,QAAI,OAAO,WAAW,UAAU;AAC9B,eAAS,OAAO,OAAO,EAAE,OAAO,KAAK,GAAG,MAAM;AAAA,IAChD,WAAW,OAAO,WAAW,YAAY;AACvC,YAAM,QAAQ,OAAO,eAAe,IAAI;AACxC,UAAI,SAAS,MAAM,OAAO,UAAU,QAAQ;AAAE,iBAAS,OAAO,KAAK,IAAI;AAAA,MAAE;AACzE,eAAS,EAAE,MAAM,QAAQ,OAAO,OAAO;AAAA,IACzC,OAAO;AACL,YAAM,IAAI,MAAM,6CAA6C;AAAA,IAC/D;AAEA,WAAO,2BAA2B,KAAK;AACvC,WAAO,KAAK,cAAc,SAAS,MAAM,CAAC;AAAA,EAC5C;AAAA,EASA,oBAAqB,MAAM;AACzB,UAAM,OAAO,KAAK,GAAG,WAAW,KAAK,MAAM,IAAI,KAAK;AACpD,UAAM,CAAC,MAAM,KAAK,WAAW;AAC7B,UAAM,UAAU,OAAO,QAAQ,WAAW,KAAK,KAAK,KAAK,IAAI,IAAI;AACjE,SAAK,mBAAmB,MAAM,MAAM,SAAS,OAAO;AAAA,EACtD;AAAA,EAEA,mBAAoB,MAAM,WAAW,SAAS,SAAS;AACrD,SAAK,iBAAiB,WAAW,SAAS,OAAO;AACjD,uBAAoB;AAAE,WAAK,oBAAoB,WAAW,OAAO;AAAA,IAAE;AACnE,uBAAmB,MAAM,OAAO;AAChC,SAAK,cAAc,EAAE,QAAQ,CAAC;AAAA,EAChC;AAAA,EAEA,SAAU,iBAAiB;AACzB,QAAI,mBAAmB,iBAAiB;AACtC,sBAAgB,cAAc,IAAI;AAClC,WAAK,eAAe;AAAA,IACtB,OAAO;AACL,WAAK,eAAe;AACpB,yBAAmB,iBAAiB,MAAM,KAAK,iBAAiB,mBAAmB,KAAK,QAAQ,CAAC;AAAA,IACnG;AAAA,EACF;AAAA,EAEA,UAAW;AACT,UAAM,gBAAgB,KAAK,kBAAkB,CAAC;AAC9C,kBAAc,QAAQ,OAAK,EAAE,QAAQ,CAAC;AACtC,SAAK,iBAAiB,CAAC;AACvB,SAAK,eAAe;AAAA,EACtB;AAAA,EAEA,cAAe,cAAc;AAC3B,UAAM,gBAAgB,KAAK,kBAAkB,CAAC;AAC9C,QAAI,CAAC,KAAK,gBAAgB;AAAE,WAAK,iBAAiB;AAAA,IAAc;AAChE,QAAI,OAAO,aAAa,YAAY,YAAY;AAC9C,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AACA,kBAAc,KAAK,YAAY;AAC/B,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}