targwire 1.0.0

package/README.md

@@ -0,0 +1,261 @@
+# TargWire
+
+Mini **IoC container** tipado para TypeScript com **Singleton**, **Transient (Factory)** e **Scoped** (child containers). Ideal para apps **Expo/React Native** (Hermes), web e Node — zero dependências.
+
+- ✅ Tokens tipados (`Token<T>`)
+- ✅ Ciclos de vida: `registerSingleton`, `registerFactory` (transient), `createScope` (scoped)
+- ✅ Overrides e reset (testes/HMR)
+- ✅ Plugin registry para registrar módulos do **app** e dar `bootstrapIOC()` uma vez só
+
+---
+
+## Instalação
+
+```bash
+npm i @seu-escopo/ioc
+# ou
+yarn add @seu-escopo/ioc
+# ou
+pnpm add @seu-escopo/ioc
+```
+
+> O pacote já é publicado transpilado (ESM + CJS) com typings. Não precisa configurar Metro/Babel pra transpilar TS em `node_modules`.
+
+---
+
+## TL;DR (Exemplo rápido)
+
+**1) Defina tokens do domínio (no app):**
+```ts
+// src/ioc/tokens.users.ts
+import { defineToken } from 'targwire';
+import type { GetUsersUseCase } from '@/domain/usecases/get_users_usecase';
+import type { UserRepository } from '@/domain/repositories/user_repository';
+import type { UserRemoteDataSource } from '@/data/datasources/remote/user_remote_data_source';
+
+export const TOKENS_USERS = {
+  RemoteDataSource: defineToken<UserRemoteDataSource>('Users.RemoteDataSource'),
+  Repository:       defineToken<UserRepository>('Users.Repository'),
+  GetUsersUseCase:  defineToken<GetUsersUseCase>('Users.GetUsersUseCase'),
+};
+```
+
+**2) Registre seu módulo via plugin (no app):**
+```ts
+// src/ioc/plugins.ts  (side-effect)
+import { registerIOCPlugin } from 'targwire';
+import { TOKENS_USERS } from './tokens.users';
+import { UserRemoteDataSourceImpl } from '@/data/datasources/remote/user_remote_data_source';
+import { UserRepositoryImpl } from '@/data/repositories/user_repository_impl';
+import { GetUsersUseCase } from '@/domain/usecases/get_users_usecase';
+
+registerIOCPlugin((c) => {
+  if (!c.isRegistered(TOKENS_USERS.RemoteDataSource))
+    c.registerSingleton(TOKENS_USERS.RemoteDataSource, () => new UserRemoteDataSourceImpl());
+  if (!c.isRegistered(TOKENS_USERS.Repository))
+    c.registerSingleton(TOKENS_USERS.Repository, () =>
+      new UserRepositoryImpl(c.resolve(TOKENS_USERS.RemoteDataSource))
+    );
+  if (!c.isRegistered(TOKENS_USERS.GetUsersUseCase))
+    c.registerFactory(TOKENS_USERS.GetUsersUseCase, () =>
+      new GetUsersUseCase(c.resolve(TOKENS_USERS.Repository))
+    );
+});
+```
+
+**3) Bootstrap uma vez no entrypoint do app:**
+```tsx
+// App.tsx
+import React from 'react';
+import '@/ioc/plugins';                 // importa teus módulos (efeito colateral)
+import { bootstrapIOC } from '@seu-escopo/ioc';
+
+bootstrapIOC();
+
+export default function App() {
+  return null; // sua navegação/telas aqui
+}
+```
+
+**4) Consumir onde precisar:**
+```ts
+import { resolve } from 'targwire';
+import { TOKENS_USERS } from '@/ioc/tokens.users';
+
+const getUsers = resolve(TOKENS_USERS.GetUsersUseCase); // transient
+const users = await getUsers.execute();
+```
+
+---
+
+## API da biblioteca
+
+```ts
+// Container raiz pronto:
+import {
+  rootContainer,
+  defineToken,             // <T>(name: string) => Token<T>
+  registerValue,           // (token, value)
+  registerSingleton,       // (token, () => T)  // lazy
+  registerFactory,         // (token, () => T)  // transient
+  resolve,                 // (token) => T
+  isRegistered,            // (token) => boolean
+  reset,                   // (tokens?) => void
+  createScope,             // () => Container   // scoped child
+  overrideValue,
+  overrideSingleton,
+  overrideFactory,
+  // Plugins/Bootstrap
+  registerIOCPlugin,       // (registrar: (c: Container) => void)
+  bootstrapIOC,            // executa todos os registrars uma vez
+} from '@seu-escopo/ioc';
+```
+
+### Ciclos de vida
+- **Singleton**: `registerSingleton(T, factory)`. A instância é criada no primeiro `resolve(T)` e reaproveitada naquele container/escopo.
+- **Transient**: `registerFactory(T, factory)`. Uma **nova** instância a cada `resolve(T)`.
+- **Scoped**: `const scope = rootContainer.createScope()`. Registros no escopo ficam isolados; `resolve` procura no escopo e sobe pro pai se necessário.
+
+---
+
+## Padrão de plugins (módulos do app)
+
+A lib **não** conhece teus domínios. Em vez de importar registradores manualmente no `App.tsx`, basta centralizar tudo num arquivo `src/ioc/plugins.ts`:
+
+```ts
+// src/ioc/plugins.ts
+import { registerIOCPlugin } from 'targwire';
+import { TOKENS_USERS } from './tokens.users';
+// ...imports do módulo
+
+registerIOCPlugin((c) => {
+  // registros do módulo Users
+});
+
+// registerIOCPlugin(...); // Auth
+// registerIOCPlugin(...); // Products
+```
+
+Depois, no `App.tsx`:
+```ts
+import '@/ioc/plugins';
+import { bootstrapIOC } from 'targwire';
+bootstrapIOC();
+```
+
+> Quer reduzir a 1 import só? Crie `src/ioc/bootstrap-app.ts` com:
+> ```ts
+> import '@/ioc/plugins';
+> export { bootstrapIOC as default } from 'targwire';
+> ```
+> E no `App.tsx`:
+> ```ts
+> import bootstrapIOC from '@/ioc/bootstrap-app';
+> bootstrapIOC();
+> ```
+
+---
+
+## Exemplos
+
+### Singleton
+```ts
+registerSingleton(TOKENS_USERS.Repository, () =>
+  new UserRepositoryImpl(resolve(TOKENS_USERS.RemoteDataSource))
+);
+const a = resolve(TOKENS_USERS.Repository);
+const b = resolve(TOKENS_USERS.Repository);
+console.log(a === b); // true
+```
+
+### Transient
+```ts
+registerFactory(TOKENS_USERS.GetUsersUseCase, () =>
+  new GetUsersUseCase(resolve(TOKENS_USERS.Repository))
+);
+const x = resolve(TOKENS_USERS.GetUsersUseCase);
+const y = resolve(TOKENS_USERS.GetUsersUseCase);
+console.log(x === y); // false
+```
+
+### Scoped por tela (React Native)
+```tsx
+import React, { useMemo } from 'react';
+import { rootContainer } from 'targwire';
+import { TOKENS_USERS } from '@/ioc/tokens.users';
+import { UserRemoteDataSourceImpl } from '@/data/datasources/remote/user_remote_data_source';
+import { UserRepositoryImpl } from '@/data/repositories/user_repository_impl';
+import { GetUsersUseCase } from '@/domain/usecases/get_users_usecase';
+
+export default function UsersScreenScoped() {
+  const scope = useMemo(() => {
+    const s = rootContainer.createScope();
+    s.registerSingleton(TOKENS_USERS.RemoteDataSource, () => new UserRemoteDataSourceImpl());
+    s.registerSingleton(TOKENS_USERS.Repository, () =>
+      new UserRepositoryImpl(s.resolve(TOKENS_USERS.RemoteDataSource))
+    );
+    s.registerFactory(TOKENS_USERS.GetUsersUseCase, () =>
+      new GetUsersUseCase(s.resolve(TOKENS_USERS.Repository))
+    );
+    return s;
+  }, []);
+
+  // use s.resolve(...) aqui
+  return null;
+}
+```
+
+---
+
+## Testes e overrides
+
+```ts
+import { reset, bootstrapIOC, overrideValue, resolve } from 'targwire';
+import { TOKENS_USERS } from '@/ioc/tokens.users';
+import '@/ioc/plugins';
+
+beforeEach(() => {
+  reset();        // limpa o root container
+  bootstrapIOC(); // re-registra os plugins
+});
+
+test('override de use case', async () => {
+  overrideValue(TOKENS_USERS.GetUsersUseCase, {
+    execute: async () => [{ id: '1', name: 'Ana' } as any],
+  } as any);
+
+  const uc = resolve(TOKENS_USERS.GetUsersUseCase);
+  const users = await uc.execute();
+  expect(users[0].name).toBe('Ana');
+});
+```
+
+---
+
+## Dicas & Troubleshooting
+
+- **`bootstrapIOC is not a function`**  
+  Verifique **export/import** (nomeado vs default) **e** a ordem dos imports:
+  - Importar `@/ioc/plugins` **antes** de `bootstrapIOC()`.
+  - Use um só estilo:
+    ```ts
+    import { bootstrapIOC } from '@seu-escopo/ioc'; // export nomeado
+    ```
+- **Tokens repetidos em HMR/Metro**  
+  Use `Symbol.for('ioc:...')` (já fazemos) e, se necessário, `reset()` durante dev.
+- **Alias `@`**  
+  Configure o alias no Babel/Metro **do app**. A lib não precisa.
+
+---
+
+## Requisitos de runtime
+
+- TypeScript 5+
+- Target ES2019+ (ok para Hermes / RN 0.7x+)
+- Sem dependências nativas
+
+---
+
+## Licença
+
+MIT © Você

