grainjs 0.1.0 → 1.0.2

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

@@ -1,3 +1,75 @@
+/**
+ * dispose.js provides tools to objects that needs to dispose resources, such as destroy DOM, and
+ * unsubscribe from events. The motivation with examples is presented here:
+ *
+ *    https://phab.getgrist.com/w/disposal/
+ *
+ * Disposable is a class for components that need cleanup (e.g. maintain DOM, listen to events,
+ * subscribe to anything). It provides a .dispose() method that should be called to destroy the
+ * component, and .onDispose()/.autoDispose() methods that the component should use to take
+ * responsibility for other pieces that require cleanup.
+ *
+ * To define a disposable class:
+ *    class Foo extends Disposable { ... }
+ *
+ * To create Foo:
+ *    const foo = Foo.create(owner, ...args);
+ * This is better than `new Foo` for two reasons:
+ *    1. If Foo's constructor throws an exception, any disposals registered in that constructor
+ *       before the exception are honored.
+ *    2. It ensures you specify the owner of the new instance (but you can use null to skip it).
+ *
+ * In Foo's constructor (or rarely methods), take ownership of other Disposable objects:
+ *    this.bar = Bar.create(this, ...);
+ *
+ * For objects that are not instances of Disposable but have a .dispose() methods, use:
+ *    this.bar = this.autoDispose(createSomethingDisposable());
+ *
+ * To call a function on disposal (e.g. to add custom disposal logic):
+ *    this.onDispose(() => this.myUnsubscribeAllMethod());
+ *    this.onDispose(this.myUnsubscribeAllMethod, this);    // slightly more efficient
+ *
+ * To mark this object to be wiped out on disposal (i.e. set all properties to null):
+ *    this.wipeOnDispose();
+ * See the documentation of that method for more info.
+ *
+ * To dispose Foo directly:
+ *    foo.dispose();
+ * To determine if an object has already been disposed:
+ *    foo.isDisposed()
+ *
+ * If you need to replace an owned object, or release, or dispose it early, use a Holder:
+ *    this._holder = Holder.create(this);
+ *    Bar.create(this._holder, 1);      // creates new Bar(1)
+ *    Bar.create(this._holder, 2);      // creates new Bar(2) and disposes previous object
+ *    this._holder.clear();             // disposes contained object
+ *    this._holder.release();           // releases contained object
+ *
+ * If you need a container for multiple objects and dispose them all together, use a MultiHolder:
+ *    this._mholder = MultiHolder.create(null);
+ *    Bar.create(this._mholder, 1);     // create new Bar(1)
+ *    Bar.create(this._mholder, 2);     // create new Bar(2)
+ *    this._mholder.dispose();          // disposes both objects
+ *
+ * If creating your own class with a dispose() method, do NOT throw exceptions from dispose().
+ * These cannot be handled properly in all cases. Read here about the same issue in C++:
+ *    http://bin-login.name/ftp/pub/docs/programming_languages/cpp/cffective_cpp/MAGAZINE/SU_FRAME.HTM#destruct
+ *
+ * Using a parametrized (generic) class as a Disposable is tricky. E.g.
+ *    class Bar<T> extends Disposable { ... }
+ *    // Bar<T>.create(...)   <-- doesn't work
+ *    // Bar.create<T>(...)   <-- doesn't work
+ *    // Bar.create(...)      <-- works, but with {} for Bar's type parameters
+ *
+ * The solution is to expose the constructor type using a helper method:
+ *    class Bar<T> extends Disposable {
+ *      // Note the tuple below which must match the constructor parameters of Bar<U>.
+ *      public static ctor<U>(): IDisposableCtor<Bar<U>, [U, boolean]> { return this; }
+ *      constructor(a: T, b: boolean) { ... }
+ *    }
+ *    Bar.ctor<T>().create(...)   // <-- works, creates Bar<T>, and does type-checking!
+ */
+import { LLink } from './emit';
 /**
  * Anything with a .dispose() method is a disposable object, and implements the IDisposable interface.
  */
