@reelout/core 0.1.1 → 0.2.0

package/dist/analyzer.js

@@ -0,0 +1,38 @@
+import { a as version, ct as promotePrereleaseVersions, f as sliceUnreleased, h as resolvePackageTag, lt as analyzePackageChanges, m as propagateDependencyUpdates } from "./workflow-BoVmbvH6.js";
+//#region src/analyzer.ts
+/**
+* Built-in plugin that inspects repository history and produces release plans for packages.
+*
+* Stages:
+* - discover (enforce: post): when promoting, resolve package tags from the repository.
+* - analyze: initialize plans if empty, collect unreleased history, compute package changes,
+*   promote prerelease versions when promoting, and propagate dependency updates.
+*/
+var analyzer = () => ({
+	name: "@reelout/core/analyzer",
+	version,
+	discover: {
+		enforce: "post",
+		handler: async (context) => {
+			if (context.promote) context.packages = await Promise.all(context.packages.map(async (pkg) => ({
+				...pkg,
+				tag: await resolvePackageTag(context.cwd, pkg)
+			})));
+		}
+	},
+	analyze: async (context) => {
+		if (context.plans.length === 0) context.plans = context.packages.map((pkg) => ({
+			package: pkg,
+			history: [],
+			release: null
+		}));
+		const history = await sliceUnreleased(context.cwd);
+		context.plans = await analyzePackageChanges(context.classifier, context.plans, history);
+		if (context.promote) context.plans = await promotePrereleaseVersions(context.plans);
+		context.plans = await propagateDependencyUpdates(context.cwd, context.plans);
+	}
+});
+//#endregion
+export { analyzer as default };
+
+//# sourceMappingURL=analyzer.js.map

package/dist/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","names":[],"sources":["../src/analyzer.ts"],"sourcesContent":["// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\nimport type { Package, ReleasePlan, ReleasePlugin } from '#types'\nimport {\n  analyzePackageChanges,\n  promotePrereleaseVersions,\n  propagateDependencyUpdates,\n  resolvePackageTag,\n  sliceUnreleased,\n} from '#workflow'\nimport { version } from '../package.json'\n\n/**\n * Built-in plugin that inspects repository history and produces release plans for packages.\n *\n * Stages:\n * - discover (enforce: post): when promoting, resolve package tags from the repository.\n * - analyze: initialize plans if empty, collect unreleased history, compute package changes,\n *   promote prerelease versions when promoting, and propagate dependency updates.\n */\nconst analyzer = (): ReleasePlugin => ({\n  name: '@reelout/core/analyzer',\n  version,\n  discover: {\n    enforce: 'post',\n    handler: async (context) => {\n      if (context.promote) {\n        context.packages = await Promise.all(\n          context.packages.map(async (pkg): Promise<Package> => ({\n            ...pkg,\n            tag: await resolvePackageTag(context.cwd, pkg),\n          }))\n        )\n      }\n    },\n  },\n  analyze: async (context) => {\n    if (context.plans.length === 0) {\n      context.plans = context.packages.map((pkg): ReleasePlan => ({\n        package: pkg,\n        history: [],\n        release: null,\n      }))\n    }\n\n    const history = await sliceUnreleased(context.cwd)\n\n    context.plans = await analyzePackageChanges(\n      context.classifier,\n      context.plans,\n      history\n    )\n\n    if (context.promote) {\n      context.plans = await promotePrereleaseVersions(context.plans)\n    }\n\n    context.plans = await propagateDependencyUpdates(context.cwd, context.plans)\n  },\n})\n\nexport default analyzer\n"],"mappings":";;;;;;;;;;AAqBA,IAAM,kBAAiC;CACrC,MAAM;CACN;CACA,UAAU;EACR,SAAS;EACT,SAAS,OAAO,YAAY;GAC1B,IAAI,QAAQ,SACV,QAAQ,WAAW,MAAM,QAAQ,IAC/B,QAAQ,SAAS,IAAI,OAAO,SAA2B;IACrD,GAAG;IACH,KAAK,MAAM,kBAAkB,QAAQ,KAAK,GAAG;GAC/C,EAAE,CACJ;EAEJ;CACF;CACA,SAAS,OAAO,YAAY;EAC1B,IAAI,QAAQ,MAAM,WAAW,GAC3B,QAAQ,QAAQ,QAAQ,SAAS,KAAK,SAAsB;GAC1D,SAAS;GACT,SAAS,CAAC;GACV,SAAS;EACX,EAAE;EAGJ,MAAM,UAAU,MAAM,gBAAgB,QAAQ,GAAG;EAEjD,QAAQ,QAAQ,MAAM,sBACpB,QAAQ,YACR,QAAQ,OACR,OACF;EAEA,IAAI,QAAQ,SACV,QAAQ,QAAQ,MAAM,0BAA0B,QAAQ,KAAK;EAG/D,QAAQ,QAAQ,MAAM,2BAA2B,QAAQ,KAAK,QAAQ,KAAK;CAC7E;AACF"}

package/dist/builder.js

