@codefast/cli 1.0.0-canary.6 → 1.0.0-canary.7

package/dist/mirror/sync-workspace-package.mjs

@@ -1,109 +0,0 @@
-import { messageFrom } from "../core/errors.mjs";
-import { createMirrorDistFilesystem } from "./dist-filesystem-impl.mjs";
-import { DIST_DIR, PACKAGE_JSON } from "./domain/constants.mjs";
-import { createPathTransform, generateExports } from "./domain/exports.mjs";
-import { resolvePackageDisplayName } from "./domain/package-display-name.mjs";
-import { writePackageJsonExportsAtomic } from "./write-exports.mjs";
-import { buildSourcePathResolver, supplementExportsInPackageJson } from "./supplement-exports.mjs";
-import path from "node:path";
-//#region src/mirror/sync-workspace-package.ts
-/**
-* @since 0.3.16-canary.0
-*/
-async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr, config, write = true) {
-	const pathJoin = path.join;
-	const pathResolve = path.resolve;
-	const pathBasename = path.basename;
-	const packageDir = pathResolve(rootDir, packagePathStr);
-	const distDir = pathJoin(packageDir, DIST_DIR);
-	const packageJsonPath = pathJoin(packageDir, PACKAGE_JSON);
-	const folderBasename = pathBasename(packageDir);
-	const distFilesystem = createMirrorDistFilesystem(fs);
-	const pkgStats = {
-		name: folderBasename,
-		path: packageDir,
-		jsModules: 0,
-		cssExports: 0,
-		extraExports: 0,
-		totalExports: 0,
-		hasTransform: false,
-		cssConfigStatus: "",
-		skipped: false,
-		skipReason: "",
-		error: null,
-		prunedExportKeys: []
-	};
-	if (!fs.existsSync(packageJsonPath)) {
-		pkgStats.skipped = true;
-		pkgStats.skipReason = "package.json not found";
-		return pkgStats;
-	}
-	let packageJsonParseError;
-	let parsedPackageJson;
-	try {
-		const packageContent = await fs.readFile(packageJsonPath, "utf8");
-		const rawPackageJson = JSON.parse(packageContent);
-		if (rawPackageJson === null || typeof rawPackageJson !== "object" || Array.isArray(rawPackageJson)) throw new SyntaxError("package.json root must be a JSON object");
-		parsedPackageJson = rawPackageJson;
-		pkgStats.name = resolvePackageDisplayName(parsedPackageJson, folderBasename);
-	} catch (caughtError) {
-		pkgStats.name = folderBasename;
-		packageJsonParseError = caughtError;
-	}
-	const pkgConfig = config[pkgStats.name];
-	if (pkgConfig === false) {
-		pkgStats.skipped = true;
-		pkgStats.skipReason = "configured to skip";
-		return pkgStats;
-	}
-	if (packageJsonParseError !== void 0) {
-		if (!fs.existsSync(distDir)) {
-			pkgStats.skipped = true;
-			pkgStats.skipReason = "dist/ not found";
-			return pkgStats;
-		}
-		pkgStats.error = messageFrom(packageJsonParseError);
-		return pkgStats;
-	}
-	if (!fs.existsSync(distDir)) {
-		pkgStats.skipped = true;
-		pkgStats.skipReason = "dist/ not found";
-		return pkgStats;
-	}
-	try {
-		const resolveSourcePath = buildSourcePathResolver(fs, packageDir);
-		const exportOptions = {
-			source: pkgConfig?.source ?? true,
-			types: pkgConfig?.types ?? true,
-			import: pkgConfig?.import ?? true,
-			resolveSourcePath
-		};
-		if (pkgConfig?.preserve) {
-			const { supplementedSpecifiers } = await supplementExportsInPackageJson(fs, packageJsonPath, packageDir, exportOptions, write);
-			pkgStats.totalExports = supplementedSpecifiers.length;
-		} else {
-			const pathTransform = createPathTransform(pkgConfig?.strip);
-			pkgStats.hasTransform = !!pathTransform;
-			const cssConfig = pkgConfig?.css;
-			if (cssConfig === false) pkgStats.cssConfigStatus = "disabled";
-			else if (cssConfig !== void 0) pkgStats.cssConfigStatus = "configured";
-			const extraExports = pkgConfig?.exports ?? {};
-			const generatedExports = await generateExports(distFilesystem, distDir, pathTransform, cssConfig, extraExports, exportOptions);
-			const { prunedKeys } = await writePackageJsonExportsAtomic(fs, packageJsonPath, {
-				generatedExports: generatedExports.exports,
-				managedExportSpecifiers: Object.keys(generatedExports.exports),
-				originalPathBySpecifier: generatedExports.originalPathBySpecifier
-			}, write);
-			pkgStats.jsModules = generatedExports.jsCount;
-			pkgStats.cssExports = generatedExports.cssCount;
-			pkgStats.extraExports = Object.keys(extraExports).length;
-			pkgStats.totalExports = Object.keys(generatedExports.exports).length;
-			pkgStats.prunedExportKeys = prunedKeys;
-		}
-	} catch (caughtError) {
-		pkgStats.error = messageFrom(caughtError);
-	}
-	return pkgStats;
-}
-//#endregion
-export { syncExportsForWorkspacePackage };

