@wtf/release-docs 9.0.2 → 10.0.0

package/guides/troubleshooting.md

@@ -61,14 +61,14 @@ behind the branch.
 
 ## Error codes
 
-Every error of these packages is a `ReleaseError` from `@wtf/release-system/errors`, in the error
-class of its package: `TrainsError` from `@wtf/release-trains/errors`, or `ReplaceError` from
-`@wtf/release-replace/errors`. semantic-release prints them as it prints its own errors: the code,
-the message, and the details, which say how to fix it. A step that finds more than one fault reports
-all of them.
+Every error of these packages is a `ReleaseError` from `@wtf/release/errors`, in the error class of
+its package: `TrainsError` from `@wtf/release-trains/errors`, or `ReplaceError` from
+`@wtf/release-replace/errors`. Each plugin marks them as they leave its steps, so semantic-release
+prints them as it prints its own errors: the code, the message, and the details, which say how to
+fix it. A step that finds more than one fault reports all of them.
 
 When git fails, the error is `EGIT`, itself a `ReleaseError`. A validator of options from
-`@wtf/release-system` fails with `EOPTIONS`, or with the code its check gives, in the error class of
+`@wtf/release` fails with `EOPTIONS`, or with the code its check gives, in the error class of
 the package that asks.
 
 This page lists the codes of the trains, npm and replace packages. The other packages describe their
@@ -77,6 +77,7 @@ own codes:
 - Cargo: [Publish Cargo crates](publishing-crates.md).
 - Go: [Publish Go modules](publishing-go-modules.md).
 - Maven: [Publish Maven modules](publishing-maven.md).
+- OCI images: [Publish OCI images](publishing-oci.md).
 - `@wtf/release-validate`: [Validate a config](validating-a-config.md).
 - `EPUBLISHSMOKE` of `@wtf/release-npm`: [Publish npm packages](publishing.md).
 
@@ -186,7 +187,7 @@ Package: `release-trains`.
 
 ### `EECOSYSTEM`
 
-Package: `release-trains`.
+Package: `release`.
 
 **Cause:** An ecosystem in `ecosystems` cannot be loaded, is not an ecosystem, or has the same name
 as another.
@@ -196,7 +197,7 @@ there. Name each ecosystem once.
 
 ### `EGIT`
 
-Package: `release-system`.
+Package: `release`.
 
 **Cause:** git failed, for example in a shallow clone.
 
@@ -212,7 +213,7 @@ Package: `release-npm`.
 
 ### `EGENERATED`
 
-Package: `release-trains`.
+Package: `release`.
 
 **Cause:** A generated folder to list is not there.
 
@@ -353,19 +354,19 @@ Each package exports its codes with what they mean:
 
 | Export           | Module                                |
 | ---------------- | ------------------------------------- |
