@skuba-lib/api 3.0.1 → 3.1.0-add-CDK.ensureAssetPlaceholders-20261027233644

package/lib/{git-BygvGOZr.mjs → git-DsCvTj_4.mjs}

@@ -1,11 +1,11 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-import { t as pathExists } from "./fs-Cjt5C6XD.mjs";
+import { t as __exportAll } from "./rolldown-runtime-D8jQpDG7.mjs";
+import { t as pathExists } from "./fs-Bac0LYeg.mjs";
 import fs from "fs-extra";
 import git, { findRoot } from "isomorphic-git";
 import path from "path";
 import ignoreFilter from "ignore";
 import http from "isomorphic-git/http/node";
-//#region src/git/commit.ts
+// src/git/commit.ts
 /**
 * Writes a commit to the local Git repository.
 */
@@ -16,8 +16,7 @@ const commit = async ({ author = { name: "skuba" }, committer = { name: "skuba"
 	fs,
 	message
 });
-//#endregion
-//#region src/git/findRoot.ts
+// src/git/findRoot.ts
 /**
 * Returns the first Git root directory encountered walking up from the provided
 * `dir`.
@@ -33,8 +32,7 @@ const findRoot$1 = async ({ dir }) => {
 		throw err;
 	}
 };
-//#endregion
-//#region src/git/getChangedFiles.ts
+// src/git/getChangedFiles.ts
 const mapState = (row) => {
 	if (row[1] === 0) return "added";
 	if (row[2] === 2) return "modified";
@@ -128,8 +126,7 @@ const createIsLfsFilter = async (gitRoot) => {
 	const filter = ignoreFilter().add((await fs.promises.readFile(lfsFile, "utf8")).split("\n").map((l) => l.trim()).filter((l) => !l.startsWith("#") && l.includes("filter=lfs")).map((l) => l.split(/\s+/)[0]).flatMap((l) => l ? [l] : []));
 	return (pathname) => filter.ignores(pathname);
 };
-//#endregion
-//#region src/git/commitAllChanges.ts
+// src/git/commitAllChanges.ts
 /**
 * Stages all changes and writes a commit to the local Git repository.
 */
@@ -160,8 +157,7 @@ const commitAllChanges = async ({ dir, message, author, committer, ignore }) =>
 		committer
 	});
 };
-//#endregion
-//#region src/git/currentBranch.ts
+// src/git/currentBranch.ts
 /**
 * Tries to return a Git branch name from CI environment variables.
 */
@@ -183,8 +179,7 @@ const currentBranch = async ({ dir, env = process.env } = {}) => {
 		fs
 	}) ?? void 0;
 };
-//#endregion
-//#region src/git/log.ts
+// src/git/log.ts
 const EMPTY_GIT_LOG_ERROR = /* @__PURE__ */ new Error("Git log does not contain any commits");
 /**
 * Gets the object ID of the head commit.
@@ -220,8 +215,7 @@ const getHeadCommitMessage = async ({ dir, env = process.env }) => {
 	if (!headResult) throw EMPTY_GIT_LOG_ERROR;
 	return headResult.commit.message;
 };
-//#endregion
-//#region src/git/remote.ts
+// src/git/remote.ts
 /**
 * Matches the owner and repository names in a GitHub repository URL.
 *
@@ -288,14 +282,12 @@ const getOwnerAndRepo = async ({ dir, env = process.env }) => {
 	}
 	throw new Error("Could not find a GitHub remote");
 };
-//#endregion
-//#region ../../src/utils/env.ts
+// ../../src/utils/env.ts
 /**
 * Whether the code is executing in a CI environment.
 */
 const isCiEnv = (env = process.env) => Boolean(env.BUILDKITE || env.CI || env.GITHUB_ACTIONS);
-//#endregion
-//#region src/github/environment.ts
+// src/github/environment.ts
 /**
 * Returns the name of the build as seen in GitHub status checks.
 *
@@ -317,8 +309,7 @@ const enabledFromEnvironment = (env = process.env) => isCiEnv(env) && Boolean(ap
 * Tries to return a GitHub API token from the environment.
 */
 const apiTokenFromEnvironment = (env = process.env) => env.GITHUB_API_TOKEN ?? env.GITHUB_TOKEN;
-//#endregion
-//#region src/git/push.ts
+// src/git/push.ts
 /**
 * Pushes the specified `ref` from the local Git repository to a remote.
 */
