@wtf/release-docs 9.0.2 → 10.0.0

package/api/@wtf/semantic-release/release/interfaces/StepOf.md

@@ -0,0 +1,63 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/semantic-release/release](../README.md) / StepOf
+
+# Interface: StepOf
+
+Defined in: [packages/semantic-release/src/release.ts:49](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release/src/release.ts#L49)
+
+What a step releases: the version, the train, and the folder and the platform of the run.
+
+## Extends
+
+- [`RepoContext`](../../../release/interfaces/RepoContext.md)\<[`ReleasePlatform`](../../../release/type-aliases/ReleasePlatform.md)\>
+
+## Properties
+
+### platform
+
+> `readonly` **platform**: [`ReleasePlatform`](../../../release/type-aliases/ReleasePlatform.md)
+
+Defined in: [packages/release/src/index.ts:80](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release/src/index.ts#L80)
+
+The platform, of the folder of the repo as its working folder.
+
+#### Inherited from
+
+[`RepoContext`](../../../release/interfaces/RepoContext.md).[`platform`](../../../release/interfaces/RepoContext.md#platform)
+
+***
+
+### root
+
+> `readonly` **root**: `FileSystemDirectoryHandle`
+
+Defined in: [packages/release/src/index.ts:78](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release/src/index.ts#L78)
+
+The folder of the repo, a handle of the File System standard.
+
+#### Inherited from
+
+[`RepoContext`](../../../release/interfaces/RepoContext.md).[`root`](../../../release/interfaces/RepoContext.md#root)
+
+***
+
+### train
+
+> `readonly` **train**: `string`
+
+Defined in: [packages/semantic-release/src/release.ts:53](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release/src/release.ts#L53)
+
+The train of the run.
+
+***
+
+### version
+
+> `readonly` **version**: `string`
+
+Defined in: [packages/semantic-release/src/release.ts:51](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release/src/release.ts#L51)
+
+The version of the release, as semantic-release decided it.

package/api/@wtf/semantic-release/schema/README.md

@@ -0,0 +1,23 @@
+[**Release trains**](../../../README.md)
+
+***
+
+[Release trains](../../../README.md) / @wtf/semantic-release/schema
+
+# @wtf/semantic-release/schema
+
+The validator of a plugin's entries of a config of semantic-release: [pluginEntriesOf](functions/pluginEntriesOf.md), of
+the validators of `@wtf/release/validator`, a Standard Schema and a Standard JSON Schema, which
+the schema of each plugin's part of a config is made of.
+
+```ts
+import { pluginEntriesOf } from '@wtf/semantic-release/schema'
+import { objectOf, stringOf } from '@wtf/release/validator'
+
+const options = objectOf<{ target: string }>({ target: { of: stringOf({ minLength: 1 }) } })
+export const configSchema = pluginEntriesOf(['@acme/semantic-release-deploy'], options)
+```
+
+## Functions
+
+- [pluginEntriesOf](functions/pluginEntriesOf.md)

package/api/@wtf/{release-system/validator → semantic-release/schema}/functions/pluginEntriesOf.md

@@ -2,13 +2,13 @@
 
 ***
 
-[Release trains](../../../../README.md) / [@wtf/release-system/validator](../README.md) / pluginEntriesOf
+[Release trains](../../../../README.md) / [@wtf/semantic-release/schema](../README.md) / pluginEntriesOf
 
 # Function: pluginEntriesOf()
 
-> **pluginEntriesOf**(`names`, `options`): [`Validator`](../interfaces/Validator.md)\<`object`\>
+> **pluginEntriesOf**(`names`, `options`): [`Validator`](../../../release/validator/interfaces/Validator.md)\<`object`\>
 
-Defined in: [packages/release-system/src/validator.ts:569](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-system/src/validator.ts#L569)
+Defined in: [packages/semantic-release/src/schema.ts:30](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release/src/schema.ts#L30)
 
 A validator of the entries of `plugins` of a whole config of semantic-release, an array, that
 name a plugin of `names` and give it options, `[name, options]`: its options of `options`. It
@@ -25,13 +25,13 @@ The names a config gives the plugin by, as its package or its path.
 
 ### options
 
-[`Validator`](../interfaces/Validator.md)\<`unknown`\>
+[`Validator`](../../../release/validator/interfaces/Validator.md)\<`unknown`\>
 
 The validator of the options of an entry of one of `names`.
 
 ## Returns
 
-[`Validator`](../interfaces/Validator.md)\<`object`\>
+[`Validator`](../../../release/validator/interfaces/Validator.md)\<`object`\>
 
 The validator of a config, of the issues of the options of each entry of the plugin, at
 `plugins[index][1]`.

package/api/@wtf/semantic-release-cargo/README.md

@@ -13,27 +13,32 @@ plugins of the run of a tag, before the plugin that makes the release of the hos
 `trains` and `ecosystems` of its options, which semantic-release gives it of the root of the
 config, and the train of the run of its option `train`, or else `RELEASE_TRAIN` of the
 environment of the run, as `@wtf/semantic-release-npm` does; and the crates as the trains read
-them, of the ecosystem of cargo (`cargoEcosystem` of `@wtf/release-cargo/ecosystem`): the crates
-of the release are the crates of the train, whose `paths` hold their folder (`ownersOf` of
-`@wtf/release-trains/packages`).
-
-- `verifyConditions` checks the options, reads the workspace by `cargo metadata`, selects the
-  crates the release publishes and puts them in order, and reads the last release of each other
-  train, by its tags (`releasedVersions` of `@wtf/release-trains/packages`), so a workspace that
-  cannot be published fails before the tag: of a crate that depends on a crate of no train
-  (`EDEPENDENCYNOTRAIN`), or of a train with no release (`EDEPENDENCYNORELEASE`);
-- `prepare` writes the version of the release into the crates of the train, and the last release
-  of each other train into its crates, into the root manifest and the manifest of each crate, and
-  into each dependency on them (`stampWorkspace`), and reads the workspace again, so a crate that
-  is not at the version of its train fails the run;
-- `publish` publishes each crate the registry lacks, in the order of their dependencies
-  (`publishCrates`), by `cargo publish`, and skips each it has, so a release that stopped part
-  way is finished by running it again; and records each crate for the links of the release of
-  the host (`recordReleased` of `@wtf/release-trains/links`): its page on crates.io, or, of
-  another registry, the `.crate` file `cargo publish` packed, which a link uploads.
-
-A dry run of semantic-release runs `verifyConditions` alone of these: it skips `prepare` and
-`publish`, so it stamps and publishes nothing.
+them, of the ecosystem of cargo (`cargoEcosystem` of `@wtf/release-cargo/ecosystem`). Each step
+maps the run onto the contract of `@wtf/release/contract`: a `Release` of the version of the next
+release, the dry run, the logger, and the folder and the platform of the run, each line and
+error of it named by the train (`runOf` of `@wtf/semantic-release`, `stepRelease` and `inTrain`
+of `@wtf/semantic-release/release`); and the plan of the train, of the crates of the working tree
+(`planOf` of `@wtf/release-trains/plan`): the crates of the train, whose `paths` hold their
+folder, in order, and the version of each crate, the release's of the train's, the last release
+of its train, by its tags, of each other. Then it runs the step of the ecosystem, of the options
+of its entry:
+
+- `verifyConditions` checks the options, and works out the plan, of no version yet, so a
+  workspace that cannot be published fails before the tag, of a crate that depends on a crate of
+  no train (`EDEPENDENCYNOTRAIN`), or of a train with no release (`EDEPENDENCYNORELEASE`);
+- `verifyRelease` runs `verify`, once the version is known, which checks the version, the crates
+  the release publishes, their order, and the credentials;
+- `prepare` runs `prepare`, which writes the version of each crate of the plan into the root
+  manifest and the manifest of each crate, and into each dependency on them, and reads the
+  workspace again, so a crate that is not at the version of its train fails the run;
+- `publish` runs `publish`, which publishes each crate the registry lacks, in the order of the
+  plan, by `cargo publish`, and skips each it has, so a release that stopped part way is finished
+  by running it again; and records each crate for the links of the release of the host
+  (`recordReleased` of `@wtf/semantic-release/links`): its page on crates.io, or, of another
+  registry, the `.crate` file `cargo publish` packed, which a link uploads.
+
+A dry run of semantic-release runs `verifyConditions` and `verifyRelease` alone of these: it skips
+`prepare` and `publish`, so it stamps and publishes nothing.
 
 It asks the sparse index of the registry, `https://index.crates.io` by default, which crates
 and versions exist, by `fetch`. It publishes by one of two credentials, as the environment of the
@@ -46,8 +51,8 @@ run has them:
 - a token, `CARGO_REGISTRY_TOKEN`, or `CARGO_REGISTRIES_<NAME>_TOKEN` of a `registry` that is not
   crates.io; cargo reads it.
 
-With both, the ID token is used and the log says so; with neither, `verifyConditions` fails
-(`ECRATEAUTH`), of a dry run too, which needs none and only warns.
+With both, the ID token is used and the log says so; with neither, `verifyRelease` fails
+(`ECRATEAUTH`), but of a dry run, which needs none, and warns so.
 
 ```js
 // release.config.mjs
@@ -75,10 +80,11 @@ export default {
 ## Variables
 
 - [default](variables/default.md)
+- [prepare](variables/prepare.md)
+- [publish](variables/publish.md)
+- [verifyConditions](variables/verifyConditions.md)
+- [verifyRelease](variables/verifyRelease.md)
 
 ## Functions
 
 - [indexLookup](functions/indexLookup.md)
-- [prepare](functions/prepare.md)
-- [publish](functions/publish.md)
-- [verifyConditions](functions/verifyConditions.md)

package/api/@wtf/semantic-release-cargo/functions/indexLookup.md

@@ -8,10 +8,10 @@
 
 > **indexLookup**(`index`, `name`, `version`): `Promise`\<`boolean`\>
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:181](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L181)
+Defined in: [packages/semantic-release-cargo/src/index.ts:159](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L159)
 
-Asks the sparse index `index` whether it has `name` at `version`, by `fetch`: of no file, a crate
-that was never published.
+Asks the sparse index `index` whether it has `name` at `version`, by the global `fetch`: of no
+file, a crate that was never published (`indexLookup` of `@wtf/release-cargo/registry`).
 
 ## Parameters
 

package/api/@wtf/semantic-release-cargo/interfaces/CargoPluginOptions.md

@@ -6,9 +6,14 @@
 
 # Interface: CargoPluginOptions
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:100](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L100)
+Defined in: [packages/semantic-release-cargo/src/index.ts:101](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L101)
 
-The options of the plugin, in the config of semantic-release or at its root.
+The options of the plugin, in the config of semantic-release or at its root: those of the root,
+and the options of cargo of its entry, as `@wtf/release-cargo/release` takes them.
+
+## Extends
+
+- [`CargoOptions`](../../release-cargo/release/interfaces/CargoOptions.md)
 
 ## Properties
 
@@ -16,7 +21,7 @@ The options of the plugin, in the config of semantic-release or at its root.
 
 > `readonly` **ecosystems**: readonly `string`[]
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:108](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L108)
+Defined in: [packages/semantic-release-cargo/src/index.ts:109](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L109)
 
 The ecosystems of the repo, of the root of the config, which the trains read the packages of:
 `'@wtf/semantic-release-cargo/ecosystem'` or `'@wtf/release-cargo'` among them, or `verifyConditions` fails (`ECARGOECOSYSTEM`), as the
@@ -28,9 +33,13 @@ trains would read no crate this plugin publishes.
 
 > `readonly` `optional` **exclude?**: readonly `string`[]
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:114](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L114)
+Defined in: [packages/release-cargo/src/release.ts:64](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/release.ts#L64)
+
+The crates of the plan not to publish, by name, as an example.
 
-The crates of the train not to publish, by name, as an example.
+#### Inherited from
+
+[`CargoOptions`](../../release-cargo/release/interfaces/CargoOptions.md).[`exclude`](../../release-cargo/release/interfaces/CargoOptions.md#exclude)
 
 ***
 
@@ -38,20 +47,28 @@ The crates of the train not to publish, by name, as an example.
 
 > `readonly` `optional` **idToken?**: `string`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:131](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L131)
+Defined in: [packages/release-cargo/src/release.ts:81](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/release.ts#L81)
 
 The variable of the environment that holds the ID token of the job, for trusted publishing:
 `CRATES_IO_ID_TOKEN`.
 
+#### Inherited from
+
+[`CargoOptions`](../../release-cargo/release/interfaces/CargoOptions.md).[`idToken`](../../release-cargo/release/interfaces/CargoOptions.md#idtoken)
+
 ***
 
 ### include?
 
 > `readonly` `optional` **include?**: readonly `string`[]
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:112](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L112)
+Defined in: [packages/release-cargo/src/release.ts:62](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/release.ts#L62)
+
+The crates of the plan to publish, by name: every crate of it that may be published by default.
 
-The crates of the train to publish, by name: every crate of it that may be published by default.
+#### Inherited from
+
+[`CargoOptions`](../../release-cargo/release/interfaces/CargoOptions.md).[`include`](../../release-cargo/release/interfaces/CargoOptions.md#include)
 
 ***
 
@@ -59,42 +76,44 @@ The crates of the train to publish, by name: every crate of it that may be publi
 
 > `readonly` `optional` **index?**: `string`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:124](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L124)
+Defined in: [packages/release-cargo/src/release.ts:74](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/release.ts#L74)
 
-The base URL of the sparse index of the registry, which the plugin asks which versions exist:
+The base URL of the sparse index of the registry, which the release asks which versions exist:
 `https://index.crates.io` by default, and required of a `registry` that is not crates.io.
 
+#### Inherited from
+
+[`CargoOptions`](../../release-cargo/release/interfaces/CargoOptions.md).[`index`](../../release-cargo/release/interfaces/CargoOptions.md#index)
+
 ***
 
 ### registry?
 
 > `readonly` `optional` **registry?**: `string`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:119](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L119)
+Defined in: [packages/release-cargo/src/release.ts:69](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/release.ts#L69)
 
 The registry, by the name of `.cargo/config.toml`: crates.io by default, which `crates-io`
 names too.
 
+#### Inherited from
+
+[`CargoOptions`](../../release-cargo/release/interfaces/CargoOptions.md).[`registry`](../../release-cargo/release/interfaces/CargoOptions.md#registry)
+
 ***
 
 ### registryApi?
 
 > `readonly` `optional` **registryApi?**: `string`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:136](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L136)
+Defined in: [packages/release-cargo/src/release.ts:86](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/release.ts#L86)
 
 The base URL of the API of the registry, where the ID token is exchanged: `https://crates.io`.
 Required of an ID token and a `registry` that is not crates.io.
 
-***
-
-### system?
+#### Inherited from
 
-> `readonly` `optional` **system?**: [`SystemInput`](../../release-system/system/type-aliases/SystemInput.md)
-
-Defined in: [packages/semantic-release-cargo/src/index.ts:138](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L138)
-
-The system the plugin runs by, over Node's.
+[`CargoOptions`](../../release-cargo/release/interfaces/CargoOptions.md).[`registryApi`](../../release-cargo/release/interfaces/CargoOptions.md#registryapi)
 
 ***
 
@@ -102,7 +121,7 @@ The system the plugin runs by, over Node's.
 
 > `readonly` `optional` **train?**: `string`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:110](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L110)
+Defined in: [packages/semantic-release-cargo/src/index.ts:111](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L111)
 
 The train of the run: `RELEASE_TRAIN` of the environment of the run by default.
 
@@ -112,7 +131,7 @@ The train of the run: `RELEASE_TRAIN` of the environment of the run by default.
 
 > `readonly` **trains**: [`Trains`](../../release-trains/type-aliases/Trains.md)
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:102](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L102)
+Defined in: [packages/semantic-release-cargo/src/index.ts:103](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L103)
 
 Every train of the repo: the crates of each are those whose folder its paths hold.
 
@@ -122,6 +141,10 @@ Every train of the repo: the crates of each are those whose folder its paths hol
 
 > `readonly` `optional` **verify?**: `boolean`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:126](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L126)
+Defined in: [packages/release-cargo/src/release.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/release.ts#L76)
 
 Whether cargo builds each crate before it publishes it: `true`.
+
+#### Inherited from
+
+[`CargoOptions`](../../release-cargo/release/interfaces/CargoOptions.md).[`verify`](../../release-cargo/release/interfaces/CargoOptions.md#verify)

package/api/@wtf/semantic-release-cargo/interfaces/CargoRelease.md

@@ -6,7 +6,7 @@
 
 # Interface: CargoRelease
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:142](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L142)
+Defined in: [packages/semantic-release-cargo/src/index.ts:115](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L115)
 
 The release the plugin gives semantic-release of the crates published.
 
@@ -16,7 +16,7 @@ The release the plugin gives semantic-release of the crates published.
 
 > `readonly` **name**: `string`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:144](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L144)
+Defined in: [packages/semantic-release-cargo/src/index.ts:117](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L117)
 
 The crates named, as `crates.io (a, b)`.
 
@@ -26,6 +26,6 @@ The crates named, as `crates.io (a, b)`.
 
 > `readonly` `optional` **url?**: `string`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:146](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L146)
+Defined in: [packages/semantic-release-cargo/src/index.ts:119](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L119)
 
 The page of the first crate that has one.

package/api/@wtf/semantic-release-cargo/schema/README.md

@@ -6,11 +6,11 @@
 
 # @wtf/semantic-release-cargo/schema
 
-The schema of the options of the plugin, as validators of `@wtf/release-system/validator`: each a
+The schema of the options of the plugin, as validators of `@wtf/release/validator`: each a
 Standard Schema, and a Standard JSON Schema of the JSON Schema of what it checks.
 
 - [cargoSchema](variables/cargoSchema.md): the options the plugin is given, of the root of the config, `trains`,
-  `ecosystems`, `train` and `system`, and of its entry, as it checks them;
+  `ecosystems` and `train`, and of its entry, as it checks them;
 - [cargoOptionsSchema](variables/cargoOptionsSchema.md): the options of its entry, `include`, `exclude`, `registry`,
   `index`, `verify`, `idToken` and `registryApi`, its own;
 - [configSchema](variables/configSchema.md): this package's part of a whole config of semantic-release, each entry of

package/api/@wtf/semantic-release-cargo/schema/type-aliases/CargoOptions.md

@@ -6,8 +6,8 @@
 
 # Type Alias: CargoOptions
 
-> **CargoOptions** = `Omit`\<[`CargoPluginOptions`](../../interfaces/CargoPluginOptions.md), `"train"` \| `"trains"` \| `"ecosystems"` \| `"system"`\>
+> **CargoOptions** = `Omit`\<[`CargoPluginOptions`](../../interfaces/CargoPluginOptions.md), `"train"` \| `"trains"` \| `"ecosystems"`\>
 
-Defined in: [packages/semantic-release-cargo/src/schema.ts:40](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/schema.ts#L40)
+Defined in: [packages/semantic-release-cargo/src/schema.ts:40](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/schema.ts#L40)
 
 The options of an entry of the plugin, its own: every one of the options but those of the root.

package/api/@wtf/semantic-release-cargo/schema/variables/cargoOptionsSchema.md

@@ -6,8 +6,8 @@
 
 # Variable: cargoOptionsSchema
 
-> `const` **cargoOptionsSchema**: [`Validator`](../../../release-system/validator/interfaces/Validator.md)\<[`CargoOptions`](../type-aliases/CargoOptions.md)\>
+> `const` **cargoOptionsSchema**: [`Validator`](../../../release/validator/interfaces/Validator.md)\<[`CargoOptions`](../type-aliases/CargoOptions.md)\>
 
-Defined in: [packages/semantic-release-cargo/src/schema.ts:43](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/schema.ts#L43)
+Defined in: [packages/semantic-release-cargo/src/schema.ts:43](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/schema.ts#L43)
 
 The validator of the options of an entry of the plugin, its own.

package/api/@wtf/semantic-release-cargo/schema/variables/cargoSchema.md

@@ -6,9 +6,9 @@
 
 # Variable: cargoSchema
 
-> `const` **cargoSchema**: [`Validator`](../../../release-system/validator/interfaces/Validator.md)\<[`RootOptions`](../../../release-trains/schema/interfaces/RootOptions.md) & [`CargoOptions`](../type-aliases/CargoOptions.md)\>
+> `const` **cargoSchema**: [`Validator`](../../../release/validator/interfaces/Validator.md)\<[`RootOptions`](../../../release-trains/schema/interfaces/RootOptions.md) & [`CargoOptions`](../type-aliases/CargoOptions.md)\>
 
-Defined in: [packages/semantic-release-cargo/src/schema.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/schema.ts#L57)
+Defined in: [packages/semantic-release-cargo/src/schema.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/schema.ts#L57)
 
 The validator of the options the plugin is given: the root's, `trains` and `ecosystems` required,
 and its own.

package/api/@wtf/semantic-release-cargo/schema/variables/configSchema.md

@@ -6,8 +6,8 @@
 
 # Variable: configSchema
 
-> `const` **configSchema**: [`Validator`](../../../release-system/validator/interfaces/Validator.md)\<`object`\>
+> `const` **configSchema**: [`Validator`](../../../release/validator/interfaces/Validator.md)\<`object`\>
 
-Defined in: [packages/semantic-release-cargo/src/schema.ts:63](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/schema.ts#L63)
+Defined in: [packages/semantic-release-cargo/src/schema.ts:63](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/schema.ts#L63)
 
 This package's part of a whole config of semantic-release: each entry of `plugins` of the plugin.

package/api/@wtf/semantic-release-cargo/schema/variables/jsonSchema.md

@@ -6,8 +6,8 @@
 
 # Variable: jsonSchema
 
-> `const` **jsonSchema**: [`JsonSchema`](../../../release-system/validator/type-aliases/JsonSchema.md)
+> `const` **jsonSchema**: [`JsonSchema`](../../../release/validator/type-aliases/JsonSchema.md)
 
-Defined in: [packages/semantic-release-cargo/src/schema.ts:69](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/schema.ts#L69)
+Defined in: [packages/semantic-release-cargo/src/schema.ts:69](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/schema.ts#L69)
 
 The JSON Schema of [configSchema](configSchema.md), as the package publishes it, `schema.json`.

package/api/@wtf/semantic-release-cargo/variables/default.md

@@ -8,7 +8,7 @@
 
 > **default**: `object`
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:541](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L541)
+Defined in: [packages/semantic-release-cargo/src/index.ts:387](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L387)
 
 ## Type Declaration
 
@@ -16,10 +16,10 @@ Defined in: [packages/semantic-release-cargo/src/index.ts:541](https://gitlab.co
 
 > **prepare**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
 
-Writes the version of the release into the crates of the train, and the last release of each other
-train into its crates, and each into the dependencies on them; and reads the workspace again: a
-crate that is not at the version of its train, as one that sets its own in a form the stamp does
-not read, fails the run here, before the tag's release.
+Runs the ecosystem's `prepare`: writes the version of the release into the crates of the train,
+and the last release of each other train into its crates, and each into the dependencies on them;
+and reads the workspace again: a crate that is not at the version of its train, as one that sets
+its own in a form the stamp does not read, fails the run here, before the tag's release.
 
 #### Parameters
 
@@ -50,8 +50,9 @@ the stamp.
 
 > **publish**: (`pluginConfig`, `context`) => `Promise`\<`false` \| [`CargoRelease`](../interfaces/CargoRelease.md)\>
 
-Publishes each crate of the release the registry lacks, in the order of their dependencies, at the
-version of the release; each the registry has already is skipped.
+Runs the ecosystem's `publish`: publishes each crate of the release the registry lacks, in the
+order of the plan, at the version of the release; each the registry has already is skipped. It
+records each crate for the links of the release of the host.
 
 #### Parameters
 
@@ -86,13 +87,11 @@ fails.
 > **verifyConditions**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
 
 Checks the options of the plugin, by `cargoSchema` of `./schema` (`EOPTIONS`), that `ecosystems`
-lists `@wtf/semantic-release-cargo/ecosystem` or `@wtf/release-cargo` (`ECARGOECOSYSTEM`), and the train of the run (`ETRAINNOTSELECTED`,
-`ETRAINUNKNOWN`); that the workspace reads, its crates select and
-order: `ECARGO`, `ECRATES`, `ECRATEPRIVATE`, `ECRATEORDER`; that no crate is of two trains
-(`ETRAINOVERLAP`), and each crate of another train the crates of the train depend on has a
-release, by the trains' own checks (`EDEPENDENCYNOTRAIN`, `EDEPENDENCYNORELEASE`); and that the
-environment holds a credential, an ID token or a token (`ECRATEAUTH`), which a dry run needs
-none of. It asks the registry nothing.
+lists `@wtf/semantic-release-cargo/ecosystem` or `@wtf/release-cargo` (`ECARGOECOSYSTEM`), and the
+train of the run (`ETRAINNOTSELECTED`, `ETRAINUNKNOWN`); and works out the plan of the train, of
+no version yet, by the trains' own checks: no crate is of two trains (`ETRAINOVERLAP`), and each
+crate of another train the crates of the train depend on has a release (`EDEPENDENCYNOTRAIN`,
+`EDEPENDENCYNORELEASE`). It checks no version: `verifyRelease` does, once it is known.
 
 #### Parameters
 
@@ -112,3 +111,33 @@ environment and the logger of the run.
 #### Returns
 
 `Promise`\<`void`\>
+
+### verifyRelease
+
+> **verifyRelease**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
+
+Runs the ecosystem's `verify`, once semantic-release knows the version of the release: that the
+version is one of semver (`ECRATESEMVER`); that a `registry` has its `index` (`EOPTIONS`); that
+the workspace reads, its crates select and order (`ECARGO`, `ECRATES`, `ECRATEPRIVATE`,
+`ECRATEORDER`); and that the environment holds a credential, an ID token or a token
+(`ECRATEAUTH`), which a dry run needs none of, and warns so. It asks the registry nothing. What it
+says and throws names the train.
+
+#### Parameters
+
+##### pluginConfig
+
+[`CargoPluginOptions`](../interfaces/CargoPluginOptions.md)
+
+The plugin's options of the config, with `trains` of its root.
+
+##### context
+
+`VerifyReleaseContext` & `OfRun`
+
+The context of semantic-release's `verifyRelease` step: the folder, the
+environment and the logger of the run, and the next release.
+
+#### Returns
+
+`Promise`\<`void`\>

package/api/@wtf/semantic-release-cargo/{functions → variables}/prepare.md

@@ -4,16 +4,16 @@
 
 [Release trains](../../../README.md) / [@wtf/semantic-release-cargo](../README.md) / prepare
 
-# Function: prepare()
+# Variable: prepare
 
-> **prepare**(`pluginConfig`, `context`): `Promise`\<`void`\>
+> `const` **prepare**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:436](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L436)
+Defined in: [packages/semantic-release-cargo/src/index.ts:318](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L318)
 
-Writes the version of the release into the crates of the train, and the last release of each other
-train into its crates, and each into the dependencies on them; and reads the workspace again: a
-crate that is not at the version of its train, as one that sets its own in a form the stamp does
-not read, fails the run here, before the tag's release.
+Runs the ecosystem's `prepare`: writes the version of the release into the crates of the train,
+and the last release of each other train into its crates, and each into the dependencies on them;
+and reads the workspace again: a crate that is not at the version of its train, as one that sets
+its own in a form the stamp does not read, fails the run here, before the tag's release.
 
 ## Parameters