@intentius/chant 0.124.100 → 0.124.101

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 (223) hide show
  1. package/dist/action-pins.d.ts +2 -0
  2. package/dist/action-pins.js +3 -0
  3. package/dist/ci-detect.d.ts +13 -0
  4. package/dist/ci-detect.js +12 -0
  5. package/dist/ci-system.d.ts +66 -0
  6. package/dist/ci-system.js +61 -0
  7. package/dist/cli/handlers/build.js +27 -0
  8. package/dist/cli/handlers/release-doctor.d.ts +12 -0
  9. package/dist/cli/handlers/release-doctor.js +118 -0
  10. package/dist/cli/handlers/release-init.d.ts +10 -0
  11. package/dist/cli/handlers/release-init.js +342 -0
  12. package/dist/cli/handlers/release.d.ts +42 -1
  13. package/dist/cli/handlers/release.js +656 -31
  14. package/dist/cli/handlers/run-generate.js +11 -0
  15. package/dist/cli/main.d.ts +2 -0
  16. package/dist/cli/main.js +44 -101
  17. package/dist/cli/parse-args.js +48 -0
  18. package/dist/cli/registry.d.ts +16 -0
  19. package/dist/cli/release-commands/artifacts.d.ts +3 -0
  20. package/dist/cli/release-commands/artifacts.js +14 -0
  21. package/dist/cli/release-commands/candidates.d.ts +3 -0
  22. package/dist/cli/release-commands/candidates.js +16 -0
  23. package/dist/cli/release-commands/changed.d.ts +3 -0
  24. package/dist/cli/release-commands/changed.js +14 -0
  25. package/dist/cli/release-commands/compose.d.ts +3 -0
  26. package/dist/cli/release-commands/compose.js +16 -0
  27. package/dist/cli/release-commands/cut.d.ts +3 -0
  28. package/dist/cli/release-commands/cut.js +49 -0
  29. package/dist/cli/release-commands/doctor.d.ts +3 -0
  30. package/dist/cli/release-commands/doctor.js +14 -0
  31. package/dist/cli/release-commands/export.d.ts +3 -0
  32. package/dist/cli/release-commands/export.js +12 -0
  33. package/dist/cli/release-commands/images.d.ts +3 -0
  34. package/dist/cli/release-commands/images.js +13 -0
  35. package/dist/cli/release-commands/index.d.ts +8 -0
  36. package/dist/cli/release-commands/index.js +52 -0
  37. package/dist/cli/release-commands/init.d.ts +3 -0
  38. package/dist/cli/release-commands/init.js +16 -0
  39. package/dist/cli/release-commands/list.d.ts +3 -0
  40. package/dist/cli/release-commands/list.js +10 -0
  41. package/dist/cli/release-commands/next.d.ts +3 -0
  42. package/dist/cli/release-commands/next.js +13 -0
  43. package/dist/cli/release-commands/publish.d.ts +3 -0
  44. package/dist/cli/release-commands/publish.js +22 -0
  45. package/dist/cli/release-commands/stamp.d.ts +3 -0
  46. package/dist/cli/release-commands/stamp.js +15 -0
  47. package/dist/cli/release-commands/status.d.ts +3 -0
  48. package/dist/cli/release-commands/status.js +17 -0
  49. package/dist/cli/release-commands/tag.d.ts +3 -0
  50. package/dist/cli/release-commands/tag.js +12 -0
  51. package/dist/cli/release-commands/types.d.ts +20 -0
  52. package/dist/cli/release-commands/types.js +1 -0
  53. package/dist/cli/release-commands/verify.d.ts +3 -0
  54. package/dist/cli/release-commands/verify.js +15 -0
  55. package/dist/cli/release-commands/workflow.d.ts +3 -0
  56. package/dist/cli/release-commands/workflow.js +13 -0
  57. package/dist/components/cli-support.d.ts +1 -1
  58. package/dist/components/cli-support.js +1 -1
  59. package/dist/config-environments.d.ts +8 -1
  60. package/dist/config-environments.js +2 -0
  61. package/dist/config.d.ts +294 -9
  62. package/dist/config.js +100 -5
  63. package/dist/floor-table.data.js +15 -1
  64. package/dist/forge-remote.d.ts +13 -0
  65. package/dist/forge-remote.js +15 -0
  66. package/dist/lexicon.d.ts +41 -2
  67. package/dist/lifecycle/__fixtures__/publish-fakes.d.ts +62 -0
  68. package/dist/lifecycle/__fixtures__/publish-fakes.js +270 -3
  69. package/dist/lifecycle/publish-attachments.d.ts +2 -1
  70. package/dist/lifecycle/publish-attachments.js +19 -2
  71. package/dist/lifecycle/publish-cargo.d.ts +99 -0
  72. package/dist/lifecycle/publish-cargo.js +412 -0
  73. package/dist/lifecycle/publish-credentials.d.ts +1 -1
  74. package/dist/lifecycle/publish-credentials.js +8 -0
  75. package/dist/lifecycle/publish-declaration.d.ts +199 -4
  76. package/dist/lifecycle/publish-declaration.js +200 -9
  77. package/dist/lifecycle/publish-forge.d.ts +45 -2
  78. package/dist/lifecycle/publish-forge.js +434 -34
  79. package/dist/lifecycle/publish-git-ssh.d.ts +15 -0
  80. package/dist/lifecycle/publish-git-ssh.js +30 -4
  81. package/dist/lifecycle/publish-github.d.ts +40 -2
  82. package/dist/lifecycle/publish-github.js +100 -3
  83. package/dist/lifecycle/publish-homebrew.d.ts +7 -9
  84. package/dist/lifecycle/publish-homebrew.js +34 -197
  85. package/dist/lifecycle/publish-index.d.ts +141 -0
  86. package/dist/lifecycle/publish-index.js +719 -0
  87. package/dist/lifecycle/publish-marketplace.js +77 -0
  88. package/dist/lifecycle/publish-mcp-registry.d.ts +66 -0
  89. package/dist/lifecycle/publish-mcp-registry.js +306 -0
  90. package/dist/lifecycle/publish-npm.js +165 -2
  91. package/dist/lifecycle/publish-oci.d.ts +34 -1
  92. package/dist/lifecycle/publish-oci.js +246 -7
  93. package/dist/lifecycle/publish-pypi.d.ts +136 -0
  94. package/dist/lifecycle/publish-pypi.js +657 -0
  95. package/dist/lifecycle/publish-record.d.ts +6 -3
  96. package/dist/lifecycle/publish-record.js +6 -3
  97. package/dist/lifecycle/publish-signing.d.ts +147 -0
  98. package/dist/lifecycle/publish-signing.js +257 -0
  99. package/dist/lifecycle/publish-targets.d.ts +27 -1
  100. package/dist/lifecycle/publish-targets.js +80 -0
  101. package/dist/lifecycle/publish-tauri.js +43 -0
  102. package/dist/lifecycle/publish-train-names.d.ts +54 -0
  103. package/dist/lifecycle/publish-train-names.js +118 -0
  104. package/dist/lifecycle/publish-verify.d.ts +121 -0
  105. package/dist/lifecycle/publish-verify.js +130 -0
  106. package/dist/lifecycle/query.js +8 -0
  107. package/dist/lifecycle/release-artifacts.d.ts +212 -0
  108. package/dist/lifecycle/release-artifacts.js +571 -0
  109. package/dist/lifecycle/release-changelog.d.ts +13 -1
  110. package/dist/lifecycle/release-changelog.js +35 -2
  111. package/dist/lifecycle/release-cut.d.ts +58 -3
  112. package/dist/lifecycle/release-cut.js +132 -34
  113. package/dist/lifecycle/release-doctor.d.ts +113 -0
  114. package/dist/lifecycle/release-doctor.js +996 -0
  115. package/dist/lifecycle/release-green.d.ts +86 -0
  116. package/dist/lifecycle/release-green.js +286 -0
  117. package/dist/lifecycle/release-init.d.ts +255 -0
  118. package/dist/lifecycle/release-init.js +859 -0
  119. package/dist/lifecycle/release-intents.d.ts +73 -0
  120. package/dist/lifecycle/release-intents.js +128 -0
  121. package/dist/lifecycle/release-next.d.ts +111 -0
  122. package/dist/lifecycle/release-next.js +252 -0
  123. package/dist/lifecycle/release-prerelease.d.ts +19 -0
  124. package/dist/lifecycle/release-prerelease.js +30 -0
  125. package/dist/lifecycle/release-publish.d.ts +256 -10
  126. package/dist/lifecycle/release-publish.js +246 -34
  127. package/dist/lifecycle/release-status-change.d.ts +226 -0
  128. package/dist/lifecycle/release-status-change.js +478 -0
  129. package/dist/lifecycle/release-status.d.ts +11 -0
  130. package/dist/lifecycle/release-status.js +1 -1
  131. package/dist/lifecycle/release-store.d.ts +73 -2
  132. package/dist/lifecycle/release-store.js +32 -1
  133. package/dist/lifecycle/release-tag.d.ts +142 -0
  134. package/dist/lifecycle/release-tag.js +323 -0
  135. package/dist/lifecycle/release-verify.d.ts +73 -1
  136. package/dist/lifecycle/release-verify.js +117 -2
  137. package/dist/lifecycle/release-version-formats.d.ts +73 -0
  138. package/dist/lifecycle/release-version-formats.js +570 -0
  139. package/dist/lifecycle/release-version.d.ts +58 -10
  140. package/dist/lifecycle/release-version.js +164 -36
  141. package/dist/lifecycle/release-workstation.d.ts +3 -2
  142. package/dist/lifecycle/release-workstation.js +3 -2
  143. package/dist/op/generate-pipeline.js +1 -1
  144. package/dist/pr-forge-base.js +4 -2
  145. package/dist/pr-forge.d.ts +20 -2
  146. package/dist/pr-forge.js +46 -10
  147. package/dist/release-floors.d.ts +8 -1
  148. package/dist/release-floors.js +9 -2
  149. package/dist/tool-pins.d.ts +38 -0
  150. package/dist/tool-pins.js +54 -0
  151. package/dist/wave-runtime.mjs +337 -334
  152. package/dist/workspace/ci-forge.d.ts +17 -0
  153. package/dist/workspace/ci-forge.js +17 -0
  154. package/dist/workspace/ci-init.js +1 -1
  155. package/dist/workspace/composites.schema.json +1 -0
  156. package/dist/workspace/declaration.d.ts +8 -0
  157. package/dist/workspace/declaration.js +12 -0
  158. package/dist/workspace/declaration.schema.json +8 -0
  159. package/dist/workspace/environments.d.ts +2 -0
  160. package/dist/workspace/environments.js +1 -1
  161. package/dist/workspace/identity-gate-rule.d.ts +61 -5
  162. package/dist/workspace/identity-gate-rule.js +81 -12
  163. package/dist/workspace/member-pipeline.d.ts +2 -1
  164. package/dist/workspace/member-pipeline.js +5 -2
  165. package/dist/workspace/reason-codes.d.ts +2 -0
  166. package/dist/workspace/reason-codes.js +3 -1
  167. package/dist/workspace/release-changed.d.ts +75 -4
  168. package/dist/workspace/release-changed.js +205 -34
  169. package/dist/workspace/release-changed.schema.json +20 -2
  170. package/dist/workspace/release-steps/artifacts.d.ts +7 -0
  171. package/dist/workspace/release-steps/artifacts.js +45 -0
  172. package/dist/workspace/release-steps/builds.d.ts +12 -0
  173. package/dist/workspace/release-steps/builds.js +38 -0
  174. package/dist/workspace/release-steps/doctor.d.ts +8 -0
  175. package/dist/workspace/release-steps/doctor.js +14 -0
  176. package/dist/workspace/release-steps/goreleaser.d.ts +16 -0
  177. package/dist/workspace/release-steps/goreleaser.js +36 -0
  178. package/dist/workspace/release-steps/green.d.ts +3 -0
  179. package/dist/workspace/release-steps/green.js +6 -0
  180. package/dist/workspace/release-steps/images.d.ts +22 -0
  181. package/dist/workspace/release-steps/images.js +59 -0
  182. package/dist/workspace/release-steps/index.d.ts +9 -0
  183. package/dist/workspace/release-steps/index.js +46 -0
  184. package/dist/workspace/release-steps/pypi.d.ts +15 -0
  185. package/dist/workspace/release-steps/pypi.js +21 -0
  186. package/dist/workspace/release-steps/qemu.d.ts +21 -0
  187. package/dist/workspace/release-steps/qemu.js +35 -0
  188. package/dist/workspace/release-steps/signing.d.ts +18 -0
  189. package/dist/workspace/release-steps/signing.js +30 -0
  190. package/dist/workspace/release-steps/stamp.d.ts +3 -0
  191. package/dist/workspace/release-steps/stamp.js +4 -0
  192. package/dist/workspace/release-steps/targets.d.ts +31 -0
  193. package/dist/workspace/release-steps/targets.js +40 -0
  194. package/dist/workspace/release-steps/types.d.ts +104 -0
  195. package/dist/workspace/release-steps/types.js +2 -0
  196. package/dist/workspace/release-steps/verify.d.ts +3 -0
  197. package/dist/workspace/release-steps/verify.js +4 -0
  198. package/dist/workspace/release-toolchains.d.ts +59 -0
  199. package/dist/workspace/release-toolchains.js +133 -0
  200. package/dist/workspace/release-train-workflow.d.ts +29 -0
  201. package/dist/workspace/release-train-workflow.js +85 -0
  202. package/dist/workspace/release-train.d.ts +3 -1
  203. package/dist/workspace/release-train.js +20 -3
  204. package/dist/workspace/release-workflow.d.ts +160 -61
  205. package/dist/workspace/release-workflow.js +539 -193
  206. package/dist/workspace/releases.schema.json +70 -1
  207. package/dist/workspace/search-contract.d.ts +1 -1
  208. package/dist/workspace/security.js +9 -2
  209. package/dist/workspace/train-cut.d.ts +182 -0
  210. package/dist/workspace/train-cut.js +482 -0
  211. package/dist/workspace/train-prepare.d.ts +61 -0
  212. package/dist/workspace/train-prepare.js +267 -0
  213. package/dist/workspace/train-publish.d.ts +177 -0
  214. package/dist/workspace/train-publish.js +575 -0
  215. package/dist/workspace/train-range-labels.d.ts +33 -0
  216. package/dist/workspace/train-range-labels.js +109 -0
  217. package/dist/workspace/trust/seal.d.ts +13 -3
  218. package/dist/workspace/trust/seal.js +14 -4
  219. package/dist/workspace/work-cli.d.ts +3 -2
  220. package/dist/workspace/work-cli.js +3 -2
  221. package/dist/workspace/workspace-ledger.d.ts +14 -1
  222. package/dist/workspace/workspace-ledger.js +33 -7
  223. package/package.json +1 -1
