@codefast/cli 0.5.0-canary.5 → 0.5.0-canary.7

package/dist/tag/domain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tag/domain/types.ts"],"names":[],"mappings":""}

package/dist/tag/output.js

@@ -0,0 +1,101 @@
+import { CLI_EXIT_GENERAL_ERROR } from "#/core/exit-codes";
+import { logger } from "#/core/logger";
+import { exitCodeForTagSyncResult } from "#/tag/cli-result";
+/**
+ * @since 0.3.16-canary.0
+ */
+export 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
+ */
+export 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 CLI_EXIT_GENERAL_ERROR;
+    }
+    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("package".length, ...targets.map((target) => (target.packageName ?? "-").length));
+    const pathColumnWidth = Math.max("path".length, ...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("source".length)}`);
+    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 hasError = result.targetResults.some((targetResult) => targetResult.runError !== null) || result.hookError !== null;
+    const summaryColor = hasError ? 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");
+}
+//# sourceMappingURL=output.js.map

package/dist/tag/output.js.map

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

package/dist/tag/prepare.js

@@ -0,0 +1,30 @@
+import { loadCodefastConfig } from "#/core/config";
+import { ok } from "#/core/result";
+import { findRepoRoot } from "#/core/workspace/resolver";
+import { resolveProvidedTagTargetPath } from "#/tag/resolve-target-path";
+/**
+ * @since 0.3.16-canary.0
+ */
+export 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,
+    });
+}
+//# sourceMappingURL=prepare.js.map

package/dist/tag/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../../src/tag/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAInD,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAEzE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAkB,EAClB,IAGC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC;IACzC,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACtB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,kBAAkB,GAAG,4BAA4B,CAAC,EAAE,EAAE;QAC1D,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;QACrD,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;QACR,OAAO;QACP,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM;QAClC,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,14 @@
+import path from "node:path";
+/**
+ * @since 0.3.16-canary.0
+ */
+export function resolveProvidedTagTargetPath(fs, args) {
+    if (args.rawTarget === undefined) {
+        return undefined;
+    }
+    const candidate = path.isAbsolute(args.rawTarget)
+        ? path.resolve(args.rawTarget)
+        : path.resolve(args.currentWorkingDirectory, args.rawTarget);
+    return fs.canonicalPathSync(candidate);
+}
+//# sourceMappingURL=resolve-target-path.js.map

package/dist/tag/resolve-target-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-target-path.js","sourceRoot":"","sources":["../../src/tag/resolve-target-path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,EAAkB,EAClB,IAGC;IAED,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;QAC/C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAC9B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/D,OAAO,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC"}

package/dist/tag/since-writer.js

@@ -0,0 +1,231 @@
+import { parseSync } from "oxc-parser";
+import { applyEditsDescending, indentOfLineContaining } from "#/core/source-text-edit";
+/**
+ * Top-level statement kinds that carry a `@since` tag: function, class, interface,
+ * type alias, enum, and variable declaration.
+ */
+const TAGGABLE_DECLARATION_TYPES = new Set([
+    "FunctionDeclaration",
+    "ClassDeclaration",
+    "TSInterfaceDeclaration",
+    "TSTypeAliasDeclaration",
+    "TSEnumDeclaration",
+    "VariableDeclaration",
+]);
+function isOxcNode(value) {
+    return typeof value === "object" && value !== null && typeof value.type === "string";
+}
+function identifierName(node) {
+    if (isOxcNode(node) && node.type === "Identifier" && typeof node.name === "string") {
+        return node.name;
+    }
+    return undefined;
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export class TagSinceWriter {
+    fs;
+    sinceDocumentationTag = "@since";
+    constructor(fs) {
+        this.fs = fs;
+    }
+    applySinceTagsToFile(filePath, version, write) {
+        const sourceText = this.fs.readFileSync(filePath, "utf8");
+        const { program, comments } = parseSync(filePath, sourceText);
+        const statements = program.body;
+        const jsDocComments = comments.filter((comment) => comment.type === "Block" && comment.value.startsWith("*"));
+        const edits = [];
+        for (const declaration of this.collectExportedDeclarations(statements)) {
+            const edit = this.makeDeclarationSinceLine(declaration, jsDocComments, 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,
+        };
+    }
+    /**
+     * The taggable declaration a top-level statement introduces, resolving the
+     * `export … <decl>` wrapper to the wrapper node — its `start` sits at `export`,
+     * matching `ts.getStart` on a modifier-bearing declaration.
+     */
+    taggableDeclarationOf(statement) {
+        if (TAGGABLE_DECLARATION_TYPES.has(statement.type)) {
+            return { anchor: statement, names: this.declarationNames(statement) };
+        }
+        if (statement.type === "ExportNamedDeclaration" || statement.type === "ExportDefaultDeclaration") {
+            const declaration = statement.declaration;
+            if (isOxcNode(declaration) && TAGGABLE_DECLARATION_TYPES.has(declaration.type)) {
+                return { anchor: statement, names: this.declarationNames(declaration) };
+            }
+        }
+        return undefined;
+    }
+    declarationNames(declaration) {
+        if (declaration.type === "VariableDeclaration") {
+            const declarators = Array.isArray(declaration.declarations)
+                ? declaration.declarations
+                : [];
+            const names = [];
+            for (const declarator of declarators) {
+                const name = identifierName(declarator.id);
+                if (name !== undefined) {
+                    names.push(name);
+                }
+            }
+            return names;
+        }
+        const name = identifierName(declaration.id);
+        return name === undefined ? [] : [name];
+    }
+    addDeclarationName(registry, name, anchor) {
+        const bucket = registry.get(name);
+        if (bucket === undefined) {
+            registry.set(name, new Set([anchor]));
+            return;
+        }
+        bucket.add(anchor);
+    }
+    collectLocalNamedDeclarations(statements) {
+        const declarations = new Map();
+        for (const statement of statements) {
+            const taggable = this.taggableDeclarationOf(statement);
+            if (!taggable) {
+                continue;
+            }
+            for (const name of taggable.names) {
+                this.addDeclarationName(declarations, name, taggable.anchor);
+            }
+        }
+        return declarations;
+    }
+    collectExportedDeclarations(statements) {
+        const exported = new Set();
+        const localNamed = this.collectLocalNamedDeclarations(statements);
+        const addByLocalName = (name) => {
+            if (name === undefined) {
+                return;
+            }
+            const anchors = localNamed.get(name);
+            if (!anchors) {
+                return;
+            }
+            for (const anchor of anchors) {
+                exported.add(anchor);
+            }
+        };
+        for (const statement of statements) {
+            if (statement.type === "ExportNamedDeclaration") {
+                // `export function foo() {}` — the wrapper is itself the taggable anchor.
+                if (isOxcNode(statement.declaration)) {
+                    const taggable = this.taggableDeclarationOf(statement);
+                    if (taggable) {
+                        exported.add(taggable.anchor);
+                    }
+                    continue;
+                }
+                // `export { local }` (no re-export source) — resolve each local binding.
+                if (statement.source === null && Array.isArray(statement.specifiers)) {
+                    for (const specifier of statement.specifiers) {
+                        addByLocalName(identifierName(specifier.local));
+                    }
+                }
+                continue;
+            }
+            if (TAGGABLE_DECLARATION_TYPES.has(statement.type)) {
+                continue;
+            }
+            // `export default function foo() {}` — declaration is the taggable anchor.
+            if (statement.type === "ExportDefaultDeclaration") {
+                const taggable = this.taggableDeclarationOf(statement);
+                if (taggable) {
+                    exported.add(taggable.anchor);
+                    continue;
+                }
+                // `export default localName` — resolve the referenced declaration.
+                addByLocalName(identifierName(statement.declaration));
+                continue;
+            }
+            // `export = localName`.
+            if (statement.type === "TSExportAssignment") {
+                addByLocalName(identifierName(statement.expression));
+            }
+        }
+        return exported;
+    }
+    /**
+     * The JSDoc block documenting `anchor`: the nearest preceding `/** … *\/` whose
+     * gap to the declaration is whitespace only, mirroring TS comment attachment.
+     */
+    associatedJsDoc(anchor, jsDocComments, sourceText) {
+        let associated;
+        for (const comment of jsDocComments) {
+            if (comment.end > anchor.start) {
+                break;
+            }
+            if (/^\s*$/.test(sourceText.slice(comment.end, anchor.start))) {
+                associated = comment;
+            }
+        }
+        return associated;
+    }
+    jsDocHasSinceTag(comment) {
+        return comment.value
+            .split("\n")
+            .map((line) => line.replace(/^\s*\*?\s?/, ""))
+            .some((line) => /^@since\b/.test(line));
+    }
+    makeJSDocSinceLine(commentStart, commentEnd, sourceText, version) {
+        const commentText = sourceText.slice(commentStart, commentEnd);
+        const baseIndent = indentOfLineContaining(sourceText, commentStart);
+        const rawBody = commentText.replace(/^\/\*\*\s?/, "").replace(/\s*\*\/$/, "");
+        const normalizedBodyLines = rawBody
+            .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 formattedBody = normalizedBodyLines.length > 0
+            ? `${normalizedBodyLines
+                .map((line) => (line.length > 0 ? `${baseIndent} * ${line}` : `${baseIndent} *`))
+                .join("\n")}\n${baseIndent} *\n`
+            : "";
+        const tag = this.sinceDocumentationTag;
+        const replacement = `/**\n${formattedBody}${baseIndent} * ${tag} ${version}\n${baseIndent} */`;
+        return { start: commentStart, end: commentEnd, replacement };
+    }
+    makeSinceOnlyJSDocBlock(declarationIndent, version) {
+        const tag = this.sinceDocumentationTag;
+        return `/**\n${declarationIndent} * ${tag} ${version}\n${declarationIndent} */`;
+    }
+    makeDeclarationSinceLine(anchor, jsDocComments, sourceText, version) {
+        const existing = this.associatedJsDoc(anchor, jsDocComments, sourceText);
+        if (existing) {
+            if (this.jsDocHasSinceTag(existing)) {
+                return undefined;
+            }
+            return this.makeJSDocSinceLine(existing.start, existing.end, sourceText, version);
+        }
+        const start = anchor.start;
+        const indent = indentOfLineContaining(sourceText, start);
+        return {
+            start,
+            end: start,
+            replacement: `${indent}${this.makeSinceOnlyJSDocBlock(indent, version)}\n${indent}`,
+        };
+    }
+}
+//# sourceMappingURL=since-writer.js.map