package/dist/mirror/sync.mjs

@@ -1,88 +0,0 @@
-import { AppError, messageFrom } from "../core/errors.mjs";
-import { err, ok } from "../core/result.mjs";
-import { listWorkspacePackageDirectories } from "../core/workspace/resolver.mjs";
-import { normalizePath } from "./domain/path-normalizer.mjs";
-import { resolvePackageFilterUnderRoot } from "./package-path.mjs";
-import { syncExportsForWorkspacePackage } from "./sync-workspace-package.mjs";
-import path from "node:path";
-//#region src/mirror/sync.ts
-/**
-* @since 0.3.16-canary.0
-*/
-async function runMirrorSync(fs, input) {
-	const config = input.config ?? {};
-	const { listener } = input;
-	const write = input.write ?? true;
-	listener?.onBanner();
-	const startTime = performance.now();
-	try {
-		let targetPackages = [];
-		if (input.packageFilter) {
-			const filterOutcome = resolvePackageFilterUnderRoot(fs, input.rootDir, input.packageFilter);
-			if (!filterOutcome.ok) return filterOutcome;
-			targetPackages = [filterOutcome.value];
-			listener?.onProcessingMode({ kind: "single" });
-		} else {
-			const layoutOutcome = await listWorkspacePackageDirectories(input.rootDir, fs, false);
-			const { relPaths, multiSource } = mirrorTargetsFromWorkspaceLayout(input.rootDir, layoutOutcome);
-			targetPackages = relPaths;
-			listener?.onProcessingMode({
-				kind: "multi",
-				source: multiSource
-			});
-		}
-		const stats = {
-			packagesFound: targetPackages.length,
-			packagesProcessed: 0,
-			packagesSkipped: 0,
-			packagesErrored: 0,
-			totalExports: 0,
-			totalJsModules: 0,
-			totalCssExports: 0,
-			packageDetails: []
-		};
-		if (targetPackages.length === 0) {
-			listener?.onNoPackages();
-			listener?.onComplete(stats, (performance.now() - startTime) / 1e3);
-			return ok(stats);
-		}
-		let ordinal = 1;
-		for (const pkgPath of targetPackages) {
-			const pkgStats = await syncExportsForWorkspacePackage(fs, input.rootDir, pkgPath, config, write);
-			stats.packageDetails.push(pkgStats);
-			listener?.onPackageComplete(pkgStats, ordinal, targetPackages.length);
-			ordinal++;
-			accumulateStats(stats, pkgStats);
-		}
-		const elapsed = (performance.now() - startTime) / 1e3;
-		listener?.onComplete(stats, elapsed);
-		return ok(stats);
-	} catch (caughtError) {
-		return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));
-	}
-}
-function accumulateStats(stats, pkgStats) {
-	if (pkgStats.skipped) stats.packagesSkipped++;
-	else if (pkgStats.error !== null) stats.packagesErrored++;
-	else {
-		stats.packagesProcessed++;
-		stats.totalExports += pkgStats.totalExports;
-		stats.totalJsModules += pkgStats.jsModules;
-		stats.totalCssExports += pkgStats.cssExports;
-	}
-}
-function mirrorTargetsFromWorkspaceLayout(rootDir, layoutOutcome) {
-	if (layoutOutcome.layoutSource === "declared-empty") return {
-		relPaths: [],
-		multiSource: "declared-empty"
-	};
-	const multiSource = layoutOutcome.layoutSource;
-	const relPaths = layoutOutcome.packageDirectoryPathsAbsolute.map((absolutePath) => normalizePath(path.relative(rootDir, absolutePath))).filter((relativePath) => relativePath.length > 0);
-	relPaths.sort((left, right) => left.localeCompare(right));
-	return {
-		relPaths,
-		multiSource
-	};
-}
-//#endregion
-export { runMirrorSync };