@@ -12,6 +12,13 @@
12
12
  * time (`releaseSealPayload`), and, when the declaration at that commit has an
13
13
  * `identity.gates.release` entry naming a class, the actor is in it.
14
14
  *
15
+ * The gate a cut claims (#5177): a cut signed by chant 0.124.101 or newer
16
+ * signs its green-gate record (`green`, `override`, `lane`) with the digest
17
+ * (`releaseGateSealPayload`, `sealVersion: 2`), so a verified signature
18
+ * vouches for the gate too, and `gate` reads `signed`. An older signature
19
+ * still verifies over its four lines, and its gate reads `unsigned`: the
20
+ * cut line's gate could have been changed after it was signed.
21
+ *
15
22
  * Reading the signers at the release's commit means a key added later does
16
23
  * not make an old release verify, and one removed later does not unmake it.
17
24
  */
@@ -64,9 +71,12 @@ export async function verifyRelease(req) {
64
71
  actor: c.actor,
65
72
  timestamp: c.timestamp,
66
73
  runId: c.runId ?? null,
67
- signatureCheck: atCommit(checkReleaseSignature(rule, { releaseDigest: c.releaseDigest, label: c.label, actor: c.actor, timestamp: c.timestamp, signature: c.signature })),
74
+ ...(c.green ? { green: c.green } : {}),
75
+ ...(c.override ? { override: c.override } : {}),
76
+ signatureCheck: atCommit(checkReleaseSignature(rule, c)),
68
77
  }));
