@guiho/mirror 2.3.2

package/library/flags.js

@@ -0,0 +1,70 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { MirrorError } from './errors';
+const booleanFlags = new Set(['dry-run', 'commit', 'push', 'allow-dirty', 'yes', 'no-color', 'verbose', 'help', 'version']);
+const adapterNames = new Set(['package.json', 'jsr.json', 'git']);
+const shortFlagAliases = {
+    '-dy': '--dry-run',
+    '-y': '--yes',
+};
+const normalizeKey = (key) => key.replace(/-([a-z])/g, (_match, letter) => letter.toUpperCase());
+const expandShortFlags = (rawArgs) => rawArgs.map((token) => shortFlagAliases[token] ?? token);
+export const parseMirrorCliOptions = (rawArgs) => {
+    const parsed = {};
+    const args = expandShortFlags(rawArgs);
+    for (let index = 0; index < args.length; index += 1) {
+        const token = args[index];
+        if (!token?.startsWith('--'))
+            continue;
+        const withoutPrefix = token.slice(2);
+        const equalsIndex = withoutPrefix.indexOf('=');
+        const rawKey = equalsIndex >= 0 ? withoutPrefix.slice(0, equalsIndex) : withoutPrefix;
+        const key = normalizeKey(rawKey);
+        if (booleanFlags.has(rawKey)) {
+            parsed[key] = true;
+            continue;
+        }
+        const value = equalsIndex >= 0
+            ? withoutPrefix.slice(equalsIndex + 1)
+            : args[index + 1] && !args[index + 1]?.startsWith('-')
+                ? args[++index] ?? ''
+                : '';
+        if (!value)
+            throw new MirrorError(`Missing value for --${rawKey}`);
+        if (key === 'output') {
+            const nextValues = value.split(',').map((item) => item.trim()).filter(Boolean);
+            const current = parsed['output'];
+            parsed['output'] = [...(Array.isArray(current) ? current : current ? [String(current)] : []), ...nextValues];
+            continue;
+        }
+        parsed[key] = value;
+    }
+    return {
+        cwd: typeof parsed['cwd'] === 'string' ? parsed['cwd'] : undefined,
+        config: typeof parsed['config'] === 'string' ? parsed['config'] : undefined,
+        format: typeof parsed['format'] === 'string' ? assertFormat(parsed['format']) : undefined,
+        noColor: parsed['noColor'] === true,
+        source: typeof parsed['source'] === 'string' ? assertAdapter(parsed['source'], '--source') : undefined,
+        output: Array.isArray(parsed['output']) ? parsed['output'].map((value) => assertAdapter(value, '--output')) : undefined,
+        packageFile: typeof parsed['packageFile'] === 'string' ? parsed['packageFile'] : undefined,
+        jsrFile: typeof parsed['jsrFile'] === 'string' ? parsed['jsrFile'] : undefined,
+        preid: typeof parsed['preid'] === 'string' ? parsed['preid'] : undefined,
+        dryRun: parsed['dryRun'] === true,
+        commit: parsed['commit'] === true,
+        push: parsed['push'] === true,
+        allowDirty: parsed['allowDirty'] === true,
+        yes: parsed['yes'] === true,
+        verbose: parsed['verbose'] === true,
+    };
+};
+const assertAdapter = (value, flagName) => {
+    if (!adapterNames.has(value))
+        throw new MirrorError(`Invalid ${flagName} value: ${value}`);
+    return value;
+};
+const assertFormat = (value) => {
+    if (value !== 'text' && value !== 'json')
+        throw new MirrorError(`Invalid --format value: ${value}`);
+    return value;
+};

package/library/guiho-mirror-bin.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export {};
+//# sourceMappingURL=guiho-mirror-bin.d.ts.map

package/library/guiho-mirror-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guiho-mirror-bin.d.ts","sourceRoot":"","sources":["../source/guiho-mirror-bin.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/library/guiho-mirror-bin.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { runMirrorCli } from './guiho-mirror';
+await runMirrorCli();