package/dist/mirror/write-exports.mjs

@@ -1,94 +0,0 @@
-import { messageFrom } from "../core/errors.mjs";
-import { PACKAGE_JSON_EXPORT } from "./domain/constants.mjs";
-import { MirrorError, MirrorErrorCode } from "./domain/errors.mjs";
-//#region src/mirror/write-exports.ts
-/**
-* Writes `exports` into `package.json` via a temp file + rename (atomic on same volume).
-* Preserves a trailing newline after JSON.
-*
-* @since 0.3.16-canary.0
-*/
-async function writePackageJsonExportsAtomic(fs, packageJsonPath, mergeInput, write = true) {
-	function containsDistTarget(value) {
-		if (typeof value === "string") return value.startsWith("./dist/");
-		if (Array.isArray(value)) return value.some((entryValue) => containsDistTarget(entryValue));
-		if (value && typeof value === "object") return Object.values(value).some((entryValue) => containsDistTarget(entryValue));
-		return false;
-	}
-	/**
-	* Keep `./package.json` at the very end for aesthetics by default.
-	* If a catch-all `./*` exists, move `./package.json` before wildcards so it remains reachable.
-	*/
-	function exportSpecifierRank(exportSpecifier, hasCatchAllWildcard) {
-		if (exportSpecifier === ".") return 0;
-		if (exportSpecifier === "./package.json") return hasCatchAllWildcard ? 2 : 4;
-		if (exportSpecifier.includes("*")) return 3;
-		return 1;
-	}
-	function compareExportSpecifiers(leftSpecifier, rightSpecifier, pathBySpecifier, hasCatchAllWildcard) {
-		const leftRank = exportSpecifierRank(leftSpecifier, hasCatchAllWildcard);
-		const rightRank = exportSpecifierRank(rightSpecifier, hasCatchAllWildcard);
-		if (leftRank !== rightRank) return leftRank - rightRank;
-		const leftOriginalPath = pathBySpecifier[leftSpecifier] ?? leftSpecifier;
-		const rightOriginalPath = pathBySpecifier[rightSpecifier] ?? rightSpecifier;
-		const originalPathComparison = leftOriginalPath.localeCompare(rightOriginalPath);
-		if (originalPathComparison !== 0) return originalPathComparison;
-		return leftSpecifier.localeCompare(rightSpecifier);
-	}
-	const raw = await fs.readFile(packageJsonPath, "utf8");
-	const packageJson = JSON.parse(raw);
-	const existingExports = packageJson.exports;
-	const existingExportMap = existingExports && typeof existingExports === "object" && !Array.isArray(existingExports) ? existingExports : {};
-	const managedSpecifiers = new Set(mergeInput.managedExportSpecifiers);
-	const originalPathBySpecifier = { ...mergeInput.originalPathBySpecifier };
-	const mergedExportMap = {};
-	const prunedKeys = [];
-	for (const [exportSpecifier, exportValue] of Object.entries(existingExportMap)) {
-		if (exportSpecifier === "./package.json") {
-			mergedExportMap[exportSpecifier] = exportValue;
-			if (!(exportSpecifier in originalPathBySpecifier)) originalPathBySpecifier[exportSpecifier] = exportSpecifier;
-			continue;
-		}
-		if (!managedSpecifiers.has(exportSpecifier)) if (containsDistTarget(exportValue)) prunedKeys.push(exportSpecifier);
-		else {
-			mergedExportMap[exportSpecifier] = exportValue;
-			if (!(exportSpecifier in originalPathBySpecifier)) originalPathBySpecifier[exportSpecifier] = exportSpecifier;
-		}
-	}
-	for (const [exportSpecifier, exportValue] of Object.entries(mergeInput.generatedExports)) mergedExportMap[exportSpecifier] = exportValue;
-	if (!("./package.json" in mergedExportMap)) mergedExportMap[PACKAGE_JSON_EXPORT] = PACKAGE_JSON_EXPORT;
-	originalPathBySpecifier[PACKAGE_JSON_EXPORT] = PACKAGE_JSON_EXPORT;
-	const rootExport = mergedExportMap["."];
-	if (rootExport && typeof rootExport === "object" && !Array.isArray(rootExport)) {
-		const rootEntry = rootExport;
-		const requirePath = typeof rootEntry.require === "string" ? rootEntry.require : void 0;
-		const importPath = typeof rootEntry.import === "string" ? rootEntry.import : void 0;
-		const typesPath = typeof rootEntry.types === "string" ? rootEntry.types : void 0;
-		if (requirePath || importPath) packageJson.main = requirePath ?? importPath;
-		if (importPath && importPath.endsWith(".mjs")) packageJson.module = importPath;
-		if (typesPath) packageJson.types = typesPath;
-	}
-	const filesField = packageJson.files;
-	if (Array.isArray(filesField)) {
-		const normalizedFiles = filesField.filter((entry) => typeof entry === "string");
-		if (!normalizedFiles.includes("dist")) normalizedFiles.push("dist");
-		packageJson.files = normalizedFiles;
-	} else packageJson.files = ["dist"];
-	const sortedExportMap = {};
-	const hasCatchAllWildcard = "./*" in mergedExportMap;
-	for (const exportSpecifier of Object.keys(mergedExportMap).toSorted((leftSpecifier, rightSpecifier) => compareExportSpecifiers(leftSpecifier, rightSpecifier, originalPathBySpecifier, hasCatchAllWildcard))) sortedExportMap[exportSpecifier] = mergedExportMap[exportSpecifier];
-	if (!write) return { prunedKeys };
-	packageJson.exports = sortedExportMap;
-	const serialized = JSON.stringify(packageJson, null, 2) + "\n";
-	const tmpPath = `${packageJsonPath}.tmp`;
-	await fs.writeFile(tmpPath, serialized, "utf8");
-	try {
-		await fs.rename(tmpPath, packageJsonPath);
-	} catch (caughtRenameError) {
-		await fs.unlink(tmpPath).catch(() => {});
-		throw new MirrorError(MirrorErrorCode.PACKAGE_WRITE, `Failed to atomically update ${packageJsonPath}: ${messageFrom(caughtRenameError)}`, caughtRenameError instanceof Error ? { cause: caughtRenameError } : void 0);
-	}
-	return { prunedKeys };
-}
-//#endregion
-export { writePackageJsonExportsAtomic };

