ts-ioc-container 47.3.1 → 47.4.0

package/README.md

@@ -39,7 +39,7 @@
     - [Proxy](#proxy)
 - [Provider](#provider) `provider`
     - [Singleton](#singleton) `singleton`
-    - [Arguments](#arguments) `args` `argsFn`
+    - [Arguments](#arguments) `setArgs` `setArgsFn`
     - [Visibility](#visibility) `visible`
     - [Alias](#alias) `asAlias`
     - [Decorator](#decorator) `decorate`
@@ -1592,8 +1592,8 @@ Provider is dependency factory which creates dependency.
 
 ```typescript
 import {
-  args,
-  argsFn,
+  setArgs,
+  setArgsFn,
   bindTo,
   Container,
   lazy,
@@ -1672,7 +1672,10 @@ describe('Provider', () => {
       constructor(readonly basePath: string) {}
     }
 
-    const container = new Container().register('FileService', Provider.fromClass(FileService).pipe(args('/var/data')));
+    const container = new Container().register(
+      'FileService',
+      Provider.fromClass(FileService).pipe(setArgs('/var/data')),
+    );
 
     const service = container.resolve<FileService>('FileService');
     expect(service.basePath).toBe('/var/data');
@@ -1687,7 +1690,7 @@ describe('Provider', () => {
       'Database',
       Provider.fromClass(Database).pipe(
         // Dynamically resolve connection string at creation time
-        argsFn((scope) => [`postgres://${scope.resolve('DbPath')}`]),
+        setArgsFn((scope) => [`postgres://${scope.resolve('DbPath')}`]),
       ),
     );
 
@@ -1825,15 +1828,20 @@ describe('Singleton', function () {
 
 ### Arguments
 Sometimes you want to bind some arguments to provider. This is what `ArgsProvider` is for.
-- `provider(args('someArgument'))`
-- `provider(argsFn((container) => [container.resolve(Logger), 'someValue']))`
-- `Provider.fromClass(Logger).pipe(args('someArgument'))`
+- `provider(setArgs('someArgument'))`
+- `provider(setArgsFn((container) => [container.resolve(Logger), 'someValue']))`
+- `Provider.fromClass(Logger).pipe(setArgs('someArgument'))`
 - NOTICE: args from this provider has higher priority than args from `resolve` method.
 
+### Positional arg injection with `args(index)`
+Use `@inject(args(index))` to explicitly bind a constructor parameter to a positional argument from `ProviderOptions`. This is useful when combining `setArgsFn(resolveByArgs)` with token-based arg passing.
+- `@inject(args(0))` — resolves the first element of the `args` array passed at resolution time
+- Works together with `token.args(...)` to pass typed dependencies through the args context
+
 ```typescript
 import {
-  args,
-  argsFn,
+  setArgs,
+  setArgsFn,
   bindTo,
   Container,
   inject,
@@ -1867,7 +1875,7 @@ describe('ArgsProvider', function () {
       }
 
       // Pre-configure the logger with a filename
-      const root = createContainer().addRegistration(R.fromClass(FileLogger).pipe(args('/var/log/app.log')));
+      const root = createContainer().addRegistration(R.fromClass(FileLogger).pipe(setArgs('/var/log/app.log')));
 
       // Resolve by class name (default key) to use the registered provider
       const logger = root.resolve<FileLogger>('FileLogger');
@@ -1880,7 +1888,7 @@ describe('ArgsProvider', function () {
       }
 
       // 'FixedContext' wins over any runtime args
-      const root = createContainer().addRegistration(R.fromClass(Logger).pipe(args('FixedContext')));
+      const root = createContainer().addRegistration(R.fromClass(Logger).pipe(setArgs('FixedContext')));
 
       // Even if we ask for 'RuntimeContext', we get 'FixedContext'
       // Resolve by class name to use the registered provider
@@ -1906,7 +1914,7 @@ describe('ArgsProvider', function () {
           R.fromClass(Service).pipe(
             // Extract 'env' from Config service dynamically
             // Note: We resolve 'Config' by string key to get the registered instance (if it were singleton)
-            argsFn((scope) => [scope.resolve<Config>('Config').env]),
+            setArgsFn((scope) => [scope.resolve<Config>('Config').env]),
           ),
         );
 
@@ -1943,7 +1951,7 @@ describe('ArgsProvider', function () {
 
     @register(
       bindTo(EntityManagerToken),
-      argsFn(resolveByArgs), // <--- Key magic: resolves dependencies based on arguments passed to token
+      setArgsFn(resolveByArgs), // <--- Key magic: resolves dependencies based on arguments passed to token
       singleton(MultiCache.fromFirstArg), // Cache unique instance per repository type
     )
     class EntityManager {

package/cjm/hooks/HookContext.js

@@ -14,7 +14,9 @@ class HookContext {
         this.instance = (0, proxy_1.isProxy)(instance) ? (0, proxy_1.getProxyTarget)(instance) : instance;
     }
     resolveArgs(...args) {
-        return (0, inject_1.resolveArgs)(this.instance.constructor, this.methodName)(this.scope, ...[...this.initialArgs, ...args]);
+        return (0, inject_1.resolveArgs)(this.instance.constructor, this.methodName)(this.scope, {
+            args: [...this.initialArgs, ...args],
+        });
     }
     invokeMethod({ args = this.resolveArgs() } = {}) {
         // @ts-ignore

package/cjm/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClassToken = exports.toSingleAlias = exports.SingleAliasToken = exports.toGroupAlias = exports.GroupAliasToken = exports.InjectionToken = exports.HooksRunner = exports.AddOnDisposeHookModule = exports.onDispose = exports.onDisposeHooksRunner = exports.AddOnConstructHookModule = exports.onConstruct = exports.onConstructHooksRunner = exports.injectProp = exports.createHookContext = exports.createHookContextFactory = exports.HookContext = exports.hasHooks = exports.hook = exports.getHooks = exports.UnexpectedHookResultError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.DependencyNotFoundError = exports.Registration = exports.bindTo = exports.register = exports.scope = exports.decorate = exports.MultiCache = exports.multiCache = exports.SingletonProvider = exports.singleton = exports.Provider = exports.resolveByArgs = exports.ProviderDecorator = exports.args = exports.argsFn = exports.lazy = exports.scopeAccess = exports.ProxyInjector = exports.SimpleInjector = exports.MetadataInjector = exports.Injector = exports.resolveArgs = exports.inject = exports.EmptyContainer = exports.Container = exports.isDependencyKey = void 0;
-exports.resolveConstructor = exports.Is = exports.pipe = exports.select = exports.getMethodTags = exports.methodTag = exports.getMethodLabels = exports.methodLabel = exports.getMethodMeta = exports.methodMeta = exports.getParamTags = exports.paramTag = exports.getParamLabels = exports.paramLabel = exports.getParamMeta = exports.paramMeta = exports.getClassTags = exports.classTag = exports.getClassLabels = exports.classLabel = exports.getClassMeta = exports.classMeta = exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.handleAsyncError = exports.handleError = exports.GroupInstanceToken = exports.ConstantToken = exports.FunctionToken = exports.SingleToken = void 0;
+exports.toSingleAlias = exports.SingleAliasToken = exports.toGroupAlias = exports.GroupAliasToken = exports.InjectionToken = exports.HooksRunner = exports.AddOnDisposeHookModule = exports.onDispose = exports.onDisposeHooksRunner = exports.AddOnConstructHookModule = exports.onConstruct = exports.onConstructHooksRunner = exports.injectProp = exports.createHookContext = exports.createHookContextFactory = exports.HookContext = exports.hasHooks = exports.hook = exports.getHooks = exports.UnexpectedHookResultError = exports.ContainerDisposedError = exports.MethodNotImplementedError = exports.DependencyMissingKeyError = exports.DependencyNotFoundError = exports.Registration = exports.bindTo = exports.register = exports.scope = exports.decorate = exports.MultiCache = exports.multiCache = exports.SingletonProvider = exports.singleton = exports.Provider = exports.resolveByArgs = exports.ProviderDecorator = exports.setArgs = exports.setArgsFn = exports.lazy = exports.scopeAccess = exports.ProxyInjector = exports.SimpleInjector = exports.MetadataInjector = exports.Injector = exports.args = exports.resolveArgs = exports.inject = exports.EmptyContainer = exports.Container = exports.isDependencyKey = void 0;
+exports.resolveConstructor = exports.Is = exports.pipe = exports.select = exports.once = exports.shallowCache = exports.debounce = exports.throttle = exports.handleAsyncError = exports.handleError = exports.getMethodTags = exports.methodTag = exports.getMethodLabels = exports.methodLabel = exports.getMethodMeta = exports.methodMeta = exports.getParamTags = exports.paramTag = exports.getParamLabels = exports.paramLabel = exports.getParamMeta = exports.paramMeta = exports.getClassTags = exports.classTag = exports.getClassLabels = exports.classLabel = exports.getClassMeta = exports.classMeta = exports.GroupInstanceToken = exports.ConstantToken = exports.FunctionToken = exports.SingleToken = exports.ClassToken = void 0;
 // Containers
 var IContainer_1 = require("./container/IContainer");
 Object.defineProperty(exports, "isDependencyKey", { enumerable: true, get: function () { return IContainer_1.isDependencyKey; } });
@@ -13,6 +13,7 @@ Object.defineProperty(exports, "EmptyContainer", { enumerable: true, get: functi
 var inject_1 = require("./injector/inject");
 Object.defineProperty(exports, "inject", { enumerable: true, get: function () { return inject_1.inject; } });
 Object.defineProperty(exports, "resolveArgs", { enumerable: true, get: function () { return inject_1.resolveArgs; } });
+Object.defineProperty(exports, "args", { enumerable: true, get: function () { return inject_1.args; } });
 var IInjector_1 = require("./injector/IInjector");
 Object.defineProperty(exports, "Injector", { enumerable: true, get: function () { return IInjector_1.Injector; } });
 var MetadataInjector_1 = require("./injector/MetadataInjector");
@@ -25,8 +26,8 @@ Object.defineProperty(exports, "ProxyInjector", { enumerable: true, get: functio
 var IProvider_1 = require("./provider/IProvider");
 Object.defineProperty(exports, "scopeAccess", { enumerable: true, get: function () { return IProvider_1.scopeAccess; } });
 Object.defineProperty(exports, "lazy", { enumerable: true, get: function () { return IProvider_1.lazy; } });
-Object.defineProperty(exports, "argsFn", { enumerable: true, get: function () { return IProvider_1.argsFn; } });
-Object.defineProperty(exports, "args", { enumerable: true, get: function () { return IProvider_1.args; } });
+Object.defineProperty(exports, "setArgsFn", { enumerable: true, get: function () { return IProvider_1.setArgsFn; } });
+Object.defineProperty(exports, "setArgs", { enumerable: true, get: function () { return IProvider_1.setArgs; } });
 Object.defineProperty(exports, "ProviderDecorator", { enumerable: true, get: function () { return IProvider_1.ProviderDecorator; } });
 Object.defineProperty(exports, "resolveByArgs", { enumerable: true, get: function () { return IProvider_1.resolveByArgs; } });
 var Provider_1 = require("./provider/Provider");
@@ -98,17 +99,6 @@ Object.defineProperty(exports, "ConstantToken", { enumerable: true, get: functio
 var GroupInstanceToken_1 = require("./token/GroupInstanceToken");
 Object.defineProperty(exports, "GroupInstanceToken", { enumerable: true, get: function () { return GroupInstanceToken_1.GroupInstanceToken; } });
 // Metadata
-var errorHandler_1 = require("./metadata/errorHandler");
-Object.defineProperty(exports, "handleError", { enumerable: true, get: function () { return errorHandler_1.handleError; } });
-Object.defineProperty(exports, "handleAsyncError", { enumerable: true, get: function () { return errorHandler_1.handleAsyncError; } });
-var throttle_1 = require("./metadata/throttle");
-Object.defineProperty(exports, "throttle", { enumerable: true, get: function () { return throttle_1.throttle; } });
-var debounce_1 = require("./metadata/debounce");
-Object.defineProperty(exports, "debounce", { enumerable: true, get: function () { return debounce_1.debounce; } });
-var shallowCache_1 = require("./metadata/shallowCache");
-Object.defineProperty(exports, "shallowCache", { enumerable: true, get: function () { return shallowCache_1.shallowCache; } });
-var once_1 = require("./metadata/once");
-Object.defineProperty(exports, "once", { enumerable: true, get: function () { return once_1.once; } });
 var class_1 = require("./metadata/class");
 Object.defineProperty(exports, "classMeta", { enumerable: true, get: function () { return class_1.classMeta; } });
 Object.defineProperty(exports, "getClassMeta", { enumerable: true, get: function () { return class_1.getClassMeta; } });
@@ -130,6 +120,17 @@ Object.defineProperty(exports, "methodLabel", { enumerable: true, get: function
 Object.defineProperty(exports, "getMethodLabels", { enumerable: true, get: function () { return method_1.getMethodLabels; } });
 Object.defineProperty(exports, "methodTag", { enumerable: true, get: function () { return method_1.methodTag; } });
 Object.defineProperty(exports, "getMethodTags", { enumerable: true, get: function () { return method_1.getMethodTags; } });
+var errorHandler_1 = require("./utils/errorHandler");
+Object.defineProperty(exports, "handleError", { enumerable: true, get: function () { return errorHandler_1.handleError; } });
+Object.defineProperty(exports, "handleAsyncError", { enumerable: true, get: function () { return errorHandler_1.handleAsyncError; } });
+var throttle_1 = require("./utils/throttle");
+Object.defineProperty(exports, "throttle", { enumerable: true, get: function () { return throttle_1.throttle; } });
+var debounce_1 = require("./utils/debounce");
+Object.defineProperty(exports, "debounce", { enumerable: true, get: function () { return debounce_1.debounce; } });
+var shallowCache_1 = require("./utils/shallowCache");
+Object.defineProperty(exports, "shallowCache", { enumerable: true, get: function () { return shallowCache_1.shallowCache; } });
+var once_1 = require("./utils/once");
+Object.defineProperty(exports, "once", { enumerable: true, get: function () { return once_1.once; } });
 // Utils
 var select_1 = require("./select");
 Object.defineProperty(exports, "select", { enumerable: true, get: function () { return select_1.select; } });

package/cjm/injector/MetadataInjector.js

@@ -5,7 +5,7 @@ const IInjector_1 = require("./IInjector");
 const inject_1 = require("./inject");
 class MetadataInjector extends IInjector_1.Injector {
     createInstance(scope, Target, { args: deps = [] } = {}) {
-        const args = (0, inject_1.resolveArgs)(Target)(scope, ...deps);
+        const args = (0, inject_1.resolveArgs)(Target)(scope, { args: deps });
         return new Target(...args);
     }
 }

package/cjm/injector/inject.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveArgs = exports.inject = void 0;
+exports.resolveArgs = exports.args = exports.inject = void 0;
 const ConstantToken_1 = require("../token/ConstantToken");
 const toToken_1 = require("../token/toToken");
 const array_1 = require("../utils/array");
@@ -11,12 +11,16 @@ const inject = (fn) => (target, propertyKey, parameterIndex) => {
     (0, parameter_1.paramMeta)(hookMetaKey(propertyKey), () => (0, toToken_1.toToken)(fn))(basic_1.Is.instance(target) ? target.constructor : target, propertyKey, parameterIndex);
 };
 exports.inject = inject;
+const args = (index) => (c, { args = [] }) => {
+    return args[index];
+};
+exports.args = args;
 const resolveArgs = (Target, methodName) => {
     const argsTokens = (0, parameter_1.getParamMeta)(hookMetaKey(methodName), Target);
-    return (scope, ...deps) => {
-        const depsTokens = deps.map((v) => new ConstantToken_1.ConstantToken(v));
+    return (scope, { args = [], lazy }) => {
+        const depsTokens = args.map((v) => new ConstantToken_1.ConstantToken(v));
         const allTokens = (0, array_1.fillEmptyIndexes)(argsTokens, depsTokens);
-        return allTokens.map((fn) => fn.resolve(scope));
+        return allTokens.map((fn) => fn.resolve(scope, { args, lazy }));
     };
 };
 exports.resolveArgs = resolveArgs;

package/cjm/provider/IProvider.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProviderDecorator = exports.lazy = exports.scopeAccess = exports.resolveByArgs = exports.argsFn = exports.args = void 0;
+exports.ProviderDecorator = exports.lazy = exports.scopeAccess = exports.resolveByArgs = exports.setArgsFn = exports.setArgs = void 0;
 const ProviderPipe_1 = require("./ProviderPipe");
 const InjectionToken_1 = require("../token/InjectionToken");
 const basic_1 = require("../utils/basic");
-const args = (...extraArgs) => (0, ProviderPipe_1.registerPipe)((p) => p.setArgs(() => extraArgs));
-exports.args = args;
-const argsFn = (fn) => (0, ProviderPipe_1.registerPipe)((p) => p.setArgs(fn));
-exports.argsFn = argsFn;
+const setArgs = (...extraArgs) => (0, ProviderPipe_1.registerPipe)((p) => p.setArgs(() => extraArgs));
+exports.setArgs = setArgs;
+const setArgsFn = (fn) => (0, ProviderPipe_1.registerPipe)((p) => p.setArgs(fn));
+exports.setArgsFn = setArgsFn;
 const resolveByArgs = (s, ...deps) => deps.map((d) => {
     if (d instanceof InjectionToken_1.InjectionToken) {
         return d.resolve(s);

package/cjm/token/FunctionToken.js

@@ -2,24 +2,31 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FunctionToken = void 0;
 const InjectionToken_1 = require("./InjectionToken");
-const MethodNotImplementedError_1 = require("../errors/MethodNotImplementedError");
 class FunctionToken extends InjectionToken_1.InjectionToken {
     fn;
+    getArgsFn = () => [];
+    isLazy = false;
     constructor(fn) {
         super();
         this.fn = fn;
     }
-    resolve(s) {
-        return this.fn(s);
+    resolve(s, { args = [], lazy = false } = {}) {
+        return this.fn(s, {
+            args: [...args, ...this.getArgsFn(s)],
+            lazy: this.isLazy || lazy,
+        });
     }
     args(...deps) {
-        throw new MethodNotImplementedError_1.MethodNotImplementedError('not implemented');
+        this.getArgsFn = () => deps;
+        return this;
     }
     argsFn(getArgsFn) {
-        throw new MethodNotImplementedError_1.MethodNotImplementedError('not implemented');
+        this.getArgsFn = getArgsFn;
+        return this;
     }
-    lazy() {
-        throw new MethodNotImplementedError_1.MethodNotImplementedError('not implemented');
+    lazy(isLazy = true) {
+        this.isLazy = isLazy;
+        return this;
     }
 }
 exports.FunctionToken = FunctionToken;

package/esm/hooks/HookContext.js

@@ -11,7 +11,9 @@ export class HookContext {
         this.instance = isProxy(instance) ? getProxyTarget(instance) : instance;
     }
     resolveArgs(...args) {
-        return resolveArgs(this.instance.constructor, this.methodName)(this.scope, ...[...this.initialArgs, ...args]);
+        return resolveArgs(this.instance.constructor, this.methodName)(this.scope, {
+            args: [...this.initialArgs, ...args],
+        });
     }
     invokeMethod({ args = this.resolveArgs() } = {}) {
         // @ts-ignore

package/esm/index.js

@@ -3,13 +3,13 @@ export { isDependencyKey, } from './container/IContainer';
 export { Container } from './container/Container';
 export { EmptyContainer } from './container/EmptyContainer';
 // Injectors
-export { inject, resolveArgs } from './injector/inject';
+export { inject, resolveArgs, args } from './injector/inject';
 export { Injector } from './injector/IInjector';
 export { MetadataInjector } from './injector/MetadataInjector';
 export { SimpleInjector } from './injector/SimpleInjector';
 export { ProxyInjector } from './injector/ProxyInjector';
 // Providers
-export { scopeAccess, lazy, argsFn, args, ProviderDecorator, resolveByArgs, } from './provider/IProvider';
+export { scopeAccess, lazy, setArgsFn, setArgs, ProviderDecorator, resolveByArgs, } from './provider/IProvider';
 export { Provider } from './provider/Provider';
 export { singleton, SingletonProvider } from './provider/SingletonProvider';
 export { multiCache, MultiCache } from './provider/Cache';
@@ -40,14 +40,14 @@ export { FunctionToken } from './token/FunctionToken';
 export { ConstantToken } from './token/ConstantToken';
 export { GroupInstanceToken } from './token/GroupInstanceToken';
 // Metadata
-export { handleError, handleAsyncError } from './metadata/errorHandler';
-export { throttle } from './metadata/throttle';
-export { debounce } from './metadata/debounce';
-export { shallowCache } from './metadata/shallowCache';
-export { once } from './metadata/once';
 export { classMeta, getClassMeta, classLabel, getClassLabels, classTag, getClassTags } from './metadata/class';
 export { paramMeta, getParamMeta, paramLabel, getParamLabels, paramTag, getParamTags } from './metadata/parameter';
 export { methodMeta, getMethodMeta, methodLabel, getMethodLabels, methodTag, getMethodTags } from './metadata/method';
+export { handleError, handleAsyncError } from './utils/errorHandler';
+export { throttle } from './utils/throttle';
+export { debounce } from './utils/debounce';
+export { shallowCache } from './utils/shallowCache';
+export { once } from './utils/once';
 // Utils
 export { select } from './select';
 export { pipe } from './utils/fp';

package/esm/injector/MetadataInjector.js

@@ -2,7 +2,7 @@ import { Injector } from './IInjector';
 import { resolveArgs } from './inject';
 export class MetadataInjector extends Injector {
     createInstance(scope, Target, { args: deps = [] } = {}) {
-        const args = resolveArgs(Target)(scope, ...deps);
+        const args = resolveArgs(Target)(scope, { args: deps });
         return new Target(...args);
     }
 }

package/esm/injector/inject.js

@@ -7,11 +7,14 @@ const hookMetaKey = (methodName = 'constructor') => `inject:${methodName}`;
 export const inject = (fn) => (target, propertyKey, parameterIndex) => {
     paramMeta(hookMetaKey(propertyKey), () => toToken(fn))(Is.instance(target) ? target.constructor : target, propertyKey, parameterIndex);
 };
+export const args = (index) => (c, { args = [] }) => {
+    return args[index];
+};
 export const resolveArgs = (Target, methodName) => {
     const argsTokens = getParamMeta(hookMetaKey(methodName), Target);
-    return (scope, ...deps) => {
-        const depsTokens = deps.map((v) => new ConstantToken(v));
+    return (scope, { args = [], lazy }) => {
+        const depsTokens = args.map((v) => new ConstantToken(v));
         const allTokens = fillEmptyIndexes(argsTokens, depsTokens);
-        return allTokens.map((fn) => fn.resolve(scope));
+        return allTokens.map((fn) => fn.resolve(scope, { args, lazy }));
     };
 };

package/esm/provider/IProvider.js

@@ -1,8 +1,8 @@
 import { isProviderPipe, registerPipe } from './ProviderPipe';
 import { InjectionToken } from '../token/InjectionToken';
 import { Is } from '../utils/basic';
-export const args = (...extraArgs) => registerPipe((p) => p.setArgs(() => extraArgs));
-export const argsFn = (fn) => registerPipe((p) => p.setArgs(fn));
+export const setArgs = (...extraArgs) => registerPipe((p) => p.setArgs(() => extraArgs));
+export const setArgsFn = (fn) => registerPipe((p) => p.setArgs(fn));
 export const resolveByArgs = (s, ...deps) => deps.map((d) => {
     if (d instanceof InjectionToken) {
         return d.resolve(s);

package/esm/token/FunctionToken.js

@@ -1,21 +1,28 @@
 import { InjectionToken } from './InjectionToken';
-import { MethodNotImplementedError } from '../errors/MethodNotImplementedError';
 export class FunctionToken extends InjectionToken {
     fn;
+    getArgsFn = () => [];
+    isLazy = false;
     constructor(fn) {
         super();
         this.fn = fn;
     }
-    resolve(s) {
-        return this.fn(s);
+    resolve(s, { args = [], lazy = false } = {}) {
+        return this.fn(s, {
+            args: [...args, ...this.getArgsFn(s)],
+            lazy: this.isLazy || lazy,
+        });
     }
     args(...deps) {
-        throw new MethodNotImplementedError('not implemented');
+        this.getArgsFn = () => deps;
+        return this;
     }
     argsFn(getArgsFn) {
-        throw new MethodNotImplementedError('not implemented');
+        this.getArgsFn = getArgsFn;
+        return this;
     }
-    lazy() {
-        throw new MethodNotImplementedError('not implemented');
+    lazy(isLazy = true) {
+        this.isLazy = isLazy;
+        return this;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-ioc-container",
-  "version": "47.3.1",
+  "version": "47.4.0",
   "description": "Typescript IoC container",
   "workspaces": [
     "docs"
@@ -73,7 +73,7 @@
     "@semantic-release/npm": "^13.1.2",
     "@swc/core": "^1.15.24",
     "@types/node": "^25.5.2",
-    "@typescript-eslint/eslint-plugin": "8.29.1",
+    "@typescript-eslint/eslint-plugin": "8.32.1",
     "@typescript-eslint/parser": "8.29.1",
     "@vitest/coverage-v8": "^4.1.2",
     "cz-conventional-changelog": "^3.3.0",
@@ -82,12 +82,12 @@
     "eslint-plugin-prettier": "5.2.6",
     "handlebars": "^4.7.8",
     "husky": "^9.1.7",
-    "lint-staged": "^15.5.0",
+    "lint-staged": "^16.4.0",
     "moq.ts": "^10.0.8",
     "prettier": "3.5.3",
     "prettier-plugin-astro": "^0.14.1",
     "reflect-metadata": "^0.2.2",
-    "rimraf": "6.0.1",
+    "rimraf": "6.1.3",
     "semantic-release": "^25.0.2",
     "tsx": "^4.21.0",
     "typescript": "5.8.3",

package/typings/hooks/hook.d.ts

@@ -1,7 +1,8 @@
 import { type IHookContext } from './HookContext';
 import type { IContainer } from '../container/IContainer';
 import { type constructor } from '../utils/basic';
-export type InjectFn<T = unknown> = (s: IContainer) => T;
+import { ProviderOptions } from '../provider/IProvider';
+export type InjectFn<T = unknown> = (s: IContainer, context: ProviderOptions) => T;
 export type HookFn<T extends IHookContext = IHookContext> = (context: T) => void | Promise<void>;
 export interface HookClass<T extends IHookContext = IHookContext> {
     execute(context: Omit<T, 'scope'>): void | Promise<void>;

package/typings/index.d.ts

@@ -1,12 +1,12 @@
 export { type IContainer, type Resolvable, type IContainerModule, type DependencyKey, type Tag, type Tagged, type ResolveOneOptions, type ResolveManyOptions, isDependencyKey, } from './container/IContainer';
 export { Container } from './container/Container';
 export { EmptyContainer } from './container/EmptyContainer';
-export { inject, resolveArgs } from './injector/inject';
+export { inject, resolveArgs, args } from './injector/inject';
 export { type IInjector, type InjectOptions, type IInjectFnResolver, Injector } from './injector/IInjector';
 export { MetadataInjector } from './injector/MetadataInjector';
 export { SimpleInjector } from './injector/SimpleInjector';
 export { ProxyInjector } from './injector/ProxyInjector';
-export { type ResolveDependency, type IProvider, scopeAccess, lazy, argsFn, args, type ArgsFn, ProviderDecorator, resolveByArgs, type IMapper, type ProviderOptions, } from './provider/IProvider';
+export { type ResolveDependency, type IProvider, scopeAccess, lazy, setArgsFn, setArgs, type ArgsFn, ProviderDecorator, resolveByArgs, type IMapper, type ProviderOptions, } from './provider/IProvider';
 export { Provider } from './provider/Provider';
 export { singleton, SingletonProvider } from './provider/SingletonProvider';
 export { type Cache, multiCache, MultiCache } from './provider/Cache';
@@ -33,14 +33,14 @@ export { SingleToken } from './token/SingleToken';
 export { FunctionToken } from './token/FunctionToken';
 export { ConstantToken } from './token/ConstantToken';
 export { type InstancePredicate, GroupInstanceToken } from './token/GroupInstanceToken';
-export { handleError, handleAsyncError, type HandleErrorParams } from './metadata/errorHandler';
-export { throttle } from './metadata/throttle';
-export { debounce } from './metadata/debounce';
-export { shallowCache } from './metadata/shallowCache';
-export { once } from './metadata/once';
 export { classMeta, getClassMeta, classLabel, getClassLabels, classTag, getClassTags } from './metadata/class';
 export { paramMeta, getParamMeta, paramLabel, getParamLabels, paramTag, getParamTags } from './metadata/parameter';
 export { methodMeta, getMethodMeta, methodLabel, getMethodLabels, methodTag, getMethodTags } from './metadata/method';
+export { handleError, handleAsyncError, type HandleErrorParams } from './utils/errorHandler';
+export { throttle } from './utils/throttle';
+export { debounce } from './utils/debounce';
+export { shallowCache } from './utils/shallowCache';
+export { once } from './utils/once';
 export { select } from './select';
 export { pipe, type MapFn } from './utils/fp';
 export { type constructor, type Instance, Is, resolveConstructor } from './utils/basic';

package/typings/injector/inject.d.ts

@@ -2,5 +2,7 @@ import { type IContainer } from '../container/IContainer';
 import { InjectionToken } from '../token/InjectionToken';
 import { InjectFn } from '../hooks/hook';
 import { type constructor } from '../utils/basic';
+import { ProviderOptions } from '../provider/IProvider';
 export declare const inject: <T>(fn: InjectionToken<T> | InjectFn<T> | symbol | string | constructor<T>) => ParameterDecorator;
-export declare const resolveArgs: (Target: constructor<unknown>, methodName?: string) => (scope: IContainer, ...deps: unknown[]) => unknown[];
+export declare const args: (index: number) => (c: IContainer, { args }: ProviderOptions) => unknown;
+export declare const resolveArgs: (Target: constructor<unknown>, methodName?: string) => (scope: IContainer, { args, lazy }: ProviderOptions) => unknown[];

package/typings/provider/IProvider.d.ts

@@ -24,8 +24,8 @@ export interface IProvider<T = any> {
     setArgs(argsFn: ArgsFn): this;
     lazy(): this;
 }
-export declare const args: <T>(...extraArgs: unknown[]) => ProviderPipe<T>;
-export declare const argsFn: <T>(fn: ArgsFn) => ProviderPipe<T>;
+export declare const setArgs: <T>(...extraArgs: unknown[]) => ProviderPipe<T>;
+export declare const setArgsFn: <T>(fn: ArgsFn) => ProviderPipe<T>;
 export declare const resolveByArgs: (s: IContainer, ...deps: unknown[]) => any[];
 export declare const scopeAccess: <T>(rule: ScopeAccessRule) => ProviderPipe<T>;
 export declare const lazy: <T>() => ProviderPipe<T>;

package/typings/token/FunctionToken.d.ts

@@ -1,11 +1,14 @@
 import type { IContainer } from '../container/IContainer';
 import { InjectionToken } from './InjectionToken';
 import { InjectFn } from '../hooks/hook';
+import { ProviderOptions } from '../provider/IProvider';
 export declare class FunctionToken<T = any> extends InjectionToken<T> {
     private readonly fn;
+    private getArgsFn;
+    private isLazy;
     constructor(fn: InjectFn<T>);
-    resolve(s: IContainer): T;
+    resolve(s: IContainer, { args, lazy }?: ProviderOptions): T;
     args(...deps: unknown[]): InjectionToken<T>;
     argsFn(getArgsFn: (s: IContainer) => unknown[]): InjectionToken<T>;
-    lazy(): InjectionToken<T>;
+    lazy(isLazy?: boolean): InjectionToken<T>;
 }