package/library/guiho-mirror.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export type { MirrorAdapterName, MirrorCliOptions, MirrorConfig, MirrorExecutionResult, MirrorFormat, MirrorRawConfig, MirrorVersionPlan, MirrorVersionPlanAction, MirrorVersionTarget, } from './types';
+export { MirrorError, invariant } from './errors';
+export { parseMirrorCliOptions } from './flags';
+export { createInitConfig, discoverMirrorConfig, loadMirrorConfig, normalizeMirrorConfig, writeInitConfig } from './config';
+export { assertValidSemver, isMirrorReleaseTarget, mirrorReleaseTargets, resolveNextVersion, sortSemverDescending } from './version';
+export { createGitCommit, createGitTag, ensureAdapterFiles, assertSupportedGitTagTemplate, isGitDirty, isGitRepository, readCurrentVersion, readGitVersion, readJsrName, readJsrVersion, readPackageName, readPackageVersion, renderGitTag, resolveProjectName, supportedGitTagTemplates, versionFromTag, writeJsrVersion, writePackageVersion, } from './adapters';
+export { buildVersionPlan, releaseLabel, resolveFileOutputPaths, validateMirrorConfig } from './plan';
+export { applyVersionPlan, executeVersionPlan } from './executor';
+export { mirrorBanner, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportValue } from './reporter';
+export { createMirrorCommand, runMirrorCli } from './cli';
+//# sourceMappingURL=guiho-mirror.d.ts.map

package/library/guiho-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guiho-mirror.d.ts","sourceRoot":"","sources":["../source/guiho-mirror.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC3H,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACpI,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,6BAA6B,EAC7B,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AACrG,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,sBAAsB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7I,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA"}

package/library/guiho-mirror.js

@@ -0,0 +1,12 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export { MirrorError, invariant } from './errors';
+export { parseMirrorCliOptions } from './flags';
+export { createInitConfig, discoverMirrorConfig, loadMirrorConfig, normalizeMirrorConfig, writeInitConfig } from './config';
+export { assertValidSemver, isMirrorReleaseTarget, mirrorReleaseTargets, resolveNextVersion, sortSemverDescending } from './version';
+export { createGitCommit, createGitTag, ensureAdapterFiles, assertSupportedGitTagTemplate, isGitDirty, isGitRepository, readCurrentVersion, readGitVersion, readJsrName, readJsrVersion, readPackageName, readPackageVersion, renderGitTag, resolveProjectName, supportedGitTagTemplates, versionFromTag, writeJsrVersion, writePackageVersion, } from './adapters';
+export { buildVersionPlan, releaseLabel, resolveFileOutputPaths, validateMirrorConfig } from './plan';
+export { applyVersionPlan, executeVersionPlan } from './executor';
+export { mirrorBanner, reportConfig, reportConfigSchema, reportExecution, reportExecutionSummary, reportPlan, reportValue } from './reporter';
+export { createMirrorCommand, runMirrorCli } from './cli';

package/library/plan.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { MirrorCliOptions, MirrorConfig, MirrorVersionPlan } from './types';
+export declare const validateMirrorConfig: (options?: MirrorCliOptions) => Promise<MirrorConfig>;
+export declare const buildVersionPlan: (target: string, options?: MirrorCliOptions) => Promise<MirrorVersionPlan>;
+export declare const resolveFileOutputPaths: (config: MirrorConfig) => string[];
+export declare const releaseLabel: (version: string, projectName?: string) => string;
+export declare const planPathForDisplay: (plan: MirrorVersionPlan, path: string) => string;
+//# sourceMappingURL=plan.d.ts.map