@@ -17,6 +89,13 @@ export interface IDisposableOwnerT<T extends IDisposable> {
 export interface IDisposableOwner {
     autoDispose(obj: IDisposable): void;
 }
+/**
+ * The static portion of class Disposable.
+ */
+export interface IDisposableCtor<Derived, CtorArgs extends any[]> {
+    new (...args: CtorArgs): Derived;
+    create<T extends new (...args: any[]) => any>(this: T, owner: IDisposableOwnerT<InstanceType<T>> | null, ...args: ConstructorParameters<T>): InstanceType<T>;
+}
 /**
  * Base class for disposable objects that can own other objects. See the module documentation.
  */
@@ -28,22 +107,14 @@ export declare abstract class Disposable implements IDisposable, IDisposableOwne
      * exception, dispose() gets called to clean up the partially-constructed object.
      *
      * Owner may be null if intend to ensure disposal some other way.
-     *
-     * TODO: create() needs more unittests, including to ensure that TypeScript types are done
-     * correctly.
      */
-    static create<T extends IDisposable>(this: new () => T, owner: IDisposableOwnerT<T> | null): T;
-    static create<T extends IDisposable, A>(this: new (a: A) => T, owner: IDisposableOwnerT<T> | null, a: A): T;
-    static create<T extends IDisposable, A, B>(this: new (a: A, b: B) => T, owner: IDisposableOwnerT<T> | null, a: A, b: B): T;
-    static create<T extends IDisposable, A, B, C>(this: new (a: A, b: B, c: C) => T, owner: IDisposableOwnerT<T> | null, a: A, b: B, c: C): T;
-    static create<T extends IDisposable, A, B, C, D>(this: new (a: A, b: B, c: C, d: D) => T, owner: IDisposableOwnerT<T> | null, a: A, b: B, c: C, d: D): T;
-    static create<T extends IDisposable, A, B, C, D, E>(this: new (a: A, b: B, c: C, d: D, e: E) => T, owner: IDisposableOwnerT<T> | null, a: A, b: B, c: C, d: D, e: E): T;
+    static create<T extends new (...args: any[]) => any>(this: T, owner: IDisposableOwnerT<InstanceType<T>> | null, ...args: ConstructorParameters<T>): InstanceType<T>;
     private _disposalList;
     constructor();
     /** Take ownership of obj, and dispose it when this.dispose() is called. */
     autoDispose<T extends IDisposable>(obj: T): T;
     /** Call the given callback when this.dispose() is called. */
-    onDispose<T>(callback: (this: T) => void, context?: T): void;
+    onDispose<T>(callback: (this: T) => void, context?: T): DisposeListener;
     /**
      * Wipe out this object when it is disposed, i.e. set all its properties to null. It is
      * recommended to call this early in the constructor.
@@ -73,7 +144,7 @@ export declare abstract class Disposable implements IDisposable, IDisposableOwne
      * Wipe out this object by setting each property to null. This is helpful for objects that are
      * disposed and should be ready to be garbage-collected.
      */
-    private _wipeOutObject();
+    private _wipeOutObject;
 }
 /**
  * Holder keeps a single disposable object. If given responsibility for another object using
@@ -82,12 +153,11 @@ export declare abstract class Disposable implements IDisposable, IDisposableOwne
  *
  * If the object is an instance of Disposable, the holder will also notice when the object gets
  * disposed from outside of it, in which case the holder will become empty again.
- *
- * TODO Holder needs unittests.
  */
 export declare class Holder<T extends IDisposable> implements IDisposable, IDisposableOwner {
-    static create<T extends IDisposable>(owner: IDisposableOwner | null): Holder<T>;
+    static create<T extends IDisposable>(owner: IDisposableOwnerT<Holder<T>> | null): Holder<T>;
     protected _owned: T | null;
+    private _disposalListener;
     /** Take ownership of a new object, disposing the previously held one. */
     autoDispose(obj: T): T;
     /** Releases the held object without disposing it, emptying the holder. */
@@ -100,8 +170,30 @@ export declare class Holder<T extends IDisposable> implements IDisposable, IDisp
     isEmpty(): boolean;
     /** When the holder is disposed, it disposes the held object if any. */
     dispose(): void;
+    /** Stop listening for the disposal of this._owned. */
+    private _unlisten;
+    private _onOutsideDispose;
+}
+/**
+ * MultiHolder keeps multiple disposable object. It disposes all held object when the holder
+ * itself is disposed. It's actually nothing more than the Disposable base class itself, just
+ * exposed with a clearer name that describes its purpose.
+ */
+export declare class MultiHolder extends Disposable {
 }
 /**
  * Sets owner of obj (i.e. calls owner.autoDispose(obj)) unless owner is null. Returns obj.
  */
 export declare function setDisposeOwner<T extends IDisposable>(owner: IDisposableOwnerT<T> | null, obj: T): T;