-| `SYSTEM_ERRORS`  | `@wtf/release-system/errors`          |
+| `RELEASE_ERRORS` | `@wtf/release/errors`                 |
 | `TRAINS_ERRORS`  | `@wtf/release-trains/errors`          |
 | `PLUGIN_ERRORS`  | `@wtf/semantic-release-trains/errors` |
 | `NPM_ERRORS`     | `@wtf/release-npm/errors`             |
 | `REPLACE_ERRORS` | `@wtf/release-replace/errors`         |
 
 ```ts
+import { RELEASE_ERRORS, ReleaseError } from '@wtf/release/errors'
 import { REPLACE_ERRORS } from '@wtf/release-replace/errors'
-import { ReleaseError, SYSTEM_ERRORS } from '@wtf/release-system/errors'
 import { TRAINS_ERRORS } from '@wtf/release-trains/errors'
 
 const MEANINGS: Readonly<Record<string, string>> = {
-  ...SYSTEM_ERRORS,
+  ...RELEASE_ERRORS,
   ...TRAINS_ERRORS,
   ...REPLACE_ERRORS
 }

package/guides/validating-a-config.md

@@ -12,6 +12,7 @@ and as a JSON Schema for an editor. The parts compose into a schema for the whol
 | `@wtf/semantic-release-cargo`    | Its entries in `plugins`                                                 |
 | `@wtf/semantic-release-go`       | Its entries in `plugins`                                                 |
 | `@wtf/semantic-release-maven`    | Its entries in `plugins`                                                 |
+| `@wtf/semantic-release-oci`      | Its entries in `plugins`                                                 |
 | `@wtf/semantic-release-validate` | Its entries in `plugins`                                                 |
 | `@wtf/semantic-release-replace`  | The root `templates`, and its entries in `plugins`                       |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wtf/release-docs",
-  "version": "9.0.2",
+  "version": "10.0.0",
   "description": "The guides of semantic-release for monorepos of more than one ecosystem, released in trains, and the API reference of its packages, which TypeDoc writes: the release of docs commits the reference and publishes it with the guides.",
   "keywords": [
     "documentation",
@@ -38,21 +38,29 @@
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
     "@types/node": "^24.10.0",
-    "@wtf/release-cargo": "3.2.0",
-    "@wtf/release-go": "1.1.0",
-    "@wtf/release-maven": "1.1.0",
-    "@wtf/release-npm": "1.2.0",
-    "@wtf/release-replace": "4.0.0",
-    "@wtf/release-system": "1.0.1",
-    "@wtf/release-trains": "8.0.2",
-    "@wtf/release-validate": "4.0.0",
-    "@wtf/semantic-release-cargo": "3.2.0",
-    "@wtf/semantic-release-go": "1.1.0",
-    "@wtf/semantic-release-maven": "1.1.0",
-    "@wtf/semantic-release-npm": "1.2.0",
-    "@wtf/semantic-release-replace": "4.0.0",
-    "@wtf/semantic-release-trains": "8.0.2",
-    "@wtf/semantic-release-validate": "4.0.0",
+    "@wtf/platform": "^1.0.0",
+    "@wtf/platform-fs-memory": "^1.0.0",
+    "@wtf/platform-fs-node": "^1.0.0",
+    "@wtf/platform-memory": "^1.0.0",
+    "@wtf/platform-node": "^1.0.0",
+    "@wtf/release": "1.0.0",
+    "@wtf/release-cargo": "4.0.0",
+    "@wtf/release-go": "2.0.0",
+    "@wtf/release-maven": "2.0.0",
+    "@wtf/release-npm": "2.0.0",
+    "@wtf/release-oci": "3.0.0",
+    "@wtf/release-replace": "5.0.0",
+    "@wtf/release-trains": "9.0.0",
+    "@wtf/release-validate": "5.0.0",
+    "@wtf/semantic-release": "1.0.0",
+    "@wtf/semantic-release-cargo": "4.0.0",
+    "@wtf/semantic-release-go": "2.0.0",
+    "@wtf/semantic-release-maven": "2.0.0",
+    "@wtf/semantic-release-npm": "2.0.0",
+    "@wtf/semantic-release-oci": "3.0.0",
+    "@wtf/semantic-release-replace": "5.0.0",
+    "@wtf/semantic-release-trains": "9.0.0",
+    "@wtf/semantic-release-validate": "4.0.1",
     "ajv": "^8.20.0",
     "semantic-release": "^25.0.9",
     "typedoc": "^0.28.20",

package/api/@wtf/release-go/tags/variables/RELEASE_AUTHOR.md

@@ -1,23 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-go/tags](../README.md) / RELEASE\_AUTHOR
-
-# Variable: RELEASE\_AUTHOR
-
-> `const` **RELEASE\_AUTHOR**: `object`
-
-Defined in: [packages/release-go/src/tags.ts:32](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L32)
-
-The author and the committer of a release commit, where the environment names none.
-
-## Type Declaration
-
-### email
-
-> `readonly` **email**: `"semantic-release-bot@martynus.net"` = `'semantic-release-bot@martynus.net'`
-
-### name
-
-> `readonly` **name**: `"semantic-release-bot"` = `'semantic-release-bot'`

package/api/@wtf/release-npm/interfaces/PublishTrainOptions.md

@@ -1,144 +0,0 @@
-[**Release trains**](../../../README.md)
-
-***
-
-[Release trains](../../../README.md) / [@wtf/release-npm](../README.md) / PublishTrainOptions
-
-# Interface: PublishTrainOptions
-
-Defined in: [packages/release-npm/src/types.ts:144](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L144)
-
-The options of the publishing of a train, the same for each of its releases.
-
-## Properties
-
-### access?
-
-> `readonly` `optional` **access?**: `"public"` \| `"restricted"`
-
-Defined in: [packages/release-npm/src/types.ts:148](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L148)
-
-The access of each package: its `publishConfig.access` by default.
-
-***
-
-### aside?
-
-> `readonly` `optional` **aside?**: readonly `string`[]
-
-Defined in: [packages/release-npm/src/types.ts:172](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L172)
-
-The packages, by name, each published under the dist-tag of its major's line where its dist-tag
-points above the release, as one that joined the train at a higher version of its own:
-`release-<major>.x` of `latest`, `<dist-tag>-<major>.x` of another, so its dist-tag stays. Any
-other package whose dist-tag points above the release fails it, and nothing is published
-(`EPUBLISHBEHIND`): none by default.
-
-***
-
-### check?
-
-> `readonly` `optional` **check?**: `boolean`
-
-Defined in: [packages/release-npm/src/types.ts:164](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L164)
-
-Whether the packages are checked before the first publish: `true`.
-
-***
-
-### conditions?
-
-> `readonly` `optional` **conditions?**: readonly `string`[]
-
-Defined in: [packages/release-npm/src/types.ts:162](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L162)
-
-The export conditions of the source, which no tarball ships: `['source']`.
-
-***
-
-### distTag?
-
-> `readonly` `optional` **distTag?**: `string`
-
-Defined in: [packages/release-npm/src/types.ts:191](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L191)
-
-The dist-tag every package is published under, over the one of the channel of the release, as a
-one-off: an empty one is none. The channel's by default.
-
-***
-
-### first?
-
-> `readonly` `optional` **first?**: `string`
-
-Defined in: [packages/release-npm/src/types.ts:158](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L158)
-
-The folder of the package published first, as a base: none by default.
-
-***
-
-### last?
-
-> `readonly` `optional` **last?**: `string`
-
-Defined in: [packages/release-npm/src/types.ts:160](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L160)
-
-The folder of the package published last, as a docs package: none by default.
-
-***
-
-### pack?
-
-> `readonly` `optional` **pack?**: readonly `string`[]
-
-Defined in: [packages/release-npm/src/types.ts:186](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L186)
-
-The private packages of the train, each by its folder, from the root of the repo, or a glob of
-folders, packed beside those that publish, into the folder of the tarballs, and never published:
-as a demo, whose tarball, kept in a `tarballDir`, the release of the host links. Each manifest as it publishes,
-of the version of the release, and each `workspace:` range of a private package of the workspace
-resolved to it too. None by default.
-
-***
-
-### provenance?
-
-> `readonly` `optional` **provenance?**: `boolean` \| `"auto"`
-
-Defined in: [packages/release-npm/src/types.ts:154](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L154)
-
-Whether each package is published with the provenance of the build: `auto`, the default, where
-the CI gives an ID token that npm signs it by (`SIGSTORE_ID_TOKEN` on GitLab, GitHub's OIDC),
-on a runner it hosts: npm refuses provenance of a self-hosted runner.
-
-***
-
-### publisher?
-
-> `readonly` `optional` **publisher?**: [`Publisher`](Publisher.md)
-
-Defined in: [packages/release-npm/src/types.ts:146](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L146)
-
-The publisher: `npmPublisher` of `./publishers` by default.
-
-***
-
-### registry?
-
-> `readonly` `optional` **registry?**: `string`
-
-Defined in: [packages/release-npm/src/types.ts:156](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L156)
-
-The registry: each package's `publishConfig.registry`, or the publisher's, by default.
-
-***
-
-### tarballDir?
-
-> `readonly` `optional` **tarballDir?**: `string`
-
-Defined in: [packages/release-npm/src/types.ts:178](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/types.ts#L178)
-
-The folder the tarballs are packed into, from the root of the repo or absolute, where they stay
-after the release, as for a link of the release of the host to a package of `pack`, which
-uploads its tarball: one of the system's temporary files by default, which goes.

package/api/@wtf/release-npm/release/functions/checkTrain.md

@@ -1,32 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-npm/release](../README.md) / checkTrain
-
-# Function: checkTrain()
-
-> **checkTrain**(`release`): `Promise`\<`string`[]\>
-
-Defined in: [packages/release-npm/src/release.ts:1044](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/release.ts#L1044)
-
-Checks the packages of a train as they are in the repo, before a release makes them ready: each
-scoped one public, of a license and a repository, none running with a private package, and an
-order of publishing that holds, unless `check` is `false`; and each name of `aside` of a package
-of the workspace. Gives the name of each package that publishes, in order; throws `EPUBLISHCHECK`
-of what is wrong.
-
-## Parameters
-
-### release
-
-[`CheckRelease`](../interfaces/CheckRelease.md)
-
-The trains, the train of the release, the folder of the repo and the options of
-the publishing.
-
-## Returns
-
-`Promise`\<`string`[]\>
-
-The name of each package that publishes, in the order of publishing.

package/api/@wtf/release-npm/release/functions/distTagOf.md

@@ -1,31 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-npm/release](../README.md) / distTagOf
-
-# Function: distTagOf()
-
-> **distTagOf**(`version`): `string`
-
-Defined in: [packages/release-npm/src/release.ts:68](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/release.ts#L68)
-
-The dist-tag of a version: `latest` of a release, and the first identifier of a prerelease, `beta`
-of `2.1.0-beta.3`, the channel of the branch semantic-release named it after; `prerelease` of one
-whose first identifier is a number, as `2.1.0-0`, which npm takes for a range and not a dist-tag,
-and is the channel of no branch. A prerelease never takes `latest`, which every install with no
-version gets.
-
-## Parameters
-
-### version
-
-`string`
-
-The version of the release, as `2.1.0` or `2.1.0-beta.3`.
-
-## Returns
-
-`string`
-
-The dist-tag of the version.

package/api/@wtf/release-npm/release/functions/packTrain.md

@@ -1,39 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-npm/release](../README.md) / packTrain
-
-# Function: packTrain()
-
-> **packTrain**(`resolved`, `options`): `Promise`\<[`PackedTrain`](../interfaces/PackedTrain.md)\>
-
-Defined in: [packages/release-npm/src/release.ts:354](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/release.ts#L354)
-
-Packs the packages of a release, of the manifests [resolveManifests](resolveManifests.md) gave: each package's
-folder copied, but its `node_modules`, into a folder of the system's temporary files, its manifest
-as it publishes written into the copy, and each packed there by a publisher that packs, all
-before the first publish. The repo is left as it is. The copies and the tarballs stay until
-`cleanup`, and the tarballs of a `tarballDir` the caller names after it too; of a pack that fails,
-they are removed.
-
-## Parameters
-
-### resolved
-
-[`ResolvedTrain`](../interfaces/ResolvedTrain.md)
-
-The packages of the release, of [resolveManifests](resolveManifests.md).
-
-### options
-
-[`PackOptions`](../interfaces/PackOptions.md)
-
-The publisher, the folder of the repo, the system, the folder of the tarballs,
-and the log.
-
-## Returns
-
-`Promise`\<[`PackedTrain`](../interfaces/PackedTrain.md)\>
-
-The packages packed, their copies and their tarballs, and how each goes.

package/api/@wtf/release-npm/release/functions/publishTrain.md

@@ -1,37 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-npm/release](../README.md) / publishTrain
-
-# Function: publishTrain()
-
-> **publishTrain**(`packed`, `run`): `Promise`\<[`PublishedTrain`](../interfaces/PublishedTrain.md)\>
-
-Defined in: [packages/release-npm/src/release.ts:658](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/release.ts#L658)
-
-Publishes the packages [packTrain](packTrain.md) packed, each in order, under the dist-tag of the
-channel, with the provenance of the build where the CI gives an ID token, and skips each the
-registry has at the version already. It leaves the copies and the tarballs, for `cleanup`.
-Before the first, it asks the registry by [publishedOf](publishedOf.md): `EPUBLISHBEHIND` of a release that
-would move a dist-tag back, and nothing published.
-
-## Parameters
-
-### packed
-
-[`PackedTrain`](../interfaces/PackedTrain.md)
-
-The packages of the release, of [packTrain](packTrain.md).
-
-### run
-
-[`PublishRun`](../interfaces/PublishRun.md)
-
-The access, the provenance, the registry, the system and the log of the publish.
-
-## Returns
-
-`Promise`\<[`PublishedTrain`](../interfaces/PublishedTrain.md)\>
-
-What was published, and what was skipped, of each package.

package/api/@wtf/release-npm/release/functions/publishedOfResolved.md

@@ -1,36 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-npm/release](../README.md) / publishedOfResolved
-
-# Function: publishedOfResolved()
-
-> **publishedOfResolved**(`resolved`, `run`): `Promise`\<[`PublishedOf`](../interfaces/PublishedOf.md)\>
-
-Defined in: [packages/release-npm/src/release.ts:530](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/release.ts#L530)
-
-[publishedOf](publishedOf.md) of a release [resolveManifests](resolveManifests.md) resolved, packed of nothing: each
-package of its folder in the repo, by the publisher of `run`, npm's by default. As the job of a
-release asks it of the next version before the tag: what it would find, with no pack.
-
-## Parameters
-
-### resolved
-
-[`ResolvedTrain`](../interfaces/ResolvedTrain.md)
-
-The packages of the release, of [resolveManifests](resolveManifests.md).
-
-### run
-
-[`PublishRun`](../interfaces/PublishRun.md) & `Pick`\<[`PackOptions`](../interfaces/PackOptions.md), `"publisher"`\>
-
-The publisher, the registry, the packages of `aside`, the system and the log the run
-asks by.
-
-## Returns
-
-`Promise`\<[`PublishedOf`](../interfaces/PublishedOf.md)\>
-
-The packages the registry has at the version, and those that go aside.

package/api/@wtf/release-npm/release/functions/releaseTrain.md

@@ -1,31 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-npm/release](../README.md) / releaseTrain
-
-# Function: releaseTrain()
-
-> **releaseTrain**(`release`): `Promise`\<[`PublishedTrain`](../interfaces/PublishedTrain.md)\>
-
-Defined in: [packages/release-npm/src/release.ts:823](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/release.ts#L823)
-
-Publishes a release of a train in one call, as a job of the pipeline of its tag does: its
-manifests resolved ([resolveManifests](resolveManifests.md)), its packages packed ([packTrain](packTrain.md)) and
-published ([publishTrain](publishTrain.md)). The copies go after, and the tarballs but of a `tarballDir`
-named; every tarball goes of a publish that fails, whose error is the one thrown. A copy that
-cannot be removed after the publish fails nothing: the log says where it stays.
-
-## Parameters
-
-### release
-
-[`ReleaseRun`](../type-aliases/ReleaseRun.md)
-
-The release, and what each of its three steps takes.
-
-## Returns
-
-`Promise`\<[`PublishedTrain`](../interfaces/PublishedTrain.md)\>
-
-What was published, and what was skipped, of each package.

package/api/@wtf/release-npm/release/functions/resolveManifests.md

@@ -1,37 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-npm/release](../README.md) / resolveManifests
-
-# Function: resolveManifests()
-
-> **resolveManifests**(`release`): `Promise`\<[`ResolvedTrain`](../interfaces/ResolvedTrain.md)\>
-
-Defined in: [packages/release-npm/src/release.ts:196](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/release.ts#L196)
-
-The manifest of each package of the train that publishes, as it publishes, in the order to
-publish them in, and checked: of the version of the release; each `workspace:` range of a package
-of the train resolved to that version, as pnpm resolves `workspace:*`, `workspace:^` and
-`workspace:~`; of a package of another train, to the last release of that train, by its tags
-merged into `HEAD` (`releasedVersions` of `@wtf/release-trains/packages`), or of `released`; and
-each export of the source stripped; and of each private package of the train of `pack`, the same,
-of no check. It writes nothing. Throws `EDEPENDENCYUNSATISFIED` of a range no release of the other
-train satisfies, `EDEPENDENCYNOTRAIN` and `EDEPENDENCYNORELEASE` of a range of a package of no
-train, or of a train with no release, that reaches the registry, and `EPUBLISHCHECK` of what is
-wrong with a manifest.
-
-## Parameters
-
-### release
-
-[`ResolveRelease`](../interfaces/ResolveRelease.md)
-
-The trains, the train, the version and the channel of the release, and its
-options.
-
-## Returns
-
-`Promise`\<[`ResolvedTrain`](../interfaces/ResolvedTrain.md)\>
-
-The packages of the train, each manifest as it publishes, in the order to publish.

package/api/@wtf/release-npm/release/functions/tagTrain.md

@@ -1,36 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-npm/release](../README.md) / tagTrain
-
-# Function: tagTrain()
-
-> **tagTrain**(`release`): `Promise`\<[`PublishedTrain`](../interfaces/PublishedTrain.md)\>
-
-Defined in: [packages/release-npm/src/release.ts:935](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-npm/src/release.ts#L935)
-
-Moves a release of a train published already to the channel of `channel`: the dist-tag of each
-package of the train that publishes pointed at the version, in the order of publishing, by the
-publisher's [Publisher.tag](../../interfaces/Publisher.md#tag); each the registry does not have at the version, as a package
-that joined the train after the release, skipped, and each whose dist-tag points above the
-version, of a publisher that reads dist-tags, as of an older release moved after a newer one,
-which would move it back; one whose dist-tag points at the version already is on the channel,
-and not moved again. The registry is asked of every package, a few at a time, by the
-publisher's [Publisher.lookup](../../interfaces/Publisher.md#lookup), before the first dist-tag moves. A publisher that moves no
-dist-tag moves none, and says so: the release stays on its channel.
-
-## Parameters
-
-### release
-
-[`TagRelease`](../interfaces/TagRelease.md)
-
-The trains, the train, the version and the channel of the release, the
-publisher, the system and the log.
-
-## Returns
-
-`Promise`\<[`PublishedTrain`](../interfaces/PublishedTrain.md)\>
-
-What was moved, and what was skipped, of each package.