@expressive/mvc 0.2.1 → 0.2.4

package/lib/index.d.ts

@@ -430,19 +430,26 @@ declare class MVC extends Model {
     /**
      * **React Hook** - Fetch most instance of this controller from context, if it exists.
      *
-     * @param required - If false, may return undefined.
+     * @param required - Unless false, will throw where instance cannot be found.
      */
-    static get<T extends Class>(this: T, required?: true): InstanceOf<T>;
+    static get<T extends Class>(this: T, required?: boolean): InstanceOf<T>;
     /**
      * **React Hook** - Fetch most instance of this controller from context.
      *
-     * @param required - Unless false, will throw where instance cannot be found.
+     * @param required - If false, may return undefined.
      */
-    static get<T extends Class>(this: T, required: boolean): InstanceOf<T> | undefined;
+    static get<T extends Class>(this: T, required: false): InstanceOf<T> | undefined;
     /**
      * **React Hook** - Fetch specific value from instance of this controller in context.
      */
     static get<T extends Class, I extends InstanceOf<T>, K extends Model.Field<I>>(this: T, key: K): I[K];
+    /**
+     * **React Hook** - Fetch instance.
+     *
+     * Effect callback will run once if found, throw if not found.
+     * Returned function is called on unmount.
+     */
+    static get<T extends Class, I extends InstanceOf<T>>(this: T, effect: (found: I) => Callback | void): I;
     /**
      * **React Hook** - Fetch and subscribe to instance of this controller within ambient component.
      */
@@ -611,7 +618,10 @@ declare function tap<T extends Class>(Type: T, required?: boolean): InstanceOf<T
 declare function useFrom<T extends Stateful, R>(source: (() => T) | T, compute: (this: T, from: T) => R, expect: true): Exclude<R, undefined>;
 declare function useFrom<T extends Stateful, R>(source: (() => T) | T, compute: (this: T, from: T) => R, expect?: boolean): R;
 
-declare function useLocal<T extends typeof Model>(Type: T, arg?: boolean | string): any;
+declare function useLocal<T extends typeof Model>(Type: T, required: false): InstanceOf<T> | undefined;
+declare function useLocal<T extends typeof Model>(Type: T, arg?: boolean): InstanceOf<T>;
+declare function useLocal<T extends typeof Model, I extends InstanceOf<T>>(Type: T, effect: (found: I) => Callback | void): I;
+declare function useLocal<T extends typeof Model, I extends InstanceOf<T>, K extends Model.Field<I>>(Type: T, key: K): I[K];
 
 declare function useModel<T extends Class, I extends InstanceOf<T>>(source: T, watch: Model.Field<I>[], callback?: (instance: I) => void): I;
 declare function useModel<T extends Class, I extends InstanceOf<T>>(source: T, callback?: (instance: I) => void): I;

package/lib/index.esm.js

@@ -1,4 +1,4 @@
-import React, { useState, useMemo } from 'react';
+import React, { useLayoutEffect, useState, useMemo } from 'react';
 
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -1027,9 +1027,14 @@ function useLocal(Type, arg) {
     const instance = useLookup().get(Type);
     if (!instance && arg !== false)
         throw Oops$4.NotFound(Type.name);
-    return typeof arg == "string" ?
-        instance[arg] :
-        instance;
+    switch (typeof arg) {
+        case "string":
+            return instance[arg];
+        case "function":
+            useLayoutEffect(() => arg(instance), []);
+        default:
+            return instance;
+    }
 }
 
 const Oops$3 = issues({
@@ -1225,8 +1230,8 @@ class MVC extends Model {
     use(arg, callback) {
         return useModel(this, arg, callback);
     }
-    static get(required) {
-        return useLocal(this, required);
+    static get(arg) {
+        return useLocal(this, arg);
     }
     static tap(key, expect) {
         return useTap(this, key, expect);