+/**
+ * Internal class that keeps track of one item of the DisposalList. It mimicks emit.Listener, but
+ * reports and swallows erros when it calls the callbacks in the list.
+ */
+declare class DisposeListener extends LLink implements IDisposable {
+    private callback;
+    private context?;
+    static callAll(begin: LLink, end: LLink, owner: Disposable): void;
+    constructor(callback: () => void, context?: any);
+    dispose(): void;
+}
+export {};

package/dist/cjs/lib/dispose.js

@@ -46,11 +46,32 @@
  *    this._holder.clear();             // disposes contained object
  *    this._holder.release();           // releases contained object
  *
+ * If you need a container for multiple objects and dispose them all together, use a MultiHolder:
+ *    this._mholder = MultiHolder.create(null);
+ *    Bar.create(this._mholder, 1);     // create new Bar(1)
+ *    Bar.create(this._mholder, 2);     // create new Bar(2)
+ *    this._mholder.dispose();          // disposes both objects
+ *
  * If creating your own class with a dispose() method, do NOT throw exceptions from dispose().
  * These cannot be handled properly in all cases. Read here about the same issue in C++:
  *    http://bin-login.name/ftp/pub/docs/programming_languages/cpp/cffective_cpp/MAGAZINE/SU_FRAME.HTM#destruct
+ *
+ * Using a parametrized (generic) class as a Disposable is tricky. E.g.
+ *    class Bar<T> extends Disposable { ... }
+ *    // Bar<T>.create(...)   <-- doesn't work
+ *    // Bar.create<T>(...)   <-- doesn't work
+ *    // Bar.create(...)      <-- works, but with {} for Bar's type parameters
+ *
+ * The solution is to expose the constructor type using a helper method:
+ *    class Bar<T> extends Disposable {
+ *      // Note the tuple below which must match the constructor parameters of Bar<U>.
+ *      public static ctor<U>(): IDisposableCtor<Bar<U>, [U, boolean]> { return this; }
+ *      constructor(a: T, b: boolean) { ... }
+ *    }
+ *    Bar.ctor<T>().create(...)   // <-- works, creates Bar<T>, and does type-checking!
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.setDisposeOwner = exports.MultiHolder = exports.Holder = exports.Disposable = void 0;
 const emit_1 = require("./emit");
 // Internal "owner" of disposable objects which doesn't actually dispose or keep track of them. It
 // is the effective owner when creating a Disposable with `new Foo()` rather than `Foo.create()`.
@@ -68,7 +89,18 @@ class Disposable {
         this._disposalList = new DisposalList();
         // This registers with a temp Holder when using create(), and is a no-op when using `new Foo`.
         _defaultDisposableOwner.autoDispose(this);
+        // Be sure to reset to no-op, so that a (non-recommended) direct call like 'new Bar()', from
+        // inside Foo's constructor doesn't use the same Holder that's temporarily holding Foo.
+        _defaultDisposableOwner = _noopOwner;
     }