@@ -340,8 +331,7 @@ const push = async ({ auth, dir, ref, remote, remoteRef, force }) => {
 		force
 	});
 };
-//#endregion
-//#region src/git/pull.ts
+// src/git/pull.ts
 /**
 * Fast forwards the specified `ref` on the local Git repository to match the remote branch.
 */
@@ -363,8 +353,7 @@ const fastForwardBranch = async ({ auth, dir, ref, remote, remoteRef }) => {
 		singleBranch: true
 	});
 };
-//#endregion
-//#region src/git/reset.ts
+// src/git/reset.ts
 /**
 * Resets the specified branch in the local Git repository to a particular
 * commit.
@@ -385,15 +374,13 @@ const reset = async ({ dir, branch, commitId, hard }) => {
 		});
 	}
 };
-//#endregion
-//#region src/git/isFileGitIgnored.ts
+// src/git/isFileGitIgnored.ts
 const isFileGitIgnored = ({ absolutePath, gitRoot }) => git.isIgnored({
 	dir: gitRoot,
 	filepath: path.relative(gitRoot, absolutePath),
 	fs
 });
-//#endregion
-//#region src/git/index.ts
+// src/git/index.ts
 var git_exports = /* @__PURE__ */ __exportAll({
 	commit: () => commit,
 	commitAllChanges: () => commitAllChanges,
@@ -408,5 +395,4 @@ var git_exports = /* @__PURE__ */ __exportAll({
 	push: () => push,
 	reset: () => reset
 });
-//#endregion
 export { push as a, enabledFromEnvironment as c, getHeadCommitMessage as d, currentBranch as f, commit as g, findRoot$1 as h, fastForwardBranch as i, getOwnerAndRepo as l, getChangedFiles as m, isFileGitIgnored as n, apiTokenFromEnvironment as o, commitAllChanges as p, reset as r, buildNameFromEnvironment as s, git_exports as t, getHeadCommitId as u };

package/lib/github/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_git = require("../git-CSGc8r3Q.cjs");
-const require_github = require("../github-CuWb88m1.cjs");
+const require_git = require("../git-BOuG-9aF.cjs");
+const require_github = require("../github-CY8WyO3R.cjs");
 exports.apiTokenFromEnvironment = require_git.apiTokenFromEnvironment;
 exports.buildNameFromEnvironment = require_git.buildNameFromEnvironment;
 exports.createCheckRun = require_github.createCheckRun;

package/lib/github/index.d.cts

@@ -1,2 +1,2 @@
-import { a as putIssueComment, c as buildNameFromEnvironment, d as createCheckRun, i as uploadFileChanges, l as enabledFromEnvironment, n as readFileChanges, o as getPullRequestNumber, r as uploadAllFileChanges, s as apiTokenFromEnvironment, u as Annotation } from "../index--hWvZI6b.cjs";
+import { a as putIssueComment, c as buildNameFromEnvironment, d as createCheckRun, i as uploadFileChanges, l as enabledFromEnvironment, n as readFileChanges, o as getPullRequestNumber, r as uploadAllFileChanges, s as apiTokenFromEnvironment, u as Annotation } from "../index-ozhcNkrB.cjs";
 export { type Annotation, apiTokenFromEnvironment, buildNameFromEnvironment, createCheckRun, enabledFromEnvironment, getPullRequestNumber, putIssueComment, readFileChanges, uploadAllFileChanges, uploadFileChanges };

package/lib/github/index.d.mts

@@ -1,2 +1,2 @@
-import { a as putIssueComment, c as buildNameFromEnvironment, d as createCheckRun, i as uploadFileChanges, l as enabledFromEnvironment, n as readFileChanges, o as getPullRequestNumber, r as uploadAllFileChanges, s as apiTokenFromEnvironment, u as Annotation } from "../index-J0PI37zH.mjs";
+import { a as putIssueComment, c as buildNameFromEnvironment, d as createCheckRun, i as uploadFileChanges, l as enabledFromEnvironment, n as readFileChanges, o as getPullRequestNumber, r as uploadAllFileChanges, s as apiTokenFromEnvironment, u as Annotation } from "../index-BIoXUgOB.mjs";
 export { type Annotation, apiTokenFromEnvironment, buildNameFromEnvironment, createCheckRun, enabledFromEnvironment, getPullRequestNumber, putIssueComment, readFileChanges, uploadAllFileChanges, uploadFileChanges };

package/lib/github/index.mjs

@@ -1,3 +1,3 @@
-import { c as enabledFromEnvironment, o as apiTokenFromEnvironment, s as buildNameFromEnvironment } from "../git-BygvGOZr.mjs";
-import { a as putIssueComment, i as uploadFileChanges, n as readFileChanges, o as getPullRequestNumber, r as uploadAllFileChanges, s as createCheckRun } from "../github-BLyV25Ac.mjs";
+import { c as enabledFromEnvironment, o as apiTokenFromEnvironment, s as buildNameFromEnvironment } from "../git-DsCvTj_4.mjs";
+import { a as putIssueComment, i as uploadFileChanges, n as readFileChanges, o as getPullRequestNumber, r as uploadAllFileChanges, s as createCheckRun } from "../github-B_q9oeR0.mjs";
 export { apiTokenFromEnvironment, buildNameFromEnvironment, createCheckRun, enabledFromEnvironment, getPullRequestNumber, putIssueComment, readFileChanges, uploadAllFileChanges, uploadFileChanges };

package/lib/{github-BLyV25Ac.mjs → github-B_q9oeR0.mjs}

@@ -1,13 +1,12 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-import { n as pluralise } from "./logging-BQNEupxh.mjs";
-import { c as enabledFromEnvironment, h as findRoot, i as fastForwardBranch, l as getOwnerAndRepo, m as getChangedFiles, o as apiTokenFromEnvironment, s as buildNameFromEnvironment, u as getHeadCommitId } from "./git-BygvGOZr.mjs";
+import { t as __exportAll } from "./rolldown-runtime-D8jQpDG7.mjs";
+import { n as pluralise } from "./logging-BnwLxc05.mjs";
+import { c as enabledFromEnvironment, h as findRoot, i as fastForwardBranch, l as getOwnerAndRepo, m as getChangedFiles, o as apiTokenFromEnvironment, s as buildNameFromEnvironment, u as getHeadCommitId } from "./git-DsCvTj_4.mjs";
 import fs from "fs-extra";
 import path from "path";
-//#region src/github/octokit.ts
+// src/github/octokit.ts
 const createRestClient = async (options) => new (await (import("@octokit/rest"))).Octokit(options);
 const graphql = async (query, parameters) => (await import("@octokit/graphql")).graphql(query, parameters);
-//#endregion
-//#region src/github/checkRun.ts
+// src/github/checkRun.ts
 const GITHUB_MAX_ANNOTATIONS = 50;
 /**
 * Suffixes the title with the number of annotations added, e.g.
@@ -31,11 +30,12 @@ const createEnrichedSummary = (summary, inputAnnotations) => [summary, ...inputA
 * A `GITHUB_API_TOKEN` or `GITHUB_TOKEN` with the `checks:write` permission
 * must be present on the environment.
 */
-const createCheckRun = async ({ annotations, conclusion, name, summary, text, title }) => {
+const createCheckRun = async ({ annotations, conclusion, detailsUrl, name, summary, text, title }) => {
 	const dir = process.cwd();
 	const [commitId, { owner, repo }] = await Promise.all([getHeadCommitId({ dir }), getOwnerAndRepo({ dir })]);
 	await (await createRestClient({ auth: apiTokenFromEnvironment() })).checks.create({
 		conclusion,
+		details_url: detailsUrl,
 		head_sha: commitId,
 		name,
 		output: {
@@ -48,8 +48,7 @@ const createCheckRun = async ({ annotations, conclusion, name, summary, text, ti
 		repo
 	});
 };
-//#endregion
-//#region src/github/pullRequest.ts
+// src/github/pullRequest.ts
 /**
 * Gets the number of the current pull request.
 *
@@ -76,8 +75,7 @@ const getPullRequestNumber = async (params = {}) => {
 	if (!pullRequestData) throw new Error(`Commit ${commitId} is not associated with an open GitHub pull request`);
 	return pullRequestData.number;
 };
-//#endregion
-//#region src/github/issueComment.ts
+// src/github/issueComment.ts
 const getUserId = async (client) => {
 	const { data } = await client.users.getAuthenticated();
 	return data.id;
@@ -133,8 +131,7 @@ const putIssueComment = async (params) => {
 		repo
 	}))).data.id };
 };
-//#endregion
-//#region src/github/push.ts
+// src/github/push.ts
 /**
 * Retrieves all file changes from the local Git repository using
 * `getChangedFiles`, then uploads the changes to a specified GitHub branch
@@ -237,8 +234,7 @@ const uploadFileChanges = async ({ dir, branch, messageHeadline, messageBody, fi
 		headers: { authorization: `Bearer ${authToken}` }
 	})).createCommitOnBranch.commit.oid;
 };
-//#endregion
-//#region src/github/index.ts
+// src/github/index.ts
 var github_exports = /* @__PURE__ */ __exportAll({
 	apiTokenFromEnvironment: () => apiTokenFromEnvironment,
 	buildNameFromEnvironment: () => buildNameFromEnvironment,
@@ -250,5 +246,4 @@ var github_exports = /* @__PURE__ */ __exportAll({
 	uploadAllFileChanges: () => uploadAllFileChanges,
 	uploadFileChanges: () => uploadFileChanges
 });
-//#endregion
 export { putIssueComment as a, uploadFileChanges as i, readFileChanges as n, getPullRequestNumber as o, uploadAllFileChanges as r, createCheckRun as s, github_exports as t };

package/lib/{github-CuWb88m1.cjs → github-CY8WyO3R.cjs}

@@ -1,15 +1,14 @@
-const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
-const require_logging = require("./logging-BqpzZfsF.cjs");
-const require_git = require("./git-CSGc8r3Q.cjs");
+const require_rolldown_runtime = require("./rolldown-runtime-BW-eSwOZ.cjs");
+const require_logging = require("./logging-DlMiOLHo.cjs");
+const require_git = require("./git-BOuG-9aF.cjs");
 let fs_extra = require("fs-extra");
 fs_extra = require_rolldown_runtime.__toESM(fs_extra, 1);
 let path = require("path");
 path = require_rolldown_runtime.__toESM(path, 1);
-//#region src/github/octokit.ts
+// src/github/octokit.ts
 const createRestClient = async (options) => new (await (import("@octokit/rest"))).Octokit(options);
 const graphql = async (query, parameters) => (await import("@octokit/graphql")).graphql(query, parameters);
-//#endregion
-//#region src/github/checkRun.ts
+// src/github/checkRun.ts
 const GITHUB_MAX_ANNOTATIONS = 50;
 /**
 * Suffixes the title with the number of annotations added, e.g.
@@ -33,11 +32,12 @@ const createEnrichedSummary = (summary, inputAnnotations) => [summary, ...inputA
 * A `GITHUB_API_TOKEN` or `GITHUB_TOKEN` with the `checks:write` permission
 * must be present on the environment.
 */
-const createCheckRun = async ({ annotations, conclusion, name, summary, text, title }) => {
+const createCheckRun = async ({ annotations, conclusion, detailsUrl, name, summary, text, title }) => {
 	const dir = process.cwd();
 	const [commitId, { owner, repo }] = await Promise.all([require_git.getHeadCommitId({ dir }), require_git.getOwnerAndRepo({ dir })]);
 	await (await createRestClient({ auth: require_git.apiTokenFromEnvironment() })).checks.create({
 		conclusion,
+		details_url: detailsUrl,
 		head_sha: commitId,
 		name,
 		output: {
@@ -50,8 +50,7 @@ const createCheckRun = async ({ annotations, conclusion, name, summary, text, ti
 		repo
 	});
 };
-//#endregion
-//#region src/github/pullRequest.ts
+// src/github/pullRequest.ts
 /**
 * Gets the number of the current pull request.
 *
@@ -78,8 +77,7 @@ const getPullRequestNumber = async (params = {}) => {
 	if (!pullRequestData) throw new Error(`Commit ${commitId} is not associated with an open GitHub pull request`);
 	return pullRequestData.number;
 };
-//#endregion
-//#region src/github/issueComment.ts
+// src/github/issueComment.ts
 const getUserId = async (client) => {
 	const { data } = await client.users.getAuthenticated();
 	return data.id;
@@ -135,8 +133,7 @@ const putIssueComment = async (params) => {
 		repo
 	}))).data.id };
 };
-//#endregion
-//#region src/github/push.ts
+// src/github/push.ts
 /**
 * Retrieves all file changes from the local Git repository using
 * `getChangedFiles`, then uploads the changes to a specified GitHub branch
@@ -239,8 +236,7 @@ const uploadFileChanges = async ({ dir, branch, messageHeadline, messageBody, fi
 		headers: { authorization: `Bearer ${authToken}` }
 	})).createCommitOnBranch.commit.oid;
 };
-//#endregion
-//#region src/github/index.ts
+// src/github/index.ts
 var github_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	apiTokenFromEnvironment: () => require_git.apiTokenFromEnvironment,
 	buildNameFromEnvironment: () => require_git.buildNameFromEnvironment,
@@ -252,7 +248,6 @@ var github_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	uploadAllFileChanges: () => uploadAllFileChanges,
 	uploadFileChanges: () => uploadFileChanges
 });
-//#endregion
 Object.defineProperty(exports, "createCheckRun", {
 	enumerable: true,
 	get: function() {

package/lib/{index-J0PI37zH.d.mts → index-BIoXUgOB.d.mts}

@@ -1,7 +1,6 @@
-import { f as ChangedFile, t as index_d_exports$1 } from "./index-CLEYcnJY.mjs";
+import { f as ChangedFile } from "./index-CX5l1M9F.mjs";
 import { Endpoints } from "@octokit/types";
 import { Octokit } from "@octokit/rest";
-//#region src/github/checkRun.d.ts
 type Output = NonNullable<Endpoints['PATCH /repos/{owner}/{repo}/check-runs/{check_run_id}']['parameters']['output']>;
 type Annotation = NonNullable<Output['annotations']>[number];
 /**
@@ -18,6 +17,12 @@ interface CreateCheckRunParameters {
    * The final conclusion of the check.
    */
   conclusion: 'failure' | 'success';
+  /**
+   * A URL that links to the full details of the check, such as a CI build.
+   *
+   * Defaults to the homepage of the GitHub App that created the check run.
+   */
+  detailsUrl?: string;
   /**
    * The name of the check. For example, "code-coverage".
    */
@@ -43,9 +48,7 @@ interface CreateCheckRunParameters {
  * A `GITHUB_API_TOKEN` or `GITHUB_TOKEN` with the `checks:write` permission
  * must be present on the environment.
  */
-declare const createCheckRun: ({ annotations, conclusion, name, summary, text, title }: CreateCheckRunParameters) => Promise<void>;
-//#endregion
-//#region src/github/environment.d.ts
+declare const createCheckRun: ({ annotations, conclusion, detailsUrl, name, summary, text, title }: CreateCheckRunParameters) => Promise<void>;
 /**
  * Returns the name of the build as seen in GitHub status checks.
  *
@@ -63,8 +66,6 @@ declare const enabledFromEnvironment: (env?: NodeJS.ProcessEnv) => boolean;
  * Tries to return a GitHub API token from the environment.
  */
 declare const apiTokenFromEnvironment: (env?: NodeJS.ProcessEnv) => string | undefined;
-//#endregion
-//#region src/github/pullRequest.d.ts
 interface GetPullRequestParameters {
   /**
    * A preconstructed Octokit client to interact with GitHub's APIs.
@@ -84,8 +85,6 @@ interface GetPullRequestParameters {
  * associated pull requests, or if they are all closed or locked.
  */
 declare const getPullRequestNumber: (params?: GetPullRequestParameters) => Promise<number>;
-//#endregion
-//#region src/github/issueComment.d.ts
 /**
  * https://docs.github.com/en/rest/reference/issues#create-an-issue-comment
  */
@@ -146,8 +145,6 @@ interface IssueComment {
  * on the environment.
  */
 declare const putIssueComment: (params: PutIssueCommentParameters) => Promise<IssueComment | null>;
-//#endregion
-//#region src/github/push.d.ts
 interface UploadAllFileChangesParams {
   dir: string;
   /**
@@ -234,5 +231,4 @@ declare const uploadFileChanges: ({ dir, branch, messageHeadline, messageBody, f
 declare namespace index_d_exports {
   export { Annotation, apiTokenFromEnvironment, buildNameFromEnvironment, createCheckRun, enabledFromEnvironment, getPullRequestNumber, putIssueComment, readFileChanges, uploadAllFileChanges, uploadFileChanges };
 }
-//#endregion
 export { putIssueComment as a, buildNameFromEnvironment as c, createCheckRun as d, uploadFileChanges as i, enabledFromEnvironment as l, readFileChanges as n, getPullRequestNumber as o, uploadAllFileChanges as r, apiTokenFromEnvironment as s, index_d_exports as t, Annotation as u };

package/lib/{index-BKHTGdUP.d.cts → index-BqaQKTmE.d.cts}

@@ -1,5 +1,4 @@
 import { Plugin } from "rolldown";
-//#region src/rolldown/lambdaAsset.d.ts
 interface LambdaAssetFile {
   /**
    * Path to the file or directory to copy, resolved relative to `projectRoot`.
@@ -93,5 +92,4 @@ declare const lambdaAsset: ({ nodeModules, assets, projectRoot: projectRootOptio
 declare namespace index_d_exports {
   export { LambdaAssetFile, LambdaAssetOptions, lambdaAsset };
 }
-//#endregion
 export { lambdaAsset as i, LambdaAssetFile as n, LambdaAssetOptions as r, index_d_exports as t };

package/lib/{index-BKHTGdUP.d.mts → index-BqaQKTmE.d.mts}

@@ -1,5 +1,4 @@
 import { Plugin } from "rolldown";
-//#region src/rolldown/lambdaAsset.d.ts
 interface LambdaAssetFile {
   /**
    * Path to the file or directory to copy, resolved relative to `projectRoot`.
@@ -93,5 +92,4 @@ declare const lambdaAsset: ({ nodeModules, assets, projectRoot: projectRootOptio
 declare namespace index_d_exports {
   export { LambdaAssetFile, LambdaAssetOptions, lambdaAsset };
 }
-//#endregion
 export { lambdaAsset as i, LambdaAssetFile as n, LambdaAssetOptions as r, index_d_exports as t };

package/lib/{index-CLEYcnJY.d.cts → index-CX5l1M9F.d.cts}

@@ -1,4 +1,3 @@
-//#region src/git/commit.d.ts
 interface Identity {
   email?: string;
   name?: string;
@@ -13,8 +12,6 @@ interface CommitParameters {
  * Writes a commit to the local Git repository.
  */
 declare const commit: ({ author, committer, dir, message }: CommitParameters) => Promise<string>;
-//#endregion
-//#region src/git/getChangedFiles.d.ts
 type ChangedFileState = 'added' | 'modified' | 'deleted';
 interface ChangedFile {
   path: string;
@@ -53,8 +50,6 @@ type ChangedFilesParameters = {
  * the changes between `src` and `dst` references.
  */
 declare const getChangedFiles: ({ dir, src, dst, ignore }: ChangedFilesParameters) => Promise<ChangedFile[]>;
-//#endregion
-//#region src/git/commitAllChanges.d.ts
 interface CommitAllParameters {
   dir: string;
   message: string;
@@ -71,8 +66,6 @@ interface CommitAllParameters {
  * Stages all changes and writes a commit to the local Git repository.
  */
 declare const commitAllChanges: ({ dir, message, author, committer, ignore }: CommitAllParameters) => Promise<string | undefined>;
-//#endregion
-//#region src/git/currentBranch.d.ts
 interface CurrentBranchParameters {
   dir?: string;
   env?: Record<string, string | undefined>;
@@ -82,8 +75,6 @@ interface CurrentBranchParameters {
  * to the local Git repository when the current working `dir` is supplied.
  */
 declare const currentBranch: ({ dir, env }?: CurrentBranchParameters) => Promise<string | undefined>;
-//#endregion
-//#region src/git/findRoot.d.ts
 interface FindRootParameters {
   dir: string;
 }
@@ -92,8 +83,6 @@ interface FindRootParameters {
  * `dir`.
  */
 declare const findRoot: ({ dir }: FindRootParameters) => Promise<string | null>;
-//#endregion
-//#region src/git/log.d.ts
 interface GetHeadCommitParameters {
   dir: string;
   env?: Record<string, string | undefined>;
@@ -112,8 +101,6 @@ declare const getHeadCommitId: ({ dir, env }: GetHeadCommitParameters) => Promis
  * and falls back to the local Git repository log.
  */
 declare const getHeadCommitMessage: ({ dir, env }: GetHeadCommitParameters) => Promise<string>;
-//#endregion
-//#region src/git/remote.d.ts
 interface GetOwnerAndRepoParameters {
   dir: string;
   env?: Record<string, string | undefined>;
@@ -133,8 +120,6 @@ declare const getOwnerAndRepo: ({ dir, env }: GetOwnerAndRepoParameters) => Prom
   owner: string;
   repo: string;
 }>;
-//#endregion
-//#region src/git/push.d.ts
 /**
  * Use a GitHub app token to auth the Git push.
  *
@@ -186,8 +171,6 @@ interface PushResult {
  * Pushes the specified `ref` from the local Git repository to a remote.
  */
 declare const push: ({ auth, dir, ref, remote, remoteRef, force }: PushParameters) => Promise<PushResult>;
-//#endregion
-//#region src/git/pull.d.ts
 /**
  * Use a GitHub app token to auth the Git push.
  *
@@ -222,8 +205,6 @@ interface PullParameters {
  * Fast forwards the specified `ref` on the local Git repository to match the remote branch.
  */
 declare const fastForwardBranch: ({ auth, dir, ref, remote, remoteRef }: PullParameters) => Promise<void>;
-//#endregion
-//#region src/git/reset.d.ts
 interface ResetParameters {
   dir: string;
   branch: string;
@@ -235,8 +216,6 @@ interface ResetParameters {
  * commit.
  */
 declare const reset: ({ dir, branch, commitId, hard }: ResetParameters) => Promise<void>;
-//#endregion
-//#region src/git/isFileGitIgnored.d.ts
 declare const isFileGitIgnored: ({ absolutePath, gitRoot }: {
   absolutePath: string;
   gitRoot: string;
@@ -244,5 +223,4 @@ declare const isFileGitIgnored: ({ absolutePath, gitRoot }: {
 declare namespace index_d_exports {
   export { ChangedFile, commit, commitAllChanges, currentBranch, fastForwardBranch, findRoot, getChangedFiles, getHeadCommitId, getHeadCommitMessage, getOwnerAndRepo, isFileGitIgnored, push, reset };
 }
-//#endregion
 export { push as a, getHeadCommitMessage as c, commitAllChanges as d, ChangedFile as f, fastForwardBranch as i, findRoot as l, commit as m, isFileGitIgnored as n, getOwnerAndRepo as o, getChangedFiles as p, reset as r, getHeadCommitId as s, index_d_exports as t, currentBranch as u };

package/lib/{index-CLEYcnJY.d.mts → index-CX5l1M9F.d.mts}

@@ -1,4 +1,3 @@
-//#region src/git/commit.d.ts
 interface Identity {
   email?: string;
   name?: string;
@@ -13,8 +12,6 @@ interface CommitParameters {
  * Writes a commit to the local Git repository.
  */
 declare const commit: ({ author, committer, dir, message }: CommitParameters) => Promise<string>;
-//#endregion
-//#region src/git/getChangedFiles.d.ts
 type ChangedFileState = 'added' | 'modified' | 'deleted';
 interface ChangedFile {
   path: string;
@@ -53,8 +50,6 @@ type ChangedFilesParameters = {
  * the changes between `src` and `dst` references.
  */
 declare const getChangedFiles: ({ dir, src, dst, ignore }: ChangedFilesParameters) => Promise<ChangedFile[]>;
-//#endregion
-//#region src/git/commitAllChanges.d.ts
 interface CommitAllParameters {
   dir: string;
   message: string;
@@ -71,8 +66,6 @@ interface CommitAllParameters {
  * Stages all changes and writes a commit to the local Git repository.
  */
 declare const commitAllChanges: ({ dir, message, author, committer, ignore }: CommitAllParameters) => Promise<string | undefined>;
-//#endregion
-//#region src/git/currentBranch.d.ts
 interface CurrentBranchParameters {
   dir?: string;
   env?: Record<string, string | undefined>;
@@ -82,8 +75,6 @@ interface CurrentBranchParameters {
  * to the local Git repository when the current working `dir` is supplied.
  */
 declare const currentBranch: ({ dir, env }?: CurrentBranchParameters) => Promise<string | undefined>;
-//#endregion
-//#region src/git/findRoot.d.ts
 interface FindRootParameters {
   dir: string;
 }
@@ -92,8 +83,6 @@ interface FindRootParameters {
  * `dir`.
  */
 declare const findRoot: ({ dir }: FindRootParameters) => Promise<string | null>;
-//#endregion
-//#region src/git/log.d.ts
 interface GetHeadCommitParameters {
   dir: string;
   env?: Record<string, string | undefined>;
@@ -112,8 +101,6 @@ declare const getHeadCommitId: ({ dir, env }: GetHeadCommitParameters) => Promis
  * and falls back to the local Git repository log.
  */
 declare const getHeadCommitMessage: ({ dir, env }: GetHeadCommitParameters) => Promise<string>;
-//#endregion
-//#region src/git/remote.d.ts
 interface GetOwnerAndRepoParameters {
   dir: string;
   env?: Record<string, string | undefined>;
@@ -133,8 +120,6 @@ declare const getOwnerAndRepo: ({ dir, env }: GetOwnerAndRepoParameters) => Prom
   owner: string;
   repo: string;
 }>;
-//#endregion
-//#region src/git/push.d.ts
 /**
  * Use a GitHub app token to auth the Git push.
  *
@@ -186,8 +171,6 @@ interface PushResult {
  * Pushes the specified `ref` from the local Git repository to a remote.
  */
 declare const push: ({ auth, dir, ref, remote, remoteRef, force }: PushParameters) => Promise<PushResult>;
-//#endregion
-//#region src/git/pull.d.ts
 /**
  * Use a GitHub app token to auth the Git push.
  *
@@ -222,8 +205,6 @@ interface PullParameters {
  * Fast forwards the specified `ref` on the local Git repository to match the remote branch.
  */
 declare const fastForwardBranch: ({ auth, dir, ref, remote, remoteRef }: PullParameters) => Promise<void>;
-//#endregion
-//#region src/git/reset.d.ts
 interface ResetParameters {
   dir: string;
   branch: string;
@@ -235,8 +216,6 @@ interface ResetParameters {
  * commit.
  */
 declare const reset: ({ dir, branch, commitId, hard }: ResetParameters) => Promise<void>;
-//#endregion
-//#region src/git/isFileGitIgnored.d.ts
 declare const isFileGitIgnored: ({ absolutePath, gitRoot }: {
   absolutePath: string;
   gitRoot: string;
@@ -244,5 +223,4 @@ declare const isFileGitIgnored: ({ absolutePath, gitRoot }: {
 declare namespace index_d_exports {
   export { ChangedFile, commit, commitAllChanges, currentBranch, fastForwardBranch, findRoot, getChangedFiles, getHeadCommitId, getHeadCommitMessage, getOwnerAndRepo, isFileGitIgnored, push, reset };
 }
-//#endregion
 export { push as a, getHeadCommitMessage as c, commitAllChanges as d, ChangedFile as f, fastForwardBranch as i, findRoot as l, commit as m, isFileGitIgnored as n, getOwnerAndRepo as o, getChangedFiles as p, reset as r, getHeadCommitId as s, index_d_exports as t, currentBranch as u };

package/lib/index-DP8zjEgM.d.cts

@@ -0,0 +1,8 @@
+declare namespace index_d_exports {
+  export { ensureAssetPlaceholders, normaliseTemplate };
+}
+declare const normaliseTemplate: (template: object) => unknown;
+declare const ensureAssetPlaceholders: (dirs: readonly string[], { cwd }?: {
+  cwd?: string;
+}) => void;
+export { index_d_exports as n, normaliseTemplate as r, ensureAssetPlaceholders as t };

package/lib/index-DP8zjEgM.d.mts

@@ -0,0 +1,8 @@
+declare namespace index_d_exports {
+  export { ensureAssetPlaceholders, normaliseTemplate };
+}
+declare const normaliseTemplate: (template: object) => unknown;
+declare const ensureAssetPlaceholders: (dirs: readonly string[], { cwd }?: {
+  cwd?: string;
+}) => void;
+export { index_d_exports as n, normaliseTemplate as r, ensureAssetPlaceholders as t };

package/lib/{index-CNxgBJm_.d.cts → index-DhV1vmV_.d.cts}

@@ -1,4 +1,3 @@
-//#region src/buildkite/annotate.d.ts
 type AnnotationStyle = 'success' | 'info' | 'warning' | 'error';
 interface AnnotationOptions {
   context?: string;
@@ -24,8 +23,6 @@ interface AnnotationOptions {
  * The `buildkite-agent` binary must also be on your `PATH`.
  */
 declare const annotate: (markdown: string, opts?: AnnotationOptions) => Promise<void>;
-//#endregion
-//#region src/buildkite/md.d.ts
 /**
  * @internal
  */
@@ -35,5 +32,4 @@ declare const md: {
 declare namespace index_d_exports {
   export { AnnotationStyle, annotate, md };
 }
-//#endregion
 export { annotate as i, md as n, AnnotationStyle as r, index_d_exports as t };