grainjs 1.0.1 → 1.1.0

package/README.md

@@ -1,41 +1,38 @@
-# GrainJS
+# GrainJS: a light typescript web framework
 
 [![npm version](https://badge.fury.io/js/grainjs.svg)](https://badge.fury.io/js/grainjs)
-[![Build Status](https://travis-ci.org/gristlabs/grainjs.svg?branch=master)](https://travis-ci.org/gristlabs/grainjs)
+[![Build status](https://github.com/gristlabs/grainjs/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/gristlabs/grainjs/actions/workflows/build-and-test.yml)
+[![codecov](https://codecov.io/gh/gristlabs/grainjs/branch/main/graph/badge.svg?token=1OIMMBLI6N)](https://codecov.io/gh/gristlabs/grainjs)
 
-GrainJS is a Javascript (and TypeScript) library for building highly performant dynamic
-applications.
+GrainJS is a JavaScript / TypeScript library for building dynamic web applications.
 
-GrainJS provides convenient pure-JS interfaces for building DOM. It has observables inspired by
-[Knockout](http://knockoutjs.com/documentation/introduction.html) to create declarative data
-models and tie them to UI. It includes light-weight event dispatching, DOM event subscriptions,
-disposable components, and in-code CSS styling.
+- It's in part inspired by [React](https://reactjs.org/), but based on observables (like
+[Knockout](http://knockoutjs.com/documentation/introduction.html)) instead of virtual dom.
+- It is lightweight, has no dependencies, and takes only ~30KB minified.
+- It needs no special tooling. It's nothing more than a library.
+- It supports convenient DOM-building in JS, event dispatching, DOM event subscriptions,
+  disposable components, and in-code CSS styling.
+- It's fully typed for use with TypeScript.
+- It's proven its worth by powering [Grist](https://github.com/gristlabs/grist-core#grist)'s rich
+  frontend app.
 
-GrainJS is in part inspired by [React](https://reactjs.org/), but based on observables instead of
-virtual dom, and with a convenient way to build DOM without JSX. It is lighter weight, and has
-less magic happening under the covers.
+## Documentation
 
-The focus is on performance and conciseness. The library has no dependencies and is only 25K
-minified.
+For docs, visit [https://gristlabs.github.io/grainjs/](https://gristlabs.github.io/grainjs/).
 
 ## Installation
 
-```
-npm install --save grainjs
+```sh
+npm install grainjs
 ```
 
-## Usage
+Or see [Getting started with GrainJS](https://gristlabs.github.io/grainjs/getting-started.html).
 
-Until proper documentation pages are created, see documentation in individual code files under the
-`lib` directory.
+## Examples
 
-Example:
+See basic examples in [Quick tour](https://gristlabs.github.io/grainjs/#quick-tour) or complete examples
+at [Examples](https://gristlabs.github.io/grainjs/examples.html).
 
-```typescript
-const name = observable("");
+## License
 
-dom.update(document.body,
-  input(name, {onInput: true}, {type: "text", placeholder: "Your name..."),
-  dom("div.name-class", "Hello, ", dom.text(name), "!"),
-);
-```
+GrainJS is licensed under [Apache-2.0 license](https://github.com/gristlabs/grainjs/blob/main/LICENSE).

package/dist/cjs/index.js

@@ -1,20 +1,31 @@
 "use strict";
-function __export(m) {
-    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
-}
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-__export(require("./lib/binding"));
-__export(require("./lib/computed"));
-__export(require("./lib/dispose"));
-__export(require("./lib/dom"));
-__export(require("./lib/emit"));
-__export(require("./lib/kowrap"));
-__export(require("./lib/obsArray"));
-__export(require("./lib/observable"));
-__export(require("./lib/pureComputed"));
-__export(require("./lib/styled"));
-__export(require("./lib/subscribe"));
-__export(require("./lib/util"));
-__export(require("./lib/widgets/input"));
-__export(require("./lib/widgets/select"));
+__exportStar(require("./lib/binding"), exports);
+__exportStar(require("./lib/computed"), exports);
+__exportStar(require("./lib/dispose"), exports);
+__exportStar(require("./lib/dom"), exports);
+__exportStar(require("./lib/emit"), exports);
+__exportStar(require("./lib/kowrap"), exports);
+__exportStar(require("./lib/obsArray"), exports);
+__exportStar(require("./lib/observable"), exports);
+__exportStar(require("./lib/pureComputed"), exports);
+__exportStar(require("./lib/styled"), exports);
+__exportStar(require("./lib/subscribe"), exports);
+__exportStar(require("./lib/util"), exports);
+__exportStar(require("./lib/widgets/input"), exports);
+__exportStar(require("./lib/widgets/select"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":";;;;;AAAA,mCAA8B;AAC9B,oCAA+B;AAC/B,mCAA8B;AAC9B,+BAA0B;AAC1B,gCAA2B;AAC3B,kCAA6B;AAC7B,oCAA+B;AAC/B,sCAAiC;AACjC,wCAAmC;AACnC,kCAA6B;AAC7B,qCAAgC;AAChC,gCAA2B;AAC3B,yCAAoC;AACpC,0CAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,iDAA+B;AAC/B,gDAA8B;AAC9B,4CAA0B;AAC1B,6CAA2B;AAC3B,+CAA6B;AAC7B,iDAA+B;AAC/B,mDAAiC;AACjC,qDAAmC;AACnC,+CAA6B;AAC7B,kDAAgC;AAChC,6CAA2B;AAC3B,sDAAoC;AACpC,uDAAqC"}

package/dist/cjs/lib/PriorityQueue.d.ts

@@ -6,12 +6,12 @@
  * It is constructed with a function that returns which of two items is "prior"; the pop() method
  * returns the most-prior element.
  */
-export declare type IsPriorFunc<T> = (a: T, b: T) => boolean;
+export type IsPriorFunc<T> = (a: T, b: T) => boolean;
 export declare class PriorityQueue<T> {
     private _isPrior;
     private _items;
     constructor(_isPrior: IsPriorFunc<T>);
-    readonly size: number;
+    get size(): number;
     push(item: T): void;
     peek(): T | undefined;
     pop(): T | undefined;

package/dist/cjs/lib/PriorityQueue.js

@@ -8,6 +8,7 @@
  * returns the most-prior element.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriorityQueue = void 0;
 class PriorityQueue {
     constructor(_isPrior) {
         this._isPrior = _isPrior;

package/dist/cjs/lib/PriorityQueue.js.map

@@ -1 +1 @@
-{"version":3,"file":"PriorityQueue.js","sourceRoot":"","sources":["../../../lib/PriorityQueue.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAIH,MAAa,aAAa;IAMxB,YAAoB,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;QAL5C,4FAA4F;QAC5F,8FAA8F;QAC9F,8CAA8C;QACtC,WAAM,GAAQ,EAAE,CAAC;IAEsB,CAAC;IAEhD,IAAW,IAAI,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjD,IAAI,CAAC,IAAO;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE9B,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAChC,OAAO,MAAM,GAAG,CAAC,EAAE;YACjB,wFAAwF;YACxF,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAG,iCAAiC;YACrE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;gBAC1B,MAAM;aACP;YACD,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;YACxB,MAAM,GAAG,MAAM,CAAC;SACjB;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvB,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAEM,GAAG;QACR,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;SAAE;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAExB,gDAAgD;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAChC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,OAAO,OAAO,GAAG,IAAI,EAAE;YACrB,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,CAAC,QAAQ,GAAG,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7E,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YACrB,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE;gBACjC,MAAM;aACP;YACD,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,GAAG,OAAO,CAAC;YACjB,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;SAC/B;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAzDD,sCAyDC"}
+{"version":3,"file":"PriorityQueue.js","sourceRoot":"","sources":["../../../lib/PriorityQueue.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAIH,MAAa,aAAa;IAMxB,YAAoB,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;QAL5C,4FAA4F;QAC5F,8FAA8F;QAC9F,8CAA8C;QACtC,WAAM,GAAQ,EAAE,CAAC;IAEsB,CAAC;IAEhD,IAAW,IAAI,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjD,IAAI,CAAC,IAAO;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE9B,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAChC,OAAO,MAAM,GAAG,CAAC,EAAE;YACjB,wFAAwF;YACxF,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAG,iCAAiC;YACrE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;gBAC1B,MAAM;aACP;YACD,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;YACxB,MAAM,GAAG,MAAM,CAAC;SACjB;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvB,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAEM,GAAG;QACR,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;SAAE;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAExB,gDAAgD;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAChC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,OAAO,OAAO,GAAG,IAAI,EAAE;YACrB,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,CAAC,QAAQ,GAAG,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7E,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YACrB,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE;gBACjC,MAAM;aACP;YACD,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,GAAG,OAAO,CAAC;YACjB,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;SAC/B;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAzDD,sCAyDC"}

package/dist/cjs/lib/_computed_queue.js

@@ -17,12 +17,16 @@
  * call, or of bundleChanges() call, the queue gets processed in order of _priority.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.bundleChanges = exports.compute = exports._getPriority = exports.DepItem = void 0;
 const PriorityQueue_1 = require("./PriorityQueue");
 /**
  * DepItem is an item in a dependency relationship. It may depend on other DepItems. It is used
  * for subscriptions and computed observables.
  */
 class DepItem {
+    static isPrioritySmaller(a, b) {
+        return a._priority < b._priority || (a._priority === b._priority && a._creation < b._creation);
+    }
     /**
      * Callback should call depItem.useDep(dep) for each DepInput it depends on.
      */
@@ -34,9 +38,6 @@ class DepItem {
         this._callback = callback;
         this._context = optContext;
     }
-    static isPrioritySmaller(a, b) {
-        return a._priority < b._priority || (a._priority === b._priority && a._creation < b._creation);
-    }
     /**
      * Mark depItem as a dependency of this DepItem. The argument may be null to indicate a leaf (an
      * item such as a plain observable, which does not itself depend on anything else).

package/dist/cjs/lib/_computed_queue.js.map

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

package/dist/cjs/lib/binding.d.ts

@@ -6,8 +6,15 @@ import { IDisposable } from './dispose';
 import { IKnockoutReadObservable, InferKoType } from './kowrap';
 import { BaseObservable } from './observable';
 import { UseCBOwner } from './subscribe';
-export declare type BindableValue<T> = BaseObservable<T> | ComputedCallback<T> | T | IKnockoutReadObservable<T>;
-export declare type ComputedCallback<T> = (use: UseCBOwner, ...args: any[]) => T;
+/**
+ * Any of the value types that DOM methods know how to subscribe to: a plain value (like a
+ * string); an Observable (including a Computed); a knockout observable; a function.
+ *
+ * If a function, it's used to create a `Computed`, and will be called with a context function
+ * `use`, allowing it to depend on other observable values (see documentation for `Computed`).
+ */
+export type BindableValue<T> = BaseObservable<T> | ComputedCallback<T> | T | IKnockoutReadObservable<T>;
+export type ComputedCallback<T> = (use: UseCBOwner, ...args: any[]) => T;
 /**
  * Subscribes a callback to valueObs, which may be one a plain value, an observable, a knockout
  * observable, or a function. If a function, it's used to create a computed() and will be called
@@ -22,7 +29,7 @@ export declare type ComputedCallback<T> = (use: UseCBOwner, ...args: any[]) => T
 export declare function subscribeBindable<KObs extends IKnockoutReadObservable<any>>(valueObs: KObs, callback: (val: InferKoType<KObs>) => void): IDisposable | null;
 export declare function subscribeBindable<T>(valueObs: BindableValue<T>, callback: (val: T) => void): IDisposable | null;
 /**
- * Subscribes a callback to valueObs (which may be a value, observable, or function) using
- * subscribe(), and disposes the subscription with the passed-in element.
+ * Subscribes a callback to `valueObs` (which may be a value, observable, or function) using
+ * `subscribeBindable()`, and ties the disposal of this subscription to the passed-in element.
  */
 export declare function subscribeElem<T>(elem: Node, valueObs: BindableValue<T>, callback: (newVal: T, oldVal?: T) => void): void;

package/dist/cjs/lib/binding.js

@@ -4,6 +4,7 @@
  * a plain value, or a function from which it builds a computed.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscribeElem = exports.subscribeBindable = void 0;
 const computed_1 = require("./computed");
 const domDispose_1 = require("./domDispose");
 const observable_1 = require("./observable");
@@ -22,7 +23,7 @@ function subscribeBindable(valueObs, callback) {
         //    let sub = subscribe(use => callback(valueObs(use)));
         // The difference is that when valueObs() evaluates to unchanged value, callback would be
         // called in the version above, but not in the version below.
-        const comp = computed_1.computed(valueObs);
+        const comp = (0, computed_1.computed)(valueObs);
         comp.addListener((val) => callback(val));
         callback(comp.get());
         return comp; // Disposing this will dispose its one listener.
@@ -31,18 +32,18 @@ function subscribeBindable(valueObs, callback) {
     if (valueObs instanceof observable_1.BaseObservable) {
         // Use subscribe() rather than addListener(), so that bundling of changes (implicit and with
         // bundleChanges()) is respected. This matters when callback also uses observables.
-        return subscribe_1.subscribe(valueObs, (use, val) => callback(val));
+        return (0, subscribe_1.subscribe)(valueObs, (use, val) => callback(val));
     }
     callback(valueObs);
     return null;
 }
 exports.subscribeBindable = subscribeBindable;
 /**
- * Subscribes a callback to valueObs (which may be a value, observable, or function) using
- * subscribe(), and disposes the subscription with the passed-in element.
+ * Subscribes a callback to `valueObs` (which may be a value, observable, or function) using
+ * `subscribeBindable()`, and ties the disposal of this subscription to the passed-in element.
  */
 function subscribeElem(elem, valueObs, callback) {
-    domDispose_1.autoDisposeElem(elem, subscribeBindable(valueObs, callback));
+    (0, domDispose_1.autoDisposeElem)(elem, subscribeBindable(valueObs, callback));
 }
 exports.subscribeElem = subscribeElem;
 //# sourceMappingURL=binding.js.map

package/dist/cjs/lib/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../lib/binding.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAEH,yCAAoC;AAEpC,6CAA6C;AAE7C,6CAA4C;AAC5C,2CAAkD;AAsBlD,SAAgB,iBAAiB,CAC7B,QAA0B,EAAE,QAA0B;IACxD,wEAAwE;IACxE,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;QAClC,uBAAuB;QACvB,MAAM,OAAO,GAAG,QAAsC,CAAC;QACvD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE;YACtC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACzB,OAAO,GAAG,CAAC;SACZ;QAED,6EAA6E;QAC7E,0DAA0D;QAC1D,yFAAyF;QACzF,6DAA6D;QAC7D,MAAM,IAAI,GAAG,mBAAQ,CAAC,QAA+B,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,CAAM,gDAAgD;KACnE;IAED,iBAAiB;IACjB,IAAI,QAAQ,YAAY,2BAAc,EAAE;QACtC,4FAA4F;QAC5F,mFAAmF;QACnF,OAAO,qBAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD;IAED,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AA/BD,8CA+BC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAI,IAAU,EAAE,QAA0B,EACtC,QAAyC;IACxE,4BAAe,CAAC,IAAI,EAAE,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/D,CAAC;AAHD,sCAGC"}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../lib/binding.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yCAAoC;AAEpC,6CAA6C;AAE7C,6CAA4C;AAC5C,2CAAkD;AA6BlD,SAAgB,iBAAiB,CAC7B,QAA0B,EAAE,QAA0B;IACxD,wEAAwE;IACxE,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;QAClC,uBAAuB;QACvB,MAAM,OAAO,GAAG,QAAsC,CAAC;QACvD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE;YACtC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACzB,OAAO,GAAG,CAAC;SACZ;QAED,6EAA6E;QAC7E,0DAA0D;QAC1D,yFAAyF;QACzF,6DAA6D;QAC7D,MAAM,IAAI,GAAG,IAAA,mBAAQ,EAAC,QAA+B,CAAC,CAAC;QACvD,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,CAAM,gDAAgD;KACnE;IAED,iBAAiB;IACjB,IAAI,QAAQ,YAAY,2BAAc,EAAE;QACtC,4FAA4F;QAC5F,mFAAmF;QACnF,OAAO,IAAA,qBAAS,EAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;KACzD;IAED,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AA/BD,8CA+BC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAI,IAAU,EAAE,QAA0B,EACtC,QAAyC;IACxE,IAAA,4BAAe,EAAC,IAAI,EAAE,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/D,CAAC;AAHD,sCAGC"}

package/dist/cjs/lib/browserGlobals.d.ts

@@ -25,11 +25,14 @@ export interface IBrowserGlobals {
     document: typeof document;
     window: typeof window;
 }
+export interface IBrowserGlobalsLax extends IBrowserGlobals {
+    window: any;
+}
 export declare const G: IBrowserGlobals;
 /**
  * Replace globals with those from the given object. Use popGlobals() to restore previous values.
  */
-export declare function pushGlobals(globals: IBrowserGlobals): void;
+export declare function pushGlobals(globals: IBrowserGlobalsLax): void;
 /**
  * Restore the values of globals to undo the preceding pushGlobals() call.
  */

package/dist/cjs/lib/browserGlobals.js

@@ -20,6 +20,8 @@
  *    });
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.popGlobals = exports.pushGlobals = exports.G = void 0;
+;
 function _updateGlobals(dest, source) {
     dest.DocumentFragment = source.DocumentFragment;
     dest.Element = source.Element;

package/dist/cjs/lib/browserGlobals.js.map

@@ -1 +1 @@
-{"version":3,"file":"browserGlobals.js","sourceRoot":"","sources":["../../../lib/browserGlobals.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;AAUH,SAAS,cAAc,CAAC,IAAqB,EAAE,MAAuB;IACpE,IAAI,CAAC,gBAAgB,GAAI,MAAM,CAAC,gBAAgB,CAAC;IACjD,IAAI,CAAC,OAAO,GAAa,MAAM,CAAC,OAAO,CAAC;IACxC,IAAI,CAAC,IAAI,GAAgB,MAAM,CAAC,IAAI,CAAC;IACrC,IAAI,CAAC,QAAQ,GAAY,MAAM,CAAC,QAAQ,CAAC;IACzC,IAAI,CAAC,MAAM,GAAc,MAAM,CAAC,MAAM,CAAC;AACzC,CAAC;AAED,sCAAsC;AACtC,MAAM,OAAO,GAAoB,EAAqB,CAAC;AACvD,cAAc,CAAC,OAAO,EAAE,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE9E,4DAA4D;AAC/C,QAAA,CAAC,qBAAyB,OAAO,EAAG;AAEjD,uFAAuF;AACvF,MAAM,aAAa,GAAsB,CAAC,OAAO,CAAC,CAAC;AAEnD;;GAEG;AACH,SAAgB,WAAW,CAAC,OAAwB;IAClD,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,cAAc,CAAC,SAAC,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAHD,kCAGC;AAED;;GAEG;AACH,SAAgB,UAAU;IACxB,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE;QAC5B,aAAa,CAAC,GAAG,EAAE,CAAC;KACrB;IACD,cAAc,CAAC,SAAC,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AALD,gCAKC"}
+{"version":3,"file":"browserGlobals.js","sourceRoot":"","sources":["../../../lib/browserGlobals.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAUsE,CAAC;AAE1E,SAAS,cAAc,CAAC,IAAqB,EAAE,MAAuB;IACpE,IAAI,CAAC,gBAAgB,GAAI,MAAM,CAAC,gBAAgB,CAAC;IACjD,IAAI,CAAC,OAAO,GAAa,MAAM,CAAC,OAAO,CAAC;IACxC,IAAI,CAAC,IAAI,GAAgB,MAAM,CAAC,IAAI,CAAC;IACrC,IAAI,CAAC,QAAQ,GAAY,MAAM,CAAC,QAAQ,CAAC;IACzC,IAAI,CAAC,MAAM,GAAc,MAAM,CAAC,MAAM,CAAC;AACzC,CAAC;AAED,sCAAsC;AACtC,MAAM,OAAO,GAAoB,EAAqB,CAAC;AACvD,cAAc,CAAC,OAAO,EAAE,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE9E,4DAA4D;AAC/C,QAAA,CAAC,qBAAyB,OAAO,EAAG;AAEjD,uFAAuF;AACvF,MAAM,aAAa,GAAsB,CAAC,OAAO,CAAC,CAAC;AAEnD;;GAEG;AACH,SAAgB,WAAW,CAAC,OAA2B;IACrD,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,cAAc,CAAC,SAAC,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAHD,kCAGC;AAED;;GAEG;AACH,SAAgB,UAAU;IACxB,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE;QAC5B,aAAa,CAAC,GAAG,EAAE,CAAC;KACrB;IACD,cAAc,CAAC,SAAC,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AALD,gCAKC"}

package/dist/cjs/lib/computed.d.ts

@@ -1,44 +1,62 @@
+import { DepItem } from './_computed_queue';
+import { IDisposableOwnerT } from './dispose';
+import { BaseObservable as Obs, Observable } from './observable';
+import { ISubscribable, UseCBOwner as UseCB } from './subscribe';
+/** @internal */
+type Owner<T> = IDisposableOwnerT<Computed<T>> | null;
 /**
- * computed.js implements a computed observable, whose value depends on other observables and gets
+ * `Computed` implements a computed observable, whose value depends on other observables and gets
  * recalculated automatically when they change.
  *
- * E.g. if we have some existing observables (which may themselves be instances of `computed`),
+ * E.g. if we have some existing observables (which may themselves be instances of `Computed`),
  * we can create a computed that subscribes to them explicitly:
- *  let obs1 = observable(5), obs2 = observable(12);
- *  let computed1 = computed(obs1, obs2, (use, v1, v2) => v1 + v2);
+ * ```ts
+ * const obs1 = Observable.create(null, 5), obs2 = Observable.create(null, 12);
+ * const computed1 = Computed.create(null, obs1, obs2, (use, v1, v2) => v1 + v2);
+ * ```
  *
  * or implicitly by using `use(obs)` function:
- *  let computed2 = computed(use => use(obs1) + use(obs2));
+ * ```ts
+ * const computed2 = Computed.create(null, use => use(obs1) + use(obs2));
+ * ```
  *
- * In either case, computed1.get() and computed2.get() will have the value 17. If obs1 or obs2 is
- * changed, computed1 and computed2 will get recomputed automatically.
+ * In either case, `computed1.get()` and `computed2.get()` will have the value 17. If `obs1` or
+ * `obs2` is changed, `computed1` and `computed2` will get recomputed automatically.
  *
  * Creating a computed allows any number of dependencies to be specified explicitly, and their
- * values will be passed to the read() callback. These may be combined with automatic dependencies
- * detected using use(). Note that constructor dependencies have less overhead.
- *
- *  let val = computed(...deps, ((use, ...depValues) => READ_CALLBACK));
+ * values will be passed to the `read()` callback. These may be combined with automatic dependencies
+ * detected using `use()`. Note that constructor dependencies have less overhead.
+ * ```ts
+ * const val = Computed.create(null, ...deps, ((use, ...depValues) => READ_CALLBACK));
+ * ```
  *
  * You may specify a `write` callback by calling `onWrite(WRITE_CALLBACK)`, which will be called
- * whenever set() is called on the computed by its user. If a `write` bacllback is not specified,
+ * whenever `set()` is called on the computed by its user. If a `write` bacllback is not specified,
  * calling `set` on a computed observable will throw an exception.
  *
- * Note that pureComputed.js offers a variation of computed() with the same interface, but which
+ * Note that `PureComputed` offers a variation of `Computed` with the same interface, but which
  * stays unsubscribed from dependencies while it itself has no subscribers.
  *
  * A computed may be used with a disposable value using `use.owner` as the value's owner. E.g.
- *    let val = computed((use) => Foo.create(use.owner, use(a), use(b)));
+ * ```ts
+ * const val = Computed.create(null, ((use) => Foo.create(use.owner, use(a), use(b)));
+ * ```
  *
- * When the computed() is re-evaluated, and when it itself is disposed, it disposes the previously
- * owned value. Note that only the pattern above works, i.e. use.owner may only be used to take
+ * When the `Computed` is re-evaluated, and when it itself is disposed, it disposes the previously
+ * owned value. Note that only the pattern above works, i.e. `use.owner` may only be used to take
  * ownership of the same disposable that the callback returns.
  */
-import { DepItem } from './_computed_queue';
-import { IDisposableOwnerT } from './dispose';
-import { BaseObservable as Obs, Observable } from './observable';
-import { ISubscribable, UseCBOwner as UseCB } from './subscribe';
-declare type Owner<T> = IDisposableOwnerT<Computed<T>> | null;
 export declare class Computed<T> extends Observable<T> {
+    /**
+     * Creates a new Computed, owned by the given owner.
+     * @param owner - Object to own this Computed, or null to handle disposal manually.
+     * @param observables - Zero or more observables on which this computes depends. The callback
+     *        will get called when any of these changes.
+     * @param callback - Read callback that will be called with `(use, ...values)`,
+     *    i.e. the `use` function and values for all of the `...observables`. The callback is called
+     *    immediately and whenever any dependency changes.
+     * @returns The newly created `Computed` observable.
+     */
     static create<T>(owner: Owner<T>, cb: (use: UseCB) => T): Computed<T>;
     static create<T, A>(owner: Owner<T>, a: Obs<A>, cb: (use: UseCB, a: A) => T): Computed<T>;
     static create<T, A, B>(owner: Owner<T>, a: Obs<A>, b: Obs<B>, cb: (use: UseCB, a: A, b: B) => T): Computed<T>;
@@ -48,18 +66,16 @@ export declare class Computed<T> extends Observable<T> {
     private _callback;
     private _write;
     private _sub;
-    /**
-     * Internal constructor for a Computed observable. You should use computed() function instead.
-     */
     constructor(callback: (use: UseCB, ...args: any[]) => T, dependencies: ISubscribable[]);
     /**
      * Used by subscriptions to keep track of dependencies.
+     * @internal
      */
     _getDepItem(): DepItem;
     /**
      * "Sets" the value of the computed by calling the write() callback if one was provided in the
      * constructor. Throws an error if there was no such callback (not a "writable" computed).
-     * @param {Object} value: The value to pass to the write() callback.
+     * @param value - The value to pass to the write() callback.
      */
     set(value: T): void;
     /**
@@ -74,9 +90,14 @@ export declare class Computed<T> extends Observable<T> {
     private _read;
 }
 /**
- * This is the type-checking interface for computed(), which allows TypeScript to do helpful
- * type-checking when using it. We can only support a fixed number of argumnets (explicit
- * dependencies), but 5 should almost always be enough.
+ * Creates a new Computed.
+ * @param observables - The initial params, of which there may be zero or more, are
+ *    observables on which this computed depends. When any of them change, the `read()` callback
+ *    will be called with the values of these observables as arguments.
+ * @param readCallback - Read callback that will be called with `(use, ...values)`,
+ *    i.e. the `use` function and values for all of the `...observables`. The callback is called
+ *    immediately and whenever any dependency changes.
+ * @returns The newly created `Computed` observable.
  */
 export declare function computed<T>(cb: (use: UseCB) => T): Computed<T>;
 export declare function computed<T, A>(a: Obs<A>, cb: (use: UseCB, a: A) => T): Computed<T>;

package/dist/cjs/lib/computed.js

@@ -1,50 +1,60 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computed = exports.Computed = void 0;
+const dispose_1 = require("./dispose");
+const observable_1 = require("./observable");
+const subscribe_1 = require("./subscribe");
+function _noWrite() {
+    throw new Error("Can't write to non-writable computed");
+}
 /**
- * computed.js implements a computed observable, whose value depends on other observables and gets
+ * `Computed` implements a computed observable, whose value depends on other observables and gets
  * recalculated automatically when they change.
  *
- * E.g. if we have some existing observables (which may themselves be instances of `computed`),
+ * E.g. if we have some existing observables (which may themselves be instances of `Computed`),
  * we can create a computed that subscribes to them explicitly:
- *  let obs1 = observable(5), obs2 = observable(12);
- *  let computed1 = computed(obs1, obs2, (use, v1, v2) => v1 + v2);
+ * ```ts
+ * const obs1 = Observable.create(null, 5), obs2 = Observable.create(null, 12);
+ * const computed1 = Computed.create(null, obs1, obs2, (use, v1, v2) => v1 + v2);
+ * ```
  *
  * or implicitly by using `use(obs)` function:
- *  let computed2 = computed(use => use(obs1) + use(obs2));
+ * ```ts
+ * const computed2 = Computed.create(null, use => use(obs1) + use(obs2));
+ * ```
  *
- * In either case, computed1.get() and computed2.get() will have the value 17. If obs1 or obs2 is
- * changed, computed1 and computed2 will get recomputed automatically.
+ * In either case, `computed1.get()` and `computed2.get()` will have the value 17. If `obs1` or
+ * `obs2` is changed, `computed1` and `computed2` will get recomputed automatically.
  *
  * Creating a computed allows any number of dependencies to be specified explicitly, and their
- * values will be passed to the read() callback. These may be combined with automatic dependencies
- * detected using use(). Note that constructor dependencies have less overhead.
- *
- *  let val = computed(...deps, ((use, ...depValues) => READ_CALLBACK));
+ * values will be passed to the `read()` callback. These may be combined with automatic dependencies
+ * detected using `use()`. Note that constructor dependencies have less overhead.
+ * ```ts
+ * const val = Computed.create(null, ...deps, ((use, ...depValues) => READ_CALLBACK));
+ * ```
  *
  * You may specify a `write` callback by calling `onWrite(WRITE_CALLBACK)`, which will be called
- * whenever set() is called on the computed by its user. If a `write` bacllback is not specified,
+ * whenever `set()` is called on the computed by its user. If a `write` bacllback is not specified,
  * calling `set` on a computed observable will throw an exception.
  *
- * Note that pureComputed.js offers a variation of computed() with the same interface, but which
+ * Note that `PureComputed` offers a variation of `Computed` with the same interface, but which
  * stays unsubscribed from dependencies while it itself has no subscribers.
  *
  * A computed may be used with a disposable value using `use.owner` as the value's owner. E.g.
- *    let val = computed((use) => Foo.create(use.owner, use(a), use(b)));
+ * ```ts
+ * const val = Computed.create(null, ((use) => Foo.create(use.owner, use(a), use(b)));
+ * ```
  *
- * When the computed() is re-evaluated, and when it itself is disposed, it disposes the previously
- * owned value. Note that only the pattern above works, i.e. use.owner may only be used to take
+ * When the `Computed` is re-evaluated, and when it itself is disposed, it disposes the previously
+ * owned value. Note that only the pattern above works, i.e. `use.owner` may only be used to take
  * ownership of the same disposable that the callback returns.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-const dispose_1 = require("./dispose");
-const observable_1 = require("./observable");
-const subscribe_1 = require("./subscribe");
-function _noWrite() {
-    throw new Error("Can't write to non-writable computed");
-}
 class Computed extends observable_1.Observable {
-    /**
-     * Internal constructor for a Computed observable. You should use computed() function instead.
-     */
+    static create(owner, ...args) {
+        const readCb = args.pop();
+        return (0, dispose_1.setDisposeOwner)(owner, new Computed(readCb, args));
+    }
+    // Internal constructor for a Computed observable. You should use computed() function instead.
     constructor(callback, dependencies) {
         // At initialization we force an undefined value even though it's not of type T: it gets set
         // to a proper value during the creation of new Subscription, which calls this._read.
@@ -53,22 +63,9 @@ class Computed extends observable_1.Observable {
         this._write = _noWrite;
         this._sub = new subscribe_1.Subscription(this._read.bind(this), dependencies, this);
     }
-    /**
-     * Creates a new Computed, owned by the given owner.
-     * @param owner: Object to own this Computed, or null to handle disposal manually.
-     * @param ...observables: Zero or more observables on which this computes depends. The callback
-     *        will get called when any of these changes.
-     * @param callback: Read callback that will be called with (use, ...values),
-     *    i.e. the `use` function and values for all of the ...observables. The callback is called
-     *    immediately and whenever any dependency changes.
-     * @returns {Computed} The newly created computed observable.
-     */
-    static create(owner, ...args) {
-        const readCb = args.pop();
-        return dispose_1.setDisposeOwner(owner, new Computed(readCb, args));
-    }
     /**
      * Used by subscriptions to keep track of dependencies.
+     * @internal
      */
     _getDepItem() {
         return this._sub._getDepItem();
@@ -76,7 +73,7 @@ class Computed extends observable_1.Observable {
     /**
      * "Sets" the value of the computed by calling the write() callback if one was provided in the
      * constructor. Throws an error if there was no such callback (not a "writable" computed).
-     * @param {Object} value: The value to pass to the write() callback.
+     * @param value - The value to pass to the write() callback.
      */
     set(value) { this._write(value); }
     /**
@@ -99,16 +96,6 @@ class Computed extends observable_1.Observable {
     }
 }
 exports.Computed = Computed;
-/**
- * Creates a new Computed.
- * @param {Observable} ...observables: The initial params, of which there may be zero or more, are
- *    observables on which this computed depends. When any of them change, the read() callback
- *    will be called with the values of these observables as arguments.
- * @param {Function} readCallback: Read callback that will be called with (use, ...values),
- *    i.e. the `use` function and values for all of the ...observables. The callback is called
- *    immediately and whenever any dependency changes.
- * @returns {Computed} The newly created computed observable.
- */
 function computed(...args) {
     const readCb = args.pop();
     return new Computed(readCb, args);

package/dist/cjs/lib/computed.js.map

@@ -1 +1 @@
-{"version":3,"file":"computed.js","sourceRoot":"","sources":["../../../lib/computed.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;AAGH,uCAA6D;AAC7D,6CAA+D;AAC/D,2CAA6E;AAE7E,SAAS,QAAQ;IACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC;AAID,MAAa,QAAY,SAAQ,uBAAa;IAuC5C;;OAEG;IACH,YAAY,QAA2C,EAAE,YAA6B;QACpF,4FAA4F;QAC5F,qFAAqF;QACrF,KAAK,CAAC,SAAgB,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,wBAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IA7BD;;;;;;;;;OASG;IACI,MAAM,CAAC,MAAM,CAAI,KAA0C,EAAE,GAAG,IAAW;QAChF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,OAAO,yBAAe,CAAC,KAAK,EAAE,IAAI,QAAQ,CAAI,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAkBD;;OAEG;IACI,WAAW;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,KAAQ,IAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAElD;;;OAGG;IACI,OAAO,CAAC,SAA6B;QAC1C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,GAAQ,EAAE,GAAG,IAAW;QACpC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAY,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;CACF;AArFD,4BAqFC;AA6BD;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAC,GAAG,IAAW;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1B,OAAO,IAAI,QAAQ,CAAM,MAAM,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAHD,4BAGC;AAED,kDAAkD;AAClD,2FAA2F;AAC3F,4FAA4F;AAC5F,+EAA+E;AAC/E,EAAE;AACF,yDAAyD;AACzD,wFAAwF;AACxF,oEAAoE;AACpE,qEAAqE;AACrE,uFAAuF;AACvF,kGAAkG;AAClG,oCAAoC"}
+{"version":3,"file":"computed.js","sourceRoot":"","sources":["../../../lib/computed.ts"],"names":[],"mappings":";;;AACA,uCAA6D;AAC7D,6CAA+D;AAC/D,2CAA6E;AAE7E,SAAS,QAAQ;IACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAa,QAAY,SAAQ,uBAAa;IA6BrC,MAAM,CAAC,MAAM,CAAI,KAA0C,EAAE,GAAG,IAAW;QAChF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,OAAO,IAAA,yBAAe,EAAC,KAAK,EAAE,IAAI,QAAQ,CAAI,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAMD,8FAA8F;IAC9F,YAAY,QAA2C,EAAE,YAA6B;QACpF,4FAA4F;QAC5F,qFAAqF;QACrF,KAAK,CAAC,SAAgB,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,wBAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED;;;OAGG;IACI,WAAW;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,KAAQ,IAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAElD;;;OAGG;IACI,OAAO,CAAC,SAA6B;QAC1C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,GAAQ,EAAE,GAAG,IAAW;QACpC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAY,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;CACF;AAnFD,4BAmFC;AAkCD,SAAgB,QAAQ,CAAC,GAAG,IAAW;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1B,OAAO,IAAI,QAAQ,CAAM,MAAM,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAHD,4BAGC;AAED,kDAAkD;AAClD,2FAA2F;AAC3F,4FAA4F;AAC5F,+EAA+E;AAC/E,EAAE;AACF,yDAAyD;AACzD,wFAAwF;AACxF,oEAAoE;AACpE,qEAAqE;AACrE,uFAAuF;AACvF,kGAAkG;AAClG,oCAAoC"}