@@ -0,0 +1,52 @@
+import { Nt as bumpVersion, a as version, d as streamPackageCommits, g as resolvePackageStableTag, k as generateGitTagName, l as buildReleaseNotes } from "./workflow-BoVmbvH6.js";
+import { t as formatError } from "./formatError-BXNdyRfu.js";
+import { colors } from "consola/utils";
+//#region src/builder.ts
+/**
+* Built-in plugin that prepares release metadata for active plans.
+*
+* Stages:
+* - build: compute new package versions, generate git tag names, build changelogs,
+*   and attach tag messages (generate from changelog when available).
+*/
+var builder = () => ({
+	name: "@reelout/core/builder",
+	version,
+	build: async (context) => {
+		context.plans = await Promise.all(context.plans.map(async (plan) => {
+			plan = { ...plan };
+			if (!plan.release) return plan;
+			plan.release = { ...plan.release };
+			let version;
+			try {
+				version = bumpVersion(plan.package, plan.release.type, context.prereleaseLabel);
+			} catch (err) {
+				context.logger.warn(colors.yellow(`Version could not be determined for package at "${colors.bold(plan.package.dir)}": ${formatError(err)}`));
+			}
+			if (version) plan.release.version = version;
+			let tagName;
+			try {
+				tagName = generateGitTagName(plan.package.entry, plan.package.name, plan.release.version);
+			} catch (err) {
+				context.logger.warn(colors.yellow(`Tag could not be determined for package at "${colors.bold(plan.package.dir)}": ${formatError(err)}`));
+			}
+			let tagMessage;
+			try {
+				if (tagName) if (context.promote && plan.history.length === 0) {
+					const previousTag = (await resolvePackageStableTag(context.cwd, plan.package))?.name;
+					const history = streamPackageCommits(context.cwd, plan.package, { until: previousTag });
+					tagMessage = await buildReleaseNotes(context, history);
+				} else tagMessage = await buildReleaseNotes(context, plan.history);
+			} catch {}
+			if (tagName) plan.release.tag = {
+				name: tagName,
+				message: tagMessage
+			};
+			return plan;
+		}));
+	}
+});
+//#endregion
+export { builder as default };
+
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","names":[],"sources":["../src/builder.ts"],"sourcesContent":["// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\nimport { generateGitTagName } from '#git'\nimport type { ReleasePlan, ReleasePlugin } from '#types'\nimport { formatError } from '#util'\nimport {\n  buildReleaseNotes,\n  bumpVersion,\n  resolvePackageStableTag,\n  streamPackageCommits,\n} from '#workflow'\nimport { colors } from 'consola/utils'\nimport { version } from '../package.json'\n\n/**\n * Built-in plugin that prepares release metadata for active plans.\n *\n * Stages:\n * - build: compute new package versions, generate git tag names, build changelogs,\n *   and attach tag messages (generate from changelog when available).\n */\nconst builder = (): ReleasePlugin => ({\n  name: '@reelout/core/builder',\n  version,\n  build: async (context) => {\n    context.plans = await Promise.all(\n      context.plans.map(async (plan): Promise<ReleasePlan> => {\n        plan = { ...plan }\n\n        if (!plan.release) return plan\n\n        plan.release = { ...plan.release }\n\n        let version: string | null | undefined\n\n        try {\n          version = bumpVersion(\n            plan.package,\n            plan.release.type,\n            context.prereleaseLabel\n          )\n        } catch (err) {\n          context.logger.warn(\n            colors.yellow(\n              `Version could not be determined for package at \"${colors.bold(plan.package.dir)}\": ${formatError(err)}`\n            )\n          )\n        }\n\n        if (version) {\n          plan.release.version = version\n        }\n\n        let tagName: string | null | undefined\n\n        try {\n          tagName = generateGitTagName(\n            plan.package.entry,\n            plan.package.name,\n            plan.release.version\n          )\n        } catch (err) {\n          context.logger.warn(\n            colors.yellow(\n              `Tag could not be determined for package at \"${colors.bold(plan.package.dir)}\": ${formatError(err)}`\n            )\n          )\n        }\n\n        let tagMessage: string | undefined\n\n        try {\n          if (tagName) {\n            if (context.promote && plan.history.length === 0) {\n              const previousTag = (\n                await resolvePackageStableTag(context.cwd, plan.package)\n              )?.name\n\n              const history = streamPackageCommits(context.cwd, plan.package, {\n                until: previousTag,\n              })\n\n              tagMessage = await buildReleaseNotes(context, history)\n            } else {\n              tagMessage = await buildReleaseNotes(context, plan.history)\n            }\n          }\n        } catch {}\n\n        if (tagName) {\n          plan.release.tag = {\n            name: tagName,\n            message: tagMessage,\n          }\n        }\n\n        return plan\n      })\n    )\n  },\n})\n\nexport default builder\n"],"mappings":";;;;;;;;;;;AAsBA,IAAM,iBAAgC;CACpC,MAAM;CACN;CACA,OAAO,OAAO,YAAY;EACxB,QAAQ,QAAQ,MAAM,QAAQ,IAC5B,QAAQ,MAAM,IAAI,OAAO,SAA+B;GACtD,OAAO,EAAE,GAAG,KAAK;GAEjB,IAAI,CAAC,KAAK,SAAS,OAAO;GAE1B,KAAK,UAAU,EAAE,GAAG,KAAK,QAAQ;GAEjC,IAAI;GAEJ,IAAI;IACF,UAAU,YACR,KAAK,SACL,KAAK,QAAQ,MACb,QAAQ,eACV;GACF,SAAS,KAAK;IACZ,QAAQ,OAAO,KACb,OAAO,OACL,mDAAmD,OAAO,KAAK,KAAK,QAAQ,GAAG,EAAE,KAAK,YAAY,GAAG,GACvG,CACF;GACF;GAEA,IAAI,SACF,KAAK,QAAQ,UAAU;GAGzB,IAAI;GAEJ,IAAI;IACF,UAAU,mBACR,KAAK,QAAQ,OACb,KAAK,QAAQ,MACb,KAAK,QAAQ,OACf;GACF,SAAS,KAAK;IACZ,QAAQ,OAAO,KACb,OAAO,OACL,+CAA+C,OAAO,KAAK,KAAK,QAAQ,GAAG,EAAE,KAAK,YAAY,GAAG,GACnG,CACF;GACF;GAEA,IAAI;GAEJ,IAAI;IACF,IAAI,SACF,IAAI,QAAQ,WAAW,KAAK,QAAQ,WAAW,GAAG;KAChD,MAAM,eACJ,MAAM,wBAAwB,QAAQ,KAAK,KAAK,OAAO,EAAA,EACtD;KAEH,MAAM,UAAU,qBAAqB,QAAQ,KAAK,KAAK,SAAS,EAC9D,OAAO,YACT,CAAC;KAED,aAAa,MAAM,kBAAkB,SAAS,OAAO;IACvD,OACE,aAAa,MAAM,kBAAkB,SAAS,KAAK,OAAO;GAGhE,QAAQ,CAAC;GAET,IAAI,SACF,KAAK,QAAQ,MAAM;IACjB,MAAM;IACN,SAAS;GACX;GAGF,OAAO;EACT,CAAC,CACH;CACF;AACF"}

