grainjs 0.1.0 → 1.0.2

package/README.md

@@ -15,7 +15,7 @@ GrainJS is in part inspired by [React](https://reactjs.org/), but based on obser
 virtual dom, and with a convenient way to build DOM without JSX. It is lighter weight, and has
 less magic happening under the covers.
 
-The focus is on performance and conciseness. The library has no dependencies and is only 25K
+The focus is on performance and conciseness. The library has no dependencies and is only 31K.
 minified.
 
 ## Installation
@@ -24,18 +24,63 @@ minified.
 npm install --save grainjs
 ```
 
-## Usage
-
-Until proper documentation pages are created, see documentation in individual code files under the
-`lib` directory.
-
-Example:
+## Basic Example
 
 ```typescript
 const name = observable("");
 
 dom.update(document.body,
-  input(name, {onInput: true}, {type: "text", placeholder: "Your name..."),
-  dom("div.name-class", "Hello, ", dom.text(name), "!"),
+  dom('input', {type: 'text', placeholder: 'Enter your name'},
+    dom.on('input', (ev, elem) => name.set(elem.value)),
+  ),
+  dom('div', 'Hello, ',
+    dom.text((use) => use(name).toUpperCase() || 'Stranger'),
+    '!',
+  ),
 );
 ```
+
+# Documentation
+
+At a basic level, GrainJS allows you to describe DOM structure in one place, using Javascript (or
+TypeScript), and to keep the dynamic aspects of it separated into variables called "observables".
+These observables serve as the model of the UI; other code can update them to cause UI to update,
+without knowing the details of the DOM construction.
+
+In addition, the library provides approaches to create and dispose resources (important for
+long-lived single-page applications), and an assortment of other related tools.
+
+- [DOM & Observables](docs/basics.md)
+  - [DOM Construction](docs/basics.md#dom-construction)
+  - [Observables](docs/basics.md#observables)
+    - [Computed Observables](docs/basics.md#computed-observables)
+  - [DOM Bindings](docs/basics.md#dom-bindings)
+    - [Conditional DOM](docs/basics.md#conditional-dom)
+    - [Repeating DOM](docs/basics.md#repeating-dom)
+    - [DOM Events](docs/basics.md#dom-events)
+  - [Styling DOM](docs/basics.md#styling-dom)
+
+- [Disposables](docs/dispose.md)
+  - [Class Disposable](docs/dispose.md#class-disposable)
+  - [Taking Ownership](docs/dispose.md#taking-ownership)
+  - [Holders](docs/dispose.md#holders)
+  - [Further Notes](docs/dispose.md#further-notes)
+
+- [More on Observables](docs/more-observables.md)
+  - [Subscribe](docs/more-observables.md#subscribe)
+  - [Disposable Values](docs/more-observables.md#disposable-values)
+  - [ObsArray](docs/more-observables.md#obsarray)
+  - [PureComputed](docs/more-observables.md#purecomputed)
+  - [Order of Evaluation](docs/more-observables.md#order-of-evaluation)
+
+- [Miscellaneous](docs/misc.md)
+  - [Event Emitters](docs/misc.md#event-emitters)
+  - [Disposing DOM](docs/misc.md#disposing-dom)
+  - [DOM Components](docs/misc.md#dom-components)
+    - [Functional Components](docs/misc.md#functional-components)
+  - [Knockout Integration](docs/misc.md#knockout-integration)
+
+- [Reference](docs/reference.md)
+  - [DOM Reference](docs/reference.md#dom-reference)
+  - [Disposables Reference](docs/reference.md#disposables-reference)
+  - [Observables Reference](docs/reference.md#observables-reference)

package/dist/cjs/index.d.ts

@@ -1,10 +1,14 @@
-export { Computed, computed } from './lib/computed';
+export * from './lib/binding';
+export * from './lib/computed';
 export * from './lib/dispose';
 export * from './lib/dom';
 export * from './lib/emit';
 export * from './lib/kowrap';
 export * from './lib/obsArray';
 export * from './lib/observable';
+export * from './lib/pureComputed';
 export * from './lib/styled';
-export { ISubscribable, Subscription, subscribe } from './lib/subscribe';
+export * from './lib/subscribe';
 export * from './lib/util';
+export * from './lib/widgets/input';
+export * from './lib/widgets/select';

package/dist/cjs/index.js

@@ -1,20 +1,27 @@
 "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;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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 });
-var computed_1 = require("./lib/computed");
-exports.Computed = computed_1.Computed;
-exports.computed = computed_1.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/styled"));
-var subscribe_1 = require("./lib/subscribe");
-exports.Subscription = subscribe_1.Subscription;
-exports.subscribe = subscribe_1.subscribe;
-__export(require("./lib/util"));
+__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,2CAAkD;AAA1C,8BAAA,QAAQ,CAAA;AAAE,8BAAA,QAAQ,CAAA;AAC1B,mCAA8B;AAC9B,+BAA0B;AAC1B,gCAA2B;AAC3B,kCAA6B;AAC7B,oCAA+B;AAC/B,sCAAiC;AACjC,kCAA6B;AAC7B,6CAAuE;AAAhD,mCAAA,YAAY,CAAA;AAAE,gCAAA,SAAS,CAAA;AAC9C,gCAA2B"}
+{"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

@@ -11,7 +11,7 @@ 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;IAME,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.d.ts

@@ -1,3 +1,20 @@
+/**
+ * This module supports computed observables, organizing them into a priority queue, so that
+ * computeds can be updated just once after multiple bundled changes.
+ *
+ * This module is for internal use only (hence the leading underscore in the name). The only
+ * function useful outside is exposed via the `observable` module as `observable.bundleChanges()`.
+ *
+ * Changes may come together because multiple observables are changed synchronously, or because
+ * multiple computeds depend on a single changed observable. In either case, if a computed depends
+ * on multiple observables that are being changed, we want it to just get updated once when the
+ * changes are complete.
+ *
+ * This is done by maintaining a _priority in each computed, where greater values get evaluated
+ * later (computed with greater values depend on those with smaller values). When a computed needs
+ * updating, it adds itself to the queue using enqueue() method. At the end of an observable.set()
+ * call, or of bundleChanges() call, the queue gets processed in order of _priority.
+ */
 /**
  * DepItem is an item in a dependency relationship. It may depend on other DepItems. It is used
  * for subscriptions and computed observables.
@@ -8,6 +25,7 @@ export declare class DepItem {
     private _enqueued;
     private _callback;
     private _context?;
+    private _creation;
     /**
      * Callback should call depItem.useDep(dep) for each DepInput it depends on.
      */

package/dist/cjs/lib/_computed_queue.js

@@ -17,6 +17,7 @@
  * 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
@@ -29,11 +30,13 @@ class DepItem {
     constructor(callback, optContext) {
         this._priority = 0;
         this._enqueued = false;
+        // Order of creation, used for ordering items at same priority.
+        this._creation = ++_nextCreationNum;
         this._callback = callback;
         this._context = optContext;
     }
     static isPrioritySmaller(a, b) {
-        return a._priority < b._priority;
+        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
@@ -65,6 +68,8 @@ class DepItem {
 exports.DepItem = DepItem;
 // The main compute queue.
 const queue = new PriorityQueue_1.PriorityQueue(DepItem.isPrioritySmaller);
+// Counter for creation order, used to create a stable ordering of DepItems at same priority.
+let _nextCreationNum = 0;
 // Array to keep track of items recomputed during this call to compute(). It could be a local
 // variable in compute(), but is made global to minimize allocations.
 const _seen = [];

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

@@ -1 +1 @@
-{"version":3,"file":"_computed_queue.js","sourceRoot":"","sources":["../../../lib/_computed_queue.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAEH,mDAA8C;AAE9C;;;GAGG;AACH;IAUE;;OAEG;IACH,YAAY,QAAoB,EAAE,UAAmB;QAR7C,cAAS,GAAW,CAAC,CAAC;QACtB,cAAS,GAAY,KAAK,CAAC;QAQjC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC;IAC7B,CAAC;IAfM,MAAM,CAAC,iBAAiB,CAAC,CAAU,EAAE,CAAU;QACpD,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IACnC,CAAC;IAeD;;;OAGG;IACI,MAAM,CAAC,OAAqB;QACjC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE;YACvB,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;SACxB;IACH,CAAC;IAED;;OAEG;IACI,SAAS;QACd,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAClB;IACH,CAAC;CACF;AA9CD,0BA8CC;AAED,0BAA0B;AAC1B,MAAM,KAAK,GAAG,IAAI,6BAAa,CAAU,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEpE,6FAA6F;AAC7F,qEAAqE;AACrE,MAAM,KAAK,GAAU,EAAE,CAAC;AAExB,kEAAkE;AAClE,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB;;GAEG;AACH,sBAA6B,GAAQ;IACnC,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAClC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAHD,oCAGC;AAED;;;;GAIG;AACH;IACE,IAAI,WAAW,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE;QACvC,4FAA4F;QAC5F,WAAW,EAAE,CAAC;QACd,IAAI;YACF,2EAA2E;YAC3E,GAAG;gBACD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,CAAC,SAAS,EAAE,CAAC;aAClB,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE;SAC1B;gBAAS;YACR,2FAA2F;YAC3F,0DAA0D;YAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;gBACxB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;aACxB;YACD,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACjB,WAAW,EAAE,CAAC;SACf;KACF;AACH,CAAC;AArBD,0BAqBC;AAED;;;;;;;GAOG;AACH,uBAAiC,IAAa;IAC5C,IAAI;QACF,WAAW,EAAE,CAAC;QACd,OAAO,IAAI,EAAE,CAAC;KACf;YAAS;QACR,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;KACX;AACH,CAAC;AARD,sCAQC"}
+{"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

@@ -1,13 +1,13 @@
+/**
+ * binding.ts offers a convenient subscribe() function that creates a binding to an observable, a
+ * a plain value, or a function from which it builds a computed.
+ */
 import { IDisposable } from './dispose';
-import { Observable } from './observable';
-import { UseCB } from './subscribe';
-export declare type BindableValue<T> = Observable<T> | ComputedCallback<T> | T | IKnockoutObservable<T>;
-export declare type ComputedCallback<T> = (use: UseCB, ...args: any[]) => T;
-export interface IKnockoutObservable<T> {
-    (): T;
-    peek(): T;
-    subscribe(callback: (newValue: T) => void, target?: any, event?: "change"): IDisposable;
-}
+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;
 /**
  * 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
@@ -19,4 +19,10 @@ export interface IKnockoutObservable<T> {
  *
  * Returns an object which should be disposed to remove the created subscriptions, or null.
  */
-export declare function subscribe<T>(valueObs: BindableValue<T>, callback: (newVal: T, oldVal?: T) => void): IDisposable | null;
+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.
+ */
+export declare function subscribeElem<T>(elem: Node, valueObs: BindableValue<T>, callback: (newVal: T, oldVal?: T) => void): void;

package/dist/cjs/lib/binding.js

@@ -4,32 +4,19 @@
  * 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");
-/**
- * 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
- * with a context function `use`, allowing it to depend on other observable values (see
- * documentation for `computed`).
- *
- * In all cases, `callback(newValue, oldValue)` is called immediately and whenever the value
- * changes. On the initial call, oldValue is undefined.
- *
- * Returns an object which should be disposed to remove the created subscriptions, or null.
- */
-function subscribe(valueObs, callback) {
+const subscribe_1 = require("./subscribe");
+function subscribeBindable(valueObs, callback) {
     // A plain function (to make a computed from), or a knockout observable.
     if (typeof valueObs === 'function') {
         // Knockout observable.
         const koValue = valueObs;
         if (typeof koValue.peek === 'function') {
-            let savedValue = koValue.peek();
-            const sub = koValue.subscribe((val) => {
-                const old = savedValue;
-                savedValue = val;
-                callback(val, old);
-            });
-            callback(savedValue, undefined);
+            const sub = koValue.subscribe((val) => callback(val));
+            callback(koValue.peek());
             return sub;
         }
         // Function from which to make a computed. Note that this is also reasonable:
@@ -37,18 +24,26 @@ function subscribe(valueObs, callback) {
         // 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);
-        comp.addListener(callback);
-        callback(comp.get(), undefined);
+        comp.addListener((val) => callback(val));
+        callback(comp.get());
         return comp; // Disposing this will dispose its one listener.
     }
     // An observable.
-    if (valueObs instanceof observable_1.Observable) {
-        const sub = valueObs.addListener(callback);
-        callback(valueObs.get(), undefined);
-        return sub;
+    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));
     }
-    callback(valueObs, undefined);
+    callback(valueObs);
     return null;
 }
-exports.subscribe = subscribe;
+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.
+ */
+function subscribeElem(elem, valueObs, callback) {
+    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,6CAAwC;AAaxC;;;;;;;;;;GAUG;AACH,mBAA6B,QAA0B,EAC1B,QAAyC;IACpE,wEAAwE;IACxE,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;QAClC,uBAAuB;QACvB,MAAM,OAAO,GAAG,QAAkC,CAAC;QACnD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE;YACtC,IAAI,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,GAAM,EAAE,EAAE;gBACvC,MAAM,GAAG,GAAG,UAAU,CAAC;gBACvB,UAAU,GAAG,GAAG,CAAC;gBACjB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAChC,OAAO,GAAG,CAAC;SACZ;QAED,6EAA6E;QAC7E,0DAA0D;QAC1D,yFAAyF;QACzF,6DAA6D;QAC7D,MAAM,IAAI,GAAG,mBAAQ,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,CAAM,gDAAgD;KACnE;IAED,iBAAiB;IACjB,IAAI,QAAQ,YAAY,uBAAU,EAAE;QAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC3C,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QACpC,OAAO,GAAG,CAAC;KACZ;IAED,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC;AACd,CAAC;AApCD,8BAoCC"}
+{"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"}

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,wBAAwB,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,qBAA4B,OAAwB;IAClD,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,cAAc,CAAC,SAAC,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAHD,kCAGC;AAED;;GAEG;AACH;IACE,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

@@ -34,14 +34,17 @@
  * ownership of the same disposable that the callback returns.
  */
 import { DepItem } from './_computed_queue';
-import { IDisposableOwner } from './dispose';
+import { IDisposableOwnerT } from './dispose';
 import { BaseObservable as Obs, Observable } from './observable';
-import { ISubscribable } from './subscribe';
-export interface UseCB {
-    <U>(obs: Obs<U>): U;
-    owner: IDisposableOwner;
-}
+import { ISubscribable, UseCBOwner as UseCB } from './subscribe';
+declare type Owner<T> = IDisposableOwnerT<Computed<T>> | null;
 export declare class Computed<T> extends Observable<T> {
+    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>;
+    static create<T, A, B, C>(owner: Owner<T>, a: Obs<A>, b: Obs<B>, c: Obs<C>, cb: (use: UseCB, a: A, b: B, c: C) => T): Computed<T>;
+    static create<T, A, B, C, D>(owner: Owner<T>, a: Obs<A>, b: Obs<B>, c: Obs<C>, d: Obs<D>, cb: (use: UseCB, a: A, b: B, c: C, d: D) => T): Computed<T>;
+    static create<T, A, B, C, D, E>(owner: Owner<T>, a: Obs<A>, b: Obs<B>, c: Obs<C>, d: Obs<D>, e: Obs<E>, cb: (use: UseCB, a: A, b: B, c: C, d: D, e: E) => T): Computed<T>;
     private _callback;
     private _write;
     private _sub;
@@ -68,7 +71,7 @@ export declare class Computed<T> extends Observable<T> {
      * Disposes the computed, unsubscribing it from all observables it depends on.
      */
     dispose(): void;
-    private _read(use, ...args);
+    private _read;
 }
 /**
  * This is the type-checking interface for computed(), which allows TypeScript to do helpful
@@ -81,3 +84,4 @@ export declare function computed<T, A, B>(a: Obs<A>, b: Obs<B>, cb: (use: UseCB,
 export declare function computed<T, A, B, C>(a: Obs<A>, b: Obs<B>, c: Obs<C>, cb: (use: UseCB, a: A, b: B, c: C) => T): Computed<T>;
 export declare function computed<T, A, B, C, D>(a: Obs<A>, b: Obs<B>, c: Obs<C>, d: Obs<D>, cb: (use: UseCB, a: A, b: B, c: C, d: D) => T): Computed<T>;
 export declare function computed<T, A, B, C, D, E>(a: Obs<A>, b: Obs<B>, c: Obs<C>, d: Obs<D>, e: Obs<E>, cb: (use: UseCB, a: A, b: B, c: C, d: D, e: E) => T): Computed<T>;
+export {};

package/dist/cjs/lib/computed.js

@@ -35,6 +35,8 @@
  * ownership of the same disposable that the callback returns.
  */
 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() {
@@ -52,6 +54,20 @@ 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.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"computed.js","sourceRoot":"","sources":["../../../lib/computed.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;AAIH,6CAA+D;AAC/D,2CAAwD;AAExD;IACE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC1D,CAAC;AAQD,cAAyB,SAAQ,uBAAa;IAK5C;;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;IAED;;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;AAnDD,4BAmDC;AA6BD;;;;;;;;;GASG;AACH,kBAAyB,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":";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"}