package/library/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../source/plan.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAA2B,MAAM,SAAS,CAAA;AAMzG,eAAO,MAAM,oBAAoB,GAAU,UAAS,gBAAqB,KAAG,OAAO,CAAC,YAAY,CAW/F,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,EAAE,UAAS,gBAAqB,KAAG,OAAO,CAAC,iBAAiB,CA4DhH,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,YAAY,aAO1D,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,EAAE,cAAc,MAAM,WAAgE,CAAA;AAElI,eAAO,MAAM,kBAAkB,GAAI,MAAM,iBAAiB,EAAE,MAAM,MAAM,WAAoC,CAAA"}

package/library/plan.js

@@ -0,0 +1,81 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { relative } from 'node:path';
+import { MirrorError } from './errors';
+import { loadMirrorConfig, relativeFromCwd, resolveMirrorPath } from './config';
+import { ensureAdapterFiles, readCurrentVersion, renderGitTag, resolveProjectName } from './adapters';
+import { resolveNextVersion } from './version';
+export const validateMirrorConfig = async (options = {}) => {
+    const config = await loadMirrorConfig(options);
+    await ensureAdapterFiles(config);
+    const projectName = await resolveProjectName(config);
+    if (config.version.source === 'git' || config.version.output.includes('git')) {
+        renderGitTag(config.git.tagTemplate, '0.0.0', projectName);
+    }
+    return config;
+};
+export const buildVersionPlan = async (target, options = {}) => {
+    const config = await validateMirrorConfig(options);
+    const projectName = await resolveProjectName(config);
+    const currentVersion = await readCurrentVersion(config, projectName);
+    const nextVersion = resolveNextVersion(currentVersion, target, config.version.prereleaseId);
+    const fileOutputPaths = resolveFileOutputPaths(config);
+    const commitEnabled = config.git.commit;
+    const pushEnabled = config.git.push;
+    const actions = [];
+    for (const path of fileOutputPaths) {
+        actions.push({
+            type: 'write-file',
+            adapter: path.endsWith(config.package.path) ? 'package.json' : 'jsr.json',
+            path,
+            currentVersion,
+            nextVersion,
+        });
+    }
+    const gitTag = config.version.output.includes('git') ? renderGitTag(config.git.tagTemplate, nextVersion, projectName) : undefined;
+    if (fileOutputPaths.length > 0 && gitTag && !commitEnabled && !pushEnabled) {
+        throw new MirrorError('Git tag output with file outputs requires --commit or --push so the tag points at the version commit.');
+    }
+    if (commitEnabled && fileOutputPaths.length > 0) {
+        actions.push({
+            type: 'git-commit',
+            message: releaseLabel(nextVersion, projectName),
+            paths: fileOutputPaths.map((path) => relative(config.cwd, path)),
+        });
+    }
+    if (gitTag)
+        actions.push({ type: 'git-tag', tag: gitTag });
+    if (pushEnabled) {
+        actions.push({
+            type: 'git-push',
+            includeCommit: fileOutputPaths.length > 0,
+            includeTags: Boolean(gitTag),
+        });
+    }
+    return {
+        cwd: config.cwd,
+        configPath: config.configPath,
+        source: config.version.source,
+        output: config.version.output,
+        currentVersion,
+        nextVersion,
+        project: { name: projectName },
+        commitEnabled,
+        pushEnabled,
+        allowDirty: config.git.allowDirty,
+        fileOutputPaths,
+        gitTag,
+        actions,
+    };
+};
+export const resolveFileOutputPaths = (config) => {
+    const paths = [];
+    if (config.version.output.includes('package.json'))
+        paths.push(resolveMirrorPath(config.cwd, config.package.path));
+    if (config.version.output.includes('jsr.json'))
+        paths.push(resolveMirrorPath(config.cwd, config.jsr.path));
+    return paths;
+};
+export const releaseLabel = (version, projectName) => (projectName ? `${projectName}@${version}` : `v${version}`);
+export const planPathForDisplay = (plan, path) => relativeFromCwd(plan.cwd, path);

