@wtf/release-docs 9.1.0 → 10.0.0

package/api/@wtf/release-maven/repository/interfaces/LookupAuth.md

@@ -0,0 +1,32 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/repository](../README.md) / LookupAuth
+
+# Interface: LookupAuth
+
+Defined in: [packages/release-maven/src/repository.ts:41](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L41)
+
+The header a lookup of the repository sends, and the variable of the environment that holds its
+value, as `{ "header": "Job-Token", "variable": "CI_JOB_TOKEN" }` of the GitLab Maven registry.
+
+## Properties
+
+### header
+
+> `readonly` **header**: `string`
+
+Defined in: [packages/release-maven/src/repository.ts:43](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L43)
+
+The name of the header, as `Job-Token`, `Private-Token` or `Authorization`.
+
+***
+
+### variable
+
+> `readonly` **variable**: `string`
+
+Defined in: [packages/release-maven/src/repository.ts:45](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L45)
+
+The variable of the environment that holds its value, as `CI_JOB_TOKEN`.

package/api/@wtf/release-maven/repository/interfaces/ReleaseTargets.md

@@ -0,0 +1,32 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-maven/repository](../README.md) / ReleaseTargets
+
+# Interface: ReleaseTargets
+
+Defined in: [packages/release-maven/src/repository.ts:176](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L176)
+
+Where the modules of a release deploy, and where the release asks for their poms.
+
+## Properties
+
+### lookup?
+
+> `readonly` `optional` **lookup?**: `string`
+
+Defined in: [packages/release-maven/src/repository.ts:183](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L183)
+
+The base URL the release asks for each pom: none, where each module deploys.
+
+***
+
+### repository?
+
+> `readonly` `optional` **repository?**: [`Repository`](Repository.md)
+
+Defined in: [packages/release-maven/src/repository.ts:181](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L181)
+
+The repository every module deploys to, as Maven's `altDeploymentRepository`: none, each
+module's own of its `distributionManagement`.

package/api/@wtf/release-maven/repository/interfaces/Repository.md

@@ -6,7 +6,7 @@
 
 # Interface: Repository
 
