@git.zone/cli 9.2.2 → 11.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/.smartconfig.json +5 -3
  2. package/assets/templates/asset_binary_installer/install.sh +109 -34
  3. package/assets/templates/asset_binary_release_gitea/.gitea/workflows/release.yml +17 -4
  4. package/assets/templates/ci_rust/.gitea/workflows/rust_nottags.yaml +29 -0
  5. package/assets/templates/ci_rust/.gitea/workflows/rust_tags.yaml +32 -0
  6. package/assets/templates/cli/cli.ts.js +1 -1
  7. package/assets/templates/gitignore/_gitignore +1 -1
  8. package/assets/templates/gitignore_rust/_gitignore +31 -0
  9. package/assets/templates/license_mit/license +4 -1
  10. package/assets/templates/npm/.package.json +4 -6
  11. package/assets/templates/npm/test/test.ts +1 -1
  12. package/assets/templates/rust/.smartscaf.yml +16 -0
  13. package/assets/templates/rust/_Cargo.toml +12 -0
  14. package/assets/templates/rust/_crate_Cargo.toml +10 -0
  15. package/assets/templates/rust/_crate_lib.rs +19 -0
  16. package/assets/templates/rust/_smartconfig.json +27 -0
  17. package/assets/templates/rust/readme.md +23 -0
  18. package/assets/templates/service/.package.json +3 -6
  19. package/assets/templates/wcc/.package.json +3 -6
  20. package/assets/templates/wcc_update/html/index.html +2 -2
  21. package/assets/templates/website/.package.json +3 -6
  22. package/assets/templates/website/npmextra.json +3 -1
  23. package/assets/templates/website_update/html/index.html +4 -4
  24. package/dist_ts/00_commitinfo_data.js +2 -2
  25. package/dist_ts/classes.gitzoneconfig.d.ts +3 -1
  26. package/dist_ts/classes.gitzoneconfig.js +9 -1
  27. package/dist_ts/helpers.managedassets.d.ts +1 -1
  28. package/dist_ts/helpers.managedassets.js +58 -14
  29. package/dist_ts/helpers.packagefiles.js +2 -2
  30. package/dist_ts/helpers.releasetargets.d.ts +6 -0
  31. package/dist_ts/helpers.releasetargets.js +13 -0
  32. package/dist_ts/helpers.smartconfigmigrations.js +42 -1
  33. package/dist_ts/helpers.toolconfig.d.ts +50 -0
  34. package/dist_ts/helpers.toolconfig.js +212 -0
  35. package/dist_ts/helpers.tssea.d.ts +11 -4
  36. package/dist_ts/helpers.tssea.js +47 -17
  37. package/dist_ts/helpers.tstest.d.ts +27 -8
  38. package/dist_ts/helpers.tstest.js +64 -26
  39. package/dist_ts/helpers.versionsource.d.ts +37 -0
  40. package/dist_ts/helpers.versionsource.js +112 -0
  41. package/dist_ts/helpers.workflow.d.ts +45 -1
  42. package/dist_ts/helpers.workflow.js +120 -5
  43. package/dist_ts/mod_commit/mod.helpers.d.ts +0 -24
  44. package/dist_ts/mod_commit/mod.helpers.js +1 -94
  45. package/dist_ts/mod_commit/mod.plugins.d.ts +1 -1
  46. package/dist_ts/mod_commit/mod.plugins.js +2 -2
  47. package/dist_ts/mod_config/index.js +131 -18
  48. package/dist_ts/mod_format/formatters/assets.formatter.js +30 -28
  49. package/dist_ts/mod_format/formatters/gitignore.formatter.d.ts +4 -2
  50. package/dist_ts/mod_format/formatters/gitignore.formatter.js +10 -7
  51. package/dist_ts/mod_format/formatters/license.formatter.d.ts +8 -0
  52. package/dist_ts/mod_format/formatters/license.formatter.js +25 -2
  53. package/dist_ts/mod_format/formatters/packagejson.formatter.js +14 -3
  54. package/dist_ts/mod_format/formatters/rustfmt.formatter.d.ts +19 -0
  55. package/dist_ts/mod_format/formatters/rustfmt.formatter.js +97 -0
  56. package/dist_ts/mod_format/formatters/smartconfig.formatter.js +5 -2
  57. package/dist_ts/mod_format/formatters/templates.formatter.d.ts +3 -2
  58. package/dist_ts/mod_format/formatters/templates.formatter.js +61 -14
  59. package/dist_ts/mod_format/formatters/tsconfig.formatter.js +2 -2
  60. package/dist_ts/mod_format/index.js +3 -1
  61. package/dist_ts/mod_format/interfaces.format.js +2 -1
  62. package/dist_ts/mod_release/classes.releasejournal.d.ts +38 -2
  63. package/dist_ts/mod_release/classes.releasejournal.js +238 -66
  64. package/dist_ts/mod_release/helpers.cargorelease.d.ts +52 -0
  65. package/dist_ts/mod_release/helpers.cargorelease.js +195 -0
  66. package/dist_ts/mod_release/helpers.npmpackages.d.ts +18 -0
  67. package/dist_ts/mod_release/helpers.npmpackages.js +40 -2
  68. package/dist_ts/mod_release/helpers.releasecheck.d.ts +73 -0
  69. package/dist_ts/mod_release/helpers.releasecheck.js +269 -0
  70. package/dist_ts/mod_release/helpers.releasepreparation.d.ts +22 -8
  71. package/dist_ts/mod_release/helpers.releasepreparation.js +74 -26
  72. package/dist_ts/mod_release/helpers.releasepublication.d.ts +21 -1
  73. package/dist_ts/mod_release/helpers.releasepublication.js +249 -4
  74. package/dist_ts/mod_release/helpers.releaseversionsource.d.ts +10 -0
  75. package/dist_ts/mod_release/helpers.releaseversionsource.js +18 -0
  76. package/dist_ts/mod_release/helpers.rsrepoengine.d.ts +192 -0
  77. package/dist_ts/mod_release/helpers.rsrepoengine.js +457 -0
  78. package/dist_ts/mod_release/index.d.ts +3 -0
  79. package/dist_ts/mod_release/index.js +177 -65
  80. package/dist_ts/mod_template/index.js +6 -2
  81. package/dist_ts/mod_tools/index.js +3 -8
  82. package/dist_ts/plugins.d.ts +1 -1
  83. package/dist_ts/plugins.js +2 -2
  84. package/package.json +6 -11
  85. package/readme.md +244 -26
  86. package/ts/00_commitinfo_data.ts +1 -1
  87. package/ts/classes.gitzoneconfig.ts +10 -1
  88. package/ts/helpers.managedassets.ts +64 -14
  89. package/ts/helpers.packagefiles.ts +1 -1
  90. package/ts/helpers.releasetargets.ts +13 -0
  91. package/ts/helpers.smartconfigmigrations.ts +48 -0
  92. package/ts/helpers.toolconfig.ts +280 -0
  93. package/ts/helpers.tssea.ts +62 -19
  94. package/ts/helpers.tstest.ts +105 -35
  95. package/ts/helpers.versionsource.ts +169 -0
  96. package/ts/helpers.workflow.ts +197 -5
  97. package/ts/mod_commit/mod.helpers.ts +0 -119
  98. package/ts/mod_commit/mod.plugins.ts +1 -1
  99. package/ts/mod_config/index.ts +169 -19
  100. package/ts/mod_format/formatters/assets.formatter.ts +29 -28
  101. package/ts/mod_format/formatters/gitignore.formatter.ts +10 -6
  102. package/ts/mod_format/formatters/license.formatter.ts +26 -1
  103. package/ts/mod_format/formatters/packagejson.formatter.ts +14 -2
  104. package/ts/mod_format/formatters/rustfmt.formatter.ts +107 -0
  105. package/ts/mod_format/formatters/smartconfig.formatter.ts +8 -1
  106. package/ts/mod_format/formatters/templates.formatter.ts +80 -14
  107. package/ts/mod_format/formatters/tsconfig.formatter.ts +1 -1
  108. package/ts/mod_format/index.ts +2 -0
  109. package/ts/mod_format/interfaces.format.ts +1 -0
  110. package/ts/mod_release/classes.releasejournal.ts +312 -39
  111. package/ts/mod_release/helpers.cargorelease.ts +289 -0
  112. package/ts/mod_release/helpers.npmpackages.ts +76 -1
  113. package/ts/mod_release/helpers.releasecheck.ts +409 -0
  114. package/ts/mod_release/helpers.releasepreparation.ts +116 -36
  115. package/ts/mod_release/helpers.releasepublication.ts +462 -1
  116. package/ts/mod_release/helpers.releaseversionsource.ts +29 -0
  117. package/ts/mod_release/helpers.rsrepoengine.ts +790 -0
  118. package/ts/mod_release/index.ts +277 -84
  119. package/ts/mod_template/index.ts +5 -1
  120. package/ts/mod_tools/index.ts +2 -7
  121. package/ts/plugins.ts +1 -1