package/dist/tag/cli-result.mjs

@@ -1,11 +0,0 @@
-import "../core/exit-codes.mjs";
-//#region src/tag/cli-result.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function exitCodeForTagSyncResult(result) {
-	if (result.selectedTargets.length === 0) return 1;
-	return result.targetResults.some((targetResult) => targetResult.runError !== null) || result.hookError !== null ? 1 : 0;
-}
-//#endregion
-export { exitCodeForTagSyncResult };

package/dist/tag/cli-schema.mjs

@@ -1,15 +0,0 @@
-import { z } from "zod";
-//#region src/tag/cli-schema.ts
-/**
-* @since 0.3.16-canary.0
-*/
-const tagSyncRunRequestSchema = z.object({
-	rootDir: z.string().min(1),
-	write: z.boolean(),
-	json: z.boolean().optional(),
-	targetPath: z.string().optional(),
-	skipPackages: z.array(z.string()).optional(),
-	config: z.unknown().optional()
-});
-//#endregion
-export { tagSyncRunRequestSchema };

package/dist/tag/command.mjs

@@ -1,56 +0,0 @@
-import { logger } from "../core/logger.mjs";
-import { readOptionalPositionalArg } from "../core/cli/positional.mjs";
-import { consumeCliAppError } from "../core/cli/result-handle.mjs";
-import { nodeFilesystem } from "../core/filesystem/node.mjs";
-import { parseWithSchema } from "../core/schema-parse.mjs";
-import { exitCodeForTagSyncResult } from "./cli-result.mjs";
-import { tagSyncRunRequestSchema } from "./cli-schema.mjs";
-import { TagSyncProgressPresenter, presentTagSyncResult } from "./output.mjs";
-import { prepareTagSync } from "./prepare.mjs";
-import { runTagSync } from "./sync.mjs";
-import process from "node:process";
-import { Command } from "commander";
-//#region src/tag/command.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function createTagCommand() {
-	return new Command("tag").description("Add @since <version> JSDoc tags to exported declarations").argument("[target]", "Directory or file to tag (default: auto-discover workspace packages)").option("--dry-run", "Show summary without writing files", false).option("--json", "Print one JSON summary on stdout (suppresses human progress)", false).action(async (target, opts) => {
-		const prelude = await prepareTagSync(nodeFilesystem, {
-			currentWorkingDirectory: process.cwd(),
-			rawTarget: readOptionalPositionalArg(target)
-		});
-		if (!consumeCliAppError(prelude)) return;
-		const { rootDir, config, resolvedTargetPath } = prelude.value;
-		const tagConfig = config.tag ?? {};
-		const parsed = parseWithSchema(tagSyncRunRequestSchema, {
-			rootDir,
-			write: !opts.dryRun,
-			json: opts.json,
-			targetPath: resolvedTargetPath,
-			skipPackages: tagConfig.skipPackages,
-			config: tagConfig
-		});
-		if (!consumeCliAppError(parsed)) return;
-		const progressPresenter = new TagSyncProgressPresenter();
-		const tagOutcome = await runTagSync(nodeFilesystem, {
-			...parsed.value,
-			listener: parsed.value.json ? void 0 : progressPresenter
-		});
-		if (!consumeCliAppError(tagOutcome)) return;
-		if (parsed.value.json) {
-			logger.out(formatTagSyncJsonOutput(tagOutcome.value, rootDir));
-			process.exitCode = exitCodeForTagSyncResult(tagOutcome.value);
-		} else process.exitCode = presentTagSyncResult(tagOutcome.value, rootDir);
-	});
-}
-function formatTagSyncJsonOutput(result, rootDir) {
-	return JSON.stringify({
-		schemaVersion: 1,
-		ok: result.hookError === null,
-		cwd: rootDir,
-		result
-	});
-}
-//#endregion
-export { createTagCommand };