package/dist/changelog.js

@@ -0,0 +1,58 @@
+import { _ as discoverPackageTag, a as version, h as resolvePackageTag, o as writeChangelog, u as buildChangelog } from "./workflow-BoVmbvH6.js";
+import { t as formatError } from "./formatError-BXNdyRfu.js";
+import { colors } from "consola/utils";
+//#region src/changelog.ts
+/**
+* Built-in plugin that resolves package tags, generates changelogs, and writes changelog files.
+*
+* Stages:
+* - discover (enforce: post): resolve missing package tags from the repository.
+* - build: generate changelogs for planned releases (optionally using the previous tag)
+*   and attach tag messages derived from changelogs.
+* - write: persist changelog files for each plan (skipped in dry-run).
+*/
+var changelog = () => ({
+	name: "@reelout/core/changelog",
+	version,
+	discover: {
+		enforce: "post",
+		handler: async (context) => {
+			context.packages = await Promise.all(context.packages.map(async (pkg) => ({
+				...pkg,
+				tag: await resolvePackageTag(context.cwd, pkg)
+			})));
+		}
+	},
+	build: async (context) => {
+		context.plans = await Promise.all(context.plans.map(async (plan) => {
+			plan = { ...plan };
+			if (!plan.release) return plan;
+			if (!plan.release.version) return plan;
+			plan.release = { ...plan.release };
+			let changelog;
+			let previousTag = plan.package.tag?.name;
+			if (!previousTag) previousTag = (await discoverPackageTag(context.cwd, plan.package))?.name;
+			try {
+				changelog = await buildChangelog(context, plan.history, {
+					packageDir: plan.package.dir,
+					changelogFile: plan.package.changelogFile,
+					version: plan.release.version,
+					previousTag,
+					currentTag: plan.release.tag?.name
+				});
+			} catch (err) {
+				context.logger.warn(colors.yellow(`Changelog could not be generated for package at "${colors.bold(plan.package.dir)}": ${formatError(err)}`));
+			}
+			if (changelog) plan.release.changelog = changelog;
+			return plan;
+		}));
+	},
+	write: async (context) => {
+		if (context.dryRun) return;
+		for (const plan of context.plans) await writeChangelog(context.cwd, plan);
+	}
+});
+//#endregion
+export { changelog as default };
+
+//# sourceMappingURL=changelog.js.map

