@wirestate/core [monorepo] [docs]

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

npm install @wirestate/core

Start

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 and its bundler plugin drives it.

React and Lit integration live in @wirestate/react and @wirestate/lit.

Learn More

• Core guide
• API reference

License

MIT