@@ -0,0 +1,37 @@
1
+ import type { IRsrepoEngineClient } from "./mod_release/helpers.rsrepoengine.js";
2
+ /**
3
+ * Where a project keeps the version gitzone releases:
4
+ * - `npm`: package.json.
5
+ * - `npm+internal-rust`: package.json; the crates of its `rust/` or `ts_rust/`
6
+ * workspace keep their own versions.
7
+ * - `cargo`: the Cargo workspace (`projectType: "rust"`), read and written
8
+ * only through the rsrepo engine (`plan` and `set-version`).
9
+ */
10
+ export type TVersionSourceKind = "npm" | "npm+internal-rust" | "cargo";
11
+ export interface IVersionSource {
12
+ kind: TVersionSourceKind;
13
+ /** The project directory the source reads and writes. */
14
+ cwd: string;
15
+ /** What carries the version, for messages. */
16
+ description: string;
17
+ /** `00_commitinfo_data.ts` is baked only into TypeScript projects. */
18
+ bakesCommitInfo: boolean;
19
+ readCurrentVersion: () => Promise<string>;
20
+ /** Writes the version and returns the changed files, relative to the workspace root. */
21
+ writeVersion: (versionArg: string) => Promise<string[]>;
22
+ }
23
+ /** Internal Rust workspaces of a TypeScript package, as tsrust lays them out. */
24
+ export declare const internalRustWorkspaceDirectories: readonly ["rust", "ts_rust"];
25
+ /**
26
+ * The version source of a project: Cargo for `projectType: "rust"`, otherwise
27
+ * package.json, which a TypeScript project with an internal Rust workspace
28
+ * shares with nothing.
29
+ */
30
+ export declare const detectVersionSourceKind: (cwdArg: string, projectTypeArg: unknown) => Promise<TVersionSourceKind>;
31
+ /** The project's projectType, read from the `.smartconfig.json` in `cwdArg`. */
32
+ export declare const readProjectType: (cwdArg: string) => unknown;
33
+ /**
34
+ * Opens the version source of `kindArg`. A Cargo source needs the project's
35
+ * rsrepo engine; a package.json source never runs it.
36
+ */
37
+ export declare const openVersionSource: (kindArg: TVersionSourceKind, cwdArg: string, engineArg?: IRsrepoEngineClient) => IVersionSource;
@@ -0,0 +1,112 @@
1
+ import * as plugins from "./plugins.js";
2
+ const fileExists = async (pathArg) => {
3
+ try {
4
+ return (await plugins.fs.stat(pathArg)).isFile();
5
+ }
6
+ catch (error) {
7
+ if (error.code === "ENOENT")
8
+ return false;
9
+ throw error;
10
+ }
11
+ };
12
+ /** Internal Rust workspaces of a TypeScript package, as tsrust lays them out. */
13
+ export const internalRustWorkspaceDirectories = ["rust", "ts_rust"];
14
+ /**
15
+ * The version source of a project: Cargo for `projectType: "rust"`, otherwise
16
+ * package.json, which a TypeScript project with an internal Rust workspace
17
+ * shares with nothing.
18
+ */
19
+ export const detectVersionSourceKind = async (cwdArg, projectTypeArg) => {
20
+ if (projectTypeArg === "rust")
21
+ return "cargo";
22
+ if (!(await fileExists(plugins.path.join(cwdArg, "package.json")))) {
23
+ if (await fileExists(plugins.path.join(cwdArg, "Cargo.toml"))) {
24
+ throw new Error(`${cwdArg} has a Cargo.toml and no package.json: set @git.zone/cli.projectType to "rust" so gitzone versions the Cargo workspace.`);
25
+ }
26
+ throw new Error(`No package.json found in ${cwdArg}: gitzone commit and release version the package.json, or the Cargo workspace of projectType "rust".`);
27
+ }
28
+ for (const directory of internalRustWorkspaceDirectories) {
29
+ if (await fileExists(plugins.path.join(cwdArg, directory, "Cargo.toml"))) {
30
+ return "npm+internal-rust";
31
+ }
32
+ }
33
+ return "npm";
34
+ };
35
+ /** The project's projectType, read from the `.smartconfig.json` in `cwdArg`. */
36
+ export const readProjectType = (cwdArg) => {
37
+ const smartconfigInstance = new plugins.smartconfig.Smartconfig(cwdArg);
38
+ const cliConfig = smartconfigInstance.dataFor("@git.zone/cli", {});
39
+ return cliConfig?.projectType;
40
+ };
41
+ const packageJsonVersionSource = (kindArg, cwdArg) => {
42
+ const packageJsonPath = plugins.path.join(cwdArg, "package.json");
43
+ const readPackageJson = async () => {
44
+ let content;
45
+ try {
46
+ content = await plugins.fs.readFile(packageJsonPath, "utf8");
47
+ }
48
+ catch (error) {
49
+ if (error.code === "ENOENT") {
50
+ throw new Error(`No package.json found in ${cwdArg}: gitzone commit and release version the package.json.`);
51
+ }
52
+ throw error;
53
+ }
54
+ const parsed = JSON.parse(content);
55
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
56
+ throw new Error(`${packageJsonPath} must contain a JSON object.`);
57
+ }
58
+ return parsed;
59
+ };
60
+ return {
61
+ kind: kindArg,
62
+ cwd: cwdArg,
63
+ description: kindArg === "npm"
64
+ ? "package.json"
65
+ : "package.json (internal crates keep their own versions)",
66
+ bakesCommitInfo: true,
67
+ readCurrentVersion: async () => {
68
+ const version = (await readPackageJson()).version;
69
+ if (typeof version !== "string" || !version) {
70
+ throw new Error("package.json does not contain a version field");
71
+ }
72
+ return version;
73
+ },
74
+ writeVersion: async (versionArg) => {
75
+ const packageJson = await readPackageJson();
76
+ packageJson.version = versionArg;
77
+ await plugins.fs.writeFile(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, "utf8");
78
+ return ["package.json"];
79
+ },
80
+ };
81
+ };
82
+ const cargoVersionSource = (cwdArg, engineArg) => ({
83
+ kind: "cargo",
84
+ cwd: cwdArg,
85
+ description: "the Cargo workspace version",
86
+ bakesCommitInfo: false,
87
+ readCurrentVersion: async () => {
88
+ const plan = await engineArg.plan({ cwd: cwdArg, registries: [] });
89
+ if (plan.layout !== "root") {
90
+ throw new Error(`projectType "rust" versions a Cargo workspace at the repository root; rsrepo found the ${plan.layout}/ layout.`);
91
+ }
92
+ if (plan.version === null) {
93
+ throw new Error("The Cargo workspace versions its crates independently. gitzone releases one shared version: move the members to [workspace.package] version and `version.workspace = true`.");
94
+ }
95
+ return plan.version;
96
+ },
97
+ writeVersion: async (versionArg) => (await engineArg.setVersion({ cwd: cwdArg, version: versionArg }))
98
+ .changedFiles,
99
+ });
100
+ /**
101
+ * Opens the version source of `kindArg`. A Cargo source needs the project's
102
+ * rsrepo engine; a package.json source never runs it.
103
+ */
104
+ export const openVersionSource = (kindArg, cwdArg, engineArg) => {
105
+ if (kindArg !== "cargo")
106
+ return packageJsonVersionSource(kindArg, cwdArg);
107
+ if (!engineArg) {
108
+ throw new Error("The Cargo version source requires the rsrepo engine.");
109
+ }
110
+ return cargoVersionSource(cwdArg, engineArg);
111
+ };
112
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy52ZXJzaW9uc291cmNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvaGVscGVycy52ZXJzaW9uc291cmNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBMEJ4QyxNQUFNLFVBQVUsR0FBRyxLQUFLLEVBQUUsT0FBZSxFQUFvQixFQUFFO0lBQzdELElBQUksQ0FBQztRQUNILE9BQU8sQ0FBQyxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUM7SUFDbkQsQ0FBQztJQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7UUFDZixJQUFLLEtBQStCLENBQUMsSUFBSSxLQUFLLFFBQVE7WUFBRSxPQUFPLEtBQUssQ0FBQztRQUNyRSxNQUFNLEtBQUssQ0FBQztJQUNkLENBQUM7QUFDSCxDQUFDLENBQUM7QUFFRixpRkFBaUY7QUFDakYsTUFBTSxDQUFDLE1BQU0sZ0NBQWdDLEdBQUcsQ0FBQyxNQUFNLEVBQUUsU0FBUyxDQUFVLENBQUM7QUFFN0U7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLHVCQUF1QixHQUFHLEtBQUssRUFDMUMsTUFBYyxFQUNkLGNBQXVCLEVBQ00sRUFBRTtJQUMvQixJQUFJLGNBQWMsS0FBSyxNQUFNO1FBQUUsT0FBTyxPQUFPLENBQUM7SUFDOUMsSUFBSSxDQUFDLENBQUMsTUFBTSxVQUFVLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTSxFQUFFLGNBQWMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ25FLElBQUksTUFBTSxVQUFVLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTSxFQUFFLFlBQVksQ0FBQyxDQUFDLEVBQUUsQ0FBQztZQUM5RCxNQUFNLElBQUksS0FBSyxDQUNiLEdBQUcsTUFBTSx5SEFBeUgs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
@@ -4,7 +4,7 @@ import { type IGiteaAssetTransferLimits } from "./mod_release/helpers.giteaasset
4
4
  import { type IReleaseNpmPackageSet } from "./mod_release/helpers.npmpackages.js";