package/dist/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","names":[],"sources":["../src/changelog.ts"],"sourcesContent":["// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\nimport type { Package, ReleasePlugin } from '#types'\nimport { formatError } from '#util'\nimport {\n  buildChangelog,\n  discoverPackageTag,\n  resolvePackageTag,\n  writeChangelog,\n} from '#workflow'\nimport { colors } from 'consola/utils'\nimport { version } from '../package.json'\n\n/**\n * Built-in plugin that resolves package tags, generates changelogs, and writes changelog files.\n *\n * Stages:\n * - discover (enforce: post): resolve missing package tags from the repository.\n * - build: generate changelogs for planned releases (optionally using the previous tag)\n *   and attach tag messages derived from changelogs.\n * - write: persist changelog files for each plan (skipped in dry-run).\n */\nconst changelog = (): ReleasePlugin => ({\n  name: '@reelout/core/changelog',\n  version,\n  discover: {\n    enforce: 'post',\n    handler: async (context) => {\n      context.packages = await Promise.all(\n        context.packages.map(async (pkg): Promise<Package> => ({\n          ...pkg,\n          tag: await resolvePackageTag(context.cwd, pkg),\n        }))\n      )\n    },\n  },\n  build: async (context) => {\n    context.plans = await Promise.all(\n      context.plans.map(async (plan) => {\n        plan = { ...plan }\n\n        if (!plan.release) {\n          return plan\n        }\n\n        if (!plan.release.version) {\n          return plan\n        }\n\n        plan.release = { ...plan.release }\n\n        let changelog: string | null | undefined\n\n        let previousTag = plan.package.tag?.name\n\n        if (!previousTag) {\n          previousTag = (await discoverPackageTag(context.cwd, plan.package))\n            ?.name\n        }\n\n        try {\n          changelog = await buildChangelog(context, plan.history, {\n            packageDir: plan.package.dir,\n            changelogFile: plan.package.changelogFile,\n            version: plan.release.version,\n            previousTag,\n            currentTag: plan.release.tag?.name,\n          })\n        } catch (err) {\n          context.logger.warn(\n            colors.yellow(\n              `Changelog could not be generated for package at \"${colors.bold(plan.package.dir)}\": ${formatError(err)}`\n            )\n          )\n        }\n\n        if (changelog) {\n          plan.release.changelog = changelog\n        }\n\n        return plan\n      })\n    )\n  },\n  write: async (context) => {\n    if (context.dryRun) {\n      return\n    }\n\n    for (const plan of context.plans) {\n      await writeChangelog(context.cwd, plan)\n    }\n  },\n})\n\nexport default changelog\n"],"mappings":";;;;;;;;;;;;;AAuBA,IAAM,mBAAkC;CACtC,MAAM;CACN;CACA,UAAU;EACR,SAAS;EACT,SAAS,OAAO,YAAY;GAC1B,QAAQ,WAAW,MAAM,QAAQ,IAC/B,QAAQ,SAAS,IAAI,OAAO,SAA2B;IACrD,GAAG;IACH,KAAK,MAAM,kBAAkB,QAAQ,KAAK,GAAG;GAC/C,EAAE,CACJ;EACF;CACF;CACA,OAAO,OAAO,YAAY;EACxB,QAAQ,QAAQ,MAAM,QAAQ,IAC5B,QAAQ,MAAM,IAAI,OAAO,SAAS;GAChC,OAAO,EAAE,GAAG,KAAK;GAEjB,IAAI,CAAC,KAAK,SACR,OAAO;GAGT,IAAI,CAAC,KAAK,QAAQ,SAChB,OAAO;GAGT,KAAK,UAAU,EAAE,GAAG,KAAK,QAAQ;GAEjC,IAAI;GAEJ,IAAI,cAAc,KAAK,QAAQ,KAAK;GAEpC,IAAI,CAAC,aACH,eAAe,MAAM,mBAAmB,QAAQ,KAAK,KAAK,OAAO,EAAA,EAC7D;GAGN,IAAI;IACF,YAAY,MAAM,eAAe,SAAS,KAAK,SAAS;KACtD,YAAY,KAAK,QAAQ;KACzB,eAAe,KAAK,QAAQ;KAC5B,SAAS,KAAK,QAAQ;KACtB;KACA,YAAY,KAAK,QAAQ,KAAK;IAChC,CAAC;GACH,SAAS,KAAK;IACZ,QAAQ,OAAO,KACb,OAAO,OACL,oDAAoD,OAAO,KAAK,KAAK,QAAQ,GAAG,EAAE,KAAK,YAAY,GAAG,GACxG,CACF;GACF;GAEA,IAAI,WACF,KAAK,QAAQ,YAAY;GAG3B,OAAO;EACT,CAAC,CACH;CACF;CACA,OAAO,OAAO,YAAY;EACxB,IAAI,QAAQ,QACV;EAGF,KAAK,MAAM,QAAQ,QAAQ,OACzB,MAAM,eAAe,QAAQ,KAAK,IAAI;CAE1C;AACF"}

package/dist/formatError-BXNdyRfu.js

@@ -0,0 +1,23 @@
+//#region src/util/formatError.ts
+/**
+* Normalize an unknown thrown value for logging or display.
+*
+* - If `err` is an `Error`, returns its `message` string.
+* - Otherwise returns the original `err` value unchanged (may be a string,
+*   object, number, `null`, or `undefined`).
+*
+* This function intentionally does not coerce non-Error values to strings so
+* callers can decide how to render structured values.
+*
+* @param err The thrown value to normalize
+* @returns The error message when `err` is an `Error`, otherwise the original value
+*/
+function formatError(err) {
+	if (Error.isError(err)) return err.message;
+	if (typeof err === "string") return err;
+	return err;
+}
+//#endregion
+export { formatError as t };
+
+//# sourceMappingURL=formatError-BXNdyRfu.js.map

