# @wirestate/core [[monorepo](https://github.com/Neloreck/wirestate)] [[docs](https://Neloreck.github.io/wirestate/)]

[![npm](https://img.shields.io/npm/v/@wirestate/core.svg?style=flat-square)](https://www.npmjs.com/package/@wirestate/core)
[![license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://github.com/Neloreck/wirestate/blob/main/LICENSE)

Framework-agnostic Wirestate runtime.

Use this package to define injectable services, create containers, run lifecycle hooks,
and communicate through container-local events, commands, and queries.

## Install

```bash
npm install @wirestate/core
```

## Start

```ts
import { Injectable, Container } from "@wirestate/core";

@Injectable()
class CounterService {
  public count: number = 0;

  public increment(): void {
    this.count++;
  }
}

const container = new Container({
  bindings: [CounterService],
});

const counterService = container.get(CounterService);

counterService.increment();
```

## What Is Included

- DI primitives such as `Injectable`, `inject`, `Container`, `ServiceToken`, and `InjectionToken`.
- `Container` and container methods such as `bind`, `unbind`, `unbindAll`, `get`, `has`, and `getOwnBindings`.
- Binding inspection helpers: `getBindingToken`, `getBindingType`, and `getBindingScope`.
- `OnActivation`, `OnDeactivation`, `OnProvision`, and `OnDeprovision`.
- `WireStatus` and `ProvisionId` for lifecycle guards on resolved service instances.
- `EventBus`, `CommandBus`, `QueryBus`, and their decorators (`OnEvent`, `OnCommand`, `OnQuery`), enabled by
  registering `EventsPlugin`, `CommandsPlugin`, or `QueriesPlugin`.
- An optional `@wirestate/core/devtools` subpath (`DevToolsPlugin`) for development-time container inspection.
- An optional `@wirestate/core/hot` subpath carrying the runtime that swaps containers when a service module is hot
  replaced. Applications normally do not call it directly: install
  [`@wirestate/dev`](https://www.npmjs.com/package/@wirestate/dev) and its bundler plugin drives it.

React and Lit integration live in [`@wirestate/react`](https://www.npmjs.com/package/@wirestate/react) and
[`@wirestate/lit`](https://www.npmjs.com/package/@wirestate/lit).

## Learn More

- [Core guide](https://Neloreck.github.io/wirestate/core/overview)
- [API reference](https://Neloreck.github.io/wirestate/api/wirestate-core/)

## License

MIT