package/dist/tag/since-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"since-writer.js","sourceRoot":"","sources":["../../src/tag/since-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAuBvF;;;GAGG;AACH,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,qBAAqB;IACrB,kBAAkB;IAClB,wBAAwB;IACxB,wBAAwB;IACxB,mBAAmB;IACnB,qBAAqB;CACtB,CAAC,CAAC;AAEH,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC/G,CAAC;AAED,SAAS,cAAc,CAAC,IAAa;IACnC,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,cAAc;IAGI,EAAE;IAFd,qBAAqB,GAAG,QAAQ,CAAC;IAElD,YAA6B,EAAkB;kBAAlB,EAAE;IAAmB,CAAC;IAEnD,oBAAoB,CAAC,QAAgB,EAAE,OAAe,EAAE,KAAc;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAI,OAAuD,CAAC,IAAI,CAAC;QACjF,MAAM,aAAa,GAAI,QAAsC,CAAC,MAAM,CAClE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CACvE,CAAC;QAEF,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,2BAA2B,CAAC,UAAU,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,GAAG,IAAI,CAAC,wBAAwB,CAAC,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5F,IAAI,IAAI,EAAE,CAAC;gBACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACxD,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;QAED,OAAO;YACL,QAAQ;YACR,kBAAkB,EAAE,KAAK,CAAC,MAAM;YAChC,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,qBAAqB,CAAC,SAAkB;QAC9C,IAAI,0BAA0B,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QACxE,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,wBAAwB,IAAI,SAAS,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;YACjG,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;YAC1C,IAAI,SAAS,CAAC,WAAW,CAAC,IAAI,0BAA0B,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1E,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,gBAAgB,CAAC,WAAoB;QAC3C,IAAI,WAAW,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC;gBACzD,CAAC,CAAE,WAAW,CAAC,YAAuC;gBACtD,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAEO,kBAAkB,CAAC,QAAmC,EAAE,IAAY,EAAE,MAAe;QAC3F,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAEO,6BAA6B,CAAC,UAAkC;QACtE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAwB,CAAC;QACrD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAClC,IAAI,CAAC,kBAAkB,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,2BAA2B,CAAC,UAAkC;QACpE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC;QAElE,MAAM,cAAc,GAAG,CAAC,IAAwB,EAAQ,EAAE;YACxD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO;YACT,CAAC;YACD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;YACT,CAAC;YACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;QAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,SAAS,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;gBAChD,0EAA0E;gBAC1E,IAAI,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;oBACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;oBACvD,IAAI,QAAQ,EAAE,CAAC;wBACb,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAChC,CAAC;oBACD,SAAS;gBACX,CAAC;gBACD,yEAAyE;gBACzE,IAAI,SAAS,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrE,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,UAAoC,EAAE,CAAC;wBACvE,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;oBAClD,CAAC;gBACH,CAAC;gBACD,SAAS;YACX,CAAC;YAED,IAAI,0BAA0B,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,SAAS;YACX,CAAC;YAED,2EAA2E;YAC3E,IAAI,SAAS,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;gBAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;gBACvD,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAC9B,SAAS;gBACX,CAAC;gBACD,mEAAmE;gBACnE,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;gBACtD,SAAS;YACX,CAAC;YAED,wBAAwB;YACxB,IAAI,SAAS,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;gBAC5C,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACK,eAAe,CACrB,MAAe,EACf,aAAwC,EACxC,UAAkB;QAElB,IAAI,UAAkC,CAAC;QACvC,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC/B,MAAM;YACR,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC9D,UAAU,GAAG,OAAO,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,gBAAgB,CAAC,OAAmB;QAC1C,OAAO,OAAO,CAAC,KAAK;aACjB,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;aAC7C,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,CAAC;IAEO,kBAAkB,CAAC,YAAoB,EAAE,UAAkB,EAAE,UAAkB,EAAE,OAAe;QACtG,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,sBAAsB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9E,MAAM,mBAAmB,GAAG,OAAO;aAChC,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;aAChE,MAAM,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE;YACjC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,iBAAiB,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACtF,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACtF,OAAO,iBAAiB,IAAI,gBAAgB,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEL,MAAM,aAAa,GACjB,mBAAmB,CAAC,MAAM,GAAG,CAAC;YAC5B,CAAC,CAAC,GAAG,mBAAmB;iBACnB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC;iBAChF,IAAI,CAAC,IAAI,CAAC,KAAK,UAAU,MAAM;YACpC,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC;QACvC,MAAM,WAAW,GAAG,QAAQ,aAAa,GAAG,UAAU,MAAM,GAAG,IAAI,OAAO,KAAK,UAAU,KAAK,CAAC;QAC/F,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IAC/D,CAAC;IAEO,uBAAuB,CAAC,iBAAyB,EAAE,OAAe;QACxE,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC;QACvC,OAAO,QAAQ,iBAAiB,MAAM,GAAG,IAAI,OAAO,KAAK,iBAAiB,KAAK,CAAC;IAClF,CAAC;IAEO,wBAAwB,CAC9B,MAAe,EACf,aAAwC,EACxC,UAAkB,EAClB,OAAe;QAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;QACzE,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpC,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,MAAM,GAAG,sBAAsB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO;YACL,KAAK;YACL,GAAG,EAAE,KAAK;YACV,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EAAE;SACpF,CAAC;IACJ,CAAC;CACF"}

