udic 0.2.2 → 0.3.0

package/README.md

@@ -1,107 +1,4 @@
 A dependency injection library.
-```ts
-import * as di from 'udic';
-```
 
-# Examples
-Run code that depends on a service:
-```ts
-// Create a service that generates random number
-const randNumber = di.service('randNumber')<() => number>();
-
-// Use the service
-const compute = di.derive(
-  [randNumber],
-  (getRandNumber) => getRandNumber() + 1
-);
-
-// 1
-console.log(
-  compute({ randNumber: () => 0 })
-);
-```
-
-Nested `derive()`:
-```ts
-// Create a service that generates random number
-const randNumber = di.service('randNumber')<() => number>();
-
-// Use the service
-const compute = di.derive(
-  [randNumber],
-  (getRandNumber) => getRandNumber() + 1
-);
-
-// Use `compute()` within current context
-const anotherCompute = di.derive(
-  [compute],
-  (computedValue) => computedValue * 2
-);
-
-// 2
-console.log(
-  anotherCompute({ randNumber: () => 0 })
-);
-```
-
-Multiple dependencies:
-```ts
-// Create a service that generates random number
-const randNumber = di.service('randNumber')<() => number>();
-
-// Use the service
-const computeNumber = di.derive(
-  [randNumber],
-  (getRandNumber) => getRandNumber() + 1,
-);
-
-// Create a service that generates random string
-const randString = di.service('randString')<() => string>();
-
-// Use the computed value of `computed`
-const computeString = di.derive(
-  [randString, computeNumber],
-  (getRandString, number) => getRandString() + ': ' + number,
-);
-
-// 'reve: 1'
-console.log(
-  computeString({
-    randNumber: () => 0,
-    randString: () => 'reve',
-  }),
-);
-```
-
-Inject not all dependencies:
-```ts
-// Create a service that generates random number
-const randNumber = di.service('randNumber')<() => number>();
-
-// Use the service
-const computeNumber = di.derive(
-  [randNumber],
-  (getRandNumber) => getRandNumber() + 1,
-);
-
-// Create a service that generates random string
-const randString = di.service('randString')<() => string>();
-
-// Use the computed value of `computed`
-const computeString = di.derive(
-  [randString, computeNumber],
-  (getRandString, number) => getRandString() + ': ' + number,
-);
-
-// Inject the randNumber service
-const computeString1 = di.inject(computeString, {
-  randNumber: () => 0
-});
-
-// 'reve: 1'
-console.log(
-  computeString1({
-    randString: () => 'reve',
-  }),
-);
-```
+## Docs
+Documentation is now on [re-utils/di](https://re-utils.pages.dev/di).

package/index.d.ts

@@ -3,11 +3,11 @@ declare const _d: unique symbol;
 type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
 type Prettify<T> = { [K in keyof T] : T[K] } & {};
 export interface Service<
-	T extends string | symbol,
-	K
+	K extends string,
+	T
 > {
-	[_t]: K;
-	[_d]: undefined extends K ? { [k in T]? : K } : { [k in T] : K };
+	[_t]: T;
+	[_d]: undefined extends T ? { [k in K]? : T } : { [k in K] : T };
 }
 export interface Compute<
 	T,
@@ -17,21 +17,33 @@ export interface Compute<
 	[_d]: T;
 	(c: T): R;
 }
-export type Dependency = Service<any, any> | Compute<any, any>;
-export type InferResult<T extends Dependency> = T[typeof _t];
-export type InferDependency<T extends Dependency> = Prettify<UnionToIntersection<T[typeof _d]>>;
+export interface Layer<
+	K extends string,
+	C extends Compute<any, any>
+> {
+	[_t]: { [k in K] : InferResult<C> };
+	[_d]: InferDependency<C>;
+	0: K;
+	1: C;
+}
+export type InferResult<T extends {
+	[_t]: any
+}> = T[typeof _t];
+export type InferDependency<T extends {
+	[_d]: any
+}> = Prettify<UnionToIntersection<T[typeof _d]>>;
 /**
 * Create a service
 * @param name - The service name
 */
-export declare const service: <T extends string | symbol>(name: T) => (<K>() => Service<T, K> & T);
+export declare const service: <T extends string>(name: T) => (<K>() => Service<T, K> & T);
 /**
 * Create a compute that relies on other services or computes
 * @param deps - The service dependencies
 * @param f
 */
 export declare const derive: <
-	const T extends Dependency[],
+	const T extends (Service<any, any> | Compute<any, any>)[],
 	const R
 >(deps: T, f: (...args: { [K in keyof T] : InferResult<T[K]> }) => R) => Compute<InferDependency<T[number]>, R>;
 /**
@@ -44,4 +56,13 @@ export declare const inject: <
 	R,
 	D extends Partial<T>
 >(compute: Compute<T, R>, d: D) => Compute<Prettify<Omit<T, keyof D>>, R>;
+export declare const layer: <
+	T,
+	K extends string,
+	const C extends Compute<any, T>
+>(service: Service<K, T>, compute: C) => Layer<K, C>;
+export declare const provide: <
+	const T extends Layer<any, any>[],
+	const D extends InferDependency<T[number]>
+>(layers: T, deps: D) => Prettify<D & InferResult<T[number]>>;
 export {};

package/index.js

@@ -1 +1 @@
-let _t=Symbol();export let service=e=>()=>e;let tag=n=>(n[_t]=Symbol(),n);export let derive=(n,i)=>tag(r=>i(...n.map(n=>typeof n===`function`?r[n[_t]]??=n(r):r[n])));export let inject=(e,n)=>tag(r=>e({...r,...n}));
+let _t=Symbol();export let service=e=>()=>e;let tag=i=>(i[_t]=Symbol(),i);export let derive=(i,o)=>tag(a=>o(...i.map(i=>typeof i===`function`?a[i[_t]]??=i(a):a[i])));export let inject=(e,i)=>tag(a=>e({...a,...i}));export let layer=(e,i)=>[e,i];export let provide=(e,i)=>{for(let a=0;a<e.length;a++)i[e[a][0]]=e[a][1](i);return i};

package/package.json

@@ -1,6 +1,6 @@
 {
 "name": "udic",
-"version": "0.2.2",
+"version": "0.3.0",
 "description": "A simple dependency injection library",
 "keywords": ["di"],
 "license": "MIT",