5
5
  export type TConfirmationMode = "prompt" | "auto" | "plan";
6
6
  export type TCommitStep = "format" | "analyze" | "test" | "build" | "changelog" | "commit" | "push";
7
- export type TReleaseTarget = "git" | "giteaAssets" | "npm" | "docker";
7
+ export type TReleaseTarget = "git" | "giteaAssets" | "npm" | "cargo" | "docker";
8
8
  export interface ICommitWorkflowConfig {
9
9
  confirmation?: TConfirmationMode;
10
10
  staging?: "all";
@@ -100,6 +100,31 @@ export interface IReleaseDockerTargetConfig {
100
100
  context?: string;
101
101
  noBuild?: boolean;
102
102
  }
103
+ /**
104
+ * Cargo publication through the rsrepo engine. No configured cargo target
105
+ * means no Cargo publication.
106
+ */
107
+ export interface IReleaseCargoTargetConfig {
108
+ enabled?: boolean;
109
+ /** `crates-io` or registry names defined in cargo config. */
110
+ registries?: string[];
111
+ /** Crates to publish; default every member whose Cargo `publish` admits each registry. */
112
+ members?: string[];
113
+ /** Minutes one accepted crate may stay unindexed before resume takes over. */
114
+ verificationWindowMinutes?: number;
115
+ }
116
+ export interface IResolvedReleaseCargoConfiguration {
117
+ registries: string[];
118
+ members?: string[];
119
+ verificationWindowMinutes: number;
120
+ }
121
+ /** The keys `release.targets` accepts; anything else is a typo or a target this gitzone lacks. */
122
+ export declare const releaseTargetConfigKeys: readonly ["git", "giteaAssets", "npm", "docker", "cargo"];
123
+ export declare const defaultCargoVerificationWindowMinutes = 15;
124
+ /** An enabled flag or registries switch the cargo target on, as for npm. */
125
+ export declare const isCargoTargetEnabled: (configArg: unknown) => boolean;
126
+ /** The active cargo target's settings; every key is checked. */
127
+ export declare const resolveCargoTargetConfiguration: (configArg: unknown) => IResolvedReleaseCargoConfiguration;
103
128
  export interface IReleaseWorkflowConfig {
104
129
  confirmation?: TConfirmationMode;
105
130
  /** Newest completed local release records to keep; default 3. */
@@ -131,6 +156,7 @@ export interface IReleaseWorkflowConfig {
131
156
  npm?: IReleaseNpmTargetConfig;
132
157
  giteaAssets?: IReleaseGiteaAssetsTargetConfig;
133
158
  docker?: IReleaseDockerTargetConfig;
159
+ cargo?: IReleaseCargoTargetConfig;
134
160
  };
135
161
  }
136
162
  export interface IResolvedCommitWorkflow {
@@ -157,6 +183,12 @@ export interface IResolvedReleaseWorkflow {
157
183
  cleanTestArtifacts: boolean;
158
184
  testCommand: string;
159
185
  buildCommand: string;
186
+ /**
187
+ * projectType "rust": the Cargo workspace carries the version, read and
188
+ * written through the rsrepo engine, and the release checkout fetches its
189
+ * locked Cargo dependencies.
190
+ */
191
+ cargoVersioned: boolean;
160
192
  changelogFile: "changelog.md";
161
193
  changelogPendingSection: "Pending";
162
194
  changelogVersionHeading: "## {{date}} - {{version}}";
@@ -187,6 +219,8 @@ export interface IResolvedReleaseWorkflow {
187
219
  giteaAssetTransfer?: IGiteaAssetTransferLimits;
188
220
  /** Attachments of a draft in progress at the same time. */
189
221
  giteaAssetConcurrency?: number;
222
+ /** The cargo target's registries, member filter and verification window, when active. */
223
+ cargo?: IResolvedReleaseCargoConfiguration;
190
224
  dockerEnabled: boolean;
191
225
  dockerEngine: "tsdocker";
192
226
  dockerRegistry?: string;
@@ -218,8 +252,17 @@ export interface IResolvedReleaseResumeConfiguration {
218
252
  giteaAssets?: IResolvedReleaseGiteaAssetsConfiguration;
219
253
  giteaAssetTransfer?: IGiteaAssetTransferLimits;
220
254
  giteaAssetConcurrency?: number;
255
+ cargo?: IResolvedReleaseCargoConfiguration;
221
256
  }
222
257
  export type TResolvedReleaseDockerConfiguration = Pick<IResolvedReleaseWorkflow, "dockerRegistry" | "dockerBuildRegistries" | "dockerTest" | "dockerPatterns" | "dockerCached" | "dockerParallel" | "dockerContext" | "dockerNoBuild">;
258
+ /**
259
+ * The test and build commands a project runs when its configuration names
260
+ * none: pnpm scripts, or rsrepo for a Rust project, which has no package.json.
261
+ */
262
+ export declare const getDefaultProjectCommands: (projectTypeArg: unknown) => {
263
+ test: string;
264
+ build: string;
265
+ };
223
266
  export type TTsdockerMinimumVersion = readonly [number, number, number];
224
267
  export declare const getTsdockerMinimumVersion: (buildRegistriesRequestedArg: boolean, imageTestsRequestedArg: boolean) => TTsdockerMinimumVersion | undefined;
225
268
  export declare const formatTsdockerMinimumVersion: (minimumVersionArg: TTsdockerMinimumVersion) => string;
@@ -259,5 +302,6 @@ export declare const resolveReleaseResumeConfiguration: (optionsArg: {
259
302
  git: boolean;
260
303
  npm: boolean;
261
304
  giteaAssets?: boolean;
305
+ cargo?: boolean;
262
306
  }) => Promise<IResolvedReleaseResumeConfiguration>;
263
307
  export declare const resolveReleaseDockerConfiguration: () => Promise<TResolvedReleaseDockerConfiguration>;