package/dist/formatError-BXNdyRfu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatError-BXNdyRfu.js","names":[],"sources":["../src/util/formatError.ts"],"sourcesContent":["// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\n/**\n * Normalize an unknown thrown value for logging or display.\n *\n * - If `err` is an `Error`, returns its `message` string.\n * - Otherwise returns the original `err` value unchanged (may be a string,\n *   object, number, `null`, or `undefined`).\n *\n * This function intentionally does not coerce non-Error values to strings so\n * callers can decide how to render structured values.\n *\n * @param err The thrown value to normalize\n * @returns The error message when `err` is an `Error`, otherwise the original value\n */\nexport function formatError<T>(err: T): T | string {\n  if (Error.isError(err)) return err.message\n  if (typeof err === 'string') return err\n  return err\n}\n"],"mappings":";;;;;;;;;;;;;;AAgBA,SAAgB,YAAe,KAAoB;CACjD,IAAI,MAAM,QAAQ,GAAG,GAAG,OAAO,IAAI;CACnC,IAAI,OAAO,QAAQ,UAAU,OAAO;CACpC,OAAO;AACT"}

package/dist/index.js

@@ -1 +1,175 @@
-export {};
+import { $ as GIT_PRETTY_FORMAT, A as ensureGitTag, At as deriveReleaseType, B as showParsedGitHistory, C as buildDependencyGraph, Ct as isSemVerGitTag, D as getGitTagMessage, Dt as RELEASE_LIFECYCLE_HOOK_LIST, E as getLatestGitTag, Et as GIT_TRAILER_RELEASE_AGENT, F as resolveGitRepository, G as detectGitRelationship, H as restoreFullGitHistory, I as pushGitChanges, J as withShallowLock, K as expandGitHistory, L as getGitRemote, M as deleteGitTag, Mt as determineReleaseType, N as createGitTag, Nt as bumpVersion, O as getCurrentGitTag, Ot as SEMVER_REGEX, P as readGitFile, Q as GIT_PRETTY_FIELD_SEPARATOR, R as ensureGitUserConfig, S as extractPlainText, St as buildTrailerPattern, T as isGitTagConnected, Tt as DEFAULT_CHANGELOG_FILE, U as mergeGitHistory, V as showGitHistory, W as GIT_REL_FLAGS, X as countGitHistory, Y as isGitShallowRepository, Z as getParsedCommit, _ as discoverPackageTag, _t as formatFile, at as extractMentions, b as iterateChangelogVersions, bt as compact, c as extractPreviousVersion, ct as promotePrereleaseVersions, d as streamPackageCommits, dt as resolveReleaseTarget, et as parseGitPrettyFormat, f as sliceUnreleased, ft as sanitizePrereleaseLabel, g as resolvePackageStableTag, gt as interpolate, h as resolvePackageTag, ht as isMatch, i as generateReleaseCommitMessage, it as resolveGitRevision, j as isGitTagPresent, jt as pickPriorityReleaseType, k as generateGitTagName, kt as isStableVersion, l as buildReleaseNotes, lt as analyzePackageChanges, m as propagateDependencyUpdates, mt as readJson, n as printReleaseReport, nt as TTLCache, o as writeChangelog, ot as createGitCommit, p as isReleaseCommit, pt as writeJson, q as isGitAncestor, r as generateReleaseReport, rt as getCurrentGitCommit, s as prependChangelog, st as getCurrentGitBranch, t as runWorkflow, tt as parseCommit, u as buildChangelog, ut as isCommitForPackage, v as verifyPackageTag, vt as execGit, w as isGitTagPointed, wt as ALL_FILES, x as extractSemVer, xt as isDefined, y as extractLatestVersion, yt as execCommand, z as getGitConfigValue } from "./workflow-BoVmbvH6.js";
+import { t as formatError } from "./formatError-BXNdyRfu.js";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+//#region src/config/normalizeCommitFilter.ts
+/**
+* Normalize a commit classifier into a consistent function.
+*
+* Accepts `null`/`undefined` (returns no-op classifier), a function classifier,
+* or a config object mapping commit types to release types. Returns a classifier
+* function that maps commits to their corresponding release types.
+*
+* @param classifier Commit classifier config, function, or falsy value
+* @returns Normalized classifier function
+*/
+function normalizeCommitFilter(classifier) {
+	if (classifier == null) return () => null;
+	if (typeof classifier === "function") return classifier;
+	const map = new Map(Object.entries(classifier).flatMap(([releaseType, commitTypes]) => {
+		return commitTypes.map((commitType) => [commitType, releaseType]);
+	}));
+	return (commit) => commit.type ? map.get(commit.type) : null;
+}
+//#endregion
+//#region src/config/normalizeReleaseRule.ts
+/**
+* Normalize a release rule for the given ref.
+*
+* If `rule` is `true`, derive the rule from the ref (branch or tag).
+* Falsy inputs return an empty rule.
+*
+* @param ref Current repository ref (branch or tag)
+* @param rule Rule input to normalize
+* @returns Normalized `ReleaseRule` object
+*/
+function normalizeReleaseRule(ref, rule) {
+	if (rule === true) switch (ref.type) {
+		case "branch": rule = ref.name.split("/").at(0);
+	}
+	if (!rule) rule = {};
+	if (typeof rule === "string") rule = {
+		prereleaseLabel: rule,
+		releaseChannel: rule
+	};
+	return {
+		type: rule.type || ref.type,
+		pattern: rule.pattern || ref.name,
+		prereleaseLabel: rule.prereleaseLabel,
+		releaseChannel: rule.releaseChannel
+	};
+}
+//#endregion
+//#region src/config/normalizeWorkspace.ts
+/**
+* Normalize and validate workspace configuration for a repository.
+*
+* Resolves the workspace entry directory relative to `cwd` and normalizes
+* the path representation. Returns a workspace object with normalized `entry`
+* and optional workspace members.
+*
+* @param cwd Repository working directory
+* @param workspace Partial workspace configuration (optional)
+* @returns Normalized workspace object
+*/
+function normalizeWorkspace(cwd, workspace) {
+	let entry = workspace?.entry || ".";
+	const members = workspace?.members ?? null;
+	entry = path.normalize(path.relative(cwd, path.resolve(cwd, entry)));
+	return {
+		entry,
+		members
+	};
+}
+//#endregion
+//#region src/config/resolvePlugin.ts
+/**
+* Resolve a plugin reference to a `ReleasePlugin` instance.
+*
+* Accepts a module specifier, a loaded plugin object, or an initializer
+* function (optionally with options) and normalizes it to a `ReleasePlugin`,
+* or `null` when resolution fails.
+*
+* @param cwd Base directory used to resolve module specifiers
+* @param plugin Plugin reference (module path, function, object, or [path, opts])
+* @returns Resolved `ReleasePlugin` or `null` when not resolvable
+*/
+async function resolvePlugin(cwd, plugin) {
+	let options;
+	if (Array.isArray(plugin)) [plugin, options] = plugin;
+	if (typeof plugin === "string") plugin = await import(createRequire(pathToFileURL(cwd)).resolve(plugin));
+	if (plugin != null && typeof plugin === "object" && Object.hasOwn(plugin, "default")) plugin = plugin.default;
+	if (typeof plugin === "function") plugin = plugin(options);
+	if (plugin != null && typeof plugin === "object" && Object.hasOwn(plugin, "name") && typeof plugin.name === "string") return plugin;
+	return null;
+}
+//#endregion
+//#region src/util/isCI.ts
+/**
+* Detect whether the current process is running in a CI environment.
+*
+* Returns true when the standard `CI` environment variable is set to a
+* truthy value. Explicit string values `"false"` and `"0"` are treated as
+* false to accommodate CI systems that expose `CI` but allow disabling it.
+*
+* This check is intentionally minimal and does not inspect provider-specific
+* environment variables (e.g., `GITHUB_ACTIONS`, `GITLAB_CI`). Callers that
+* need provider-level detail should check those variables separately.
+*
+* @returns `true` if running in CI; otherwise `false`
+*/
+function isCI() {
+	return !!(process.env.CI && process.env.CI !== "false" && process.env.CI !== "0");
+}
+//#endregion
+//#region src/util/unique.ts
+/**
+* Return a new array containing only the first-seen occurrence of each item.
+*
+* This preserves the original iteration order and performs equality checks
+* using JavaScript's `Set` semantics (i.e., primitives by value, objects by
+* reference). The input array is not mutated.
+*
+* @param array The array of items to deduplicate
+* @returns A new array with duplicates removed, preserving first-seen order
+*/
+function unique(array) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const item of array) if (!seen.has(item)) {
+		seen.add(item);
+		result.push(item);
+	}
+	return result;
+}
+//#endregion
+//#region src/workflow/discovery/sortPackages.ts
+/**
+* Sort workspace packages topologically based on their dependency graphs.
+*
+* Deepest dependents are placed first in the resulting array, ensuring that
+* a package always precedes its own dependencies. Ties and circular dependencies
+* are resolved deterministically using an alphabetical sort on the package directory (`dir`).
+*
+* @param packages The workspace packages to sort.
+* @returns A new array of packages sorted by dependency depth and directory path.
+*/
+function sortPackages(packages) {
+	const packageNodes = [];
+	const packageMap = /* @__PURE__ */ new Map();
+	for (const pkg of packages.toSorted((a, b) => a.dir.localeCompare(b.dir))) {
+		const node = {
+			package: pkg,
+			level: -1
+		};
+		packageNodes.push(node);
+		if (pkg.name) packageMap.set(pkg.name, node);
+	}
+	for (const node of packageNodes) visit(node);
+	function visit(node, level = 0, visited = /* @__PURE__ */ new Set()) {
+		if (node.level >= level) return;
+		if (visited.has(node)) return;
+		visited.add(node);
+		for (const depName of node.package.dependencies) {
+			const depNode = packageMap.get(depName);
+			if (depNode && depNode !== node) visit(depNode, level + 1, visited);
+		}
+		node.level = level;
+	}
+	return packageNodes.toSorted((a, b) => b.level - a.level).map((node) => node.package);
+}
+//#endregion
+export { ALL_FILES, DEFAULT_CHANGELOG_FILE, GIT_PRETTY_FIELD_SEPARATOR, GIT_PRETTY_FORMAT, GIT_REL_FLAGS, GIT_TRAILER_RELEASE_AGENT, RELEASE_LIFECYCLE_HOOK_LIST, SEMVER_REGEX, TTLCache, analyzePackageChanges, buildChangelog, buildDependencyGraph, buildReleaseNotes, buildTrailerPattern, bumpVersion, compact, countGitHistory, createGitCommit, createGitTag, deleteGitTag, deriveReleaseType, detectGitRelationship, determineReleaseType, discoverPackageTag, ensureGitTag, ensureGitUserConfig, execCommand, execGit, expandGitHistory, extractLatestVersion, extractMentions, extractPlainText, extractPreviousVersion, extractSemVer, formatError, formatFile, generateGitTagName, generateReleaseCommitMessage, generateReleaseReport, getCurrentGitBranch, getCurrentGitCommit, getCurrentGitTag, getGitConfigValue, getGitRemote, getGitTagMessage, getLatestGitTag, getParsedCommit, interpolate, isCI, isCommitForPackage, isDefined, isGitAncestor, isGitShallowRepository, isGitTagConnected, isGitTagPointed, isGitTagPresent, isMatch, isReleaseCommit, isSemVerGitTag, isStableVersion, iterateChangelogVersions, mergeGitHistory, normalizeCommitFilter, normalizeReleaseRule, normalizeWorkspace, parseCommit, parseGitPrettyFormat, pickPriorityReleaseType, prependChangelog, printReleaseReport, promotePrereleaseVersions, propagateDependencyUpdates, pushGitChanges, readGitFile, readJson, resolveGitRepository, resolveGitRevision, resolvePackageStableTag, resolvePackageTag, resolvePlugin, resolveReleaseTarget, restoreFullGitHistory, runWorkflow, sanitizePrereleaseLabel, showGitHistory, showParsedGitHistory, sliceUnreleased, sortPackages, streamPackageCommits, unique, verifyPackageTag, withShallowLock, writeChangelog, writeJson };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/config/normalizeCommitFilter.ts","../src/config/normalizeReleaseRule.ts","../src/config/normalizeWorkspace.ts","../src/config/resolvePlugin.ts","../src/util/isCI.ts","../src/util/unique.ts","../src/workflow/discovery/sortPackages.ts"],"sourcesContent":["// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\nimport type { CommitClassifier, ReleaseConfig, ReleaseType } from '#types'\n\n/**\n * Normalize a commit classifier into a consistent function.\n *\n * Accepts `null`/`undefined` (returns no-op classifier), a function classifier,\n * or a config object mapping commit types to release types. Returns a classifier\n * function that maps commits to their corresponding release types.\n *\n * @param classifier Commit classifier config, function, or falsy value\n * @returns Normalized classifier function\n */\nexport function normalizeCommitFilter(\n  classifier: ReleaseConfig['classifier'] | null | undefined\n): CommitClassifier {\n  if (classifier == null) {\n    return () => null\n  }\n\n  if (typeof classifier === 'function') {\n    return classifier\n  }\n\n  const map = new Map(\n    Object.entries(classifier).flatMap(([releaseType, commitTypes]) => {\n      return commitTypes.map((commitType) => [\n        commitType,\n        releaseType as ReleaseType,\n      ])\n    })\n  )\n\n  return (commit) => (commit.type ? map.get(commit.type) : null)\n}\n","// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\nimport type { ReleaseContext, ReleaseRule } from '#types'\n\n/**\n * Normalize a release rule for the given ref.\n *\n * If `rule` is `true`, derive the rule from the ref (branch or tag).\n * Falsy inputs return an empty rule.\n *\n * @param ref Current repository ref (branch or tag)\n * @param rule Rule input to normalize\n * @returns Normalized `ReleaseRule` object\n */\nexport function normalizeReleaseRule(\n  ref: ReleaseContext['ref'],\n  rule: boolean | string | Partial<ReleaseRule> | null | undefined\n): ReleaseRule {\n  if (rule === true) {\n    switch (ref.type) {\n      case 'branch':\n        rule = ref.name.split('/').at(0)\n        break\n    }\n  }\n\n  if (!rule) {\n    rule = {}\n  }\n\n  if (typeof rule === 'string') {\n    rule = { prereleaseLabel: rule, releaseChannel: rule }\n  }\n\n  return {\n    type: rule.type || ref.type,\n    pattern: rule.pattern || ref.name,\n    prereleaseLabel: rule.prereleaseLabel,\n    releaseChannel: rule.releaseChannel,\n  }\n}\n","// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\nimport type { Workspace } from '#types'\nimport path from 'node:path'\n\n/**\n * Normalize and validate workspace configuration for a repository.\n *\n * Resolves the workspace entry directory relative to `cwd` and normalizes\n * the path representation. Returns a workspace object with normalized `entry`\n * and optional workspace members.\n *\n * @param cwd Repository working directory\n * @param workspace Partial workspace configuration (optional)\n * @returns Normalized workspace object\n */\nexport function normalizeWorkspace(\n  cwd: string,\n  workspace?: {\n    entry?: string | null | undefined\n    members?: readonly string[] | null | undefined\n  }\n): Workspace {\n  let entry = workspace?.entry || '.'\n  const members = workspace?.members ?? null\n\n  entry = path.normalize(path.relative(cwd, path.resolve(cwd, entry)))\n\n  return {\n    entry,\n    members,\n  }\n}\n","// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\nimport type { ReleasePlugin } from '#types'\nimport { createRequire } from 'node:module'\nimport { pathToFileURL } from 'node:url'\n\n/**\n * Resolve a plugin reference to a `ReleasePlugin` instance.\n *\n * Accepts a module specifier, a loaded plugin object, or an initializer\n * function (optionally with options) and normalizes it to a `ReleasePlugin`,\n * or `null` when resolution fails.\n *\n * @param cwd Base directory used to resolve module specifiers\n * @param plugin Plugin reference (module path, function, object, or [path, opts])\n * @returns Resolved `ReleasePlugin` or `null` when not resolvable\n */\nexport async function resolvePlugin(\n  cwd: string,\n  plugin: unknown\n): Promise<ReleasePlugin | null> {\n  let options: unknown\n\n  if (Array.isArray(plugin)) {\n    ;[plugin, options] = plugin\n  }\n\n  if (typeof plugin === 'string') {\n    const require = createRequire(pathToFileURL(cwd))\n    plugin = await import(require.resolve(plugin))\n  }\n\n  if (\n    plugin != null &&\n    typeof plugin === 'object' &&\n    Object.hasOwn(plugin, 'default')\n  ) {\n    plugin = (plugin as { default: unknown }).default\n  }\n\n  if (typeof plugin === 'function') {\n    plugin = plugin(options)\n  }\n\n  if (\n    plugin != null &&\n    typeof plugin === 'object' &&\n    Object.hasOwn(plugin, 'name') &&\n    typeof (plugin as ReleasePlugin).name === 'string'\n  ) {\n    return plugin as ReleasePlugin\n  }\n\n  return null\n}\n","// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\n/**\n * Detect whether the current process is running in a CI environment.\n *\n * Returns true when the standard `CI` environment variable is set to a\n * truthy value. Explicit string values `\"false\"` and `\"0\"` are treated as\n * false to accommodate CI systems that expose `CI` but allow disabling it.\n *\n * This check is intentionally minimal and does not inspect provider-specific\n * environment variables (e.g., `GITHUB_ACTIONS`, `GITLAB_CI`). Callers that\n * need provider-level detail should check those variables separately.\n *\n * @returns `true` if running in CI; otherwise `false`\n */\nexport function isCI(): boolean {\n  return !!(\n    process.env.CI &&\n    process.env.CI !== 'false' &&\n    process.env.CI !== '0'\n  )\n}\n","// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\n/**\n * Return a new array containing only the first-seen occurrence of each item.\n *\n * This preserves the original iteration order and performs equality checks\n * using JavaScript's `Set` semantics (i.e., primitives by value, objects by\n * reference). The input array is not mutated.\n *\n * @param array The array of items to deduplicate\n * @returns A new array with duplicates removed, preserving first-seen order\n */\nexport function unique<T>(array: readonly T[]): T[] {\n  const seen = new Set<T>()\n  const result: T[] = []\n\n  for (const item of array) {\n    if (!seen.has(item)) {\n      seen.add(item)\n      result.push(item)\n    }\n  }\n\n  return result\n}\n","// SPDX-License-Identifier: MIT\n// Copyright (c) 2026 Fai\n\nimport type { Package } from '#types'\n\ninterface PackageNode {\n  package: Package\n  level: number\n}\n\n/**\n * Sort workspace packages topologically based on their dependency graphs.\n *\n * Deepest dependents are placed first in the resulting array, ensuring that\n * a package always precedes its own dependencies. Ties and circular dependencies\n * are resolved deterministically using an alphabetical sort on the package directory (`dir`).\n *\n * @param packages The workspace packages to sort.\n * @returns A new array of packages sorted by dependency depth and directory path.\n */\nexport function sortPackages(packages: readonly Package[]): Package[] {\n  const packageNodes: PackageNode[] = []\n  const packageMap = new Map<string, PackageNode>()\n\n  for (const pkg of packages.toSorted((a, b) => a.dir.localeCompare(b.dir))) {\n    const node: PackageNode = {\n      package: pkg,\n      level: -1,\n    }\n\n    packageNodes.push(node)\n\n    if (pkg.name) {\n      packageMap.set(pkg.name, node)\n    }\n  }\n\n  for (const node of packageNodes) {\n    visit(node)\n  }\n\n  function visit(\n    node: PackageNode,\n    level = 0,\n    visited = new Set<PackageNode>()\n  ): void {\n    if (node.level >= level) {\n      return\n    }\n\n    if (visited.has(node)) {\n      return\n    }\n\n    visited.add(node)\n\n    for (const depName of node.package.dependencies) {\n      const depNode = packageMap.get(depName)\n\n      if (depNode && depNode !== node) {\n        visit(depNode, level + 1, visited)\n      }\n    }\n\n    node.level = level\n  }\n\n  const sorted = packageNodes\n    .toSorted((a, b) => b.level - a.level)\n    .map((node) => node.package)\n\n  return sorted\n}\n"],"mappings":"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"}

package/dist/types-la_KkjCS.js

@@ -0,0 +1 @@
+export {};

package/dist/types.js

@@ -0,0 +1,2 @@
+import "./types-la_KkjCS.js";
+export {};