package/dist/index.cjs

@@ -0,0 +1,154 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Container: () => Container,
+  _clearIOCPlugins: () => _clearIOCPlugins,
+  bootstrapIOC: () => bootstrapIOC,
+  createScope: () => createScope,
+  defineToken: () => defineToken,
+  getIOCPlugins: () => getIOCPlugins,
+  isRegistered: () => isRegistered,
+  overrideFactory: () => overrideFactory,
+  overrideSingleton: () => overrideSingleton,
+  overrideValue: () => overrideValue,
+  registerFactory: () => registerFactory,
+  registerIOCPlugin: () => registerIOCPlugin,
+  registerSingleton: () => registerSingleton,
+  registerValue: () => registerValue,
+  reset: () => reset,
+  resolve: () => resolve,
+  rootContainer: () => rootContainer
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/container.ts
+var Container = class _Container {
+  constructor(parent) {
+    this.parent = parent;
+    this.registry = /* @__PURE__ */ new Map();
+  }
+  defineToken(desc) {
+    return Symbol.for(`ioc:${desc}`);
+  }
+  registerValue(token, value) {
+    this.registry.set(token, { kind: "value", value });
+  }
+  registerSingleton(token, factory) {
+    this.registry.set(token, { kind: "singleton", factory });
+  }
+  registerFactory(token, factory) {
+    this.registry.set(token, { kind: "factory", factory });
+  }
+  isRegistered(token) {
+    return this.registry.has(token) || !!this.parent && this.parent.isRegistered(token);
+  }
+  resolve(token) {
+    if (this.registry.has(token)) {
+      const prov = this.registry.get(token);
+      switch (prov.kind) {
+        case "value":
+          return prov.value;
+        case "singleton":
+          if (prov.instance === void 0) prov.instance = prov.factory();
+          return prov.instance;
+        case "factory":
+          return prov.factory();
+      }
+    }
+    if (this.parent) return this.parent.resolve(token);
+    throw new Error(`Token not registered: ${String(token)}`);
+  }
+  override(token, provider) {
+    this.registry.set(token, provider);
+  }
+  reset(tokens) {
+    if (!tokens) return void this.registry.clear();
+    for (const t of tokens) this.registry.delete(t);
+  }
+  createScope() {
+    return new _Container(this);
+  }
+  overrideValue(token, value) {
+    this.override(token, { kind: "value", value });
+  }
+  overrideSingleton(token, factory) {
+    this.override(token, { kind: "singleton", factory });
+  }
+  overrideFactory(token, factory) {
+    this.override(token, { kind: "factory", factory });
+  }
+};
+var rootContainer = new Container();
+var defineToken = (desc) => rootContainer.defineToken(desc);
+var registerValue = (t, v) => rootContainer.registerValue(t, v);
+var registerSingleton = (t, f) => rootContainer.registerSingleton(t, f);
+var registerFactory = (t, f) => rootContainer.registerFactory(t, f);
+var resolve = (t) => rootContainer.resolve(t);
+var isRegistered = (t) => rootContainer.isRegistered(t);
+var reset = (tokens) => rootContainer.reset(tokens);
+var createScope = () => rootContainer.createScope();
+var overrideValue = (t, v) => rootContainer.overrideValue(t, v);
+var overrideSingleton = (t, f) => rootContainer.overrideSingleton(t, f);
+var overrideFactory = (t, f) => rootContainer.overrideFactory(t, f);
+
+// src/plugins.ts
+var registrars = [];
+function registerIOCPlugin(registrar) {
+  registrars.push(registrar);
+}
+function getIOCPlugins() {
+  return registrars.slice();
+}
+function _clearIOCPlugins() {
+  registrars.length = 0;
+}
+
+// src/bootstrap.ts
+var bootstrapped = false;
+function bootstrapIOC() {
+  if (bootstrapped) return;
+  for (const reg of getIOCPlugins()) {
+    reg(rootContainer);
+  }
+  bootstrapped = true;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Container,
+  _clearIOCPlugins,
+  bootstrapIOC,
+  createScope,
+  defineToken,
+  getIOCPlugins,
+  isRegistered,
+  overrideFactory,
+  overrideSingleton,
+  overrideValue,
+  registerFactory,
+  registerIOCPlugin,
+  registerSingleton,
+  registerValue,
+  reset,
+  resolve,
+  rootContainer
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/container.ts","../src/plugins.ts","../src/bootstrap.ts"],"sourcesContent":["export * from './container';\nexport * from './plugins';\nexport * from './bootstrap';\n","// src/container.ts\ntype Factory<T> = () => T;\nexport type Token<T> = symbol & { __type?: T };\n\ntype Provider<T> =\n  | { kind: 'value'; value: T }\n  | { kind: 'singleton'; factory: Factory<T>; instance?: T }\n  | { kind: 'factory'; factory: Factory<T> };\n\nexport class Container {\n  private registry = new Map<Token<any>, Provider<any>>();\n  constructor(private parent?: Container) {}\n\n  defineToken<T>(desc: string): Token<T> {\n    return Symbol.for(`ioc:${desc}`) as Token<T>;\n  }\n\n  registerValue<T>(token: Token<T>, value: T) {\n    this.registry.set(token, { kind: 'value', value });\n  }\n  registerSingleton<T>(token: Token<T>, factory: Factory<T>) {\n    this.registry.set(token, { kind: 'singleton', factory });\n  }\n  registerFactory<T>(token: Token<T>, factory: Factory<T>) {\n    this.registry.set(token, { kind: 'factory', factory });\n  }\n\n  isRegistered<T>(token: Token<T>): boolean {\n    return this.registry.has(token) || (!!this.parent && this.parent.isRegistered(token));\n  }\n\n  resolve<T>(token: Token<T>): T {\n    if (this.registry.has(token)) {\n      const prov = this.registry.get(token)!;\n      switch (prov.kind) {\n        case 'value': return prov.value as T;\n        case 'singleton':\n          if (prov.instance === undefined) prov.instance = prov.factory();\n          return prov.instance as T;\n        case 'factory': return prov.factory();\n      }\n    }\n    if (this.parent) return this.parent.resolve(token);\n    throw new Error(`Token not registered: ${String(token)}`);\n  }\n\n  override<T>(token: Token<T>, provider: Provider<T>) {\n    this.registry.set(token, provider);\n  }\n\n  reset(tokens?: Token<any>[]) {\n    if (!tokens) return void this.registry.clear();\n    for (const t of tokens) this.registry.delete(t);\n  }\n\n  createScope(): Container {\n    return new Container(this);\n  }\n\n  overrideValue<T>(token: Token<T>, value: T) { this.override(token, { kind: 'value', value }); }\n  overrideSingleton<T>(token: Token<T>, factory: Factory<T>) { this.override(token, { kind: 'singleton', factory }); }\n  overrideFactory<T>(token: Token<T>, factory: Factory<T>) { this.override(token, { kind: 'factory', factory }); }\n}\n\n// Root container + helpers\nexport const rootContainer = new Container();\nexport const defineToken = <T>(desc: string) => rootContainer.defineToken<T>(desc);\nexport const registerValue = <T>(t: Token<T>, v: T) => rootContainer.registerValue(t, v);\nexport const registerSingleton = <T>(t: Token<T>, f: Factory<T>) => rootContainer.registerSingleton(t, f);\nexport const registerFactory = <T>(t: Token<T>, f: Factory<T>) => rootContainer.registerFactory(t, f);\nexport const resolve = <T>(t: Token<T>) => rootContainer.resolve<T>(t);\nexport const isRegistered = <T>(t: Token<T>) => rootContainer.isRegistered<T>(t);\nexport const reset = (tokens?: Token<any>[]) => rootContainer.reset(tokens);\nexport const createScope = () => rootContainer.createScope();\nexport const overrideValue = <T>(t: Token<T>, v: T) => rootContainer.overrideValue(t, v);\nexport const overrideSingleton = <T>(t: Token<T>, f: Factory<T>) => rootContainer.overrideSingleton(t, f);\nexport const overrideFactory = <T>(t: Token<T>, f: Factory<T>) => rootContainer.overrideFactory(t, f);\n","// src/plugins.ts\nimport type { Container } from './container';\n\nexport type IOCRegistrar = (c: Container) => void;\n\nconst registrars: IOCRegistrar[] = [];\n\nexport function registerIOCPlugin(registrar: IOCRegistrar) {\n  registrars.push(registrar);\n}\n\n/** Apenas leitura (sem expor o array interno) */\nexport function getIOCPlugins(): IOCRegistrar[] {\n  return registrars.slice();\n}\n\n/** Para testes: limpar a lista de registrars */\nexport function _clearIOCPlugins() {\n  registrars.length = 0;\n}\n","// src/bootstrap.ts\nimport { rootContainer } from './container';\nimport { getIOCPlugins } from './plugins';\n\nlet bootstrapped = false;\n\n/**\n * Executa todos os registrars previamente registrados (plugins de módulos).\n * Deve ser chamado uma única vez no início do app.\n */\nexport function bootstrapIOC(): void {\n  if (bootstrapped) return;\n  for (const reg of getIOCPlugins()) {\n    reg(rootContainer);\n  }\n  bootstrapped = true;\n}\n\nexport default bootstrapIOC;\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,59 @@
+type Factory<T> = () => T;
+type Token<T> = symbol & {
+    __type?: T;
+};
+type Provider<T> = {
+    kind: 'value';
+    value: T;
+} | {
+    kind: 'singleton';
+    factory: Factory<T>;
+    instance?: T;
+} | {
+    kind: 'factory';
+    factory: Factory<T>;
+};
+declare class Container {
+    private parent?;
+    private registry;
+    constructor(parent?: Container | undefined);
+    defineToken<T>(desc: string): Token<T>;
+    registerValue<T>(token: Token<T>, value: T): void;
+    registerSingleton<T>(token: Token<T>, factory: Factory<T>): void;
+    registerFactory<T>(token: Token<T>, factory: Factory<T>): void;
+    isRegistered<T>(token: Token<T>): boolean;
+    resolve<T>(token: Token<T>): T;
+    override<T>(token: Token<T>, provider: Provider<T>): void;
+    reset(tokens?: Token<any>[]): undefined;
+    createScope(): Container;
+    overrideValue<T>(token: Token<T>, value: T): void;
+    overrideSingleton<T>(token: Token<T>, factory: Factory<T>): void;
+    overrideFactory<T>(token: Token<T>, factory: Factory<T>): void;
+}
+declare const rootContainer: Container;
+declare const defineToken: <T>(desc: string) => Token<T>;
+declare const registerValue: <T>(t: Token<T>, v: T) => void;
+declare const registerSingleton: <T>(t: Token<T>, f: Factory<T>) => void;
+declare const registerFactory: <T>(t: Token<T>, f: Factory<T>) => void;
+declare const resolve: <T>(t: Token<T>) => T;
+declare const isRegistered: <T>(t: Token<T>) => boolean;
+declare const reset: (tokens?: Token<any>[]) => undefined;
+declare const createScope: () => Container;
+declare const overrideValue: <T>(t: Token<T>, v: T) => void;
+declare const overrideSingleton: <T>(t: Token<T>, f: Factory<T>) => void;
+declare const overrideFactory: <T>(t: Token<T>, f: Factory<T>) => void;
+
+type IOCRegistrar = (c: Container) => void;
+declare function registerIOCPlugin(registrar: IOCRegistrar): void;
+/** Apenas leitura (sem expor o array interno) */
+declare function getIOCPlugins(): IOCRegistrar[];
+/** Para testes: limpar a lista de registrars */
+declare function _clearIOCPlugins(): void;
+
+/**
+ * Executa todos os registrars previamente registrados (plugins de módulos).
+ * Deve ser chamado uma única vez no início do app.
+ */
+declare function bootstrapIOC(): void;
+
+export { Container, type IOCRegistrar, type Token, _clearIOCPlugins, bootstrapIOC, createScope, defineToken, getIOCPlugins, isRegistered, overrideFactory, overrideSingleton, overrideValue, registerFactory, registerIOCPlugin, registerSingleton, registerValue, reset, resolve, rootContainer };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+type Factory<T> = () => T;
+type Token<T> = symbol & {
+    __type?: T;
+};
+type Provider<T> = {
+    kind: 'value';
+    value: T;
+} | {
+    kind: 'singleton';
+    factory: Factory<T>;
+    instance?: T;
+} | {
+    kind: 'factory';
+    factory: Factory<T>;
+};
+declare class Container {
+    private parent?;
+    private registry;
+    constructor(parent?: Container | undefined);
+    defineToken<T>(desc: string): Token<T>;
+    registerValue<T>(token: Token<T>, value: T): void;
+    registerSingleton<T>(token: Token<T>, factory: Factory<T>): void;
+    registerFactory<T>(token: Token<T>, factory: Factory<T>): void;
+    isRegistered<T>(token: Token<T>): boolean;
+    resolve<T>(token: Token<T>): T;
+    override<T>(token: Token<T>, provider: Provider<T>): void;
+    reset(tokens?: Token<any>[]): undefined;
+    createScope(): Container;
+    overrideValue<T>(token: Token<T>, value: T): void;
+    overrideSingleton<T>(token: Token<T>, factory: Factory<T>): void;
+    overrideFactory<T>(token: Token<T>, factory: Factory<T>): void;
+}
+declare const rootContainer: Container;
+declare const defineToken: <T>(desc: string) => Token<T>;
+declare const registerValue: <T>(t: Token<T>, v: T) => void;
+declare const registerSingleton: <T>(t: Token<T>, f: Factory<T>) => void;
+declare const registerFactory: <T>(t: Token<T>, f: Factory<T>) => void;
+declare const resolve: <T>(t: Token<T>) => T;
+declare const isRegistered: <T>(t: Token<T>) => boolean;
+declare const reset: (tokens?: Token<any>[]) => undefined;
+declare const createScope: () => Container;
+declare const overrideValue: <T>(t: Token<T>, v: T) => void;
+declare const overrideSingleton: <T>(t: Token<T>, f: Factory<T>) => void;
+declare const overrideFactory: <T>(t: Token<T>, f: Factory<T>) => void;
+
+type IOCRegistrar = (c: Container) => void;
+declare function registerIOCPlugin(registrar: IOCRegistrar): void;
+/** Apenas leitura (sem expor o array interno) */
+declare function getIOCPlugins(): IOCRegistrar[];
+/** Para testes: limpar a lista de registrars */
+declare function _clearIOCPlugins(): void;
+
+/**
+ * Executa todos os registrars previamente registrados (plugins de módulos).
+ * Deve ser chamado uma única vez no início do app.
+ */
+declare function bootstrapIOC(): void;
+
+export { Container, type IOCRegistrar, type Token, _clearIOCPlugins, bootstrapIOC, createScope, defineToken, getIOCPlugins, isRegistered, overrideFactory, overrideSingleton, overrideValue, registerFactory, registerIOCPlugin, registerSingleton, registerValue, reset, resolve, rootContainer };

package/dist/index.js

@@ -0,0 +1,111 @@
+// src/container.ts
+var Container = class _Container {
+  constructor(parent) {
+    this.parent = parent;
+    this.registry = /* @__PURE__ */ new Map();
+  }
+  defineToken(desc) {
+    return Symbol.for(`ioc:${desc}`);
+  }
+  registerValue(token, value) {
+    this.registry.set(token, { kind: "value", value });
+  }
+  registerSingleton(token, factory) {
+    this.registry.set(token, { kind: "singleton", factory });
+  }
+  registerFactory(token, factory) {
+    this.registry.set(token, { kind: "factory", factory });
+  }
+  isRegistered(token) {
+    return this.registry.has(token) || !!this.parent && this.parent.isRegistered(token);
+  }
+  resolve(token) {
+    if (this.registry.has(token)) {
+      const prov = this.registry.get(token);
+      switch (prov.kind) {
+        case "value":
+          return prov.value;
+        case "singleton":
+          if (prov.instance === void 0) prov.instance = prov.factory();
+          return prov.instance;
+        case "factory":
+          return prov.factory();
+      }
+    }
+    if (this.parent) return this.parent.resolve(token);
+    throw new Error(`Token not registered: ${String(token)}`);
+  }
+  override(token, provider) {
+    this.registry.set(token, provider);
+  }
+  reset(tokens) {
+    if (!tokens) return void this.registry.clear();
+    for (const t of tokens) this.registry.delete(t);
+  }
+  createScope() {
+    return new _Container(this);
+  }
+  overrideValue(token, value) {
+    this.override(token, { kind: "value", value });
+  }
+  overrideSingleton(token, factory) {
+    this.override(token, { kind: "singleton", factory });
+  }
+  overrideFactory(token, factory) {
+    this.override(token, { kind: "factory", factory });
+  }
+};
+var rootContainer = new Container();
+var defineToken = (desc) => rootContainer.defineToken(desc);
+var registerValue = (t, v) => rootContainer.registerValue(t, v);
+var registerSingleton = (t, f) => rootContainer.registerSingleton(t, f);
+var registerFactory = (t, f) => rootContainer.registerFactory(t, f);
+var resolve = (t) => rootContainer.resolve(t);
+var isRegistered = (t) => rootContainer.isRegistered(t);
+var reset = (tokens) => rootContainer.reset(tokens);
+var createScope = () => rootContainer.createScope();
+var overrideValue = (t, v) => rootContainer.overrideValue(t, v);
+var overrideSingleton = (t, f) => rootContainer.overrideSingleton(t, f);
+var overrideFactory = (t, f) => rootContainer.overrideFactory(t, f);
+
+// src/plugins.ts
+var registrars = [];
+function registerIOCPlugin(registrar) {
+  registrars.push(registrar);
+}
+function getIOCPlugins() {
+  return registrars.slice();
+}
+function _clearIOCPlugins() {
+  registrars.length = 0;
+}
+
+// src/bootstrap.ts
+var bootstrapped = false;
+function bootstrapIOC() {
+  if (bootstrapped) return;
+  for (const reg of getIOCPlugins()) {
+    reg(rootContainer);
+  }
+  bootstrapped = true;
+}
+export {
+  Container,
+  _clearIOCPlugins,
+  bootstrapIOC,
+  createScope,
+  defineToken,
+  getIOCPlugins,
+  isRegistered,
+  overrideFactory,
+  overrideSingleton,
+  overrideValue,
+  registerFactory,
+  registerIOCPlugin,
+  registerSingleton,
+  registerValue,
+  reset,
+  resolve,
+  rootContainer
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/container.ts","../src/plugins.ts","../src/bootstrap.ts"],"sourcesContent":["// src/container.ts\ntype Factory<T> = () => T;\nexport type Token<T> = symbol & { __type?: T };\n\ntype Provider<T> =\n  | { kind: 'value'; value: T }\n  | { kind: 'singleton'; factory: Factory<T>; instance?: T }\n  | { kind: 'factory'; factory: Factory<T> };\n\nexport class Container {\n  private registry = new Map<Token<any>, Provider<any>>();\n  constructor(private parent?: Container) {}\n\n  defineToken<T>(desc: string): Token<T> {\n    return Symbol.for(`ioc:${desc}`) as Token<T>;\n  }\n\n  registerValue<T>(token: Token<T>, value: T) {\n    this.registry.set(token, { kind: 'value', value });\n  }\n  registerSingleton<T>(token: Token<T>, factory: Factory<T>) {\n    this.registry.set(token, { kind: 'singleton', factory });\n  }\n  registerFactory<T>(token: Token<T>, factory: Factory<T>) {\n    this.registry.set(token, { kind: 'factory', factory });\n  }\n\n  isRegistered<T>(token: Token<T>): boolean {\n    return this.registry.has(token) || (!!this.parent && this.parent.isRegistered(token));\n  }\n\n  resolve<T>(token: Token<T>): T {\n    if (this.registry.has(token)) {\n      const prov = this.registry.get(token)!;\n      switch (prov.kind) {\n        case 'value': return prov.value as T;\n        case 'singleton':\n          if (prov.instance === undefined) prov.instance = prov.factory();\n          return prov.instance as T;\n        case 'factory': return prov.factory();\n      }\n    }\n    if (this.parent) return this.parent.resolve(token);\n    throw new Error(`Token not registered: ${String(token)}`);\n  }\n\n  override<T>(token: Token<T>, provider: Provider<T>) {\n    this.registry.set(token, provider);\n  }\n\n  reset(tokens?: Token<any>[]) {\n    if (!tokens) return void this.registry.clear();\n    for (const t of tokens) this.registry.delete(t);\n  }\n\n  createScope(): Container {\n    return new Container(this);\n  }\n\n  overrideValue<T>(token: Token<T>, value: T) { this.override(token, { kind: 'value', value }); }\n  overrideSingleton<T>(token: Token<T>, factory: Factory<T>) { this.override(token, { kind: 'singleton', factory }); }\n  overrideFactory<T>(token: Token<T>, factory: Factory<T>) { this.override(token, { kind: 'factory', factory }); }\n}\n\n// Root container + helpers\nexport const rootContainer = new Container();\nexport const defineToken = <T>(desc: string) => rootContainer.defineToken<T>(desc);\nexport const registerValue = <T>(t: Token<T>, v: T) => rootContainer.registerValue(t, v);\nexport const registerSingleton = <T>(t: Token<T>, f: Factory<T>) => rootContainer.registerSingleton(t, f);\nexport const registerFactory = <T>(t: Token<T>, f: Factory<T>) => rootContainer.registerFactory(t, f);\nexport const resolve = <T>(t: Token<T>) => rootContainer.resolve<T>(t);\nexport const isRegistered = <T>(t: Token<T>) => rootContainer.isRegistered<T>(t);\nexport const reset = (tokens?: Token<any>[]) => rootContainer.reset(tokens);\nexport const createScope = () => rootContainer.createScope();\nexport const overrideValue = <T>(t: Token<T>, v: T) => rootContainer.overrideValue(t, v);\nexport const overrideSingleton = <T>(t: Token<T>, f: Factory<T>) => rootContainer.overrideSingleton(t, f);\nexport const overrideFactory = <T>(t: Token<T>, f: Factory<T>) => rootContainer.overrideFactory(t, f);\n","// src/plugins.ts\nimport type { Container } from './container';\n\nexport type IOCRegistrar = (c: Container) => void;\n\nconst registrars: IOCRegistrar[] = [];\n\nexport function registerIOCPlugin(registrar: IOCRegistrar) {\n  registrars.push(registrar);\n}\n\n/** Apenas leitura (sem expor o array interno) */\nexport function getIOCPlugins(): IOCRegistrar[] {\n  return registrars.slice();\n}\n\n/** Para testes: limpar a lista de registrars */\nexport function _clearIOCPlugins() {\n  registrars.length = 0;\n}\n","// src/bootstrap.ts\nimport { rootContainer } from './container';\nimport { getIOCPlugins } from './plugins';\n\nlet bootstrapped = false;\n\n/**\n * Executa todos os registrars previamente registrados (plugins de módulos).\n * Deve ser chamado uma única vez no início do app.\n */\nexport function bootstrapIOC(): void {\n  if (bootstrapped) return;\n  for (const reg of getIOCPlugins()) {\n    reg(rootContainer);\n  }\n  bootstrapped = true;\n}\n\nexport default bootstrapIOC;\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "targwire",
+  "version": "1.0.0",
+  "description": "TargWire – mini IoC para TS/JS com Singleton, Transient e Scoped (ideal para Expo/React Native).",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "react-native": "dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.5.0"
+  }
+}