beez-rp 0.1.1

package/src/testing.js

@@ -0,0 +1,70 @@
+/**
+ * Version bump fixtures for the test suites of every repository that uses
+ * `beez-rp`, so `create-version`, the Vercel build gate and any custom release
+ * command are checked against the same rule: from a stable version only the
+ * next patch, minor or major is allowed.
+ *
+ * @module testing
+ */
+
+/** Stable version every fixture bumps from. */
+export const CURRENT_STABLE_VERSION = "1.2.3";
+
+/** The only versions allowed after {@link CURRENT_STABLE_VERSION}: next patch, minor and major. */
+export const ALLOWED_NEXT_VERSIONS = Object.freeze(["1.2.4", "1.3.0", "2.0.0"]);
+
+/** Every rejected kind of bump from {@link CURRENT_STABLE_VERSION}, grouped by why it is rejected. */
+export const REJECTED_VERSION_BUMPS = Object.freeze({
+  unchanged: Object.freeze(["1.2.3"]),
+  lower: Object.freeze(["1.2.2", "1.1.9", "0.9.9", "1.2.0", "0.0.1"]),
+  "skips patches": Object.freeze(["1.2.5", "1.2.10"]),
+  "skips minors": Object.freeze(["1.4.0", "1.10.0"]),
+  "skips majors": Object.freeze(["3.0.0", "10.0.0"]),
+  "minor bump without resetting the patch": Object.freeze(["1.3.3", "1.3.1"]),
+  "major bump without resetting minor and patch": Object.freeze(["2.2.3", "2.0.3", "2.3.0", "2.0.1"]),
+  prerelease: Object.freeze([
+    "1.2.4-alpha",
+    "1.2.4-alpha.1",
+    "1.3.0-beta.2",
+    "2.0.0-rc.1",
+    "1.2.4-canary.0",
+    "1.2.4-next.3",
+    "1.2.4-dev",
+    "1.2.4-snapshot",
+    "1.2.4-0",
+    "1.2.4-alpha.beta.1",
+    "1.2.4-SNAPSHOT-20260926",
+  ]),
+  "build metadata": Object.freeze(["1.2.4+build.5", "1.3.0+sha.8fc0245", "2.0.0-beta.1+exp"]),
+  "not a plain X.Y.Z": Object.freeze([
+    "1.3",
+    "2",
+    "1.2.4.0",
+    "01.2.4",
+    "1.02.4",
+    "1.3.00",
+    "x.y.z",
+    "1.2.x",
+    "latest",
+    "",
+    " 1.2.4",
+    "1.2.4 ",
+    "v1.2.4",
+    "V1.2.4",
+    "^1.2.4",
+    "~1.3.0",
+    ">=2.0.0",
+    "1.2.4 || 1.3.0",
+  ]),
+});
+
+/**
+ * All rejected bumps as `[reason, version]` pairs for table-driven tests.
+ *
+ * @type {ReadonlyArray<readonly [string, string]>}
+ */
+export const REJECTED_VERSION_BUMP_CASES = Object.freeze(
+  Object.entries(REJECTED_VERSION_BUMPS).flatMap(([reason, versions]) =>
+    versions.map((version) => /** @type {const} */ ([reason, version]))
+  )
+);

package/src/versions.js