package/library/reporter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { MirrorConfig, MirrorExecutionResult, MirrorFormat, MirrorVersionPlan } from './types';
+export declare const mirrorBanner: (configPath?: string) => string;
+export declare const reportValue: (value: unknown, format?: MirrorFormat) => string;
+export declare const reportConfig: (config: MirrorConfig, format?: MirrorFormat) => string;
+export declare const reportConfigSchema: (format?: MirrorFormat) => string;
+export declare const reportPlan: (plan: MirrorVersionPlan, format?: MirrorFormat) => string;
+export declare const reportExecution: (result: MirrorExecutionResult, format?: MirrorFormat) => string;
+export declare const reportExecutionSummary: (result: MirrorExecutionResult, format?: MirrorFormat) => string;
+//# sourceMappingURL=reporter.d.ts.map

package/library/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../source/reporter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAGnG,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,WAW/C,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,SAAQ,YAAqB,WAGxE,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,QAAQ,YAAY,EAAE,SAAQ,YAAqB,WAe/E,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAQ,YAAqB,WAkC/D,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,MAAM,iBAAiB,EAAE,SAAQ,YAAqB,WAyBhF,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,qBAAqB,EAAE,SAAQ,YAAqB,WAG3F,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,qBAAqB,EAAE,SAAQ,YAAqB,WAgBlG,CAAA"}

package/library/reporter.js