package/dist/tag/domain/types.mjs

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

package/dist/tag/output.mjs

@@ -1,87 +0,0 @@
-import { logger } from "../core/logger.mjs";
-import "../core/exit-codes.mjs";
-import { exitCodeForTagSyncResult } from "./cli-result.mjs";
-//#region src/tag/output.ts
-/**
-* @since 0.3.16-canary.0
-*/
-var TagSyncProgressPresenter = class TagSyncProgressPresenter {
-	onTargetStarted(target) {
-		logger.out(TagSyncProgressPresenter.formatProgress({
-			type: "target-started",
-			target
-		}));
-	}
-	onTargetCompleted(target, result) {
-		logger.out(TagSyncProgressPresenter.formatProgress({
-			type: "target-completed",
-			target,
-			result
-		}));
-	}
-	static formatProgress(event) {
-		const targetDisplayName = (target) => target.packageName ?? target.rootRelativeTargetPath;
-		if (event.type === "target-started") return `[tag] Processing ${targetDisplayName(event.target)}...`;
-		const changedFiles = event.result.result?.filesChanged ?? 0;
-		return `[tag] Done ${targetDisplayName(event.target)} (${changedFiles} changes)`;
-	}
-};
-const colorReset = "\x1B[0m";
-const colors = {
-	red: "\x1B[31m",
-	green: "\x1B[32m",
-	yellow: "\x1B[33m"
-};
-/**
-* @since 0.3.16-canary.0
-*/
-function presentTagSyncResult(result, rootDir) {
-	logger.out(formatTargetTable(result.selectedTargets, rootDir));
-	if (result.selectedTargets.length === 0) {
-		logger.err("No packages found in workspace. Check your pnpm-workspace.yaml or provide an explicit target path.");
-		return 1;
-	}
-	const warningsAndErrorsSection = formatWarningsAndErrors(result);
-	if (warningsAndErrorsSection) logger.err(warningsAndErrorsSection);
-	logger.out(formatSummary(result));
-	return exitCodeForTagSyncResult(result);
-}
-function withColorizedLine(line, colorCode) {
-	return `${colorCode}${line}${colorReset}`;
-}
-function warningsAndErrorsFromResult(result) {
-	const entries = [];
-	for (const targetResult of result.targetResults) if (targetResult.runError) entries.push(targetResult.runError);
-	if (result.hookError) entries.push(result.hookError);
-	return entries;
-}
-function formatTargetTable(targets, rootDir) {
-	const packageColumnWidth = Math.max(7, ...targets.map((target) => (target.packageName ?? "-").length));
-	const pathColumnWidth = Math.max(4, ...targets.map((target) => target.rootRelativeTargetPath.length));
-	const lines = [];
-	lines.push(`[tag] Root: ${rootDir}`);
-	lines.push(`[tag] Resolved targets: ${targets.length}`);
-	lines.push("[tag] Targets:");
-	lines.push(`  ${"package".padEnd(packageColumnWidth)}   ${"path".padEnd(pathColumnWidth)}   source`);
-	lines.push(`  ${"-".repeat(packageColumnWidth)}   ${"-".repeat(pathColumnWidth)}   ${"-".repeat(6)}`);
-	for (const target of targets) lines.push(`  ${(target.packageName ?? "-").padEnd(packageColumnWidth)}   ${target.rootRelativeTargetPath.padEnd(pathColumnWidth)}   ${target.source}`);
-	return lines.join("\n");
-}
-function formatWarningsAndErrors(result) {
-	const entries = warningsAndErrorsFromResult(result);
-	if (entries.length === 0) return null;
-	const lines = [withColorizedLine("⚠️ Warnings & Errors", colors.yellow)];
-	for (const entry of entries) lines.push(withColorizedLine(`- ${entry}`, colors.red));
-	return lines.join("\n");
-}
-function formatSummary(result) {
-	const isDryRun = result.mode === "dry-run";
-	const summaryPrefix = isDryRun ? "[tag:dry-run]" : "[tag]";
-	const versionSuffix = result.versionSummary === "mixed" && result.distinctVersions.length > 0 ? ` [${result.distinctVersions.join(", ")}]` : "";
-	const summaryColor = result.targetResults.some((targetResult) => targetResult.runError !== null) || result.hookError !== null ? colors.red : isDryRun ? colors.yellow : colors.green;
-	const lines = [withColorizedLine(`${summaryPrefix} version=${result.versionSummary}${versionSuffix} files=${result.filesChanged}/${result.filesScanned} declarations=${result.taggedDeclarations}`, summaryColor)];
-	if (result.skippedPackages.length > 0) lines.push(`[tag] Skipped: ${result.skippedPackages.length} package(s)`);
-	return lines.join("\n");
-}
-//#endregion
-export { TagSyncProgressPresenter, presentTagSyncResult };