@@ -0,0 +1,211 @@
+/**
+ * Release version rules: only stable `X.Y.Z` versions exist, and after a
+ * version only its next patch, minor or major is allowed (from `1.2.3`:
+ * `1.2.4`, `1.3.0` or `2.0.0`). No version can be skipped, repeated or
+ * lowered, and prereleases or build metadata are never released.
+ *
+ * @module versions
+ */
+
+import {
+  BREAKING_CHANGE_FOOTER_PATTERN,
+  CONVENTIONAL_HEADER_PATTERN,
+  FEATURE_COMMIT_TYPE,
+  LEGACY_FEATURE_SUBJECT_PATTERN,
+  RELEASE_TAG_PREFIX,
+  RELEASE_TYPE,
+  RELEASE_TYPE_ORDER,
+  RELEASE_VERSION_PATTERN,
+  SEMVER_PATTERN,
+} from "./constants/versions.js";
+
+/**
+ * @typedef {"patch" | "minor" | "major"} ReleaseType
+ * @typedef {{ releaseType: ReleaseType, version: string }} NextVersion
+ */
+
+/**
+ * Returns whether a value is a stable `X.Y.Z` release version.
+ *
+ * @param {unknown} version - Candidate version.
+ * @returns {boolean} `true` only for plain `X.Y.Z` without prerelease, metadata, prefix or leading zeros.
+ */
+export function isStableReleaseVersion(version) {
+  return typeof version === "string" && RELEASE_VERSION_PATTERN.test(version);
+}
+
+/**
+ * Parses a stable `X.Y.Z` version.
+ *
+ * @param {string} version - Version such as `0.93.0`.
+ * @returns {[number, number, number]} Major, minor and patch numbers.
+ * @throws {Error} When the version is not a stable release version.
+ */
+export function parseReleaseVersion(version) {
+  const match = RELEASE_VERSION_PATTERN.exec(String(version));
+
+  if (!match) {
+    throw new Error(`beez-rp:parseReleaseVersion expected X.Y.Z, received "${version}"`);
+  }
+
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+
+/**
+ * Returns the next version for a semver release type.
+ *
+ * @param {string} version - Current `X.Y.Z` version.
+ * @param {ReleaseType} releaseType - One of {@link RELEASE_TYPE}.
+ * @returns {string} Next `X.Y.Z` version.
+ * @throws {Error} When the version is not stable or the release type is unknown.
+ */
+export function bumpReleaseVersion(version, releaseType) {
+  const [major, minor, patch] = parseReleaseVersion(version);
+
+  switch (releaseType) {
+    case RELEASE_TYPE.major:
+      return `${major + 1}.0.0`;
+    case RELEASE_TYPE.minor:
+      return `${major}.${minor + 1}.0`;
+    case RELEASE_TYPE.patch:
+      return `${major}.${minor}.${patch + 1}`;
+    default:
+      throw new Error(`beez-rp:bumpReleaseVersion unknown release type "${releaseType}"`);
+  }
+}
+
+/**
+ * Lists the only versions allowed after the current one: the next patch,
+ * minor and major. Anything else would skip versions or go backwards.
+ *
+ * @param {string} currentVersion - Current `X.Y.Z` version.
+ * @returns {NextVersion[]} Allowed next versions, patch first.
+ */
+export function listNextVersions(currentVersion) {
+  return RELEASE_TYPE_ORDER.map((releaseType) => ({
+    releaseType,
+    version: bumpReleaseVersion(currentVersion, releaseType),
+  }));
+}
+
+/**
+ * Lists the versions allowed after any previous semver version. A previous
+ * prerelease is also followed by its own stable release (`1.0.0-beta.1` →
+ * `1.0.0`).
+ *
+ * @param {string} previousVersion - Previous version, stable or prerelease.
+ * @returns {string[] | null} Allowed versions, or `null` when the previous version is not semver.
+ */
+export function listAllowedVersionsAfter(previousVersion) {
+  const match = SEMVER_PATTERN.exec(String(previousVersion));
+
+  if (!match) {
+    return null;
+  }
+
+  const [, core, prerelease] = match;
+  const nextVersions = listNextVersions(core).map((candidate) => candidate.version);
+
+  return prerelease ? [core, ...nextVersions] : nextVersions;
+}
+
+/**
+ * Resolves the version requested through `--bump` or `--set-version`.
+ *
+ * @param {string} currentVersion - Current `X.Y.Z` version.
+ * @param {{ bump: ReleaseType | null, setVersion: string | null }} request - Parsed CLI options.
+ * @returns {NextVersion | null} Requested version, or `null` to ask interactively.
+ * @throws {Error} With a Spanish message when the request is invalid.
+ */
+export function resolveRequestedVersion(currentVersion, { bump, setVersion }) {
+  const nextVersions = listNextVersions(currentVersion);
+
+  if (bump) {
+    return nextVersions.find((candidate) => candidate.releaseType === bump) ?? null;
+  }
+
+  if (setVersion === null || setVersion === undefined) {
+    return null;
+  }
+
+  if (!isStableReleaseVersion(setVersion)) {
+    throw new Error(`--set-version espera el formato X.Y.Z y recibió "${setVersion}".`);
+  }
+
+  const match = nextVersions.find((candidate) => candidate.version === setVersion);
+
+  if (!match) {
+    const allowed = nextVersions.map((candidate) => candidate.version).join(", ");
+    throw new Error(
+      `--set-version ${setVersion} no es válida después de ${currentVersion}: tiene que ser mayor y no saltear versiones. Opciones: ${allowed}.`
+    );
+  }
+
+  return match;
+}
+
+/**
+ * Builds the Git tag name of a release version.
+ *
+ * @param {string} version - `X.Y.Z` version.
+ * @returns {string} Tag such as `v0.94.0`.
+ */
+export function toReleaseTag(version) {
+  return `${RELEASE_TAG_PREFIX}${version}`;
+}
+
+/**
+ * Returns whether a commit subject is a release bump commit (`0.93.0`).
+ *
+ * @param {string} subject - Commit subject.
+ * @returns {boolean} `true` for version-only subjects.
+ */
+export function isReleaseCommitSubject(subject) {
+  return isStableReleaseVersion(subject.trim());
+}
+
+/**
+ * Suggests the semver release type for the commits that will ship.
+ *
+ * Breaking changes suggest `major`; features (conventional `feat` or legacy
+ * imperative subjects such as "Add ...") suggest `minor`; a set made only of
+ * conventional maintenance commits (`fix`, `chore`, `docs`, ...) suggests
+ * `patch`. Unknown legacy subjects suggest `minor`.
+ *
+ * @param {{ subject: string, body?: string }[]} commits - Commits since the last release.
+ * @returns {{ releaseType: ReleaseType, reason: string }} Suggested type and a Spanish explanation.
+ */
+export function suggestReleaseType(commits) {
+  const shippedCommits = commits.filter((commit) => !isReleaseCommitSubject(commit.subject));
+  let hasFeature = false;
+  let hasUnknownSubject = false;
+
+  for (const commit of shippedCommits) {
+    const header = CONVENTIONAL_HEADER_PATTERN.exec(commit.subject);
+
+    if (header?.groups?.breaking || BREAKING_CHANGE_FOOTER_PATTERN.test(commit.body ?? "")) {
+      return { releaseType: RELEASE_TYPE.major, reason: "hay cambios incompatibles (breaking change)" };
+    }
+
+    if (header?.groups) {
+      hasFeature ||= header.groups.type.toLowerCase() === FEATURE_COMMIT_TYPE;
+      continue;
+    }
+
+    if (LEGACY_FEATURE_SUBJECT_PATTERN.test(commit.subject)) {
+      hasFeature = true;
+    } else {
+      hasUnknownSubject = true;
+    }
+  }
+
+  if (hasFeature) {
+    return { releaseType: RELEASE_TYPE.minor, reason: "hay funcionalidades nuevas" };
+  }
+
+  if (hasUnknownSubject || shippedCommits.length === 0) {
+    return { releaseType: RELEASE_TYPE.minor, reason: "criterio habitual del repositorio" };
+  }
+
+  return { releaseType: RELEASE_TYPE.patch, reason: "solo hay arreglos y mantenimiento" };
+}

package/types/build-gate.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Decides whether Vercel builds a commit (`vercel.json` → `ignoreCommand`).
+ *
+ * Only a stable `X.Y.Z` version that is the next patch, minor or major of the
+ * previous commit's version ships, the same rule `create-version` applies. An
+ * unchanged, lower or skipped version (`1.0.0` → `3.0.0`) and any prerelease
+ * or build-metadata version skip the build. When the previous version cannot
+ * be read there is nothing to compare, so a stable version builds.
+ *
+ * @module build-gate
+ */
+export type BuildDecision = {
+    shouldBuild: boolean;
+    reason: string;
+};
+/**
+ * @typedef {{ shouldBuild: boolean, reason: string }} BuildDecision
+ */
+/**
+ * Decides whether a commit is built.
+ *
+ * @param {string | null} previousVersion - Version of the previous commit, or `null` when unreadable.
+ * @param {string | null} currentVersion - Version of the commit being deployed, or `null` when unreadable.
+ * @returns {BuildDecision} Decision and a log line.
+ */
+export declare function decideBuild(previousVersion: string | null, currentVersion: string | null): BuildDecision;
+/**
+ * Reads the previous and the current `package.json` versions of a Git
+ * checkout and decides whether it is built.
+ *
+ * @param {string} repositoryRoot - Checkout whose `HEAD` is being deployed.
+ * @returns {BuildDecision} Decision and a log line.
+ */
+export declare function decideBuildForCheckout(repositoryRoot: string): BuildDecision;

package/types/changelog-ai.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Asks Codex to fill the CHANGELOG `[Unreleased]` block when a release finds it empty.
+ *
+ * The prompt travels through stdin (`codex exec -`), so the shell command stays a
+ * fixed string on Windows, where `codex` is a `.cmd` shim that needs a shell.
+ *
+ * @module changelog-ai
+ */
+/**
+ * Builds the instructions for Codex from the commits that will ship.
+ *
+ * @param {{ sha: string, subject: string }[]} commits - Unreleased commits, newest first.
+ * @param {string} audience - Who reads the changelog, e.g. "quien consume el paquete".
+ * @returns {string} Prompt in Spanish.
+ */
+export declare function buildChangelogPrompt(commits: {
+    sha: string;
+    subject: string;
+}[], audience: string): string;
+/**
+ * Runs Codex non-interactively with the prompt on stdin, showing its progress.
+ *
+ * @param {string} root - Repository directory where Codex edits CHANGELOG.md.
+ * @param {string} prompt - Instructions from {@link buildChangelogPrompt}.
+ * @returns {Promise<number>} Codex exit code; {@link CODEX_NOT_FOUND_EXIT_CODE} when the CLI is not installed.
+ */
+export declare function runCodex(root: string, prompt: string): Promise<number>;

package/types/changelog.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Reads and releases CHANGELOG.md in the Keep a Changelog format.
+ *
+ * Every change adds its entries under `## [Unreleased]`, grouped by change
+ * type (`### Added`, `### Changed`, `### Deprecated`, `### Removed`,
+ * `### Fixed`, `### Security`). Releasing moves that block under
+ * `## [X.Y.Z] - YYYY-MM-DD` and leaves an empty `## [Unreleased]` on top.
+ * Headings of older releases without brackets (`## 0.6.0 - 2026-09-23`)
+ * remain valid.
+ *
+ * @module changelog
+ */
+export type ChangelogBlock = {
+    label: string;
+    heading: string;
+    start: number;
+    bodyStart: number;
+    end: number;
+};
+export type UnreleasedState = {
+    exists: boolean;
+    entryCount: number;
+    unknownSections: string[];
+    body: string;
+};
+/**
+ * Describes the `## [Unreleased]` block.
+ *
+ * @param {string} changelog - CHANGELOG.md contents.
+ * @returns {UnreleasedState} Unreleased state.
+ */
+export declare function readUnreleased(changelog: string): UnreleasedState;
+/**
+ * Returns the newest released block (the first one that is not `[Unreleased]`).
+ *
+ * @param {string} changelog - CHANGELOG.md contents.
+ * @returns {{ version: string, entryCount: number } | null} Latest release entry.
+ */
+export declare function readLatestRelease(changelog: string): {
+    version: string;
+    entryCount: number;
+} | null;
+/**
+ * Moves the `[Unreleased]` changes under a new version heading and leaves an empty `[Unreleased]` block.
+ *
+ * @param {string} changelog - CHANGELOG.md contents.
+ * @param {string} version - Version being released.
+ * @param {string} releaseDate - Date in `YYYY-MM-DD` format.
+ * @returns {string} Released changelog.
+ * @throws {Error} When `[Unreleased]` is missing, empty or uses an unknown section.
+ */
+export declare function releaseUnreleased(changelog: string, version: string, releaseDate: string): string;

package/types/constants/build-gate.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Contract between the `beez-rp ignore-build` command and the Vercel
+ * `ignoreCommand` wrapper that reads its output.
+ *
+ * @module constants/build-gate
+ */
+/** Decision printed as the last output line of `beez-rp ignore-build`. */
+export declare const BUILD_DECISION: Readonly<{
+    build: "BUILD";
+    skip: "SKIP";
+}>;
+/** Git revision whose `package.json` holds the previous version. */
+export declare const PREVIOUS_REVISION = "HEAD^";
+/** Manifest that holds the version. */
+export declare const PACKAGE_MANIFEST_FILE = "package.json";
+/** Exit code of `beez-rp ignore-build` when a decision was printed. */
+export declare const DECISION_EXIT_CODE = 0;
+/** Exit code of `beez-rp ignore-build` when it could not decide; wrappers must skip the build. */
+export declare const GATE_FAILURE_EXIT_CODE = 2;

package/types/constants/changelog-ai.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Codex invocation used to fill an empty `[Unreleased]` block.
+ *
+ * @module constants/changelog-ai
+ */
+/** Exit code shells use when a command does not exist. */
+export declare const CODEX_NOT_FOUND_EXIT_CODE = 127;
+/** Fixed Codex command: non-interactive, allowed to edit the workspace, no saved session, prompt on stdin. */
+export declare const CODEX_COMMAND = "codex exec --sandbox workspace-write --ephemeral --color never -";
+/** Length of the abbreviated commit ids listed in the prompt. */
+export declare const PROMPT_SHORT_SHA_LENGTH = 7;

package/types/constants/changelog.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Keep a Changelog contract used to read and release `CHANGELOG.md`.
+ *
+ * @module constants/changelog
+ */
+/** Changelog file released together with `package.json`. */
+export declare const CHANGELOG_FILE = "CHANGELOG.md";
+/** Heading of the block that collects changes not yet released. */
+export declare const UNRELEASED_HEADING = "## [Unreleased]";
+/** Change types allowed as `###` sections, in Keep a Changelog order. */
+export declare const CHANGE_TYPES: readonly string[];
+/** Any release-level heading: `## [Unreleased]`, `## [0.7.0] - 2026-09-26` or `## 0.6.0 - 2026-09-23`. */
+export declare const RELEASE_HEADING_PATTERN: RegExp;
+/** Unreleased heading, case-insensitive, as its own line. */
+export declare const UNRELEASED_LINE_PATTERN: RegExp;
+/** A change entry line. */
+export declare const ENTRY_LINE_PATTERN: RegExp;
+/** A change-type section heading inside a release block. */
+export declare const SECTION_HEADING_PATTERN: RegExp;
+/** Leading whitespace left before the next block after moving `[Unreleased]`. */
+export declare const LEADING_WHITESPACE_PATTERN: RegExp;
+/** Line break in a changelog written on any platform. */
+export declare const LINE_BREAK_PATTERN: RegExp;

package/types/constants/cli.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Commands understood by the `beez-rp` command line.
+ *
+ * @module constants/cli
+ */
+/** Command names accepted as the first `beez-rp` argument. */
+export declare const CLI_COMMAND: Readonly<{
+    ignoreBuild: "ignore-build";
+}>;

package/types/constants/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Facade of every `beez-rp` constant, grouped by domain.
+ *
+ * @module constants
+ */
+export * from "./build-gate.js";
+export * from "./changelog.js";
+export * from "./changelog-ai.js";
+export * from "./cli.js";
+export * from "./terminal-ui.js";
+export * from "./versions.js";

package/types/constants/terminal-ui.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Layout, ANSI and key contracts of the dependency-free terminal UI.
+ *
+ * @module constants/terminal-ui
+ */
+/** Widest box drawn, so lines stay readable on large terminals. */
+export declare const MAX_BOX_WIDTH = 84;
+/** Width assumed when stdout does not report its columns. */
+export declare const FALLBACK_TERMINAL_WIDTH = 80;
+/** Columns kept free at the right of the terminal when sizing a box. */
+export declare const TERMINAL_RIGHT_MARGIN = 2;
+/** Horizontal padding inside a box, per side. */
+export declare const BOX_PADDING = 1;
+/** Width of the label column of status rows. */
+export declare const ROW_LABEL_WIDTH = 16;
+/** Spinner animation frames. */
+export declare const SPINNER_FRAMES: readonly string[];
+/** Delay between spinner frames. */
+export declare const SPINNER_INTERVAL_MS = 80;
+/** Exit code conventionally used after Ctrl+C. */
+export declare const INTERRUPTED_EXIT_CODE = 130;
+/** Splits styled text into ANSI escape sequences and single code points. */
+export declare const ANSI_TOKEN_PATTERN: RegExp;
+/** First character of every ANSI escape sequence. */
+export declare const ANSI_ESCAPE = "\u001B";
+/** ANSI control sequences used by boxes, spinners and prompts. */
+export declare const ANSI_SEQUENCE: Readonly<{
+    reset: "\u001B[0m";
+    hideCursor: "\u001B[?25l";
+    showCursor: "\u001B[?25h";
+    clearLine: "\r\u001B[2K";
+    clearBelow: "\u001B[0J";
+}>;
+/** Border color of each box tone. */
+export declare const BOX_TONE: Readonly<{
+    neutral: "gray";
+    info: "cyan";
+    success: "green";
+    warning: "yellow";
+    danger: "red";
+    accent: "magenta";
+}>;
+/** Nerd Font glyphs (Font Awesome and Octicons sets) used as status icons. */
+export declare const ICON_GLYPH: Readonly<{
+    success: "";
+    failure: "";
+    warning: "";
+    info: "";
+    pending: "";
+    arrow: "";
+    bullet: "";
+    star: "";
+    rocket: "";
+}>;
+/** Label/value rows (`renderRow`): the value starts after a gap of two or more spaces. */
+export declare const VALUE_COLUMN_PATTERN: RegExp;
+/** Leading marker (icon, arrow, bullet or `1.`, never a word) followed by a space, used as hanging indent. */
+export declare const HANGING_MARKER_PATTERN: RegExp;
+/** Options that can be picked with a single digit key (1-9). */
+export declare const MAX_NUMBERED_OPTIONS = 9;
+/** A single digit key that picks a numbered option. */
+export declare const NUMBER_KEY_PATTERN: RegExp;
+/** Seconds in a minute, used to format durations. */
+export declare const SECONDS_PER_MINUTE = 60;
+/** Milliseconds in a second, used to format durations. */
+export declare const MILLISECONDS_PER_SECOND = 1000;
+/** Key names (`readline` keypress events) handled by the select prompt. */
+export declare const PROMPT_KEY: Readonly<{
+    interrupt: "c";
+    previous: readonly string[];
+    next: readonly string[];
+    confirm: readonly string[];
+}>;

package/types/constants/versions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Release version rules shared by `create-version` and the Vercel build gate.
+ *
+ * @module constants/versions
+ */
+/** Semver release types, from the smallest to the largest change. */
+export declare const RELEASE_TYPE: Readonly<{
+    patch: "patch";
+    minor: "minor";
+    major: "major";
+}>;
+/** Release types in the order they are offered: patch, minor, major. */
+export declare const RELEASE_TYPE_ORDER: readonly ("major" | "minor" | "patch")[];
+/** Stable `X.Y.Z` release version: no prerelease, build metadata, prefix or leading zeros. */
+export declare const RELEASE_VERSION_PATTERN: RegExp;
+/** Any semver version, capturing its `X.Y.Z` core and optional prerelease. */
+export declare const SEMVER_PATTERN: RegExp;
+/** Prefix of the annotated Git tags that mark each release (`v0.93.0`). */
+export declare const RELEASE_TAG_PREFIX = "v";
+/** `git log --grep` pattern of release commit subjects (`0.93.0`). */
+export declare const RELEASE_COMMIT_SUBJECT_GREP: string;
+/** Conventional commit header: `type(scope)!: subject`. */
+export declare const CONVENTIONAL_HEADER_PATTERN: RegExp;
+/** Footer that marks a breaking change in a conventional commit body. */
+export declare const BREAKING_CHANGE_FOOTER_PATTERN: RegExp;
+/** Conventional commit type that ships user-visible features. */
+export declare const FEATURE_COMMIT_TYPE = "feat";
+/** Imperative verbs used by legacy, non-conventional feature subjects. */
+export declare const LEGACY_FEATURE_SUBJECT_PATTERN: RegExp;

package/types/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `beez-rp`: dependency-free release process shared by the Beez projects.
+ *
+ * - `beez-rp/versions`: stable `X.Y.Z` rules; only the next patch, minor or major is allowed.
+ * - `beez-rp/build-gate`: Vercel `ignoreCommand` decision built on those rules.
+ * - `beez-rp/changelog` and `beez-rp/changelog-ai`: Keep a Changelog release and Codex fill-in.
+ * - `beez-rp/terminal-ui`: boxes, spinners and prompts for release commands.
+ * - `beez-rp/testing`: shared version bump fixtures for consumer test suites.
+ * - `beez-rp/constants`: every constant above, grouped by domain.
+ *
+ * @module beez-rp
+ */
+export * from "./build-gate.js";
+export * from "./changelog.js";
+export * from "./changelog-ai.js";
+export * from "./versions.js";
+export { ICON, countTerminalRows, formatDuration, getPromptWaitMs, measureActiveMs, paint, print, renderBanner, renderBox, renderRow, renderStepHeader, resolveBoxWidth, resolveNumberKey, select, startSpinner, visibleWidth, wrapStyledLine, } from "./terminal-ui.js";
+export * from "./constants/index.js";