0 Fork 0

Files

T

imccyu 2c85c484d3 build(release): reference workspace members through the workspace protocol

1504 hand-written ranges pointing at workspace members become workspace:^, so
pnpm pack substitutes each member's real version at publication: sibling
peerDependencies follow the family version instead of being pinned at ^0.0.1,
and a reference to a vendored package follows that package's own line. Without
this, publishing 0.0.2 ships peer ranges naming a version that does not exist,
and 0.0.1-rc.1 does not satisfy ^0.0.1 either.

It also retires ranges that had gone stale against the workspace: ^4.0.0-rc.6
for a 4.0.0-rc.7 checkout, ^3.17.0 for schemastery 3.18.0.

workspace:* stays where an exact published version is the point, which is how
the Landlock entry pins its platform packages.

A workspace constraint now requires the protocol, so a new package cannot
reintroduce a hand-written range. The same constraint caught packages/boot/cmdline
arriving on master without the publishable trio, which this change completes.

2026-08-11 00:17:09 +08:00

src

refactor(loader): resolve config after injected services

2026-08-10 23:45:04 +08:00

bin.js

build(vendor): rescope the vendored Cordis packages into @deepseek-ai

2026-08-10 22:04:13 +08:00

LICENSE

Vendor Cordis framework packages as source

2026-06-11 10:53:32 +08:00

package.json

build(release): reference workspace members through the workspace protocol

2026-08-11 00:17:09 +08:00

README.md

Vendor Cordis framework packages as source

2026-06-11 10:53:32 +08:00

tsconfig.json

refactor: rename build typings dir to types

2026-06-20 00:26:02 +08:00

README.md

Cordis

Cordis is a TypeScript plugin framework for applications that need explicit dependency injection, scoped services, lifecycle-managed cleanup, and optional configuration-driven loading. The core package is published as cordis; the official packages in this repository add a loader, config-file includes, HMR, console logging, timers, and project scaffolding.

Install

yarn add cordis

Cordis is ESM-first. The repository is tested on current Node releases, and the scaffolder requires Node 22 or newer.

Quick Start

import { Context, Service } from 'cordis'

declare module 'cordis' {
  interface Context {
    counter: Counter
  }

  interface Events {
    'app/ready'(message: string): void
  }
}

class Counter extends Service {
  value = 0

  constructor(ctx: Context) {
    super(ctx, 'counter')
  }

  next() {
    return ++this.value
  }
}

const greeter = Object.assign((ctx: Context) => {
  ctx.on('app/ready', (message) => {
    ctx.logger.info('%s #%d', message, ctx.counter.next())
  })
}, {
  inject: ['counter'],
})

const root = new Context()
await root.plugin(Counter)
await root.plugin(greeter)

root.emit('app/ready', 'started')
await root.fiber.dispose()

The important pieces are:

new Context() creates the root dependency container.
ctx.plugin() starts a plugin and returns a Fiber.
inject tells Cordis which services must exist before the plugin runs.
Effects, event listeners, and services are removed when their owning fiber is disposed.

Documentation

Packages

Package	Purpose
`cordis`	Core context, plugin registry, fiber lifecycle, events, services, and logger.
`create-cordis`	Interactive project scaffolder.
`@cordisjs/plugin-loader`	Runtime plugin tree and loader service.
`@cordisjs/plugin-include`	YAML/JSON config-file include support for the loader.
`@cordisjs/plugin-group`	Nested plugin groups for loader configs.
`@cordisjs/plugin-hmr`	Hot module replacement for loader-managed plugins.
`@cordisjs/plugin-logger-console`	Console exporter for the built-in logger.
`@cordisjs/plugin-timer`	Disposal-aware timeout, interval, throttle, and debounce helpers.
`@cordisjs/utils`	Shared utilities used by Cordis packages.

Development

yarn install
yarn build
yarn test
yarn lint

The monorepo uses Yakumo to build and test all packages. Most examples in the docs use public APIs from cordis; loader examples additionally use @cordisjs/plugin-loader and @cordisjs/plugin-include.