package/dist/tag/prepare.mjs

@@ -1,29 +0,0 @@
-import { ok } from "../core/result.mjs";
-import { loadCodefastConfig } from "../core/config.mjs";
-import { findRepoRoot } from "../core/workspace/resolver.mjs";
-import { resolveProvidedTagTargetPath } from "./resolve-target-path.mjs";
-//#region src/tag/prepare.ts
-/**
-* @since 0.3.16-canary.0
-*/
-async function prepareTagSync(fs, args) {
-	let rootDir;
-	try {
-		rootDir = findRepoRoot(args.currentWorkingDirectory, fs);
-	} catch {
-		rootDir = args.currentWorkingDirectory;
-	}
-	const loadedOutcome = await loadCodefastConfig(rootDir, fs);
-	if (!loadedOutcome.ok) return loadedOutcome;
-	const resolvedTargetPath = resolveProvidedTagTargetPath(fs, {
-		currentWorkingDirectory: args.currentWorkingDirectory,
-		rawTarget: args.rawTarget
-	});
-	return ok({
-		rootDir,
-		config: loadedOutcome.value.config,
-		resolvedTargetPath
-	});
-}
-//#endregion
-export { prepareTagSync };

package/dist/tag/resolve-target-path.mjs

@@ -1,12 +0,0 @@
-import path from "node:path";
-//#region src/tag/resolve-target-path.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function resolveProvidedTagTargetPath(fs, args) {
-	if (args.rawTarget === void 0) return;
-	const candidate = path.isAbsolute(args.rawTarget) ? path.resolve(args.rawTarget) : path.resolve(args.currentWorkingDirectory, args.rawTarget);
-	return fs.canonicalPathSync(candidate);
-}
-//#endregion
-export { resolveProvidedTagTargetPath };