@@ -0,0 +1,121 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { configPathForDisplay, relativeFromCwd } from './config';
+export const mirrorBanner = (configPath) => {
+    const noColor = process.env['NO_COLOR'] === '1';
+    const title = noColor ? '🪞  GUIHO Mirror' : '\x1b[1;36m🪞  GUIHO Mirror\x1b[0m';
+    if (configPath === undefined)
+        return `\n${title}\n\n`;
+    const dim = noColor ? '' : '\x1b[2m';
+    const reset = noColor ? '' : '\x1b[0m';
+    const status = configPath ? configPath : '(none)';
+    return `\n${title}\n\n${dim}config: ${status}${reset}\n\n`;
+};
+export const reportValue = (value, format = 'text') => {
+    if (format === 'json')
+        return `${JSON.stringify(value, null, 2)}\n`;
+    return `${String(value)}\n`;
+};
+export const reportConfig = (config, format = 'text') => {
+    if (format === 'json')
+        return `${JSON.stringify(config, null, 2)}\n`;
+    return [
+        `config: ${configPathForDisplay(config)}`,
+        `source: ${config.version.source}`,
+        `output: ${config.version.output.join(', ')}`,
+        `package: ${config.package.path}`,
+        `jsr: ${config.jsr.path}`,
+        `tag_template: ${config.git.tagTemplate}`,
+        `commit: ${String(config.git.commit)}`,
+        `push: ${String(config.git.push)}`,
+        `allow_dirty: ${String(config.git.allowDirty)}`,
+        '',
+    ].join('\n');
+};
+export const reportConfigSchema = (format = 'text') => {
+    if (format === 'json') {
+        return `${JSON.stringify({ schema: 'See text output for full reference.' }, null, 2)}\n`;
+    }
+    return [
+        'MIRROR CONFIGURATION SCHEMA (mirror.config.toml)',
+        '',
+        '  schema = 1                                Required. Schema version. Must be 1.',
+        '',
+        '  [project]',
+        '  name = "<string>"                         Optional. Explicit project name.',
+        '  name_source = "package.json" | "jsr.json" Optional. Read project name from this adapter.',
+        '',
+        '  [version]',
+        '  scheme = "semver"                         Required. Only "semver" is supported.',
+        '  source = "package.json" | "jsr.json" | "git"  Required. Adapter to read the current version from.',
+        '  output = ["package.json", "jsr.json", "git"]  Required. Adapters to write the next version to.',
+        '  prerelease_id = "<string>"                Optional. Default prerelease identifier (e.g. "alpha").',
+        '',
+        '  [package]',
+        '  path = "<path>"                           Optional. Path to package.json. Default: "package.json".',
+        '',
+        '  [jsr]',
+        '  path = "<path>"                           Optional. Path to jsr.json. Default: "jsr.json".',
+        '',
+        '  [git]',
+        '  tag_template = "<template>"               Optional. Git tag format. Default: "v{version}".',
+        '                                            Supported: "v{version}", "{name}@{version}", "{name}/v{version}".',
+        '  commit = true | false                     Optional. Create release commits. Default: false.',
+        '  push = true | false                       Optional. Push release refs. Default: false.',
+        '  allow_dirty = true | false                Optional. Allow dirty Git worktree. Default: false.',
+        '',
+    ].join('\n');
+};
+export const reportPlan = (plan, format = 'text') => {
+    if (format === 'json')
+        return `${JSON.stringify(plan, null, 2)}\n`;
+    const lines = [
+        `current: ${plan.currentVersion}`,
+        `next: ${plan.nextVersion}`,
+        `source: ${plan.source}`,
+        `output: ${plan.output.join(', ')}`,
+    ];
+    if (plan.project.name)
+        lines.push(`project: ${plan.project.name}`);
+    if (plan.configPath)
+        lines.push(`config: ${relativeFromCwd(plan.cwd, plan.configPath)}`);
+    if (plan.fileOutputPaths.length > 0)
+        lines.push(`files: ${plan.fileOutputPaths.map((path) => relativeFromCwd(plan.cwd, path)).join(', ')}`);
+    if (plan.gitTag)
+        lines.push(`tag: ${plan.gitTag}`);
+    lines.push('actions:');
+    for (const action of plan.actions) {
+        if (action.type === 'write-file')
+            lines.push(`- write ${relativeFromCwd(plan.cwd, action.path)}: ${action.currentVersion} -> ${action.nextVersion}`);
+        if (action.type === 'git-commit')
+            lines.push(`- commit ${action.message}`);
+        if (action.type === 'git-tag')
+            lines.push(`- tag ${action.tag}`);
+        if (action.type === 'git-push')
+            lines.push(`- push commit=${String(action.includeCommit)} tags=${String(action.includeTags)}`);
+    }
+    return `${lines.join('\n')}\n`;
+};
+export const reportExecution = (result, format = 'text') => {
+    if (format === 'json')
+        return `${JSON.stringify(result, null, 2)}\n`;
+    return `${reportPlan(result.plan, 'text')}applied: ${String(result.applied)}\ndry_run: ${String(result.dryRun)}\n`;
+};
+export const reportExecutionSummary = (result, format = 'text') => {
+    if (format === 'json')
+        return `${JSON.stringify(result, null, 2)}\n`;
+    const outputs = result.plan.output.join(', ');
+    const files = result.plan.fileOutputPaths.map((path) => relativeFromCwd(result.plan.cwd, path)).join(', ');
+    const lines = [
+        `applied: ${String(result.applied)}`,
+        `dry_run: ${String(result.dryRun)}`,
+        `version: ${result.plan.nextVersion}`,
+        `outputs: ${outputs}`,
+    ];
+    if (files)
+        lines.push(`files: ${files}`);
+    if (result.plan.gitTag)
+        lines.push(`tag: ${result.plan.gitTag}`);
+    return `${lines.join('\n')}\n`;
+};