package/dist/tag/sync.js

@@ -0,0 +1,166 @@
+import path from "node:path";
+import { AppError } from "#/core/errors";
+import { messageFrom } from "#/core/errors";
+import { createAnyGlobMatcher } from "#/core/glob";
+import { err, ok } from "#/core/result";
+import { resolveTagTargetCandidates } from "#/tag/target-candidates";
+import { runTagOnTarget } from "#/tag/target-runner";
+/**
+ * @since 0.3.16-canary.0
+ */
+export async function runTagSync(fs, input) {
+    try {
+        const tagConfig = input.config;
+        const targetCandidates = await resolveTagTargetCandidates(fs, input.rootDir, input.targetPath);
+        const { includedCandidates, skippedPackages } = filterSkippedCandidates(targetCandidates, input.skipPackages);
+        const selectedTargets = includedCandidates.map((candidate) => resolveTargetSelection(fs, candidate, input.rootDir));
+        const targetExecutionResults = await Promise.all(selectedTargets.map((resolvedTarget) => runOnResolvedTarget(fs, resolvedTarget, input.write, input.listener)));
+        const allFileResults = targetExecutionResults.flatMap((targetResult) => targetResult.result?.fileResults ?? []);
+        const filesScanned = targetExecutionResults.reduce((sum, targetResult) => sum + (targetResult.result?.filesScanned ?? 0), 0);
+        const filesChanged = targetExecutionResults.reduce((sum, targetResult) => sum + (targetResult.result?.filesChanged ?? 0), 0);
+        const taggedDeclarations = targetExecutionResults.reduce((sum, targetResult) => sum + (targetResult.result?.taggedDeclarations ?? 0), 0);
+        const modifiedFiles = allFileResults.filter((entry) => entry.changed).map((entry) => entry.filePath);
+        const hookError = input.write && modifiedFiles.length > 0
+            ? await runTagOnAfterWriteHook(tagConfig?.onAfterWrite, modifiedFiles)
+            : null;
+        const versionsSet = extractDistinctVersions(targetExecutionResults);
+        const distinctVersions = [...versionsSet].toSorted((left, right) => left.localeCompare(right));
+        return ok({
+            mode: input.write ? "applied" : "dry-run",
+            selectedTargets,
+            skippedPackages,
+            targetResults: targetExecutionResults,
+            filesScanned,
+            filesChanged,
+            taggedDeclarations,
+            versionSummary: summarizeVersions(versionsSet),
+            distinctVersions,
+            modifiedFiles,
+            hookError,
+        });
+    }
+    catch (caughtError) {
+        return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));
+    }
+}
+async function runTagOnAfterWriteHook(hook, modifiedFiles) {
+    if (!hook || modifiedFiles.length === 0) {
+        return null;
+    }
+    try {
+        await hook({ files: modifiedFiles });
+        return null;
+    }
+    catch (caughtHookError) {
+        return `[tag] onAfterWrite hook failed: ${messageFrom(caughtHookError)}`;
+    }
+}
+function summarizeVersions(distinctVersions) {
+    if (distinctVersions.size === 0) {
+        return "none";
+    }
+    if (distinctVersions.size > 1) {
+        return "mixed";
+    }
+    return distinctVersions.values().next().value ?? "none";
+}
+function extractDistinctVersions(targetResults) {
+    return new Set(targetResults
+        .map((targetResult) => targetResult.result?.version)
+        .filter((version) => typeof version === "string" && version.length > 0));
+}
+function chooseWorkspacePackageTargetPath(fs, candidate) {
+    if (candidate.source !== "workspace-package") {
+        return {
+            targetPath: candidate.candidatePath,
+            source: candidate.source,
+        };
+    }
+    const preferredSourceDir = path.join(candidate.candidatePath, "src");
+    try {
+        if (fs.statSync(preferredSourceDir).isDirectory()) {
+            return { targetPath: preferredSourceDir, source: "workspace-package-selected-src" };
+        }
+    }
+    catch {
+        // preferredSourceDir does not exist; fall through to package root
+    }
+    return {
+        targetPath: candidate.candidatePath,
+        source: "workspace-package-selected-root",
+    };
+}
+function resolveTargetSelection(fs, candidate, rootDir) {
+    const selectedTarget = chooseWorkspacePackageTargetPath(fs, candidate);
+    const rootRelativeTargetPath = path.relative(rootDir, selectedTarget.targetPath).split(path.sep).join("/");
+    return {
+        targetPath: selectedTarget.targetPath,
+        rootRelativeTargetPath: rootRelativeTargetPath || ".",
+        source: selectedTarget.source,
+        packageDir: candidate.packageDir,
+        packageName: candidate.packageName,
+    };
+}
+/**
+ * Partition tag target candidates into those to tag and those to skip, matching
+ * each candidate's package name against `skipPackages` as glob patterns.
+ * Candidates without a package name (e.g. an explicit-target path) are never skipped.
+ *
+ * @since 0.5.0-canary.0
+ */
+export function filterSkippedCandidates(targetCandidates, skipPackages) {
+    if (!skipPackages || skipPackages.length === 0) {
+        return {
+            includedCandidates: targetCandidates,
+            skippedPackages: [],
+        };
+    }
+    const isSkipped = createAnyGlobMatcher(skipPackages);
+    const includedCandidates = [];
+    const skippedPackages = [];
+    for (const candidate of targetCandidates) {
+        const packageName = candidate.packageName;
+        if (packageName && isSkipped(packageName)) {
+            skippedPackages.push(packageName);
+            continue;
+        }
+        includedCandidates.push(candidate);
+    }
+    return { includedCandidates, skippedPackages };
+}
+async function runOnResolvedTarget(fs, resolvedTarget, write, listener) {
+    listener?.onTargetStarted(resolvedTarget);
+    const absoluteTargetPath = path.resolve(resolvedTarget.targetPath);
+    if (!fs.existsSync(absoluteTargetPath)) {
+        const missingTargetResult = {
+            target: resolvedTarget,
+            targetExists: false,
+            runError: `Not found: ${absoluteTargetPath}`,
+            result: null,
+        };
+        listener?.onTargetCompleted(resolvedTarget, missingTargetResult);
+        return missingTargetResult;
+    }
+    try {
+        const runResult = runTagOnTarget(fs, absoluteTargetPath, { write });
+        const targetRunResult = {
+            target: resolvedTarget,
+            targetExists: true,
+            runError: null,
+            result: runResult,
+        };
+        listener?.onTargetCompleted(resolvedTarget, targetRunResult);
+        return targetRunResult;
+    }
+    catch (caughtRunError) {
+        const failedTargetRunResult = {
+            target: resolvedTarget,
+            targetExists: true,
+            runError: messageFrom(caughtRunError),
+            result: null,
+        };
+        listener?.onTargetCompleted(resolvedTarget, failedTargetRunResult);
+        return failedTargetRunResult;
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/tag/sync.js.map

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