+    /**
+     * Create Disposable instances using `Class.create(owner, ...)` rather than `new Class(...)`.
+     *
+     * This reminds you to provide an owner, and ensures that if the constructor throws an
+     * exception, dispose() gets called to clean up the partially-constructed object.
+     *
+     * Owner may be null if intend to ensure disposal some other way.
+     */
     static create(owner, ...args) {
         const origDefaultOwner = _defaultDisposableOwner;
         const holder = new Holder();
@@ -102,7 +134,7 @@ class Disposable {
     }
     /** Call the given callback when this.dispose() is called. */
     onDispose(callback, context) {
-        this._disposalList.addListener(callback, context);
+        return this._disposalList.addListener(callback, context);
     }
     /**
      * Wipe out this object when it is disposed, i.e. set all its properties to null. It is
@@ -134,8 +166,14 @@ class Disposable {
      */
     dispose() {
         const disposalList = this._disposalList;
-        this._disposalList = null;
-        disposalList.callAndDispose(this);
+        if (!disposalList) {
+            // tslint:disable-next-line:no-console
+            console.error("Error disposing %s which is already disposed", _describe(this));
+        }
+        else {
+            this._disposalList = null;
+            disposalList.callAndDispose(this);
+        }
     }
     /**
      * Wipe out this object by setting each property to null. This is helpful for objects that are
@@ -158,38 +196,38 @@ exports.Disposable = Disposable;
  *
  * If the object is an instance of Disposable, the holder will also notice when the object gets
  * disposed from outside of it, in which case the holder will become empty again.
- *
- * TODO Holder needs unittests.
  */
 class Holder {
     constructor() {
         this._owned = null;
+        this._disposalListener = undefined;
     }
     static create(owner) {
         return setDisposeOwner(owner, new Holder());
     }
     /** Take ownership of a new object, disposing the previously held one. */
     autoDispose(obj) {
-        if (this._owned) {
-            this._owned.dispose();
-        }
+        this.clear();
         this._owned = obj;
         if (obj instanceof Disposable) {
-            obj.onDispose(this.release, this);
+            this._disposalListener = obj.onDispose(this._onOutsideDispose, this);
         }
         return obj;
     }
     /** Releases the held object without disposing it, emptying the holder. */
     release() {
+        this._unlisten();
         const ret = this._owned;
         this._owned = null;
         return ret;
     }
     /** Disposes the held object and empties the holder. */
     clear() {
-        if (this._owned) {
-            this._owned.dispose();
+        this._unlisten();
+        const owned = this._owned;
+        if (owned) {
             this._owned = null;
+            owned.dispose();
         }
     }
     /** Returns the held object, or null if the Holder is empty. */
@@ -198,8 +236,28 @@ class Holder {
     isEmpty() { return !this._owned; }
     /** When the holder is disposed, it disposes the held object if any. */
     dispose() { this.clear(); }
+    /** Stop listening for the disposal of this._owned. */
+    _unlisten() {
+        const disposalListener = this._disposalListener;
+        if (disposalListener) {
+            this._disposalListener = undefined;
+            disposalListener.dispose();
+        }
+    }
+    _onOutsideDispose() {
+        this._disposalListener = undefined;
+        this._owned = null;
+    }
 }
 exports.Holder = Holder;
+/**
+ * MultiHolder keeps multiple disposable object. It disposes all held object when the holder
+ * itself is disposed. It's actually nothing more than the Disposable base class itself, just
+ * exposed with a clearer name that describes its purpose.
+ */
+class MultiHolder extends Disposable {
+}
+exports.MultiHolder = MultiHolder;
 /**
  * Sets owner of obj (i.e. calls owner.autoDispose(obj)) unless owner is null. Returns obj.
  */
@@ -225,6 +283,7 @@ class DisposalList extends emit_1.LLink {
     addListener(callback, optContext) {
         const lis = new DisposeListener(callback, optContext);
         this._insertBefore(this._next, lis);
+        return lis;
     }
     /**
      * Call all callbacks and dispose this object. The owner is required for better reporting of
@@ -262,5 +321,11 @@ class DisposeListener extends emit_1.LLink {
             begin = lis._next;
         }
     }
+    dispose() {
+        if (this.isDisposed()) {
+            return;
+        }
+        this._removeNode(this);
+    }
 }
 //# sourceMappingURL=dispose.js.map

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

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

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

@@ -16,19 +16,22 @@
  *    creates Node <a id="link" class="c1 c2" href={{url}}Hello <span>world</span></a>,
  *    identical to the first example above.
  */
-export { DomMethod, DomElementMethod, DomArg, DomElementArg, svg, update, frag, find, findAll } from './_domImpl';
-export * from './_domComponent';
-export * from './_domDispose';
-export * from './_domForEach';
-export * from './_domMethods';
+export * from './domImpl';
+export * from './domComponent';
+export * from './domComputed';
+export * from './domDispose';
+export * from './domForEach';
+export * from './domMethods';
 export * from './domevent';
-import * as _domComponent from './_domComponent';
-import * as _domDispose from './_domDispose';
-import * as _domForEach from './_domForEach';
-import * as _domImpl from './_domImpl';
-import * as _domMethods from './_domMethods';
+import * as _domComponent from './domComponent';
+import * as _domComputed from './domComputed';
+import * as _domDispose from './domDispose';
+import * as _domForEach from './domForEach';
+import * as _domImpl from './domImpl';
+import * as _domMethods from './domMethods';
 import * as domevent from './domevent';
-export declare function dom(tagString: string, ...args: _domImpl.DomElementArg[]): HTMLElement;
+import { IDomArgs, TagElem, TagName } from './domImpl';
+export declare function dom<Tag extends TagName>(tagString: Tag, ...args: IDomArgs<TagElem<Tag>>): TagElem<Tag>;
 export declare namespace dom {
     const svg: typeof _domImpl.svg;
     const frag: typeof _domImpl.frag;
@@ -62,17 +65,18 @@ export declare namespace dom {
     const dataElem: typeof _domMethods.dataElem;
     const data: typeof _domMethods.data;
     const getData: typeof _domMethods.getData;
-    const replaceContent: typeof _domMethods.replaceContent;
-    const domComputed: typeof _domMethods.domComputed;
-    const maybe: typeof _domMethods.maybe;
+    const replaceContent: typeof _domComputed.replaceContent;
+    const domComputed: typeof _domComputed.domComputed;
+    const domComputedOwned: typeof _domComputed.domComputedOwned;
+    const maybe: typeof _domComputed.maybe;
+    const maybeOwned: typeof _domComputed.maybeOwned;
     const forEach: typeof _domForEach.forEach;
-    const Component: typeof _domComponent.Component;
     const create: typeof _domComponent.create;
-    const createInit: typeof _domComponent.createInit;
     const onElem: typeof domevent.onElem;
     const on: typeof domevent.on;
     const onMatchElem: typeof domevent.onMatchElem;
     const onMatch: typeof domevent.onMatch;
-    const onKeyPressElem: typeof domevent.onKeyPressElem;
+    const onKeyElem: typeof domevent.onKeyElem;
     const onKeyPress: typeof domevent.onKeyPress;
+    const onKeyDown: typeof domevent.onKeyDown;
 }

package/dist/cjs/lib/dom.js

@@ -17,32 +17,38 @@
  *    creates Node <a id="link" class="c1 c2" href={{url}}Hello <span>world</span></a>,
  *    identical to the first example above.
  */
-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 });
+exports.dom = void 0;
 // We keep various dom-related functions organized in private modules, but they are exposed here.
-var _domImpl_1 = require("./_domImpl");
-exports.svg = _domImpl_1.svg;
-exports.update = _domImpl_1.update;
-exports.frag = _domImpl_1.frag;
-exports.find = _domImpl_1.find;
-exports.findAll = _domImpl_1.findAll;
-__export(require("./_domComponent"));
-__export(require("./_domDispose"));
-__export(require("./_domForEach"));
-__export(require("./_domMethods"));
-__export(require("./domevent"));
-const _domComponent = require("./_domComponent");
-const _domDispose = require("./_domDispose");
-const _domForEach = require("./_domForEach");
-const _domImpl = require("./_domImpl");
-const _domMethods = require("./_domMethods");
+__exportStar(require("./domImpl"), exports);
+__exportStar(require("./domComponent"), exports);
+__exportStar(require("./domComputed"), exports);
+__exportStar(require("./domDispose"), exports);
+__exportStar(require("./domForEach"), exports);
+__exportStar(require("./domMethods"), exports);
+__exportStar(require("./domevent"), exports);
+const _domComponent = require("./domComponent");
+const _domComputed = require("./domComputed");
+const _domDispose = require("./domDispose");
+const _domForEach = require("./domForEach");
+const _domImpl = require("./domImpl");
+const _domMethods = require("./domMethods");
 const domevent = require("./domevent");
+const domImpl_1 = require("./domImpl");
 // We just want to re-export _domImpl.dom, but to allow adding methods to it in a typesafe way,
 // TypeScript wants us to declare a real function in the same file.
 function dom(tagString, ...args) {
-    return _domImpl.dom(tagString, ...args);
+    return domImpl_1.dom(tagString, ...args);
 }
 exports.dom = dom;
 // Additionally export all methods as properties of dom() function.
@@ -79,18 +85,19 @@ exports.dom = dom;
     dom.dataElem = _domMethods.dataElem;
     dom.data = _domMethods.data;
     dom.getData = _domMethods.getData;
-    dom.replaceContent = _domMethods.replaceContent;
-    dom.domComputed = _domMethods.domComputed;
-    dom.maybe = _domMethods.maybe;
+    dom.replaceContent = _domComputed.replaceContent;
+    dom.domComputed = _domComputed.domComputed;
+    dom.domComputedOwned = _domComputed.domComputedOwned;
+    dom.maybe = _domComputed.maybe;
+    dom.maybeOwned = _domComputed.maybeOwned;
     dom.forEach = _domForEach.forEach;
-    dom.Component = _domComponent.Component;
     dom.create = _domComponent.create;
-    dom.createInit = _domComponent.createInit;
     dom.onElem = domevent.onElem;
     dom.on = domevent.on;
     dom.onMatchElem = domevent.onMatchElem;
     dom.onMatch = domevent.onMatch;
-    dom.onKeyPressElem = domevent.onKeyPressElem;
+    dom.onKeyElem = domevent.onKeyElem;
     dom.onKeyPress = domevent.onKeyPress;
+    dom.onKeyDown = domevent.onKeyDown;
 })(dom = exports.dom || (exports.dom = {}));
 //# sourceMappingURL=dom.js.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * UI components that can be inserted into dom().
+ *
+ * Components are created and inserted using dom.create():
+ *
+ *    dom('div',
+ *      dom.create(MyWidget, ...myArgs),        // Calls MyWidget.create(owner, ...myArgs)
+ *      dom.create(createMyWidget, ...myArgs),  // Calls createMyWidget(owner, ...myArgs)
+ *    )
+ *
+ * The first argument may be a function, which is called directly, or a class with a .create()
+ * static method, in which case that's what gets called.
+ *
+ * In both cases, the call gets a first argument of `owner` followed by the rest of the arguments
+ * to dom.create(). The `owner` is a MultiHolder that will own this component. This works
+ * naturally with any class that derives from Disposable, since it then has a suitable static
+ * create() method.
+ *
+ * Function-based components may use owner to easily handle disposal. For example:
+ *
+ *    dom.create(createMyWidget)
+ *    function createMyWidget(owner) {
+ *      const foo = Foo.create(owner);
+ *      return dom('div', foo.getTitle());
+ *    }
+ *
+ * The `owner` argument is the main benefit of dom.create(). Logically, the owner is the DOM where
+ * the component is attached. When the parent DOM element is disposed, so is the component.
+ *
+ *    [Explanation] To understand why the syntax is such, consider a potential alternative such as:
+ *
+ *       dom('div', _insert_(new Comp1()), _insert_(new Comp2(...args)))
+ *
+ *    In both cases, the constructor for Comp1 runs before the constructor for Comp2. What happens
+ *    when Comp2's constructor throws an exception? In the second case, nothing yet owns the
+ *    created Comp1 component, and it will never get cleaned up. With dom.create(), the DOM
+ *    gets ownership of Comp1 early enough and will dispose it.
+ *
+ * A function component may return DOM directly. A class component returns the class instance,
+ * which must have a .buildDom() method which will be called right after the constructor to get
+ * the DOM. Note that buildDom is only called once.
+ *
+ * A function component may also return an object with .buildDom(). So these are equivalent:
+ *
+ *    dom.create(MyWidget)
+ *    dom.create((owner) => MyWidget.create(owner))
+ *
+ * Note that ownership should be handled using the `owner` argument. Don't do this:
+ *
+ *    // NON-EXAMPLE: Nothing will dispose the created object:
+ *    // dom.create(() => new MyWidget());
+ *
+ * The returned DOM may includes Nodes, strings, and domComputed() values, as well as arrays of
+ * any of these. In other words, any DomArg goes except DomMethods. All the DOM returned will be
+ * disposed when the containing element is disposed, followed by the `owner` itself.
+ */
+import { MultiHolder } from './dispose';
+import { DomContents } from './domComputed';
+export interface IDomComponent {
+    buildDom(): DomContents;
+}
+export declare type DomComponentReturn = DomContents | IDomComponent;
+export declare type IDomCreateFunc<Args extends any[]> = (owner: MultiHolder, ...args: Args) => DomComponentReturn;
+export interface IDomCreateClass<Args extends any[]> {
+    create: IDomCreateFunc<Args>;
+    new (...args: Args): DomComponentReturn;
+}
+export declare type IDomCreator<Args extends any[]> = IDomCreateFunc<Args> | IDomCreateClass<Args>;
+declare type DomCreatorArgs<T> = T extends (owner: MultiHolder, ...args: infer P) => any ? P : (T extends new (...args: infer P) => any ? P : never);
+export declare function create<Fn extends IDomCreator<any[]>>(fn: Fn, ...args: DomCreatorArgs<Fn>): DomContents;
+export {};

package/dist/cjs/lib/domComponent.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.create = void 0;
+const domComputed_1 = require("./domComputed");
+function create(fn, ...args) {
+    return domComputed_1.domComputedOwned(null, (owner) => {
+        const value = ('create' in fn) ?
+            fn.create(owner, ...args) :
+            fn(owner, ...args);
+        return (value && typeof value === 'object' && 'buildDom' in value) ?
+            value.buildDom() : value;
+    });
+}
+exports.create = create;
+//# sourceMappingURL=domComponent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domComponent.js","sourceRoot":"","sources":["../../../lib/domComponent.ts"],"names":[],"mappings":";;;AAyDA,+CAA4D;AAuB5D,SAAgB,MAAM,CAAgC,EAAM,EAAE,GAAG,IAAwB;IACvF,OAAO,8BAAgB,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;QACtC,MAAM,KAAK,GAAuB,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;YACjD,EAA6B,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;YACtD,EAA4B,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC;YAClE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AARD,wBAQC"}