ditox 2.3.0 → 2.3.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Mikhail Nasyrov
+Copyright (c) 2023 Mikhail Nasyrov
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,66 +1,37 @@
-# Ditox.js
+# ditox package
 
 <img alt="lemon" src="https://raw.githubusercontent.com/mnasyrov/ditox/master/lemon.svg" width="120" />
 
-Powerful dependency injection container for building modular apps.
+**Dependency injection for modular web applications**
 
-[![npm](https://img.shields.io/npm/v/ditox.svg)](https://www.npmjs.com/package/ditox)
-[![downloads](https://img.shields.io/npm/dt/ditox.svg)](https://www.npmjs.com/package/ditox)
-[![types](https://img.shields.io/npm/types/ditox.svg)](https://www.npmjs.com/package/ditox)
-[![licence](https://img.shields.io/github/license/mnasyrov/ditox.svg)](https://github.com/mnasyrov/ditox/blob/master/LICENSE)
-[![Coverage Status](https://coveralls.io/repos/github/mnasyrov/ditox/badge.svg)](https://coveralls.io/github/mnasyrov/ditox)
+Please see the documentation at [ditox.js.org](https://ditox.js.org)
 
-## Table of Contents
-
-<!-- toc -->
-
-- [Features](#features)
-- [Installation](#installation)
-- [Usage](#usage)
-- [Container Hierarchy](#container-hierarchy)
-- [Factory Lifetimes](#factory-lifetimes)
-  * [`singleton`](#singleton)
-  * [`scoped`](#scoped)
-  * [`transient`](#transient)
-- [Dependency modules](#dependency-modules)
-- [API References](#api-references)
-
-<!-- tocstop -->
-
-## Features
-
-- Simple and functional API
-- Container hierarchy
-- Scoped containers
-- Dependency modules
-- Multi-value tokens
-- Typescript typings
-- Supports Node.js, Deno and browsers
+[![npm](https://img.shields.io/npm/v/ditox)](https://www.npmjs.com/package/ditox)
+[![stars](https://img.shields.io/github/stars/mnasyrov/ditox)](https://github.com/mnasyrov/ditox/stargazers)
+[![types](https://img.shields.io/npm/types/ditox)](https://www.npmjs.com/package/ditox)
+[![licence](https://img.shields.io/github/license/mnasyrov/ditox)](https://github.com/mnasyrov/ditox/blob/master/LICENSE)
+[![coverage](https://coveralls.io/repos/github/mnasyrov/ditox/badge)](https://coveralls.io/github/mnasyrov/ditox)
 
 ## Installation
 
-Install with `npm`
-
-```
-npm install ditox --save
-```
-
-Or `yarn`
+You can use the following command to install this package:
 
-```
-yarn add ditox
+```shell
+npm install --save ditox
 ```
 
-You can also use the [UMD](https://github.com/umdjs/umd) build from `unpkg`
+The package can be used as [UMD](https://github.com/umdjs/umd) module. Use
+[jsdelivr.com](https://jsdelivr.com) CDN site to load
+[ditox](https://www.jsdelivr.com/package/npm/ditox):
 
 ```html
-<script src="https://unpkg.com/ditox/dist/index.browser.js" />
+<script src="//cdn.jsdelivr.net/npm/ditox/dist/umd/index.js" />
 <script>
   const container = Ditox.createContainer();
 </script>
 ```
 
-Usage with Deno:
+Using in Deno environment:
 
 ```ts
 import {createContainer} from 'https://deno.land/x/ditox/mod.ts';
@@ -68,17 +39,32 @@ import {createContainer} from 'https://deno.land/x/ditox/mod.ts';
 const container = createContainer();
 ```
 
-## Usage
+## General description
+
+DI pattern in general allows to declare and construct a code graph of an
+application. It can be described by following phases:
+
+1. Code declaration phase:
+
+- Defining public API and types of business layer
+- Creation of injection tokens
+- Declaring DI modules
+
+2. Binding phase:
+
+- Creation of a container
+- Binding values, factories and modules to the container
+
+3. Runtime phase:
 
-Ditox.js works with containers, tokens, values and value factories.
-There are no class decorators, field injectors and other magic stuff. Only explicit binding and resolving.
+- Running the code
+- Values are constructed by registered factories
 
-In general, all you need is to do the following:
+Diagram:
 
-- Create binding tokens.
-- Create a container.
-- Register values and factories in the container using the tokens.
-- Resolve the tokens and use the provided values.
+<img alt="diagram" src="../../media/diagram.svg" width="800" />
+
+## Usage Example
 
 ```js
 import {createContainer, injectable, optional, token} from 'ditox';
@@ -93,42 +79,41 @@ class UserService {
 }
 
 // Define tokens for injections.
-// Token can be optional to provide default values.
-const TOKENS = {
-  StorageConfig: optional(token(), {name: 'default storage'}),
-  Storage: token('Token description for debugging'),
-  Logger: token(),
-  UserService: token(),
-};
+const STORAGE_TOKEN = token < UserService > 'Token description for debugging';
+const LOGGER_TOKEN = token();
+const USER_SERVICE_TOKEN = token();
+
+// Token can be optional with a default value.
+const STORAGE_CONFIG_TOKEN = optional(token(), {name: 'default storage'});
 
 // Create the container.
 const container = createContainer();
 
 // Provide a value to the container.
-container.bindValue(TOKENS.StorageConfig, {name: 'custom storage'});
+container.bindValue(STORAGE_CONFIG_TOKEN, {name: 'custom storage'});
 
 // Dynamic values are provided by factories.
 
 // A factory can be decorated with `injectable()` to resolve its arguments.
 // By default, a factory has `singleton` lifetime.
 container.bindFactory(
-  TOKENS.Storage,
-  injectable(createStorage, TOKENS.StorageConfig),
+  STORAGE_TOKEN,
+  injectable(createStorage, STORAGE_CONFIG_TOKEN),
 );
 
 // A factory can have `transient` lifetime to create a value on each resolving.
-container.bindFactory(TOKENS.Logger, createLogger, {scope: 'transient'});
+container.bindFactory(LOGGER_TOKEN, createLogger, {scope: 'transient'});
 
 // A class can be injected by `injectableClass()` which calls its constructor
 // with injected dependencies as arguments.
 container.bindFactory(
-  TOKENS.UserService,
+  USER_SERVICE_TOKEN,
   injectable(
     (storage, logger) => new UserService(storage, logger),
-    TOKENS.Storage,
+    STORAGE_TOKEN,
     // A token can be made optional to resolve with a default value
     // when it is not found during resolving.
-    optional(TOKENS.Logger),
+    optional(LOGGER_TOKEN),
   ),
   {
     // `scoped` and `singleton` scopes can have `onRemoved` callback.
@@ -139,13 +124,13 @@ container.bindFactory(
 );
 
 // Get a value from the container, it returns `undefined` in case a value is not found.
-const logger = container.get(TOKENS.Logger);
+const logger = container.get(LOGGER_TOKEN);
 
 // Resolve a value, it throws `ResolverError` in case a value is not found.
-const userService = container.resolve(TOKENS.userService);
+const userService = container.resolve(userService);
 
 // Remove a value from the container.
-container.remove(TOKENS.Logger);
+container.remove(LOGGER_TOKEN);
 
 // Clean up the container.
 container.removeAll();
@@ -153,86 +138,96 @@ container.removeAll();
 
 ## Container Hierarchy
 
-Ditox.js supports "parent-child" hierarchy. If the child container cannot to resolve a token, it asks the parent container to resolve it:
+Ditox.js supports "parent-child" hierarchy. If the child container cannot to
+resolve a token, it asks the parent container to resolve it:
 
 ```js
 import {creatContainer, token} from 'ditox';
 
-const V1 = token();
-const V2 = token();
+const V1_TOKEN = token();
+const V2_TOKEN = token();
 
 const parent = createContainer();
-parent.bindValue(V1, 10);
-parent.bindValue(V2, 20);
+parent.bindValue(V1_TOKEN, 10);
+parent.bindValue(V2_TOKEN, 20);
 
 const container = createContainer(parent);
-container.bindValue(V2, 21);
+container.bindValue(V2_TOKEN, 21);
 
-container.resolve(V1); // 10
-container.resolve(V2); // 21
+container.resolve(V1_TOKEN); // 10
+container.resolve(V2_TOKEN); // 21
 ```
 
 ## Factory Lifetimes
 
-Ditox.js supports managing the lifetime of values which are produced by factories.
-There are the following types:
+Ditox.js supports managing the lifetime of values which are produced by
+factories. There are the following types:
 
-- `singleton` - **This is the default**. The value is created and cached by the container which registered the factory.
-- `scoped` - The value is created and cached by the container which starts resolving.
+- `singleton` - **This is the default**. The value is created and cached by the
+  container which registered the factory.
+- `scoped` - The value is created and cached by the container which starts
+  resolving.
 - `transient` - The value is created every time it is resolved.
 
 ### `singleton`
 
-**This is the default scope**. "Singleton" allows to cache a produced value by a parent container which registered the factory:
+**This is the default scope**. "Singleton" allows to cache a produced value by a
+parent container which registered the factory:
 
 ```js
 import {creatContainer, token} from 'ditox';
 
-const TAG = token();
-const LOGGER = token();
+const TAG_TOKEN = token();
+const LOGGER_TOKEN = token();
 
 const createLogger = (tag) => (message) => console.log(`[${tag}] ${message}`);
 
 const parent = createContainer();
-parent.bindValue(TAG, 'parent');
-parent.bindFactory(LOGGER, injectable(createLogger, TAG), {scope: 'singleton'});
+parent.bindValue(TAG_TOKEN, 'parent');
+parent.bindFactory(LOGGER_TOKEN, injectable(createLogger, TAG_TOKEN), {
+  scope: 'singleton',
+});
 
 const container1 = createContainer(parent);
-container1.bindValue(TAG, 'container1');
+container1.bindValue(TAG_TOKEN, 'container1');
 
 const container2 = createContainer(parent);
-container2.bindValue(TAG, 'container2');
+container2.bindValue(TAG_TOKEN, 'container2');
 
-parent.resolve(LOGGER)('xyz'); // [parent] xyz
-container1.resolve(LOGGER)('foo'); // [parent] foo
-container2.resolve(LOGGER)('bar'); // [parent] bar
+parent.resolve(LOGGER_TOKEN)('xyz'); // [parent] xyz
+container1.resolve(LOGGER_TOKEN)('foo'); // [parent] foo
+container2.resolve(LOGGER_TOKEN)('bar'); // [parent] bar
 ```
 
 ### `scoped`
 
-"Scoped" lifetime allows to have sub-containers with own instances of some services which can be disposed. For example, a context during HTTP request handling, or other unit of work:
+"Scoped" lifetime allows to have sub-containers with own instances of some
+services which can be disposed. For example, a context during HTTP request
+handling, or other unit of work:
 
 ```js
 import {creatContainer, token} from 'ditox';
 
-const TAG = token();
-const LOGGER = token();
+const TAG_TOKEN = token();
+const LOGGER_TOKEN = token();
 
 const createLogger = (tag) => (message) => console.log(`[${tag}] ${message}`);
 
 const parent = createContainer();
 // `scoped` is default scope and can be omitted.
-parent.bindFactory(LOGGER, injectable(createLogger, TAG), {scope: 'scoped'});
+parent.bindFactory(LOGGER_TOKEN, injectable(createLogger, TAG_TOKEN), {
+  scope: 'scoped',
+});
 
 const container1 = createContainer(parent);
-container1.bindValue(TAG, 'container1');
+container1.bindValue(TAG_TOKEN, 'container1');
 
 const container2 = createContainer(parent);
-container2.bindValue(TAG, 'container2');
+container2.bindValue(TAG_TOKEN, 'container2');
 
-parent.resolve(LOGGER)('xyz'); // throws ResolverError, the parent does not have TAG value.
-container1.resolve(LOGGER)('foo'); // [container1] foo
-container2.resolve(LOGGER)('bar'); // [container2] bar
+parent.resolve(LOGGER_TOKEN)('xyz'); // throws ResolverError, the parent does not have TAG value.
+container1.resolve(LOGGER_TOKEN)('foo'); // [container1] foo
+container2.resolve(LOGGER_TOKEN)('bar'); // [container2] bar
 
 // Dispose a container.
 container1.removeAll();
@@ -243,43 +238,54 @@ container1.removeAll();
 "Transient" makes to a produce values by the factory for each resolving:
 
 ```js
-import {creatContainer, token} from 'ditox';
+import {createContainer, token} from 'ditox';
 
-const TAG = token();
-const LOGGER = token();
+const TAG_TOKEN = token();
+const LOGGER_TOKEN = token();
 
 const createLogger = (tag) => (message) => console.log(`[${tag}] ${message}`);
 
 const parent = createContainer();
-parent.bindValue(TAG, 'parent');
-parent.bindFactory(LOGGER, injectable(createLogger, TAG), {scope: 'singleton'});
+parent.bindValue(TAG_TOKEN, 'parent');
+parent.bindFactory(LOGGER_TOKEN, injectable(createLogger, TAG_TOKEN), {
+  scope: 'transient',
+});
 
 const container1 = createContainer(parent);
-container1.bindValue(TAG, 'container1');
+container1.bindValue(TAG_TOKEN, 'container1');
 
 const container2 = createContainer(parent);
-container2.bindValue(TAG, 'container2');
+container2.bindValue(TAG_TOKEN, 'container2');
 
-parent.resolve(LOGGER)('xyz'); // [parent] xyz
-container1.resolve(LOGGER)('foo'); // [container1] foo
-container2.resolve(LOGGER)('bar'); // [container2] bar
+parent.resolve(LOGGER_TOKEN)('xyz'); // [parent] xyz
+container1.resolve(LOGGER_TOKEN)('foo'); // [container1] foo
+container2.resolve(LOGGER_TOKEN)('bar'); // [container2] bar
 
-parent.bindValue(TAG, 'parent-rebind');
-parent.resolve(LOGGER)('xyz'); // [parent-rebind] xyz
+parent.bindValue(TAG_TOKEN, 'parent-rebind');
+parent.resolve(LOGGER_TOKEN)('xyz'); // [parent-rebind] xyz
 ```
 
-## Dependency modules
+## Dependency Modules
 
-Dependencies can be organized as modules in declarative way with `ModuleDeclaration`.
-It is useful for providing pieces of functionality from libraries to an app which depends on them.
+Dependencies can be organized as modules in declarative way with
+`ModuleDeclaration`. It is useful for providing pieces of functionality from
+libraries to an app which depends on them.
+
+```typescript
+import {Module, ModuleDeclaration, token} from 'ditox';
+import {TRANSPORT_TOKEN} from './transport';
+
+export type Logger = {log: (message: string) => void};
+export const LOGGER_TOKEN = token<Logger>();
 
-```ts
 type LoggerModule = Module<{logger: Logger}>;
 
-const LOGGER_MODULE_TOKEN = token<LoggerModule>;
+const LOGGER_MODULE_TOKEN = token<LoggerModule>();
 
 const LOGGER_MODULE: ModuleDeclaration<LoggerModule> = {
+  // An optional explicit token for a module itself
   token: LOGGER_MODULE_TOKEN,
+
   factory: (container) => {
     const transport = container.resolve(TRANSPORT_TOKEN).open();
     return {
@@ -295,7 +301,7 @@ const LOGGER_MODULE: ModuleDeclaration<LoggerModule> = {
 
 Later such module declarations can be bound to a container:
 
-```ts
+```typescript
 const container = createContainer();
 
 // bind a single module
@@ -305,13 +311,16 @@ bindModule(container, LOGGER_MODULE);
 bindModules(container, [DATABASE_MODULE, CONFIG_MODULE, API_MODULE]);
 ```
 
-There are utility functions for module declarations:
-- `declareModule()` – declare a module as `ModuleDeclaration` however `token` field can be optional for anonymous modules.
-- `declareModuleBindings()` – declares an anonymous module with imports. This module binds the provided ones to a container.
+Utility functions for module declarations:
+
+- `declareModule()` – declare a module as `ModuleDeclaration` however `token`
+  field can be optional for anonymous modules.
+- `declareModuleBindings()` – declares an anonymous module with imports. This
+  module binds the provided ones to a container.
 
 Example for these functions:
 
-```ts
+```typescript
 const LOGGER_MODULE = declareModule<LoggerModule>({
   factory: createLoggerModule,
   exports: {
@@ -322,11 +331,7 @@ const LOGGER_MODULE = declareModule<LoggerModule>({
 const APP_MODULE = declareModuleBinding([LOGGER_MODULE, DATABASE_MODULE]);
 ```
 
-## API References
-
-- [`ditox`](./docs)
-- [`ditox-react`](https://github.com/mnasyrov/ditox/tree/master/packages/ditox-react#readme)
-
 ---
 
-&copy; 2020-2021 [Mikhail Nasyrov](https://github.com/mnasyrov), [MIT license](./LICENSE)
+This project is licensed under the
+[MIT license](https://github.com/mnasyrov/ditox/blob/master/LICENSE).

package/dist/browser/index.js

@@ -1,2 +1,2 @@
-var o=function(n,t){return o=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(o,n){o.__proto__=n}||function(o,n){for(var t in n)Object.prototype.hasOwnProperty.call(n,t)&&(o[t]=n[t])},o(n,t)};var n=function(){return n=Object.assign||function(o){for(var n,t=1,r=arguments.length;t<r;t++)for(var e in n=arguments[t])Object.prototype.hasOwnProperty.call(n,e)&&(o[e]=n[e]);return o},n.apply(this,arguments)};function t(o,n,t){if(t||2===arguments.length)for(var r,e=0,i=n.length;e<i;e++)!r&&e in n||(r||(r=Array.prototype.slice.call(n,0,e)),r[e]=n[e]);return o.concat(r||Array.prototype.slice.call(n))}function r(o){return{symbol:Symbol(o)}}function e(o,n){return{symbol:o.symbol,isOptional:!0,optionalValue:n}}var i=function(n){function t(o){var t=this.constructor,r=n.call(this,o)||this;return Object.setPrototypeOf(r,t.prototype),r.name="ResolverError",r}return function(n,t){if("function"!=typeof t&&null!==t)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");function r(){this.constructor=n}o(n,t),n.prototype=null===t?Object.create(t):(r.prototype=t.prototype,new r)}(t,n),t}(Error),u=r("ditox.Container"),l=r("ditox.ParentContainer"),c=r("ditox.Resolver"),a=Symbol(),s=function(){throw new Error("FAKE_FACTORY")},f=r("ditox.FactoriesMap");function y(o){return o.symbol===u.symbol||o.symbol===l.symbol||o.symbol===c.symbol}function p(o){var n=new Map,t=new Map,r={bindValue:function(o,t){y(o)||n.set(o.symbol,t)},bindFactory:function(o,n,r){y(o)||t.set(o.symbol,{factory:n,options:r})},remove:function(o){var r;if(!y(o)){var e=null===(r=t.get(o.symbol))||void 0===r?void 0:r.options;e&&p(o.symbol,e),n.delete(o.symbol),t.delete(o.symbol)}},removeAll:function(){t.forEach((function(o,n){o.options&&p(n,o.options)})),n.clear(),t.clear(),v()},hasToken:function(r){var e;return n.has(r.symbol)||t.has(r.symbol)||null!==(e=null==o?void 0:o.hasToken(r))&&void 0!==e&&e},get:function(o){var n=e(o,r);return n!==a?n:o.isOptional?o.optionalValue:void 0},resolve:function(o){var n,t=e(o,r);if(t!==a)return t;if(o.isOptional)return o.optionalValue;throw new i('Token "'.concat(null!==(n=o.symbol.description)&&void 0!==n?n:"",'" is not provided'))}};function e(e,i){var u=n.get(e.symbol),l=void 0!==u||n.has(e.symbol);if(l&&i===r)return u;var f,y,p=t.get(e.symbol);if(p&&p.factory!==s)switch(f=p.options,null!==(y=null==f?void 0:f.scope)&&void 0!==y?y:"singleton"){case"singleton":if(l)return u;if(null==o?void 0:o.hasToken(e))break;var v=p.factory(r);return r.bindValue(e,v),v;case"scoped":var b=p.factory(i);return i.bindValue(e,b),i!==r&&i.bindFactory(e,s,p.options),b;case"transient":return p.factory(i)}if(l)return u;var d=null==o?void 0:o.get(c);return d?d(e,i):a}function p(o,t){var r=function(o){return void 0===o.scope||"scoped"===o.scope||"singleton"===o.scope?o.onRemoved:void 0}(t);if(r){var e=n.get(o);(void 0!==e||n.has(o))&&r(e)}}function v(){n.set(u.symbol,r),n.set(c.symbol,e),n.set(f.symbol,t),o&&n.set(l.symbol,o)}return v(),r}function v(o){return null!=o&&"object"==typeof o&&"symbol"in o&&"symbol"==typeof o.symbol}function b(o,n,r){var e,i=t(t([],null!==(e=o.get(n))&&void 0!==e?e:[],!0),[r],!1);o.bindValue(n,i)}function d(o,n){if(v(n))return o.get(n);var t={};return Object.keys(n).forEach((function(r){return t[r]=o.get(n[r])})),t}function m(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return n.map((function(n){return d(o,n)}))}function h(o,n){if(v(n))return o.resolve(n);var t={};return Object.keys(n).forEach((function(r){return t[r]=o.resolve(n[r])})),t}function g(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return n.map((function(n){return h(o,n)}))}function O(o){for(var n=this,r=[],e=1;e<arguments.length;e++)r[e-1]=arguments[e];return function(e){var i=g.apply(void 0,t([e],r,!1));return o.apply(n,i)}}function w(o){for(var n=[],r=1;r<arguments.length;r++)n[r-1]=arguments[r];return O.apply(void 0,t([function(){for(var n=[],r=0;r<arguments.length;r++)n[r]=arguments[r];return new(o.bind.apply(o,t([void 0],n,!1)))}],n,!1))}function k(o,n,t){var r=n.token,e=n.imports,i=n.factory,u=n.beforeBinding,l=n.afterBinding,c=n.exports,a=null==t?void 0:t.scope;u&&u(o),e&&E(o,e);var s=new Set;c&&Object.keys(c).forEach((function(n){var t=c[n];t&&(s.add(t),o.bindFactory(t,O((function(o){return o[n]}),r),{scope:a}))}));o.bindFactory(r,i,{scope:a,onRemoved:function(n){n.destroy&&n.destroy(),s.forEach((function(n){return o.remove(n)})),s.clear()}}),l&&l(o)}function E(o,n){n.forEach((function(n){"module"in n?k(o,n.module,n.options):k(o,n)}))}function j(o){var t;return n(n({},o),{token:null!==(t=o.token)&&void 0!==t?t:r()})}function _(o){return j({factory:function(){return{}},imports:o})}export{i as ResolverError,k as bindModule,E as bindModules,b as bindMultiValue,p as createContainer,j as declareModule,_ as declareModuleBindings,O as injectable,w as injectableClass,v as isToken,e as optional,h as resolveValue,g as resolveValues,r as token,d as tryResolveValue,m as tryResolveValues};
+var o=function(n,t){return o=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(o,n){o.__proto__=n}||function(o,n){for(var t in n)Object.prototype.hasOwnProperty.call(n,t)&&(o[t]=n[t])},o(n,t)};var n=function(){return n=Object.assign||function(o){for(var n,t=1,r=arguments.length;t<r;t++)for(var e in n=arguments[t])Object.prototype.hasOwnProperty.call(n,e)&&(o[e]=n[e]);return o},n.apply(this,arguments)};function t(o,n,t){if(t||2===arguments.length)for(var r,e=0,i=n.length;e<i;e++)!r&&e in n||(r||(r=Array.prototype.slice.call(n,0,e)),r[e]=n[e]);return o.concat(r||Array.prototype.slice.call(n))}function r(o){return{symbol:Symbol(o)}}function e(o,n){return{symbol:o.symbol,isOptional:!0,optionalValue:n}}var i=function(n){function t(o){var t=this.constructor,r=n.call(this,o)||this;return Object.setPrototypeOf(r,t.prototype),r.name="ResolverError",r}return function(n,t){if("function"!=typeof t&&null!==t)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");function r(){this.constructor=n}o(n,t),n.prototype=null===t?Object.create(t):(r.prototype=t.prototype,new r)}(t,n),t}(Error),u=r("ditox.Container"),l=r("ditox.ParentContainer"),c=r("ditox.Resolver"),a=Symbol(),s=function(){throw new Error("FAKE_FACTORY")},f="singleton",y=r("ditox.FactoriesMap");function p(o){return o.symbol===u.symbol||o.symbol===l.symbol||o.symbol===c.symbol}function v(o){var n=new Map,t=new Map,r={bindValue:function(o,t){p(o)||n.set(o.symbol,t)},bindFactory:function(o,n,r){p(o)||t.set(o.symbol,{factory:n,options:r})},remove:function(o){var r;if(!p(o)){var e=null===(r=t.get(o.symbol))||void 0===r?void 0:r.options;e&&v(o.symbol,e),n.delete(o.symbol),t.delete(o.symbol)}},removeAll:function(){t.forEach((function(o,n){o.options&&v(n,o.options)})),n.clear(),t.clear(),b()},hasToken:function(r){var e;return n.has(r.symbol)||t.has(r.symbol)||null!==(e=null==o?void 0:o.hasToken(r))&&void 0!==e&&e},get:function(o){var n=e(o,r);return n!==a?n:o.isOptional?o.optionalValue:void 0},resolve:function(o){var n,t=e(o,r);if(t!==a)return t;if(o.isOptional)return o.optionalValue;throw new i('Token "'.concat(null!==(n=o.symbol.description)&&void 0!==n?n:"",'" is not provided'))}};function e(e,i){var u=n.get(e.symbol),l=void 0!==u||n.has(e.symbol);if(l&&i===r)return u;var y,p,v=t.get(e.symbol);if(v&&v.factory!==s)switch(y=v.options,null!==(p=null==y?void 0:y.scope)&&void 0!==p?p:f){case"singleton":if(l)return u;if(null==o?void 0:o.hasToken(e))break;var b=v.factory(r);return r.bindValue(e,b),b;case"scoped":var d=v.factory(i);return i.bindValue(e,d),i!==r&&i.bindFactory(e,s,v.options),d;case"transient":return v.factory(i)}if(l)return u;var m=null==o?void 0:o.get(c);return m?m(e,i):a}function v(o,t){var r=function(o){return void 0===o.scope||"scoped"===o.scope||"singleton"===o.scope?o.onRemoved:void 0}(t);if(r){var e=n.get(o);(void 0!==e||n.has(o))&&r(e)}}function b(){n.set(u.symbol,r),n.set(c.symbol,e),n.set(y.symbol,t),o&&n.set(l.symbol,o)}return b(),r}function b(o){return null!=o&&"object"==typeof o&&"symbol"in o&&"symbol"==typeof o.symbol}function d(o,n,r){var e,i=t(t([],null!==(e=o.get(n))&&void 0!==e?e:[],!0),[r],!1);o.bindValue(n,i)}function m(o,n){if(b(n))return o.get(n);var t={};return Object.keys(n).forEach((function(r){return t[r]=o.get(n[r])})),t}function h(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return n.map((function(n){return m(o,n)}))}function g(o,n){if(b(n))return o.resolve(n);var t={};return Object.keys(n).forEach((function(r){return t[r]=o.resolve(n[r])})),t}function O(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return n.map((function(n){return g(o,n)}))}function w(o){for(var n=this,r=[],e=1;e<arguments.length;e++)r[e-1]=arguments[e];return function(e){var i=O.apply(void 0,t([e],r,!1));return o.apply(n,i)}}function k(o){for(var n=[],r=1;r<arguments.length;r++)n[r-1]=arguments[r];return w.apply(void 0,t([function(){for(var n=[],r=0;r<arguments.length;r++)n[r]=arguments[r];return new(o.bind.apply(o,t([void 0],n,!1)))}],n,!1))}function E(o,n,t){var r=n.token,e=n.imports,i=n.factory,u=n.beforeBinding,l=n.afterBinding,c=n.exports,a=null==t?void 0:t.scope;u&&u(o),e&&j(o,e);var s=new Set;c&&Object.keys(c).forEach((function(n){var t=c[n];t&&(s.add(t),o.bindFactory(t,w((function(o){return o[n]}),r),{scope:a}))}));o.bindFactory(r,i,{scope:a,onRemoved:function(n){n.destroy&&n.destroy(),s.forEach((function(n){return o.remove(n)})),s.clear()}}),l&&l(o)}function j(o,n){n.forEach((function(n){"module"in n?E(o,n.module,n.options):E(o,n)}))}function _(o){var t;return n(n({},o),{token:null!==(t=o.token)&&void 0!==t?t:r()})}function x(o){return _({factory:function(){return{}},imports:o})}export{i as ResolverError,E as bindModule,j as bindModules,d as bindMultiValue,v as createContainer,_ as declareModule,x as declareModuleBindings,w as injectable,k as injectableClass,b as isToken,e as optional,g as resolveValue,O as resolveValues,r as token,m as tryResolveValue,h as tryResolveValues};
 //# sourceMappingURL=index.js.map

package/dist/umd/index.js

@@ -1,2 +1,2 @@
-!function(o,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((o="undefined"!=typeof globalThis?globalThis:o||self).Ditox={})}(this,(function(o){"use strict";var n=function(o,t){return n=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(o,n){o.__proto__=n}||function(o,n){for(var t in n)Object.prototype.hasOwnProperty.call(n,t)&&(o[t]=n[t])},n(o,t)};var t=function(){return t=Object.assign||function(o){for(var n,t=1,e=arguments.length;t<e;t++)for(var r in n=arguments[t])Object.prototype.hasOwnProperty.call(n,r)&&(o[r]=n[r]);return o},t.apply(this,arguments)};function e(o,n,t){if(t||2===arguments.length)for(var e,r=0,i=n.length;r<i;r++)!e&&r in n||(e||(e=Array.prototype.slice.call(n,0,r)),e[r]=n[r]);return o.concat(e||Array.prototype.slice.call(n))}function r(o){return{symbol:Symbol(o)}}var i=function(o){function t(n){var t=this.constructor,e=o.call(this,n)||this;return Object.setPrototypeOf(e,t.prototype),e.name="ResolverError",e}return function(o,t){if("function"!=typeof t&&null!==t)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");function e(){this.constructor=o}n(o,t),o.prototype=null===t?Object.create(t):(e.prototype=t.prototype,new e)}(t,o),t}(Error),l=r("ditox.Container"),u=r("ditox.ParentContainer"),a=r("ditox.Resolver"),s=Symbol(),c=function(){throw new Error("FAKE_FACTORY")},f=r("ditox.FactoriesMap");function p(o){return o.symbol===l.symbol||o.symbol===u.symbol||o.symbol===a.symbol}function y(o){return null!=o&&"object"==typeof o&&"symbol"in o&&"symbol"==typeof o.symbol}function v(o,n){if(y(n))return o.get(n);var t={};return Object.keys(n).forEach((function(e){return t[e]=o.get(n[e])})),t}function d(o,n){if(y(n))return o.resolve(n);var t={};return Object.keys(n).forEach((function(e){return t[e]=o.resolve(n[e])})),t}function b(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return n.map((function(n){return d(o,n)}))}function m(o){for(var n=this,t=[],r=1;r<arguments.length;r++)t[r-1]=arguments[r];return function(r){var i=b.apply(void 0,e([r],t,!1));return o.apply(n,i)}}function h(o,n,t){var e=n.token,r=n.imports,i=n.factory,l=n.beforeBinding,u=n.afterBinding,a=n.exports,s=null==t?void 0:t.scope;l&&l(o),r&&g(o,r);var c=new Set;a&&Object.keys(a).forEach((function(n){var t=a[n];t&&(c.add(t),o.bindFactory(t,m((function(o){return o[n]}),e),{scope:s}))}));o.bindFactory(e,i,{scope:s,onRemoved:function(n){n.destroy&&n.destroy(),c.forEach((function(n){return o.remove(n)})),c.clear()}}),u&&u(o)}function g(o,n){n.forEach((function(n){"module"in n?h(o,n.module,n.options):h(o,n)}))}function O(o){var n;return t(t({},o),{token:null!==(n=o.token)&&void 0!==n?n:r()})}o.ResolverError=i,o.bindModule=h,o.bindModules=g,o.bindMultiValue=function(o,n,t){var r,i=e(e([],null!==(r=o.get(n))&&void 0!==r?r:[],!0),[t],!1);o.bindValue(n,i)},o.createContainer=function(o){var n=new Map,t=new Map,e={bindValue:function(o,t){p(o)||n.set(o.symbol,t)},bindFactory:function(o,n,e){p(o)||t.set(o.symbol,{factory:n,options:e})},remove:function(o){var e;if(!p(o)){var r=null===(e=t.get(o.symbol))||void 0===e?void 0:e.options;r&&y(o.symbol,r),n.delete(o.symbol),t.delete(o.symbol)}},removeAll:function(){t.forEach((function(o,n){o.options&&y(n,o.options)})),n.clear(),t.clear(),v()},hasToken:function(e){var r;return n.has(e.symbol)||t.has(e.symbol)||null!==(r=null==o?void 0:o.hasToken(e))&&void 0!==r&&r},get:function(o){var n=r(o,e);return n!==s?n:o.isOptional?o.optionalValue:void 0},resolve:function(o){var n,t=r(o,e);if(t!==s)return t;if(o.isOptional)return o.optionalValue;throw new i('Token "'.concat(null!==(n=o.symbol.description)&&void 0!==n?n:"",'" is not provided'))}};function r(r,i){var l=n.get(r.symbol),u=void 0!==l||n.has(r.symbol);if(u&&i===e)return l;var f,p,y=t.get(r.symbol);if(y&&y.factory!==c)switch(f=y.options,null!==(p=null==f?void 0:f.scope)&&void 0!==p?p:"singleton"){case"singleton":if(u)return l;if(null==o?void 0:o.hasToken(r))break;var v=y.factory(e);return e.bindValue(r,v),v;case"scoped":var d=y.factory(i);return i.bindValue(r,d),i!==e&&i.bindFactory(r,c,y.options),d;case"transient":return y.factory(i)}if(u)return l;var b=null==o?void 0:o.get(a);return b?b(r,i):s}function y(o,t){var e=function(o){return void 0===o.scope||"scoped"===o.scope||"singleton"===o.scope?o.onRemoved:void 0}(t);if(e){var r=n.get(o);(void 0!==r||n.has(o))&&e(r)}}function v(){n.set(l.symbol,e),n.set(a.symbol,r),n.set(f.symbol,t),o&&n.set(u.symbol,o)}return v(),e},o.declareModule=O,o.declareModuleBindings=function(o){return O({factory:function(){return{}},imports:o})},o.injectable=m,o.injectableClass=function(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return m.apply(void 0,e([function(){for(var n=[],t=0;t<arguments.length;t++)n[t]=arguments[t];return new(o.bind.apply(o,e([void 0],n,!1)))}],n,!1))},o.isToken=y,o.optional=function(o,n){return{symbol:o.symbol,isOptional:!0,optionalValue:n}},o.resolveValue=d,o.resolveValues=b,o.token=r,o.tryResolveValue=v,o.tryResolveValues=function(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return n.map((function(n){return v(o,n)}))}}));
+!function(o,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((o="undefined"!=typeof globalThis?globalThis:o||self).Ditox={})}(this,(function(o){"use strict";var n=function(o,t){return n=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(o,n){o.__proto__=n}||function(o,n){for(var t in n)Object.prototype.hasOwnProperty.call(n,t)&&(o[t]=n[t])},n(o,t)};var t=function(){return t=Object.assign||function(o){for(var n,t=1,e=arguments.length;t<e;t++)for(var r in n=arguments[t])Object.prototype.hasOwnProperty.call(n,r)&&(o[r]=n[r]);return o},t.apply(this,arguments)};function e(o,n,t){if(t||2===arguments.length)for(var e,r=0,i=n.length;r<i;r++)!e&&r in n||(e||(e=Array.prototype.slice.call(n,0,r)),e[r]=n[r]);return o.concat(e||Array.prototype.slice.call(n))}function r(o){return{symbol:Symbol(o)}}var i=function(o){function t(n){var t=this.constructor,e=o.call(this,n)||this;return Object.setPrototypeOf(e,t.prototype),e.name="ResolverError",e}return function(o,t){if("function"!=typeof t&&null!==t)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");function e(){this.constructor=o}n(o,t),o.prototype=null===t?Object.create(t):(e.prototype=t.prototype,new e)}(t,o),t}(Error),l=r("ditox.Container"),u=r("ditox.ParentContainer"),a=r("ditox.Resolver"),s=Symbol(),c=function(){throw new Error("FAKE_FACTORY")},f="singleton",p=r("ditox.FactoriesMap");function y(o){return o.symbol===l.symbol||o.symbol===u.symbol||o.symbol===a.symbol}function v(o){return null!=o&&"object"==typeof o&&"symbol"in o&&"symbol"==typeof o.symbol}function d(o,n){if(v(n))return o.get(n);var t={};return Object.keys(n).forEach((function(e){return t[e]=o.get(n[e])})),t}function b(o,n){if(v(n))return o.resolve(n);var t={};return Object.keys(n).forEach((function(e){return t[e]=o.resolve(n[e])})),t}function m(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return n.map((function(n){return b(o,n)}))}function h(o){for(var n=this,t=[],r=1;r<arguments.length;r++)t[r-1]=arguments[r];return function(r){var i=m.apply(void 0,e([r],t,!1));return o.apply(n,i)}}function g(o,n,t){var e=n.token,r=n.imports,i=n.factory,l=n.beforeBinding,u=n.afterBinding,a=n.exports,s=null==t?void 0:t.scope;l&&l(o),r&&O(o,r);var c=new Set;a&&Object.keys(a).forEach((function(n){var t=a[n];t&&(c.add(t),o.bindFactory(t,h((function(o){return o[n]}),e),{scope:s}))}));o.bindFactory(e,i,{scope:s,onRemoved:function(n){n.destroy&&n.destroy(),c.forEach((function(n){return o.remove(n)})),c.clear()}}),u&&u(o)}function O(o,n){n.forEach((function(n){"module"in n?g(o,n.module,n.options):g(o,n)}))}function w(o){var n;return t(t({},o),{token:null!==(n=o.token)&&void 0!==n?n:r()})}o.ResolverError=i,o.bindModule=g,o.bindModules=O,o.bindMultiValue=function(o,n,t){var r,i=e(e([],null!==(r=o.get(n))&&void 0!==r?r:[],!0),[t],!1);o.bindValue(n,i)},o.createContainer=function(o){var n=new Map,t=new Map,e={bindValue:function(o,t){y(o)||n.set(o.symbol,t)},bindFactory:function(o,n,e){y(o)||t.set(o.symbol,{factory:n,options:e})},remove:function(o){var e;if(!y(o)){var r=null===(e=t.get(o.symbol))||void 0===e?void 0:e.options;r&&v(o.symbol,r),n.delete(o.symbol),t.delete(o.symbol)}},removeAll:function(){t.forEach((function(o,n){o.options&&v(n,o.options)})),n.clear(),t.clear(),d()},hasToken:function(e){var r;return n.has(e.symbol)||t.has(e.symbol)||null!==(r=null==o?void 0:o.hasToken(e))&&void 0!==r&&r},get:function(o){var n=r(o,e);return n!==s?n:o.isOptional?o.optionalValue:void 0},resolve:function(o){var n,t=r(o,e);if(t!==s)return t;if(o.isOptional)return o.optionalValue;throw new i('Token "'.concat(null!==(n=o.symbol.description)&&void 0!==n?n:"",'" is not provided'))}};function r(r,i){var l=n.get(r.symbol),u=void 0!==l||n.has(r.symbol);if(u&&i===e)return l;var p,y,v=t.get(r.symbol);if(v&&v.factory!==c)switch(p=v.options,null!==(y=null==p?void 0:p.scope)&&void 0!==y?y:f){case"singleton":if(u)return l;if(null==o?void 0:o.hasToken(r))break;var d=v.factory(e);return e.bindValue(r,d),d;case"scoped":var b=v.factory(i);return i.bindValue(r,b),i!==e&&i.bindFactory(r,c,v.options),b;case"transient":return v.factory(i)}if(u)return l;var m=null==o?void 0:o.get(a);return m?m(r,i):s}function v(o,t){var e=function(o){return void 0===o.scope||"scoped"===o.scope||"singleton"===o.scope?o.onRemoved:void 0}(t);if(e){var r=n.get(o);(void 0!==r||n.has(o))&&e(r)}}function d(){n.set(l.symbol,e),n.set(a.symbol,r),n.set(p.symbol,t),o&&n.set(u.symbol,o)}return d(),e},o.declareModule=w,o.declareModuleBindings=function(o){return w({factory:function(){return{}},imports:o})},o.injectable=h,o.injectableClass=function(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return h.apply(void 0,e([function(){for(var n=[],t=0;t<arguments.length;t++)n[t]=arguments[t];return new(o.bind.apply(o,e([void 0],n,!1)))}],n,!1))},o.isToken=v,o.optional=function(o,n){return{symbol:o.symbol,isOptional:!0,optionalValue:n}},o.resolveValue=b,o.resolveValues=m,o.token=r,o.tryResolveValue=d,o.tryResolveValues=function(o){for(var n=[],t=1;t<arguments.length;t++)n[t-1]=arguments[t];return n.map((function(n){return d(o,n)}))}}));
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ditox",
-  "version": "2.3.0",
-  "description": "Powerful dependency injection container for building modular apps.",
+  "version": "2.3.1",
+  "description": "Dependency injection for modular web applications",
   "license": "MIT",
   "author": "Mikhail Nasyrov <mikhail@mnasyrov.com> (https://github.com/mnasyrov)",
   "homepage": "https://github.com/mnasyrov/ditox",
@@ -11,11 +11,15 @@
     "url": "https://github.com/mnasyrov/ditox.git"
   },
   "keywords": [
-    "detox",
-    "dependency-injection",
+    "dependency container",
+    "dependency injection",
+    "typescript",
+    "javascript",
+    "npm",
     "dependency",
     "injection",
     "container",
+    "module",
     "ioc",
     "di"
   ],
@@ -45,7 +49,8 @@
     "build": "npm run build:cjs && npm run build:esm && npm run build:rollup",
     "build:cjs": "tsc -p tsconfig.build.json --outDir dist/cjs --module commonjs",
     "build:esm": "tsc -p tsconfig.build.json --outDir dist/esm --module es2015",
-    "build:rollup": "rollup -c"
+    "build:rollup": "rollup -c",
+    "typedoc": "typedoc"
   },
-  "gitHead": "3d34ea7a89e0bb599fa2d9dbfa67e75ec68bfba2"
+  "gitHead": "1e10e32350931dba38acc4d00b2cc1cd6d5cffb5"
 }

package/docs/.nojekyll

@@ -1 +0,0 @@
-TypeDoc added this file to prevent GitHub Pages from using Jekyll. You can turn off this behavior by setting the `githubPages` option to false.