@expressive/mvc 1.0.0-beta.22 → 1.0.0-beta.26

package/lib/index.esm.js

@@ -0,0 +1,1220 @@
+import { useMemo, useLayoutEffect, useState, createContext, useContext, createElement } from 'react';
+
+class Issue extends Error {
+    constructor() {
+        super(...arguments);
+        // drop first line (error factory) in stack trace.
+        this.stack = this.stack.replace(/\n.+/, "");
+    }
+    warn() {
+        console.warn(this.message);
+    }
+    throw() {
+        throw this;
+    }
+}
+function issues(register) {
+    const Library = {};
+    for (const name in register)
+        Library[name] = (...args) => new Issue(register[name].apply(null, args));
+    return Library;
+}
+
+const Oops$9 = issues({
+    BadEffectCallback: () => `Callback for effect-callback may only return a function.`
+});
+const { assign, create, defineProperty, entries, getPrototypeOf, getOwnPropertyNames, getOwnPropertyDescriptor, getOwnPropertyDescriptors, getOwnPropertySymbols, keys: keys$1, values } = Object;
+function define(target, key, value) {
+    defineProperty(target, key, { value });
+}
+function defineLazy(object, property, init) {
+    defineProperty(object, property, {
+        configurable: true,
+        get() {
+            const value = init.call(this);
+            defineProperty(this, property, { value });
+            return value;
+        }
+    });
+}
+function setAlias(func, displayName) {
+    assign(func, { displayName });
+}
+function createEffect(callback) {
+    let unSet;
+    return function (value) {
+        if (typeof unSet == "function")
+            unSet();
+        unSet = callback.call(this, value);
+        if (unSet instanceof Promise)
+            unSet = undefined;
+        if (unSet && typeof unSet !== "function")
+            throw Oops$9.BadEffectCallback();
+    };
+}
+function createValueEffect(callback) {
+    let unSet;
+    return function (value) {
+        if (typeof unSet == "function")
+            unSet(value);
+        const out = callback.call(this, value);
+        if (typeof out == "boolean")
+            return out;
+        if (!out || out instanceof Promise)
+            return;
+        if (typeof out == "function")
+            unSet = out;
+        else
+            throw Oops$9.BadEffectCallback();
+    };
+}
+function select(source, select) {
+    const proxy = {};
+    for (const k in source)
+        proxy[k] = k;
+    return select(proxy);
+}
+function selectRecursive(using, keys) {
+    const found = new Set();
+    const spy = {};
+    for (const key of new Set(keys))
+        defineProperty(spy, key, {
+            get() {
+                found.add(key);
+                return spy;
+            }
+        });
+    using(spy);
+    return Array.from(found);
+}
+
+class Subscriber {
+    constructor(parent, onUpdate) {
+        this.onUpdate = onUpdate;
+        this.active = false;
+        this.follows = {};
+        this.dependant = new Set();
+        if (!(parent instanceof Controller))
+            parent = manage(parent);
+        this.parent = parent;
+        this.source = parent.subject;
+        this.proxy = create(parent.subject);
+        define(this.proxy, LOCAL, this);
+        for (const key in parent.state)
+            this.spy(key);
+    }
+    spy(key) {
+        const { proxy, source } = this;
+        const { set } = getOwnPropertyDescriptor(source, key);
+        const intercept = () => {
+            this.follow(key);
+            delete proxy[key];
+            return proxy[key];
+        };
+        setAlias(intercept, `tap ${key}`);
+        defineProperty(proxy, key, {
+            get: intercept,
+            set,
+            configurable: true,
+            enumerable: true
+        });
+    }
+    follow(key, cb) {
+        this.follows[key] = cb || this.onUpdate;
+    }
+    commit() {
+        const { dependant, follows, parent } = this;
+        const onDone = parent.addListener(follows);
+        this.active = true;
+        dependant.forEach(x => x.commit());
+        return this.release = () => {
+            dependant.forEach(x => x.release());
+            onDone();
+        };
+    }
+}
+
+const Oops$8 = issues({
+    ComputeFailed: (parent, property, initial) => `An exception was thrown while ${initial ? "initializing" : "refreshing"} [${parent}.${property}].`,
+    ComputedEarly: (property) => `Note: Computed values don't run until accessed, except when subscribed to. '${property}' getter may have run earlier than intended.`
+});
+const ComputedInit = new WeakSet();
+const ComputedInfo = new WeakMap();
+const ComputedUsed = new WeakMap();
+const ComputedKeys = new WeakMap();
+function prepare(parent, key, source, setter, getter) {
+    let sub;
+    const { state, subject } = parent;
+    const info = { key, parent, priority: 1 };
+    const current = getter
+        ? () => getter.call(subject, state[key], key)
+        : () => state[key];
+    const prioritize = register(parent, key, info);
+    function compute(initial) {
+        try {
+            return setter.call(sub.proxy, sub.proxy);
+        }
+        catch (err) {
+            Oops$8.ComputeFailed(subject, key, !!initial).warn();
+            throw err;
+        }
+    }
+    function update() {
+        let value;
+        try {
+            value = compute(false);
+        }
+        catch (e) {
+            console.error(e);
+        }
+        finally {
+            if (state[key] !== value) {
+                parent.update(key, value);
+                return value;
+            }
+        }
+    }
+    function create(early) {
+        sub = new Subscriber(source(), update);
+        defineProperty(state, key, {
+            value: undefined,
+            writable: true
+        });
+        defineProperty(subject, key, {
+            enumerable: true,
+            configurable: true,
+            get: current
+        });
+        try {
+            state[key] = compute(true);
+        }
+        catch (e) {
+            if (early)
+                Oops$8.ComputedEarly(key).warn();
+            throw e;
+        }
+        finally {
+            sub.commit();
+            for (const key in sub.follows)
+                prioritize(key);
+        }
+        return current();
+    }
+    setAlias(update, `try ${key}`);
+    setAlias(create, `new ${key}`);
+    setAlias(setter, `run ${key}`);
+    ComputedInit.add(create);
+    ComputedInfo.set(update, info);
+    for (const on of [state, subject])
+        defineProperty(on, key, {
+            get: create,
+            configurable: true,
+            enumerable: true
+        });
+}
+function register(on, key, info) {
+    let register = ComputedUsed.get(on);
+    if (!register)
+        ComputedUsed.set(on, register = new Map());
+    register.set(key, info);
+    return (key) => {
+        const peer = register.get(key);
+        if (peer && peer.priority >= info.priority)
+            info.priority = peer.priority + 1;
+    };
+}
+function ensure(on, keys) {
+    for (const key of keys) {
+        const desc = getOwnPropertyDescriptor(on.subject, key);
+        const getter = desc && desc.get;
+        if (ComputedInit.has(getter))
+            getter(true);
+    }
+}
+function capture(on, request) {
+    const compute = ComputedInfo.get(request);
+    const callback = request;
+    if (!compute)
+        return;
+    let pending = ComputedKeys.get(on);
+    if (!pending)
+        ComputedKeys.set(on, pending = []);
+    if (compute.parent !== on)
+        callback();
+    else {
+        const queue = pending.findIndex(peer => compute.priority > ComputedInfo.get(peer).priority);
+        pending.splice(queue + 1, 0, callback);
+    }
+    return true;
+}
+function flush(on) {
+    const handled = on.frame;
+    let pending = ComputedKeys.get(on);
+    if (pending) {
+        while (pending.length) {
+            const compute = pending.shift();
+            const { key } = ComputedInfo.get(compute);
+            if (!handled.has(key))
+                compute();
+        }
+        ComputedKeys.delete(on);
+    }
+}
+
+const Lifecycle = {
+    WILL_RENDER: "willRender",
+    WILL_UPDATE: "willUpdate",
+    WILL_MOUNT: "willMount",
+    WILL_UNMOUNT: "willUnmount",
+    DID_MOUNT: "didMount"
+};
+const lifecycleEvents = [
+    "didCreate",
+    "willDestroy",
+    ...values(Lifecycle)
+];
+function lifecycle(prefix) {
+    const type = eventsFor(prefix);
+    return function useLifecycle(sub, tag) {
+        const emit = useMemo(() => {
+            const subject = sub.source;
+            const id = typeof tag == "function" ? tag(subject) : tag;
+            return (name) => {
+                for (const key of [name, type(name)])
+                    subject.update(key, id);
+            };
+        }, [sub, tag]);
+        emit(Lifecycle.WILL_RENDER);
+        emit(sub.active
+            ? Lifecycle.WILL_UPDATE
+            : Lifecycle.WILL_MOUNT);
+        useLayoutEffect(() => {
+            sub.commit();
+            emit(Lifecycle.DID_MOUNT);
+            return () => {
+                emit(Lifecycle.WILL_UNMOUNT);
+                sub.release();
+            };
+        }, [sub]);
+    };
+}
+function eventsFor(prefix) {
+    const map = new Map();
+    for (const name of values(Lifecycle)) {
+        const alias = prefix + name[0].toUpperCase() + name.slice(1);
+        lifecycleEvents.push(alias);
+        map.set(name, alias);
+    }
+    return (e) => map.get(e);
+}
+
+const CONTROL = Symbol("control");
+const LOCAL = Symbol("local");
+const STATE = Symbol("state");
+function manage(src) {
+    return src[CONTROL];
+}
+const Pending = new Map();
+function apply(fn, label) {
+    const name = label || fn.name || "pending";
+    const placeholder = Symbol(`${name} instruction`);
+    function setup(key) {
+        let output = fn.call(this, key, this);
+        if (typeof output == "function") {
+            const getter = output;
+            output = Object.assign(Object.assign({}, getOwnPropertyDescriptor(this.subject, key)), { get() {
+                    return getter(this[LOCAL]);
+                } });
+        }
+        if (output)
+            defineProperty(this.subject, key, output);
+    }
+    Pending.set(placeholder, setup);
+    return placeholder;
+}
+class Controller {
+    constructor(subject) {
+        this.subject = subject;
+        this.state = {};
+        this.frame = new Set();
+        this.handles = new Set();
+        this.waiting = [];
+    }
+    static setup(onto) {
+        const control = new this(onto);
+        defineLazy(onto, CONTROL, () => {
+            onto[STATE] = control.state;
+            control.start();
+            if (onto.didCreate)
+                onto.didCreate();
+            return control;
+        });
+        return control;
+    }
+    get pending() {
+        return this.frame.size > 0;
+    }
+    start() {
+        const { subject } = this;
+        for (const key in subject) {
+            const desc = getOwnPropertyDescriptor(subject, key);
+            if (desc && "value" in desc) {
+                const { value } = desc;
+                const instruction = Pending.get(value);
+                if (instruction) {
+                    Pending.delete(value);
+                    delete subject[key];
+                    instruction.call(this, key, this);
+                }
+                else if (typeof value !== "function" || /^[A-Z]/.test(key))
+                    this.manage(key, value);
+            }
+        }
+        this.emit();
+        return this;
+    }
+    select(using) {
+        const keys = getOwnPropertyNames(this.state);
+        return using
+            ? selectRecursive(using, keys.concat(lifecycleEvents))
+            : keys;
+    }
+    manage(key, initial, effect) {
+        const { state, subject } = this;
+        state[key] = initial;
+        defineProperty(subject, key, {
+            enumerable: true,
+            configurable: true,
+            get: () => state[key],
+            set: this.setter(key, effect)
+        });
+    }
+    setter(key, handler) {
+        const { state, subject } = this;
+        return (value) => {
+            if (state[key] == value)
+                return;
+            if (handler)
+                switch (handler.call(subject, value)) {
+                    case true:
+                        this.update(key);
+                    case false:
+                        return;
+                }
+            this.update(key, value);
+        };
+    }
+    addListener(batch) {
+        this.handles.add(batch);
+        return () => {
+            this.handles.delete(batch);
+        };
+    }
+    include(to) {
+        if (capture(this, to))
+            return;
+        else
+            this.waiting.push(to);
+    }
+    update(key, value) {
+        if (1 in arguments)
+            this.state[key] = value;
+        if (this.frame.has(key))
+            return;
+        if (!this.frame.size)
+            setTimeout(() => this.emit(), 0);
+        this.frame.add(key);
+        for (const subscription of this.handles)
+            if (key in subscription)
+                this.include(subscription[key]);
+    }
+    emit() {
+        flush(this);
+        const keys = Array.from(this.frame);
+        const handle = new Set(this.waiting.splice(0));
+        this.frame.clear();
+        handle.forEach(callback => {
+            try {
+                callback(keys);
+            }
+            catch (e) { }
+        });
+    }
+}
+function keys(from, using) {
+    if (typeof using == "string")
+        return [using];
+    if (typeof using == "object") {
+        using = Array.from(using);
+        if (using.length === 0)
+            using = undefined;
+        else
+            return using;
+    }
+    return from.select(using);
+}
+
+function child(from, name) {
+    return apply(function child(key) {
+        const proxyCache = new WeakMap();
+        const getCurrent = from.call(this, key);
+        function subscribe(sub) {
+            let child;
+            function start() {
+                const instance = getCurrent();
+                if (instance) {
+                    child = new Subscriber(instance, sub.onUpdate);
+                    if (sub.active)
+                        child.commit();
+                    sub.dependant.add(child);
+                    proxyCache.set(sub, child.proxy);
+                }
+            }
+            function refresh() {
+                if (child) {
+                    child.release();
+                    sub.dependant.delete(child);
+                    proxyCache.set(sub, undefined);
+                    child = undefined;
+                }
+                start();
+                sub.onUpdate();
+            }
+            start();
+            sub.follow(key, refresh);
+        }
+        return (local) => {
+            if (!local)
+                return getCurrent();
+            if (!proxyCache.has(local))
+                subscribe(local);
+            return proxyCache.get(local);
+        };
+    }, name || from.name);
+}
+
+const Oops$7 = issues({
+    HasPropertyUndefined: (control, property) => `${control}.${property} is marked as required for this render.`
+});
+function use$1(init) {
+    const [state, update] = useState(() => [
+        init(() => update(state.concat()))
+    ]);
+    return state[0];
+}
+function useLazy(Type, callback) {
+    const instance = useMemo(() => {
+        const instance = Type.create();
+        if (callback)
+            callback(instance);
+        return instance;
+    }, []);
+    useLayoutEffect(() => () => instance.destroy(), []);
+    return instance;
+}
+function useWatcher(target, focus, expected) {
+    const hook = use$1(refresh => {
+        const sub = new Subscriber(target, refresh);
+        if (focus) {
+            const src = sub.proxy;
+            const key = keys(sub.parent, focus)[0];
+            defineProperty(sub, "proxy", {
+                get() {
+                    if (src[key] === undefined && expected)
+                        throw Oops$7.HasPropertyUndefined(target, key);
+                    return src[key];
+                }
+            });
+        }
+        return sub;
+    });
+    useLayoutEffect(() => hook.commit(), []);
+    return hook.proxy;
+}
+function useModel(Type, callback) {
+    const hook = use$1(refresh => {
+        const instance = new Type();
+        const control = manage(instance);
+        const sub = new Subscriber(control, refresh);
+        const release = control.addListener({
+            [Lifecycle.WILL_UNMOUNT]() {
+                instance.destroy();
+                release();
+            }
+        });
+        if (callback)
+            callback(instance);
+        return sub;
+    });
+    return hook.proxy;
+}
+
+const Oops$6 = issues({
+    CantAttachGlobal: (parent, child) => `Singleton '${parent}' attempted to attach '${child}' but it is not also a singleton.`,
+    AmbientRequired: (requested, requester, key) => `Attempted to find an instance of ${requested} in context. It is required for [${requester}.${key}], but one could not be found.`
+});
+const PendingContext = new WeakMap();
+const ContextWasUsed = new WeakMap();
+function tap(type, argument) {
+    return child(function tap(key) {
+        return pendingAccess(this.subject, type, key, argument);
+    });
+}
+function pendingAccess(from, type, key, argument) {
+    if ("current" in type)
+        return () => type.current;
+    if ("current" in from.constructor)
+        throw Oops$6.CantAttachGlobal(from, type.name);
+    let instance;
+    getPending(from).push(context => {
+        instance = context.get(type);
+        if (typeof argument == "function") {
+            if (argument(instance) === false)
+                instance = undefined;
+        }
+        else if (!instance && argument)
+            throw Oops$6.AmbientRequired(type.name, from, key);
+    });
+    return () => instance;
+}
+function usePeerContext(subject) {
+    if (ContextWasUsed.has(subject)) {
+        if (ContextWasUsed.get(subject))
+            useLookup();
+        return;
+    }
+    const pending = PendingContext.get(subject);
+    if (pending) {
+        const local = useLookup();
+        for (const init of pending)
+            init(local);
+        PendingContext.delete(subject);
+    }
+    ContextWasUsed.set(subject, !!pending);
+}
+function getPending(subject) {
+    let pending = PendingContext.get(subject);
+    if (!pending)
+        PendingContext.set(subject, pending = []);
+    return pending;
+}
+
+class Lookup {
+    constructor() {
+        this.table = new Map();
+    }
+    get local() {
+        return getOwnPropertySymbols(this).map((symbol) => this[symbol]);
+    }
+    key(T) {
+        let key = this.table.get(T);
+        if (!key) {
+            key = Symbol(T.name);
+            this.table.set(T, key);
+        }
+        return key;
+    }
+    get(T) {
+        return this[this.key(T)];
+    }
+    push(I) {
+        const next = create(this);
+        if (I instanceof Model || typeof I == "function")
+            next.register(I);
+        else
+            for (const i of values(I))
+                next.register(i);
+        return next;
+    }
+    register(I) {
+        let writable = true;
+        let T;
+        if (I instanceof Model) {
+            T = I.constructor;
+            writable = false;
+        }
+        else {
+            T = I;
+            I = I.create();
+        }
+        do {
+            defineProperty(this, this.key(T), {
+                value: I, writable
+            });
+            T = getPrototypeOf(T);
+        } while (T !== Model);
+        return I;
+    }
+    pop() {
+        for (const key of getOwnPropertySymbols(this)) {
+            const entry = getOwnPropertyDescriptor(this, key);
+            if (entry.writable)
+                entry.value.destroy();
+        }
+    }
+}
+
+const Oops$5 = issues({
+    NoProviderType: () => `Provider 'of' prop must be Model, typeof Model or a collection of them.`,
+    NothingInContext: (name) => `Couldn't find ${name} in context; did you forget to use a Provider?`,
+    BadConsumerProps: () => `Provider expects either a render function, 'get' or 'has' props.`
+});
+const LookupContext = createContext(new Lookup());
+const useLookup = () => useContext(LookupContext);
+function useFromContext(Type, strict) {
+    const instance = useLookup().get(Type);
+    if (!instance && strict)
+        throw Oops$5.NothingInContext(Type.name);
+    return instance;
+}
+function Consumer(props) {
+    const { get, has, children, of: Control } = props;
+    if (typeof children == "function")
+        return children(Control.tap());
+    const callback = has || get;
+    if (typeof callback == "function")
+        callback(Control.get(!!has));
+    else
+        throw Oops$5.BadConsumerProps();
+    return null;
+}
+function useNewContext(from, inject) {
+    return useMemo(() => {
+        if (!inject)
+            throw Oops$5.NoProviderType();
+        const context = from.push(inject);
+        for (const instance of context.local)
+            for (const apply of getPending(instance))
+                apply(context);
+        return context;
+    }, []);
+}
+function useAppliedProps(within, props) {
+    const update = useMemo(() => {
+        const targets = within.local;
+        return function integrate(props) {
+            for (const [key, value] of entries(props))
+                if (key != "of" && key != "children")
+                    for (const into of targets)
+                        if (key in into)
+                            into[key] = value;
+        };
+    }, []);
+    update(props);
+}
+function RenderFunction(props) {
+    const hook = use$1(refresh => {
+        const targets = props.context.local;
+        if (targets.length == 1)
+            return new Subscriber(targets[0], refresh);
+        return {};
+    });
+    if (hook.commit)
+        useLayoutEffect(() => hook.commit(), []);
+    return props.render(hook.proxy);
+}
+function Provider(props) {
+    const render = props.children;
+    const current = useLookup();
+    const context = useNewContext(current, props.of);
+    useAppliedProps(context, props);
+    useLayoutEffect(() => () => context.pop(), []);
+    return createElement(LookupContext.Provider, { value: context }, typeof render == "function"
+        ? createElement(RenderFunction, { context, render })
+        : render);
+}
+
+const Oops$4 = issues({
+    StrictUpdate: (expected) => `Strict update() did ${expected ? "not " : ""}find pending updates.`,
+    NoChaining: () => `Then called with undefined; update promise will never catch nor supports chaining.`
+});
+const useElementLifecycle = lifecycle("element");
+const useComponentLifecycle = lifecycle("component");
+class Model {
+    constructor() {
+        const control = Controller.setup(this);
+        define(this, "get", this);
+        define(this, "set", this);
+        defer(control, "on");
+        defer(control, "effect");
+        control.include(() => {
+            delete this.on;
+            delete this.effect;
+        });
+    }
+    tap(path, expect) {
+        const proxy = useWatcher(this, path, expect);
+        this.update("willRender", true);
+        return proxy;
+    }
+    tag(id) {
+        const hook = use$1(refresh => {
+            return new Subscriber(this, refresh);
+        });
+        useElementLifecycle(hook, id || 0);
+        return hook.proxy;
+    }
+    use(callback) {
+        const hook = use$1(refresh => {
+            if (callback)
+                callback(this);
+            return new Subscriber(this, refresh);
+        });
+        useComponentLifecycle(hook);
+        return hook.proxy;
+    }
+    on(subset, handler, squash, once) {
+        const control = manage(this);
+        const set = keys(control, subset);
+        const batch = {};
+        const remove = control.addListener(batch);
+        const callback = squash
+            ? handler.bind(this)
+            : (frame) => {
+                for (const key of frame)
+                    if (set.includes(key))
+                        handler.call(this, control.state[key], key);
+            };
+        const handle = once
+            ? (k) => { remove(); callback(k); }
+            : callback;
+        for (const key of set)
+            batch[key] = handle;
+        ensure(control, set);
+        return remove;
+    }
+    once(select, callback, squash) {
+        if (callback)
+            return this.on(select, callback, squash, true);
+        else
+            return new Promise(resolve => {
+                this.on(select, resolve, true, true);
+            });
+    }
+    effect(callback, select) {
+        const control = manage(this);
+        let target = this;
+        const effect = createEffect(callback);
+        const invoke = () => effect.call(target, target);
+        if (select) {
+            invoke();
+            return this.on(select, invoke, true);
+        }
+        else {
+            const sub = new Subscriber(control, invoke);
+            target = sub.proxy;
+            invoke();
+            return sub.commit();
+        }
+    }
+    import(from, subset) {
+        for (const key of keys(manage(this), subset))
+            if (key in from)
+                this[key] = from[key];
+    }
+    export(subset) {
+        const control = manage(this);
+        const output = {};
+        for (const key of keys(control, subset))
+            output[key] = control.state[key];
+        return output;
+    }
+    update(arg, tag) {
+        const control = manage(this);
+        if (typeof arg == "function")
+            arg = select(this, arg);
+        if (typeof arg == "boolean") {
+            if (!control.pending === arg)
+                return Promise.reject(Oops$4.StrictUpdate(arg));
+        }
+        else if (arg) {
+            control.update(arg);
+            if (1 in arguments && arg in this) {
+                const method = this[arg];
+                if (typeof method == "function")
+                    if (typeof tag != "boolean")
+                        method.call(this, tag);
+                    else if (tag)
+                        method.call(this);
+            }
+        }
+        return {
+            then(callback) {
+                if (callback)
+                    if (control.pending)
+                        control.include(callback);
+                    else
+                        callback(false);
+                else
+                    throw Oops$4.NoChaining();
+            }
+        };
+    }
+    destroy() {
+        this.update("willDestroy", true);
+    }
+    toString() {
+        return this.constructor.name;
+    }
+    static create(...args) {
+        const instance = new this(...args);
+        manage(instance);
+        return instance;
+    }
+    static new(callback) {
+        const instance = useLazy(this, callback);
+        instance.update("willRender", true);
+        return instance;
+    }
+    static find(strict) {
+        return useFromContext(this, strict);
+    }
+    static get(key) {
+        const instance = this.find(!!key);
+        return (typeof key == "function" ?
+            key(instance) :
+            typeof key == "string" ?
+                instance[key] :
+                instance);
+    }
+    static tap(key, expect) {
+        return this.find(true).tap(key, expect);
+    }
+    static tag(id) {
+        return this.find(true).tag(id);
+    }
+    static use(callback) {
+        const instance = useModel(this, callback);
+        useComponentLifecycle(instance[LOCAL]);
+        usePeerContext(instance.get);
+        return instance;
+    }
+    static uses(props, only) {
+        return this.use(instance => {
+            instance.import(props, only);
+        });
+    }
+    static using(props, only) {
+        const instance = this.use();
+        instance.import(props, only);
+        return instance;
+    }
+    static meta(path) {
+        return useWatcher(this, path);
+    }
+    static isTypeof(maybe) {
+        return (typeof maybe == "function" &&
+            maybe.prototype instanceof this);
+    }
+}
+Model.CONTROL = CONTROL;
+Model.STATE = STATE;
+Model.LOCAL = LOCAL;
+defineLazy(Model, CONTROL, function () {
+    return new Controller(this).start();
+});
+function defer(on, method) {
+    const { subject, waiting } = on;
+    const real = subject[method];
+    subject[method] = (...args) => {
+        let done;
+        waiting.push(() => {
+            done = real.apply(subject, args);
+        });
+        return () => done();
+    };
+}
+
+const Parent = new WeakMap();
+const Oops$3 = issues({
+    ParentRequired: (expects, child) => `New ${child} created standalone but requires parent of type ${expects}. Did you remember to create via use(${child})?`,
+    UnexpectedParent: (expects, child, got) => `New ${child} created as child of ${got}, but must be instanceof ${expects}.`,
+    UndefinedNotAllowed: (key) => `Child property ${key} may not be undefined.`,
+    BadArgument: (type) => `Instruction \`use\` cannot accept argument type of ${type}.`,
+    IsReadOnly: (owner, key) => `${owner}.${key} is set to read-only, but tried to reassign assign.`,
+    MustBeDefined: (owner, key) => `${owner}.${key} must have initial value, as a read-only property.`
+});
+function bootstrap(object) {
+    const breakdown = getOwnPropertyDescriptors(object);
+    const control = new Model();
+    for (const key in breakdown)
+        defineProperty(control, key, breakdown[key]);
+    return control;
+}
+function use(input, argument) {
+    return child(function use(key) {
+        const { subject } = this;
+        // `true` => readonly
+        // `false` => writable, may be undefined
+        // `undefined` => writable (default)
+        let mode = argument;
+        let current;
+        const onUpdate = (next, initial) => {
+            if (mode === true && !initial)
+                throw Oops$3.IsReadOnly(subject, key);
+            if (next) {
+                current = next instanceof Model
+                    ? next : bootstrap(next);
+                Parent.set(current, subject);
+                manage(current);
+            }
+            else if (mode === undefined)
+                throw Oops$3.UndefinedNotAllowed(key);
+            else
+                current = undefined;
+            if (typeof argument == "function")
+                return argument(current);
+        };
+        if (input) {
+            current =
+                Model.isTypeof(input) ? new input() :
+                    input instanceof Model ? input :
+                        typeof input === "function" ? input() :
+                            typeof input === "object" ? bootstrap(input) :
+                                Oops$3.BadArgument(typeof input).throw();
+            if (current)
+                mode = onUpdate(current, true) || mode;
+            else if (mode == true)
+                throw Oops$3.MustBeDefined(subject, key);
+        }
+        else
+            mode = false;
+        this.manage(key, current, onUpdate);
+        return () => current;
+    });
+}
+function parent(Expects, required) {
+    return apply(function parent() {
+        const child = this.subject;
+        const expected = Expects.name;
+        const value = Parent.get(this.subject);
+        if (!value) {
+            if (required)
+                throw Oops$3.ParentRequired(expected, child);
+        }
+        else if (!(value instanceof Expects))
+            throw Oops$3.UnexpectedParent(expected, child, value);
+        return { value };
+    });
+}
+
+const Oops$2 = issues({
+    DuplicateAction: (key) => `Invoked action ${key} but one is already active.`,
+    BadComputedSource: (model, property, got) => `Bad from-instruction provided to ${model}.${property}. Expects an arrow-function or a Model as source. Got ${got}.`,
+    PeerNotAllowed: (model, property) => `Attempted to use an instruction result (probably use or tap) as computed source for ${model}.${property}. This is not possible.`
+});
+function createRef(key, cb) {
+    const refObjectFunction = this.setter(key, cb && createValueEffect(cb));
+    defineProperty(refObjectFunction, "current", {
+        set: refObjectFunction,
+        get: () => this.state[key]
+    });
+    return refObjectFunction;
+}
+function ref(arg) {
+    return apply(function ref(key) {
+        let value = {};
+        if (typeof arg == "object") {
+            const source = manage(arg);
+            for (const key in source.state)
+                defineLazy(value, key, createRef.bind(source, key));
+        }
+        else
+            value = createRef.call(this, key, arg);
+        return { value };
+    });
+}
+function on(initial, cb) {
+    return apply(function on(key) {
+        this.manage(key, initial, cb && createValueEffect(cb));
+    });
+}
+function memo(factory, defer) {
+    return apply(function memo(key) {
+        const source = this.subject;
+        const get = () => factory.call(source);
+        if (defer)
+            defineLazy(source, key, get);
+        else
+            define(source, key, get());
+    });
+}
+function lazy(value) {
+    return apply(function lazy(key) {
+        const source = this.subject;
+        source[key] = value;
+        defineProperty(this.state, key, {
+            get: () => source[key]
+        });
+    });
+}
+function act(task) {
+    return apply(function act(key) {
+        let pending = false;
+        const invoke = (...args) => {
+            if (pending)
+                return Promise.reject(Oops$2.DuplicateAction(key));
+            pending = true;
+            this.update(key);
+            return new Promise(res => {
+                res(task.apply(this.subject, args));
+            }).finally(() => {
+                pending = false;
+                this.update(key);
+            });
+        };
+        setAlias(invoke, `run ${key}`);
+        defineProperty(invoke, "active", {
+            get: () => pending
+        });
+        return {
+            value: invoke,
+            writable: false
+        };
+    });
+}
+function from(source, setter, getter) {
+    return apply(function from(key) {
+        const { subject } = this;
+        let getSource;
+        // Easy mistake, using a peer, will always be unresolved.
+        if (typeof source == "symbol")
+            throw Oops$2.PeerNotAllowed(subject, key);
+        // replace source controller in-case different
+        if (typeof source == "object")
+            getSource = () => manage(source);
+        // specifically an arrow function (getter factory)
+        else if (!source.prototype) {
+            setter = source.call(subject, key);
+            getSource = () => this;
+        }
+        // is a peer Model (constructor)
+        else if (Model.isTypeof(source))
+            getSource = pendingAccess(subject, source, key, true);
+        // Regular function is to ambiguous so not allowed.
+        else
+            throw Oops$2.BadComputedSource(subject, key, source);
+        prepare(this, key, getSource, setter, getter);
+    });
+}
+
+const Oops$1 = issues({
+    ValueNotReady: (model, key) => `Value ${model}.${key} value is not yet available.`
+});
+function pending(source, compute) {
+    return (source === undefined ?
+        suspendForValue() :
+        typeof source == "function" && !source.prototype ?
+            suspendForAsync(source) :
+            suspendForComputed(source, compute));
+}
+/**
+ * Get value, suspend instead if undefined.
+ *
+ * Throws suspense promise also interpretable as an error.
+ * React could handle it but other contexts probably not.
+ */
+function pendingValue(via, key) {
+    const value = via.state[key];
+    if (value !== undefined)
+        return value;
+    const error = Oops$1.ValueNotReady(via.subject, key);
+    const promise = new Promise(resolve => {
+        const release = via.addListener({
+            [key](value) {
+                if (value !== undefined) {
+                    release();
+                    resolve();
+                }
+            }
+        });
+    });
+    throw Object.assign(promise, {
+        toString: () => String(error),
+        message: error.message,
+        stack: error.stack
+    });
+}
+function suspendForComputed(source, compute) {
+    function getter(_value, key) {
+        return pendingValue(manage(this), key);
+    }
+    return from(source, compute, getter);
+}
+function suspendForValue() {
+    return apply(function pending(key) {
+        this.state[key] = undefined;
+        return {
+            set: this.setter(key),
+            get: () => pendingValue(this, key)
+        };
+    });
+}
+function suspendForAsync(source) {
+    return apply(function suspense(key) {
+        const subject = this.subject;
+        let waiting = true;
+        let value;
+        let error;
+        return () => {
+            if (error)
+                throw error;
+            if (!waiting)
+                return value;
+            const issue = Oops$1.ValueNotReady(subject, key);
+            let suspend = source
+                .call(subject, key)
+                .catch(err => error = err)
+                .then(out => value = out)
+                .finally(() => waiting = false);
+            throw Object.assign(suspend, {
+                message: issue.message,
+                stack: issue.stack
+            });
+        };
+    });
+}
+
+const Oops = issues({
+    GlobalDoesNotExist: (name) => `Tried to access singleton ${name}, but none exist! Did you forget to initialize?\nCall ${name}.create() before attempting to access, or consider using ${name}.use() instead.`,
+    GlobalExists: (name) => `Shared instance of ${name} already exists! Consider unmounting existing, or use ${name}.reset() to force-delete it.`
+});
+const Active = new WeakMap();
+class Singleton extends Model {
+    static get current() {
+        return Active.get(this);
+    }
+    static create(...args) {
+        const Type = this;
+        if (Active.has(Type))
+            throw Oops.GlobalExists(this.name);
+        let instance = super.create(...args);
+        Active.set(Type, instance);
+        return instance;
+    }
+    static update(updates) {
+        const instance = this.current || this.create();
+        instance.import(updates);
+        return instance.update();
+    }
+    static is() {
+        return this.find(true);
+    }
+    static find(strict) {
+        const instance = this.current;
+        if (!instance && strict)
+            throw Oops.GlobalDoesNotExist(this.name);
+        return instance;
+    }
+    static reset() {
+        if (this.current)
+            this.current.destroy();
+    }
+    destroy() {
+        super.destroy();
+        Active.delete(this.constructor);
+    }
+}
+
+export { Consumer, Model, Provider, Singleton, act, apply, child, Model as default, from, lazy, memo, on, parent, pending, ref, tap, use };
+//# sourceMappingURL=index.esm.js.map