feat(selector): export useSelector and createSelector

index.d.ts

@@ -11,6 +11,14 @@ declare type CB<T> = (t: T) => void;
 
 declare type CovarianceGuard<T> = [T, unknown];
 
+export declare function createSelector<V, Fns = {}>(
+  options: WritableSelectorOptions<V>,
+): Wire<V, Fns>;
+
+export declare function createSelector<V, Fns = {}>(
+  options: ReadOnlySelectorOptions<V>,
+): ReadonlyWire<V, Fns>;
+
 export declare function createWire<V, Fns = {}>(initialValue: V): Wire<V, Fns>;
 
 declare type Defined<T> = T extends undefined ? never : T;
@@ -30,6 +38,8 @@ declare interface FnsWireGuard<Fns> {
   ' fns-wire': StrictMethodsGuard<Fns>;
 }
 
+declare type GetWireValue = <V>(wire: ReadonlyStateWire<V>) => V;
+
 declare type InitializerOrValue<V> = V | (() => V);
 
 export declare type Interceptor<Value> = (
@@ -49,6 +59,10 @@ declare type Methods<T> = Pick<T, MethodKeys<T>>;
 
 declare type NonNever<T> = IsNever<T> extends true ? any : T;
 
+declare interface ReadOnlySelectorOptions<V> {
+  get: (options: { get: GetWireValue }) => V;
+}
+
 export declare interface ReadonlyStateWire<V>
   extends ReadonlyStateWireGuard<V> {
   /**
@@ -71,6 +85,8 @@ declare interface ReadonlyStateWireGuard<V> {
 export declare type ReadonlyWire<V, Fns = {}> = ReadonlyStateWire<V> &
   FnsWire<Fns>;
 
+declare type SetWireValue = <V>(wire: StateWire<V>, value: Defined<V>) => void;
+
 export declare interface StateWire<V> extends StateWireGuard<V> {
   /**
    * get current value
@@ -160,6 +176,14 @@ export declare function useInterceptor<W extends StateWire<any>>(
   interceptor: Interceptor<WireState<W>>,
 ): W;
 
+export declare function useSelector<V, Fns = {}>(
+  options: WritableSelectorOptions<V>,
+): Wire<V, Fns>;
+
+export declare function useSelector<V, Fns = {}>(
+  options: ReadOnlySelectorOptions<V>,
+): ReadonlyWire<V, Fns>;
+
 export declare function useWire<V, Fns = {}>(
   upLink: Wire<V, Fns>,
 ): Wire<V, Fns>;
@@ -236,4 +260,15 @@ export declare type WireState<
   W extends ReadonlyStateWire<any>
 > = W extends ReadonlyStateWire<infer V> ? V : never;
 
+declare interface WritableSelectorOptions<V> {
+  get: (options: { get: GetWireValue }) => V;
+  set: (
+    options: {
+      get: GetWireValue;
+      set: SetWireValue;
+    },
+    value: V,
+  ) => void;
+}
+
 export {};

src/index.ts

@@ -12,3 +12,5 @@ export { useWireValue } from './state-wire/use-wire-value';
 export { useInterceptor } from './interceptor/use-interceptor';
 export { useFn } from './fn-wire/use-fn';
 export { createWire } from './wire/create-wire';
+export { createSelector } from './selector/create-selector';
+export { useSelector } from './selector/use-selector';