package/dist/tag/since-writer.mjs

@@ -1,131 +0,0 @@
-import { applyEditsDescending, indentOfLineContaining } from "../core/source-text-edit.mjs";
-import ts from "typescript";
-//#region src/tag/since-writer.ts
-/**
-* @since 0.3.16-canary.0
-*/
-var TagSinceWriter = class {
-	fs;
-	sinceDocumentationTag = "@since";
-	constructor(fs) {
-		this.fs = fs;
-	}
-	applySinceTagsToFile(filePath, version, write) {
-		const sourceText = this.fs.readFileSync(filePath, "utf8");
-		const sf = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, filePath.endsWith(".tsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
-		const edits = [];
-		for (const declaration of this.collectExportedDeclarations(sf)) {
-			const edit = this.makeDeclarationSinceLine(declaration, sf, sourceText, version);
-			if (edit) edits.push(edit);
-		}
-		if (edits.length > 0 && write) {
-			const updated = applyEditsDescending(sourceText, edits);
-			this.fs.writeFileSync(filePath, updated, "utf8");
-		}
-		return {
-			filePath,
-			taggedDeclarations: edits.length,
-			changed: edits.length > 0
-		};
-	}
-	hasExportModifier(node) {
-		return (ts.canHaveModifiers(node) ? ts.getModifiers(node) : void 0)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword) ?? false;
-	}
-	isTaggableDeclaration(node) {
-		return ts.isFunctionDeclaration(node) || ts.isClassDeclaration(node) || ts.isInterfaceDeclaration(node) || ts.isTypeAliasDeclaration(node) || ts.isEnumDeclaration(node) || ts.isVariableStatement(node);
-	}
-	addDeclarationName(registry, name, declaration) {
-		if (!registry.has(name)) {
-			registry.set(name, /* @__PURE__ */ new Set([declaration]));
-			return;
-		}
-		const bucket = registry.get(name);
-		if (bucket === void 0) throw new Error(`declaration registry missing set for ${name}`);
-		bucket.add(declaration);
-	}
-	collectLocalNamedDeclarations(sf) {
-		const declarations = /* @__PURE__ */ new Map();
-		for (const statement of sf.statements) {
-			if (ts.isFunctionDeclaration(statement) && statement.name) {
-				this.addDeclarationName(declarations, statement.name.text, statement);
-				continue;
-			}
-			if (ts.isClassDeclaration(statement) && statement.name) {
-				this.addDeclarationName(declarations, statement.name.text, statement);
-				continue;
-			}
-			if (ts.isInterfaceDeclaration(statement)) {
-				this.addDeclarationName(declarations, statement.name.text, statement);
-				continue;
-			}
-			if (ts.isTypeAliasDeclaration(statement)) {
-				this.addDeclarationName(declarations, statement.name.text, statement);
-				continue;
-			}
-			if (ts.isEnumDeclaration(statement)) {
-				this.addDeclarationName(declarations, statement.name.text, statement);
-				continue;
-			}
-			if (!ts.isVariableStatement(statement)) continue;
-			for (const declaration of statement.declarationList.declarations) if (ts.isIdentifier(declaration.name)) this.addDeclarationName(declarations, declaration.name.text, statement);
-		}
-		return declarations;
-	}
-	collectExportedDeclarations(sf) {
-		const exported = /* @__PURE__ */ new Set();
-		const localNamed = this.collectLocalNamedDeclarations(sf);
-		for (const statement of sf.statements) {
-			if (this.isTaggableDeclaration(statement) && this.hasExportModifier(statement)) {
-				exported.add(statement);
-				continue;
-			}
-			if (ts.isExportDeclaration(statement) && !statement.moduleSpecifier && statement.exportClause && ts.isNamedExports(statement.exportClause)) {
-				for (const element of statement.exportClause.elements) {
-					const localName = element.propertyName?.text ?? element.name.text;
-					const declarations = localNamed.get(localName);
-					if (!declarations) continue;
-					for (const declaration of declarations) exported.add(declaration);
-				}
-				continue;
-			}
-			if (!ts.isExportAssignment(statement) || !ts.isIdentifier(statement.expression)) continue;
-			const declarations = localNamed.get(statement.expression.text);
-			if (!declarations) continue;
-			for (const declaration of declarations) exported.add(declaration);
-		}
-		return exported;
-	}
-	makeJSDocSinceLine(existingComment, sourceText, version) {
-		const commentText = sourceText.slice(existingComment.pos, existingComment.end);
-		const baseIndent = indentOfLineContaining(sourceText, existingComment.pos);
-		const normalizedBodyLines = commentText.replace(/^\/\*\*\s?/, "").replace(/\s*\*\/$/, "").split("\n").map((line) => line.replace(/^\s*\*\s?/, "").replace(/\s+$/, "")).filter((line, lineIndex, lines) => {
-			if (line.length > 0) return true;
-			const hasNonEmptyBefore = lines.slice(0, lineIndex).some((value) => value.length > 0);
-			const hasNonEmptyAfter = lines.slice(lineIndex + 1).some((value) => value.length > 0);
-			return hasNonEmptyBefore && hasNonEmptyAfter;
-		});
-		const replacement = `/**\n${normalizedBodyLines.length > 0 ? `${normalizedBodyLines.map((line) => line.length > 0 ? `${baseIndent} * ${line}` : `${baseIndent} *`).join("\n")}\n${baseIndent} *\n` : ""}${baseIndent} * ${this.sinceDocumentationTag} ${version}\n${baseIndent} */`;
-		return {
-			start: existingComment.pos,
-			end: existingComment.end,
-			replacement
-		};
-	}
-	makeSinceOnlyJSDocBlock(declarationIndent, version) {
-		return `/**\n${declarationIndent} * ${this.sinceDocumentationTag} ${version}\n${declarationIndent} */`;
-	}
-	makeDeclarationSinceLine(declaration, sf, sourceText, version) {
-		if (ts.getJSDocTags(declaration).some((tag) => tag.tagName.text === "since")) return;
-		const lastJsDoc = ts.getJSDocCommentsAndTags(declaration).filter(ts.isJSDoc).at(-1);
-		if (lastJsDoc) return this.makeJSDocSinceLine(lastJsDoc, sourceText, version);
-		const start = declaration.getStart(sf);
-		const indent = indentOfLineContaining(sourceText, start);
-		return {
-			start,
-			end: start,
-			replacement: `${indent}${this.makeSinceOnlyJSDocBlock(indent, version)}\n${indent}`
-		};
-	}
-};
-//#endregion
-export { TagSinceWriter };