Files
deepseek-harness/vendor/hmr/README.md
T
Tianyi Cui 72688a3888 Vendor Cordis framework packages as source
cordis 4.0.0-rc.6, plugin-loader, -include, -group, -timer, -hmr,
-logger-console, cosmokit 1.8.1, schemastery 3.18.0 — copied from the
cordis-workspace checkout, flattened under vendor/, original npm names,
private: true. vendor/README.md is the manifest: upstream repos +
commit SHAs, local-modification log, sync procedure.

Local modification: hmr's locale YAML imports and .i18n() call removed
(avoids a runtime YAML import hook we don't vendor).
2026-06-11 10:53:32 +08:00

1.3 KiB

@cordisjs/plugin-hmr

Hot module replacement for loader-managed Cordis plugins.

The HMR plugin watches source files, traces Node's module graph, clears affected module caches, and reloads only the plugin entries that depend on changed application files. Changes to framework-level dependencies fall back to loader.exit(), letting the host process restart.

Requirements

  • @cordisjs/plugin-loader
  • @cordisjs/plugin-timer
  • A runtime that exposes Node's internal module loader. The package throws if the loader service has no internal module loader available.

Usage

- id: timer
  name: '@cordisjs/plugin-timer'
- id: hmr
  name: '@cordisjs/plugin-hmr'
  config:
    root:
      - src
    ignored:
      - '**/node_modules'
      - '**/.*'
    debounce: 100

Config

Field Description
base Optional base directory resolved from ctx.baseUrl.
root Chokidar roots to watch. Defaults to ['.'].
ignored Picomatch patterns excluded from watch and reload analysis.
debounce Milliseconds to wait before processing a burst of changes.

Events

Event Description
hmr/change Emitted for changed files that are not handled by plugin reload or config reload.
hmr/reload Emitted after one or more plugin entries are reloaded.