package/library/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { ReleaseType } from 'semver';
+export type MirrorAdapterName = 'package.json' | 'jsr.json' | 'git';
+export type MirrorProjectNameSource = 'package.json' | 'jsr.json';
+export type MirrorFormat = 'text' | 'json';
+export type MirrorVersionTarget = ReleaseType | string;
+export type MirrorJsonObject = Record<string, unknown>;
+export type MirrorRawConfig = Partial<{
+    schema: number;
+    project: Partial<{
+        name: string;
+        name_source: MirrorProjectNameSource;
+    }>;
+    version: Partial<{
+        scheme: 'semver';
+        source: MirrorAdapterName;
+        output: MirrorAdapterName[];
+        prerelease_id: string;
+    }>;
+    package: Partial<{
+        path: string;
+    }>;
+    jsr: Partial<{
+        path: string;
+    }>;
+    git: Partial<{
+        tag_template: string;
+        commit: boolean;
+        push: boolean;
+        allow_dirty: boolean;
+    }>;
+}>;
+export type MirrorConfig = {
+    schema: 1;
+    cwd: string;
+    configPath?: string;
+    project: {
+        name?: string;
+        nameSource?: MirrorProjectNameSource;
+    };
+    version: {
+        scheme: 'semver';
+        source: MirrorAdapterName;
+        output: MirrorAdapterName[];
+        prereleaseId: string;
+    };
+    package: {
+        path: string;
+    };
+    jsr: {
+        path: string;
+    };
+    git: {
+        tagTemplate: string;
+        commit: boolean;
+        push: boolean;
+        allowDirty: boolean;
+    };
+};
+export type MirrorCliOptions = {
+    cwd?: string;
+    config?: string;
+    format?: MirrorFormat;
+    noColor?: boolean;
+    source?: MirrorAdapterName;
+    output?: MirrorAdapterName[];
+    packageFile?: string;
+    jsrFile?: string;
+    preid?: string;
+    dryRun?: boolean;
+    commit?: boolean;
+    push?: boolean;
+    allowDirty?: boolean;
+    yes?: boolean;
+    verbose?: boolean;
+};
+export type MirrorConfigDiscovery = {
+    path?: string;
+    raw?: MirrorRawConfig;
+};
+export type MirrorProject = {
+    name?: string;
+};
+export type MirrorVersionPlanAction = {
+    type: 'write-file';
+    adapter: 'package.json' | 'jsr.json';
+    path: string;
+    currentVersion: string;
+    nextVersion: string;
+} | {
+    type: 'git-commit';
+    message: string;
+    paths: string[];
+} | {
+    type: 'git-tag';
+    tag: string;
+} | {
+    type: 'git-push';
+    includeCommit: boolean;
+    includeTags: boolean;
+};
+export type MirrorVersionPlan = {
+    cwd: string;
+    configPath?: string;
+    source: MirrorAdapterName;
+    output: MirrorAdapterName[];
+    currentVersion: string;
+    nextVersion: string;
+    project: MirrorProject;
+    commitEnabled: boolean;
+    pushEnabled: boolean;
+    allowDirty: boolean;
+    fileOutputPaths: string[];
+    gitTag?: string;
+    actions: MirrorVersionPlanAction[];
+};
+export type MirrorExecutionResult = {
+    plan: MirrorVersionPlan;
+    applied: boolean;
+    dryRun: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/library/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../source/types.ts"],"names":[],"mappings":"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"}

package/library/types.js

@@ -0,0 +1,4 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export {};

package/library/version.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { ReleaseType } from 'semver';
+export declare const mirrorReleaseTargets: readonly ["major", "premajor", "minor", "preminor", "patch", "prepatch", "prerelease"];
+export declare const isMirrorReleaseTarget: (target: string) => target is ReleaseType;
+export declare const assertValidSemver: (version: string, label: string) => void;
+export declare const resolveNextVersion: (currentVersion: string, target: string, prereleaseId?: string) => string;
+export declare const sortSemverDescending: (versions: string[]) => string[];
+//# sourceMappingURL=version.d.ts.map

package/library/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../source/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAGzC,eAAO,MAAM,oBAAoB,wFAQU,CAAA;AAE3C,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI,WACH,CAAA;AAE9D,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,SAE/D,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,gBAAgB,MAAM,EAAE,QAAQ,MAAM,EAAE,qBAAiB,WAW3F,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,EAAE,aAAiC,CAAA"}

package/library/version.js

@@ -0,0 +1,31 @@
+/**
+ * @copyright Copyright (c) 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { inc, rcompare, valid as validSemver } from 'semver';
+import { MirrorError } from './errors';
+export const mirrorReleaseTargets = [
+    'major',
+    'premajor',
+    'minor',
+    'preminor',
+    'patch',
+    'prepatch',
+    'prerelease',
+];
+export const isMirrorReleaseTarget = (target) => mirrorReleaseTargets.includes(target);
+export const assertValidSemver = (version, label) => {
+    if (!validSemver(version))
+        throw new MirrorError(`${label} is not a valid semantic version: ${version}`);
+};
+export const resolveNextVersion = (currentVersion, target, prereleaseId = '') => {
+    assertValidSemver(currentVersion, 'Current version');
+    if (validSemver(target))
+        return target;
+    if (!isMirrorReleaseTarget(target))
+        throw new MirrorError(`Invalid version target: ${target}`);
+    const nextVersion = prereleaseId ? inc(currentVersion, target, prereleaseId) : inc(currentVersion, target);
+    if (!nextVersion)
+        throw new MirrorError(`Failed to resolve next version from ${currentVersion} using ${target}`);
+    return nextVersion;
+};
+export const sortSemverDescending = (versions) => [...versions].sort(rcompare);

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@guiho/mirror",
+  "description": "Open source project versioning for Bun, npm, JSR, and Git.",
+  "version": "2.3.2",
+  "type": "module",
+  "main": "./library/guiho-mirror.js",
+  "types": "./library/guiho-mirror.d.ts",
+  "exports": {
+    ".": {
+      "types": "./library/guiho-mirror.d.ts",
+      "import": "./library/guiho-mirror.js"
+    }
+  },
+  "bin": {
+    "mirror": "./library/guiho-mirror-bin.js"
+  },
+  "files": [
+    "README.md",
+    "library/",
+    "docs/",
+    "bin/",
+    "jsr.json",
+    "CHANGELOG.md",
+    "LICENSE.md",
+    "docs.md"
+  ],
+  "keywords": [
+    "bun",
+    "cli",
+    "git",
+    "jsr",
+    "semver",
+    "versioning"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Cristovao GUIHO",
+    "email": "cg@guiho.co",
+    "url": "https://guiho.co/cg"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "bun run --watch source/guiho-mirror-bin.ts",
+    "build": "rm -rf library && tsc -p .",
+    "binary": "bun build source/guiho-mirror-bin.ts --compile --outfile bin/mirror",
+    "bundle": "rm -rf bundle && bun build source/guiho-mirror-bin.ts --outdir bundle --target node --sourcemap=linked",
+    "typecheck": "tsc -p . --noEmit",
+    "clean": "rm -rf .temp",
+    "clean-build": "rm -rf build library bundle bin",
+    "clean-installation": "rm -rf node_modules bun.lock",
+    "_tc": "bun run typecheck",
+    "_ci": "bun clean && bun clean-build && bun clean-installation",
+    "_up": "bun _gaa && bun x taze --install --write --interactive",
+    "_upb": "bun _gaa && bun update --interactive",
+    "_uid": "bun nanoid --alphabet abcdefghijklmnopqrstuvwxyz-_0123456789",
+    "_gaa": "npx google-artifactregistry-auth"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CGuiho/mirror.git",
+    "directory": "mirror"
+  },
+  "homepage": "https://github.com/CGuiho/mirror#readme",
+  "bugs": {
+    "url": "https://github.com/CGuiho/mirror/issues"
+  },
+  "dependencies": {
+    "citty": "^0.2.2",
+    "semver": "^7.8.0"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.3",
+    "@types/semver": "^7.7.1",
+    "typescript": "5.8.2"
+  }
+}