-Defined in: [packages/release-maven/src/repository.ts:28](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/repository.ts#L28)
+Defined in: [packages/release-maven/src/repository.ts:30](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L30)
 
 A repository a module deploys to: the `<server>` of settings.xml of its credentials, and its URL.
 
@@ -16,7 +16,7 @@ A repository a module deploys to: the `<server>` of settings.xml of its credenti
 
 > `readonly` **id**: `string`
 
-Defined in: [packages/release-maven/src/repository.ts:30](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/repository.ts#L30)
+Defined in: [packages/release-maven/src/repository.ts:32](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L32)
 
 Its id, which names the `<server>` of settings.xml Maven deploys by.
 
@@ -26,6 +26,6 @@ Its id, which names the `<server>` of settings.xml Maven deploys by.
 
 > `readonly` **url**: `string`
 
-Defined in: [packages/release-maven/src/repository.ts:32](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/repository.ts#L32)
+Defined in: [packages/release-maven/src/repository.ts:34](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L34)
 
 Its URL.

package/api/@wtf/release-maven/repository/interfaces/ValuesOf.md

@@ -6,7 +6,7 @@
 
 # Interface: ValuesOf
 
-Defined in: [packages/release-maven/src/repository.ts:85](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/repository.ts#L85)
+Defined in: [packages/release-maven/src/repository.ts:98](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L98)
 
 The values a `${…}` of a URL names.
 
@@ -16,7 +16,7 @@ The values a `${…}` of a URL names.
 
 > `readonly` **env**: `Readonly`\<`Record`\<`string`, `string` \| `undefined`\>\>
 
-Defined in: [packages/release-maven/src/repository.ts:89](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/repository.ts#L89)
+Defined in: [packages/release-maven/src/repository.ts:102](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L102)
 
 The environment, which `${env.NAME}` names.
 
@@ -26,6 +26,6 @@ The environment, which `${env.NAME}` names.
 
 > `readonly` **properties**: `ReadonlyMap`\<`string`, `string`\>
 
-Defined in: [packages/release-maven/src/repository.ts:87](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/repository.ts#L87)
+Defined in: [packages/release-maven/src/repository.ts:100](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L100)
 
 The properties of the module, of its parents in the repo, its own over theirs.

package/api/@wtf/release-maven/repository/variables/MAVEN_CENTRAL.md

@@ -8,6 +8,6 @@
 
 > `const` **MAVEN\_CENTRAL**: `"https://repo1.maven.org/maven2"` = `'https://repo1.maven.org/maven2'`
 
-Defined in: [packages/release-maven/src/repository.ts:25](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/repository.ts#L25)
+Defined in: [packages/release-maven/src/repository.ts:27](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/repository.ts#L27)
 
 Maven Central, as it is read: what the Central Portal publishes is served here.

package/api/@wtf/release-maven/stamp/README.md

@@ -6,13 +6,13 @@
 
 # @wtf/release-maven/stamp
 
-The versions of the trains written into the poms of a repo, of no XML serializer: the reader of
+The versions of a release written into the poms of a repo, of no XML serializer: the reader of
 `./pom` gives where each element and its text are in the file, and the stamp writes each version
 into the text at its place, so every other byte, the comments, the layout and the line ends, stays
-as it was, and a release commit changes the versions alone. Each module takes the version of its
-train: of the train of the release, the release's; of another train, its last release
-(`releasedVersions` of `@wtf/release-trains/packages`); of no train, none. What it writes, of
-every pom of the repo:
+as it was, and a release commit changes the versions alone. Each module takes the version its
+caller gives it, as the `versions` of the plan of a release: of the modules of the release, the
+release's; of each other, the last release of its own; of a module given none, none. What it
+writes, of every pom of the repo:
 
 - the `<version>` of the project of each module that takes a version, a `${revision}` too;
 - the `<version>` of its `<parent>`, where the parent is a module of the repo that takes a
@@ -23,9 +23,9 @@ every pom of the repo:
 
 A dependency of no `<version>` is left: it takes the version its `dependencyManagement` gives, which
 is stamped. A module that takes a version and writes no `<version>` of its own takes its parent's,
-so its parent must take the same version: a module of another train than its parent, or whose
-parent is not of the repo, needs a `<version>` of its own (`EMAVENSTAMP`). A module of no train that
-inherits its version moves with its parent.
+so its parent must take the same version: a module released apart from its parent, or whose
+parent is not of the repo, needs a `<version>` of its own (`EMAVENSTAMP`). A module given no
+version that inherits its version moves with its parent.
 
 ```ts
 import { stampPom } from '@wtf/release-maven/stamp'

package/api/@wtf/release-maven/stamp/functions/checkVersions.md

@@ -8,7 +8,7 @@
 
 > **checkVersions**(`modules`, `versions`): `void`
 
-Defined in: [packages/release-maven/src/stamp.ts:264](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L264)
+Defined in: [packages/release-maven/src/stamp.ts:263](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L263)
 
 The modules that are not at the version they take, of their poms read again: what a stamp left
 wrong, as a module whose version is of a property the stamp does not write.

package/api/@wtf/release-maven/stamp/functions/stampModules.md

@@ -6,28 +6,23 @@
 
 # Function: stampModules()
 
-> **stampModules**(`system`, `cwd`, `modules`, `versions`): `Promise`\<[`StampedModules`](../interfaces/StampedModules.md)\>
+> **stampModules**(`root`, `modules`, `versions`, `dryRun?`): `Promise`\<[`StampedModules`](../interfaces/StampedModules.md)\>
 
-Defined in: [packages/release-maven/src/stamp.ts:216](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L216)
+Defined in: [packages/release-maven/src/stamp.ts:216](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L216)
 
 Writes `versions` into the poms of `modules`, as the module says: of each module that takes a
 version, its project's `<version>`, the `<parent>` of each child of it, and each dependency and
 plugin that names it, in every pom of the repo. A module that takes no version, as of no train,
-keeps its own, and what names it is left. A pom of no change is not written.
+keeps its own, and what names it is left. A pom of no change is not written, and of a dry run
+none is.
 
 ## Parameters
 
-### system
+### root
 
-[`System`](../../../release-system/system/interfaces/System.md)
+`FileSystemDirectoryHandle`
 
-The system the poms are read and written by.
-
-### cwd
-
-`string`
-
-The folder of the repo.
+The folder of the repo, whose poms are read and written.
 
 ### modules
 
@@ -39,9 +34,14 @@ The modules of the repo, as `readModules` of `./artifacts` gives them.
 
 `ReadonlyMap`\<`string`, `string`\>
 
-The version each module takes, by its name: of the modules of the train of the
-release, the release's, and of each other train's, its last release (`releasedVersions` of
-`@wtf/release-trains/packages`).
+The version each module takes, by its name: of the modules of the release, the
+release's, and of each other, the last release of its own.
+
+### dryRun?
+
+`boolean` = `false`
+
+Whether to write nothing, and give the poms it would write: `false` by default.
 
 ## Returns
 

package/api/@wtf/release-maven/stamp/functions/stampPom.md

@@ -8,7 +8,7 @@
 
 > **stampPom**(`text`, `options`, `file?`): [`Stamped`](../interfaces/Stamped.md)
 
-Defined in: [packages/release-maven/src/stamp.ts:127](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L127)
+Defined in: [packages/release-maven/src/stamp.ts:127](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L127)
 
 The pom `text` with the versions written, as the module says: every byte but those of the
 versions as it was. Idempotent: stamped twice, the second changes nothing.

package/api/@wtf/release-maven/stamp/interfaces/PomStampOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: PomStampOptions
 
-Defined in: [packages/release-maven/src/stamp.ts:46](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L46)
+Defined in: [packages/release-maven/src/stamp.ts:46](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L46)
 
 What to write into a pom.
 
@@ -16,7 +16,7 @@ What to write into a pom.
 
 > `readonly` **artifacts**: `ReadonlyMap`\<`string`, `string`\>
 
-Defined in: [packages/release-maven/src/stamp.ts:54](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L54)
+Defined in: [packages/release-maven/src/stamp.ts:54](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L54)
 
 The version of each module of the repo that takes one, by its name, `groupId:artifactId`.
 
@@ -26,7 +26,7 @@ The version of each module of the repo that takes one, by its name, `groupId:art
 
 > `readonly` **groupId**: `string`
 
-Defined in: [packages/release-maven/src/stamp.ts:48](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L48)
+Defined in: [packages/release-maven/src/stamp.ts:48](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L48)
 
 The groupId of the module, which `${project.groupId}` of a dependency names.
 
@@ -36,7 +36,7 @@ The groupId of the module, which `${project.groupId}` of a dependency names.
 
 > `readonly` **parent**: `string` \| `undefined`
 
-Defined in: [packages/release-maven/src/stamp.ts:52](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L52)
+Defined in: [packages/release-maven/src/stamp.ts:52](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L52)
 
 The version of its `<parent>`, of a parent of the repo that takes one: none, it is left.
 
@@ -46,6 +46,6 @@ The version of its `<parent>`, of a parent of the repo that takes one: none, it
 
 > `readonly` **version**: `string` \| `undefined`
 
-Defined in: [packages/release-maven/src/stamp.ts:50](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L50)
+Defined in: [packages/release-maven/src/stamp.ts:50](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L50)
 
 The version of the project, of a module that takes one: none, it is left.

package/api/@wtf/release-maven/stamp/interfaces/Stamped.md

@@ -6,7 +6,7 @@
 
 # Interface: Stamped
 
-Defined in: [packages/release-maven/src/stamp.ts:58](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L58)
+Defined in: [packages/release-maven/src/stamp.ts:58](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L58)
 
 A pom stamped, and how many values it wrote.
 
@@ -16,7 +16,7 @@ A pom stamped, and how many values it wrote.
 
 > `readonly` **changes**: `number`
 
-Defined in: [packages/release-maven/src/stamp.ts:62](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L62)
+Defined in: [packages/release-maven/src/stamp.ts:62](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L62)
 
 The values that were another, and are of the versions now.
 
@@ -26,6 +26,6 @@ The values that were another, and are of the versions now.
 
 > `readonly` **text**: `string`
 
-Defined in: [packages/release-maven/src/stamp.ts:60](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L60)
+Defined in: [packages/release-maven/src/stamp.ts:60](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L60)
 
 The pom, the versions written.

package/api/@wtf/release-maven/stamp/interfaces/StampedModules.md

@@ -6,7 +6,7 @@
 
 # Interface: StampedModules
 
-Defined in: [packages/release-maven/src/stamp.ts:164](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L164)
+Defined in: [packages/release-maven/src/stamp.ts:164](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L164)
 
 The result of stamping the poms of a repo: the poms written, and the values in them.
 
@@ -16,7 +16,7 @@ The result of stamping the poms of a repo: the poms written, and the values in t
 
 > `readonly` **changes**: `number`
 
-Defined in: [packages/release-maven/src/stamp.ts:168](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L168)
+Defined in: [packages/release-maven/src/stamp.ts:168](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L168)
 
 The values written.
 
@@ -26,6 +26,6 @@ The values written.
 
 > `readonly` **files**: readonly `string`[]
 
-Defined in: [packages/release-maven/src/stamp.ts:166](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-maven/src/stamp.ts#L166)
+Defined in: [packages/release-maven/src/stamp.ts:166](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/stamp.ts#L166)
 
-The poms whose text changed, from the root of the repo.
+The poms whose text changed, from the root of the repo: of a dry run, those it would write.

package/api/@wtf/release-npm/README.md

@@ -6,26 +6,30 @@
 
 # @wtf/release-npm
 
-The npm packages of a monorepo released in trains, of no release tool, by the `system` its
-caller gives it. Its default export is the ecosystem of npm, `npmEcosystem` of `./ecosystem`,
-which a config of the trains names in `ecosystems` as `'@wtf/release-npm'`, so the trains read
-the packages of the repo by it; and every package of a release train published: in the order of
-their dependencies, by a [Publisher](interfaces/Publisher.md) of your choice, npm's by default, each at the version
-of the release, its `workspace:` ranges resolved, checked and packed before the first publish,
-each already on the registry skipped, under the dist-tag of its channel. This module declares
-what a publisher is; the code is at the subpaths:
-
-- `./ecosystem`: the ecosystem of npm, as the trains read it;
+The npm packages of a monorepo released, of no release tool and no train, by the folder of the
+repo and the platform its caller gives it. Its default export is the ecosystem of npm,
+`npmEcosystem` of `./ecosystem`, of the contract of `@wtf/release/contract`: the read side, which a
+config names in `ecosystems` as `'@wtf/release-npm'`, so the trains read the packages of the repo
+by it; and the steps of a release, each over the plan its driver gives it, the packages that
+publish in order and the versions of the repo, of the options of [NpmOptions](interfaces/NpmOptions.md): `verify`,
+`prepare`, `smoke`, `publish` and `move`. Each package is published in the order of the plan, by
+a [Publisher](interfaces/Publisher.md) of your choice, npm's by default, at the version of the release, its
+`workspace:` ranges resolved, checked and packed before the first publish, each already on the
+registry skipped, under the dist-tags of `moving`. This module declares what a publisher is, and
+the options; the code is at the subpaths:
+
+- `./ecosystem`: the ecosystem of npm, and its steps;
 - `./manifests`: the package.json files of the repo, their fields and ranges, and each a package
-  of the trains;
+  of an ecosystem;
 - `./workspace`: the packages of a workspace, by its globs;
 - `./publishers`: the publishers built in, `npm` and `pnpm`;
-- `./release`: the manifests of a release resolved (`resolveManifests`), its packages packed
-  (`packTrain`) and published (`publishTrain`), none of which writes a file of the repo;
+- `./release`: each step of a release, and what each builds on: the manifests of a plan resolved
+  (`resolvePlan`), its packages packed (`packRelease`) and published (`publishPacked`), and its
+  dist-tags moved (`moveRelease`), none of which writes a file of the repo;
 - `./prepare`: what a package is made before it publishes;
 - `./check`: the guard of a release, of each package as it publishes;
 - `./smoke`: the packages packed tried as a consumer installs them;
-- `./errors`: the codes of its errors.
+- `./errors`: `NpmError`, and the codes of its errors.
 
 ```js
 // release.config.mjs
@@ -38,11 +42,12 @@ export default {
 ## Interfaces
 
 - [Lookup](interfaces/Lookup.md)
+- [NpmAside](interfaces/NpmAside.md)
+- [NpmOptions](interfaces/NpmOptions.md)
 - [Publisher](interfaces/Publisher.md)
 - [PublisherContext](interfaces/PublisherContext.md)
 - [PublishOptions](interfaces/PublishOptions.md)
 - [PublishPackage](interfaces/PublishPackage.md)
-- [PublishTrainOptions](interfaces/PublishTrainOptions.md)
 
 ## References
 

package/api/@wtf/release-npm/check/README.md

@@ -6,7 +6,7 @@
 
 # @wtf/release-npm/check
 
-The guard of the publishing of a train ([checkPackages](functions/checkPackages.md)): each fault that would fail its
+The guard of the publishing of a release ([checkPackages](functions/checkPackages.md)): each fault that would fail its
 release part way, or publish a package no consumer can install, as an [Issue](interfaces/Issue.md), and none
 where it publishes as it should. It reads nothing: it checks what it is given.
 

package/api/@wtf/release-npm/check/functions/checkPackages.md

@@ -8,9 +8,9 @@
 
 > **checkPackages**(`packages`, `options?`): [`Issue`](../interfaces/Issue.md)[]
 
-Defined in: [packages/release-npm/src/check.ts:147](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L147)
+Defined in: [packages/release-npm/src/check.ts:147](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L147)
 
-The faults of `packages`, the packages of a train that publish, as each would publish: those of
+The faults of `packages`, the packages of a release that publish, as each would publish: those of
 each alone, a dependency of one on a private package of `workspace`, and those of the order of
 publishing. None, where they publish as they should.
 
@@ -20,7 +20,7 @@ publishing. None, where they publish as they should.
 
 readonly [`CheckedPackage`](../type-aliases/CheckedPackage.md)[]
 
-The packages of the train that publish, as each would publish.
+The packages of the release that publish, as each would publish.
 
 ### options?
 

package/api/@wtf/release-npm/check/functions/formatIssue.md

@@ -8,7 +8,7 @@
 
 > **formatIssue**(`issue`): `string`
 
-Defined in: [packages/release-npm/src/check.ts:74](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L74)
+Defined in: [packages/release-npm/src/check.ts:74](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L74)
 
 A fault, as one line: its folder, its package's name, and what it is.
 

package/api/@wtf/release-npm/check/interfaces/CheckOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: CheckOptions
 
-Defined in: [packages/release-npm/src/check.ts:55](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L55)
+Defined in: [packages/release-npm/src/check.ts:55](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L55)
 
 What is checked.
 
@@ -16,7 +16,7 @@ What is checked.
 
 > `readonly` `optional` **access?**: `"public"` \| `"restricted"`
 
-Defined in: [packages/release-npm/src/check.ts:63](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L63)
+Defined in: [packages/release-npm/src/check.ts:63](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L63)
 
 The access every package publishes with, of the option, over each one's own.
 
@@ -26,7 +26,7 @@ The access every package publishes with, of the option, over each one's own.
 
 > `readonly` `optional` **conditions?**: readonly `string`[]
 
-Defined in: [packages/release-npm/src/check.ts:65](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L65)
+Defined in: [packages/release-npm/src/check.ts:65](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L65)
 
 The export conditions of the source: `['source']`.
 
@@ -34,9 +34,9 @@ The export conditions of the source: `['source']`.
 
 ### faults?
 
-> `readonly` `optional` **faults?**: readonly [`OrderFault`](../../../release-trains/packages/interfaces/OrderFault.md)[]
+> `readonly` `optional` **faults?**: readonly [`OrderFault`](../../../release/order/interfaces/OrderFault.md)[]
 
-Defined in: [packages/release-npm/src/check.ts:59](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L59)
+Defined in: [packages/release-npm/src/check.ts:59](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L59)
 
 What is wrong with the order of publishing, as `publishOrder` found it.
 
@@ -46,7 +46,7 @@ What is wrong with the order of publishing, as `publishOrder` found it.
 
 > `readonly` `optional` **prepared?**: `boolean`
 
-Defined in: [packages/release-npm/src/check.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L57)
+Defined in: [packages/release-npm/src/check.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L57)
 
 Whether the packages are prepared, as they are about to publish: `true`.
 
@@ -56,6 +56,6 @@ Whether the packages are prepared, as they are about to publish: `true`.
 
 > `readonly` `optional` **workspace?**: readonly [`CheckedPackage`](../type-aliases/CheckedPackage.md)[]
 
-Defined in: [packages/release-npm/src/check.ts:61](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L61)
+Defined in: [packages/release-npm/src/check.ts:61](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L61)
 
 Every package of the workspace, private ones too, as a dependency is found among them.

package/api/@wtf/release-npm/check/interfaces/Issue.md

@@ -6,9 +6,9 @@
 
 # Interface: Issue
 
-Defined in: [packages/release-npm/src/check.ts:45](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L45)
+Defined in: [packages/release-npm/src/check.ts:45](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L45)
 
-A fault of a package, or of the train, whose `dir` is then `.`.
+A fault of a package, or of the release, whose `dir` is then `.`.
 
 ## Properties
 
@@ -16,7 +16,7 @@ A fault of a package, or of the train, whose `dir` is then `.`.
 
 > `readonly` **code**: [`IssueCode`](../type-aliases/IssueCode.md)
 
-Defined in: [packages/release-npm/src/check.ts:46](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L46)
+Defined in: [packages/release-npm/src/check.ts:46](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L46)
 
 ***
 
@@ -24,7 +24,7 @@ Defined in: [packages/release-npm/src/check.ts:46](https://gitlab.com/wetryfun/r
 
 > `readonly` **dir**: `string`
 
-Defined in: [packages/release-npm/src/check.ts:48](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L48)
+Defined in: [packages/release-npm/src/check.ts:48](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L48)
 
 The folder of the package, from the root of the repo.
 
@@ -34,7 +34,7 @@ The folder of the package, from the root of the repo.
 
 > `readonly` **message**: `string`
 
-Defined in: [packages/release-npm/src/check.ts:51](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L51)
+Defined in: [packages/release-npm/src/check.ts:51](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L51)
 
 ***
 
@@ -42,6 +42,6 @@ Defined in: [packages/release-npm/src/check.ts:51](https://gitlab.com/wetryfun/r
 
 > `readonly` `optional` **name?**: `string`
 
-Defined in: [packages/release-npm/src/check.ts:50](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L50)
+Defined in: [packages/release-npm/src/check.ts:50](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L50)
 
 The name of the package, where it is one.

package/api/@wtf/release-npm/check/type-aliases/CheckedPackage.md

@@ -8,6 +8,6 @@
 
 > **CheckedPackage** = `Pick`\<[`Manifest`](../../manifests/interfaces/Manifest.md), `"dir"` \| `"name"` \| `"json"`\>
 
-Defined in: [packages/release-npm/src/check.ts:23](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L23)
+Defined in: [packages/release-npm/src/check.ts:23](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L23)
 
 A package as the guard reads it: its folder, its name, and what its package.json holds.

package/api/@wtf/release-npm/check/type-aliases/IssueCode.md

@@ -6,8 +6,8 @@
 
 # Type Alias: IssueCode
 
-> **IssueCode** = `"NOT_PUBLIC"` \| `"NO_LICENSE"` \| `"NO_REPOSITORY"` \| `"PRIVATE_DEPENDENCY"` \| `"WORKSPACE_SPECIFIER"` \| `"SOURCE_CONDITION"` \| `"TYPESCRIPT_EXPORT"` \| [`OrderFault`](../../../release-trains/packages/interfaces/OrderFault.md)\[`"code"`\]
+> **IssueCode** = `"NOT_PUBLIC"` \| `"NO_LICENSE"` \| `"NO_REPOSITORY"` \| `"PRIVATE_DEPENDENCY"` \| `"WORKSPACE_SPECIFIER"` \| `"SOURCE_CONDITION"` \| `"TYPESCRIPT_EXPORT"` \| [`OrderFault`](../../../release/order/interfaces/OrderFault.md)\[`"code"`\]
 
-Defined in: [packages/release-npm/src/check.ts:26](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-npm/src/check.ts#L26)
+Defined in: [packages/release-npm/src/check.ts:26](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-npm/src/check.ts#L26)
 
 What a fault is, to match on.

package/api/@wtf/release-npm/ecosystem/README.md

@@ -6,17 +6,27 @@
 
 # @wtf/release-npm/ecosystem
 
-The ecosystem of npm ([npmEcosystem](variables/npmEcosystem.md)), as the trains read it, and the default export of
-the package, which a config names in `ecosystems` as `'@wtf/release-npm'`: the packages of the
-repo, each package.json git tracks, of a name; a range of the workspace protocol published as
-pnpm resolves it; and the rules of semver.
-
-```js
-// release.config.mjs
-export default {
-  trains: { core: { paths: ['packages/core'] } },
-  ecosystems: ['@wtf/release-npm']
-}
+The ecosystem of npm ([npmEcosystem](variables/npmEcosystem.md)), the default export of the package, which a config
+names in `ecosystems` as `'@wtf/release-npm'`: the read side, the packages of the repo, each
+package.json git tracks, of a name, a range of the workspace protocol published as pnpm resolves
+it, and the rules of semver; and the steps of a release of the contract of
+`@wtf/release/contract`, each over the plan its driver gives it, of the options of
+[NpmOptions](../interfaces/NpmOptions.md), as `./release` has them.
+
+```ts
+import type { Release } from '@wtf/release/contract'
+import { runStep } from '@wtf/release/driver'
+import npm from '@wtf/release-npm'
+
+declare const release: Release
+
+const own = (await npm.packages(release)).filter(({ published }) => published)
+const versions = new Map(own.map(({ name }) => [name, release.version]))
+const plans = new Map([['npm', { own, versions }]])
+const ecosystems = [[npm, { moving: ['latest'] }]] as const
+await runStep(release, plans, ecosystems, 'verify')
+await runStep(release, plans, ecosystems, 'prepare')
+const { released } = await runStep(release, plans, ecosystems, 'publish')
 ```
 
 ## Variables