69
- const verified = cuts.find((c) => c.signatureCheck.status === "verified");
78
+ // #5177: a verified cut whose signature covers its gate is the one to show, else any verified cut.
79
+ const verified = cuts.find((c) => c.signatureCheck.status === "verified" && c.signatureCheck.gate === "signed") ?? cuts.find((c) => c.signatureCheck.status === "verified");
70
80
  const digestMatches = verifyReleaseDigest(release);
71
81
  const status = verified ? "verified" : cuts.every((c) => c.signatureCheck.status === "unsigned") ? "unsigned" : "unverified";
72
82
  const where = `${rule.signers.signersPath} at ${at.slice(0, 12)}`;
@@ -87,6 +97,111 @@ export async function verifyRelease(req) {
87
97
  status: digestMatches ? status : "unverified",
88
98
  verifiedBy: digestMatches && verified ? { actor: verified.actor, key: verified.signatureCheck.key } : null,
89
99
  reason,
100
+ gate: gateOf(digestMatches ? verified : undefined),
90
101
  cuts,
91
102
  };
92
103
  }
104
+ /** How the gate of `verified`, the cut whose signature verified, reads (#5177). */
105
+ function gateOf(verified) {
106
+ if (!verified)
107
+ return { status: "unsigned", reason: "no cut's signature verifies, so nothing vouches for the gate a cut records" };
108
+ if (verified.signatureCheck.gate === "signed")
109
+ return { status: "signed", reason: `the green gate the cut by ${verified.actor} records is covered by its signature` };
110
+ return { status: "unsigned", reason: `the cut by ${verified.actor} was signed before chant signed the green gate, so its signature does not cover the gate the cut line records` };
111
+ }
112
+ /**
113
+ * The Sigstore bundles the publish record holds for `releaseDigest` (#5164):
114
+ * each signature or attestation item of the newest revealed line of each
115
+ * target, with its target's kind and name.
116
+ */
117
+ export async function recordedSignatures(cwd, releaseDigest) {
118
+ const { readPublishRecords } = await import("./publish-record.js");
119
+ const records = await readPublishRecords(releaseDigest, { cwd }).catch(() => []);
120
+ const newest = new Map();
121
+ for (const r of records)
122
+ if (r.step === "revealed")
123
+ newest.set(r.target, r);
124
+ return [...newest.values()].flatMap((r) => r.items.filter((i) => (i.attachment === "signature" || i.attachment === "attestation") && (i.signs?.length ?? 0) > 0).map((item) => ({ kind: r.kind, target: r.name, item })));
125
+ }
126
+ /**
127
+ * Check the Sigstore bundles a publish recorded for `releaseDigest`
128
+ * (#5164). An image's are read from its registry by cosign. A forge
129
+ * release's are read from `assetsDir`, where its assets were downloaded
130
+ * (such as `gh release download <tag> -D <dir>`): each bundle must be the
131
+ * bytes the record names, and a file beside it must be the digest it signs.
132
+ * The identity is `release.signing.identity` and `issuer` when the config
133
+ * names them, else the one the publish recorded: a workflow of the
134
+ * repository the publish ran in.
135
+ */
136
+ export async function verifySigstore(req) {
137
+ const { existsSync, readFileSync } = await import("node:fs");
138
+ const { join, resolve } = await import("node:path");
139
+ const { cosignVerifier } = await import("./publish-signing.js");
140
+ const { bytesDigest } = await import("./publish-targets.js");
141
+ const { loadChantConfig } = await import("../config.js");
142
+ const recorded = await recordedSignatures(req.cwd, req.releaseDigest);
143
+ if (recorded.length === 0)
144
+ return { status: "none", checks: [], reason: "the publish record holds no Sigstore signature for this release" };
145
+ const config = (await loadChantConfig(req.cwd).catch(() => null))?.config.release?.signing;
146
+ const pinned = typeof config === "object" ? config : {};
147
+ const verifier = req.verifier ?? cosignVerifier(req.env ?? process.env);
148
+ const missing = verifier.unavailable();
149
+ const checks = [];
150
+ for (const { kind, target, item } of recorded) {
151
+ const attachment = item.attachment;
152
+ const signs = item.signs ?? [];
153
+ const issuer = pinned.issuer ?? item.sigstore?.issuer;
154
+ const identity = pinned.identity ?? item.sigstore?.identity;
155
+ const id = issuer && identity ? { issuer, identity } : null;
156
+ const base = { name: item.name, kind, target, attachment, signs, identity: id };
157
+ const done = (status, reason) => checks.push({ ...base, status, reason });
158
+ if (!id) {
159
+ done("unchecked", "the record names no identity for it; set release.signing.identity and issuer");
160
+ continue;
161
+ }
162
+ if (missing) {
163
+ done("unchecked", missing);
164
+ continue;
165
+ }
166
+ if (kind === "oci") {
167
+ const ref = signs[0].name;
168
+ const why = attachment === "signature" ? await verifier.verifyImage(ref, id) : await verifier.verifyImageAttestation(ref, item.predicateType ?? "", id);
169
+ done(why ? "failed" : "verified", why ?? `${verifier.name} verified it on ${ref}`);
170
+ continue;
171
+ }
172
+ if (!req.assetsDir) {
173
+ done("unchecked", "it is a release asset; download the release's assets and pass --assets <dir>");
174
+ continue;
175
+ }
176
+ const file = join(resolve(req.assetsDir), item.name);
177
+ if (!existsSync(file)) {
178
+ done("unchecked", `${item.name} is not in ${req.assetsDir}`);
179
+ continue;
180
+ }
181
+ const bundle = new Uint8Array(readFileSync(file));
182
+ if (item.digest && bytesDigest(bundle) !== item.digest) {
183
+ done("failed", `${item.name} in ${req.assetsDir} is ${bytesDigest(bundle)}, and the publish uploaded ${item.digest}`);
184
+ continue;
185
+ }
186
+ const changed = signs.find((s) => existsSync(join(resolve(req.assetsDir), s.name)) && bytesDigest(new Uint8Array(readFileSync(join(resolve(req.assetsDir), s.name)))) !== s.digest);
187
+ if (changed) {
188
+ done("failed", `${changed.name} in ${req.assetsDir} is not the ${changed.digest} the release published`);
189
+ continue;
190
+ }
191
+ let why = null;
192
+ for (const s of signs) {
193
+ why = attachment === "signature" ? await verifier.verifyBlob(bundle, s.digest, id) : await verifier.verifyBlobAttestation(bundle, s.digest, item.predicateType ?? "", id);
194
+ if (why) {
195
+ why = `${s.name}: ${why}`;
196
+ break;
197
+ }
198
+ }
199
+ done(why ? "failed" : "verified", why ?? `${verifier.name} verified it for ${signs.map((s) => s.name).join(", ")}`);
200
+ }
201
+ const bad = checks.filter((c) => c.status !== "verified");
202
+ return {
203
+ status: bad.length === 0 ? "verified" : "failed",
204
+ checks,
205
+ reason: bad.length === 0 ? `${checks.length} Sigstore bundle(s) verified` : bad.map((c) => `${c.name} (${c.target}): ${c.status}, ${c.reason}`).join("; "),
206
+ };
207
+ }
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Stamping the release's label into manifests other than package.json (#5156).
3
+ *
4
+ * `release.version.files` names the files, each with a format chant knows
5
+ * (Cargo.toml, Cargo.lock, pyproject.toml, Chart.yaml, an MCP server.json,
6
+ * a krew plugin manifest, artifacthub-pkg.yml), a field path in a JSON, YAML
7
+ * or TOML file, or a regular expression. Every stamp is an edit in place:
8
+ * the file is scanned for the scalars it holds and only the text of the
9
+ * version scalars changes, so comments, key order, quoting and layout stay
10
+ * as committed. Nothing is parsed into a document and written back.
11
+ *
12
+ * The scanners below read the subset of each syntax a manifest uses: JSON
13
+ * in full, TOML in full but for multi-line inline tables, and YAML's block
14
+ * style (maps, sequences, plain and quoted scalars, block scalars skipped).
15
+ * A YAML flow collection is skipped, so a version inside one is reached
16
+ * with a `pattern` instead.
17
+ *
18
+ * This module reaches only Node's built-ins.
19
+ */
20
+ /** The manifest formats chant stamps by name. */
21
+ export declare const MANIFEST_FORMATS: readonly ["cargo", "cargo-lock", "pyproject", "helm", "mcp-server", "krew", "artifacthub"];
22
+ export type ManifestFormat = (typeof MANIFEST_FORMATS)[number];
23
+ /** A file whose format chant knows, by name or from its file name. */
24
+ export interface ManifestFile {
25
+ path: string;
26
+ /** Default from the file name: `Cargo.toml`, `Cargo.lock`, `pyproject.toml`, `Chart.yaml`, `server.json`, `artifacthub-pkg.yml`. A krew manifest names `krew`. */
27
+ format?: ManifestFormat;
28
+ /** `helm` and `artifacthub`: stamp `appVersion` too. */
29
+ appVersion?: boolean;
30
+ /** `cargo-lock`: the crates whose entries take the label. Default every crate of the Cargo workspace (an entry with no `source`). */
31
+ crates?: string[];
32
+ }
33
+ /** A field in a JSON, YAML or TOML file, by its dotted path: `version`, `spec.version`, `packages[].version`. */
34
+ export interface FieldFile {
35
+ path: string;
36
+ field: string;
37
+ /** Written before the label, such as `v`. */
38
+ prefix?: string;
39
+ }
40
+ /** A regular expression: each capture group of every match takes the label. */
41
+ export interface PatternFile {
42
+ path: string;
43
+ pattern: string;
44
+ /** Written before the label, such as `v`. */
45
+ prefix?: string;
46
+ }
47
+ export type ReleaseVersionFile = string | ManifestFile | FieldFile | PatternFile;
48
+ export declare class ManifestStampError extends Error {
49
+ readonly code: string;
50
+ readonly fix?: string | undefined;
51
+ constructor(code: string, message: string, fix?: string | undefined);
52
+ }
53
+ /** The path a `files` entry names. */
54
+ export declare function versionFilePath(entry: ReleaseVersionFile): string;
55
+ type Resolved = {
56
+ kind: "manifest";
57
+ format: ManifestFormat;
58
+ entry: ManifestFile;
59
+ } | {
60
+ kind: "field";
61
+ entry: FieldFile;
62
+ syntax: Syntax;
63
+ } | {
64
+ kind: "pattern";
65
+ entry: PatternFile;
66
+ re: RegExp;
67
+ };
68
+ type Syntax = "json" | "yaml" | "toml";
69
+ /** What an entry stamps, checked: a format known by name, a field in a file whose syntax the extension gives, or a pattern with a capture group. */
70
+ export declare function resolveVersionFile(entry: ReleaseVersionFile): Resolved;
71
+ /** One `files` entry's file, given its text, stamped with `label`. `file` is the path relative to the member. */
72
+ export declare function stampVersionFile(entry: ReleaseVersionFile, text: string, label: string): string;
73
+ export {};