@vitest-agent/sdk 7.1.0 → 9.0.0

package/utils/format-console.js

@@ -1,222 +0,0 @@
-import { ansi } from "./ansi.js";
-import { formatScopedCoverageNote } from "./format-scoped-coverage-note.js";
-
-// src/utils/format-console.ts
-/**
-* Return the metric with the lowest percentage from a `FileCoverageReport`.
-*
-* @remarks
-* Used to surface the single worst coverage metric per file in console output,
-* keeping the display compact. Labels are abbreviated: `"Stmts"`, `"Branch"`,
-* `"Funcs"`, `"Lines"`.
-*
-* @param f - File coverage report to analyze
-* @returns Object with `label` and `pct` of the worst metric
-*
-* @internal
-*/
-function getWorstMetric(f) {
-	return [
-		{
-			label: "Stmts",
-			pct: f.summary.statements
-		},
-		{
-			label: "Branch",
-			pct: f.summary.branches
-		},
-		{
-			label: "Funcs",
-			pct: f.summary.functions
-		},
-		{
-			label: "Lines",
-			pct: f.summary.lines
-		}
-	].reduce((worst, m) => m.pct < worst.pct ? m : worst);
-}
-/**
-* Strip the working directory prefix from a file path to produce a
-* project-relative path for display.
-*
-* @param filePath - Absolute or relative file path
-* @param cwd - Working directory to strip
-* @returns Project-relative path string
-*
-* @internal
-*/
-function relativePath(filePath, cwd) {
-	if (filePath.startsWith(cwd)) {
-		const rel = filePath.slice(cwd.length);
-		return rel.startsWith("/") ? rel.slice(1) : rel;
-	}
-	return filePath;
-}
-/**
-* Determine the output tier based on test results and coverage state.
-*
-* - `"red"` -- failures, unhandled errors, or files below threshold
-* - `"yellow"` -- all tests pass but coverage targets exist (room to improve)
-* - `"green"` -- all tests pass, all coverage targets met
-*
-* @internal
-*/
-function determineTier(report) {
-	if (report.summary.failed > 0 || report.unhandledErrors.length > 0) return "red";
-	if (report.coverage) {
-		if (report.coverage.lowCoverage.length > 0) return "red";
-		if (report.coverage.targets && report.coverage.belowTarget && report.coverage.belowTarget.length > 0) return "yellow";
-	}
-	return "green";
-}
-/**
-* Format an {@link (AgentReport:variable)} as compact, actionable console markdown.
-*
-* @remarks
-* The output is structured for LLM agent consumption with four sections:
-*
-* 1. **Compact header** with pass/fail counts and duration
-* 2. **Failed test details** with error messages and diffs (the core value)
-* 3. **Coverage gaps** showing only files below threshold, worst metric first
-* 4. **Next steps** with re-run commands and cache file pointer
-*
-* When all tests pass, the output collapses to a single success line
-* with an optional cache file reference.
-*
-* Returns an empty string when `consoleOutput` is `"silent"`.
-*
-* @param report - The report to format
-* @param options - Formatting options controlling verbosity and color
-* @returns Formatted markdown string, or empty string for silent mode
-*
-* @internal
-*/
-function formatConsoleMarkdown(report, options) {
-	const { consoleOutput, coverageConsoleLimit, noColor, cwd } = options;
-	if (consoleOutput === "silent") return "";
-	const ao = { noColor };
-	const lines = [];
-	const hasFailures = report.summary.failed > 0;
-	const duration = Math.round(report.summary.duration);
-	const projectLabel = report.project ? ` (${report.project})` : "";
-	if (hasFailures) lines.push(`## ${ansi("✗", "red", ao)} Vitest${projectLabel} \u2014 ${report.summary.failed} failed, ${report.summary.passed} passed (${duration}ms)`);
-	else lines.push(`## ${ansi("✓", "green", ao)} Vitest${projectLabel} \u2014 ${report.summary.passed} passed (${duration}ms)`);
-	lines.push("");
-	if (options.trendSummary && report.coverage) {
-		const { direction, runCount, firstMetric } = options.trendSummary;
-		const tier = determineTier(report);
-		if (tier === "green") {
-			const trendNote = `Coverage: all targets met | trending ${direction} over ${runCount} runs`;
-			lines[0] = `${lines[0]} — ${trendNote}`;
-		} else if (tier === "yellow") {
-			const belowTargetCount = report.coverage.belowTarget?.length ?? 0;
-			let summary = `Coverage: ${belowTargetCount} file${belowTargetCount !== 1 ? "s" : ""} below target`;
-			summary += ` | trending ${direction} over ${runCount} runs`;
-			if (firstMetric) {
-				summary += ` (${firstMetric.name}: ${firstMetric.from}% -> ${firstMetric.to}%`;
-				if (firstMetric.target) summary += `, target: ${firstMetric.target}%`;
-				summary += ")";
-			}
-			lines.push(summary);
-			lines.push("");
-		} else {
-			let summary = "Coverage:";
-			if (report.coverage.lowCoverage.length > 0) summary += ` ${report.coverage.lowCoverage.length} file${report.coverage.lowCoverage.length !== 1 ? "s" : ""} below threshold`;
-			summary += ` | trending ${direction} over ${runCount} runs`;
-			if (firstMetric) summary += ` (${firstMetric.name}: ${firstMetric.from}% -> ${firstMetric.to}%)`;
-			lines.push(summary);
-			lines.push("");
-		}
-	}
-	if (hasFailures) for (const mod of report.failed) {
-		const file = relativePath(mod.file, cwd);
-		lines.push(`### ${ansi("✗", "red", ao)} \`${file}\``);
-		lines.push("");
-		if (mod.errors && mod.errors.length > 0) for (const err of mod.errors) {
-			lines.push(ansi(err.message, "red", ao));
-			if (err.diff) {
-				lines.push("");
-				lines.push("```diff");
-				lines.push(err.diff);
-				lines.push("```");
-			}
-			lines.push("");
-		}
-		const failedTests = mod.tests.filter((t) => t.state === "failed");
-		for (const test of failedTests) {
-			const label = test.classification ? ` [${test.classification}]` : "";
-			lines.push(`- ${ansi("✗", "red", ao)} **${test.fullName}**${label}`);
-			if (test.errors && test.errors.length > 0) for (const err of test.errors) {
-				lines.push(`  ${ansi(err.message, "dim", ao)}`);
-				if (err.diff) {
-					lines.push("");
-					lines.push("  ```diff");
-					for (const diffLine of err.diff.split("\n")) lines.push(`  ${diffLine}`);
-					lines.push("  ```");
-				}
-			}
-			lines.push("");
-		}
-	}
-	if (report.coverage) {
-		const cov = report.coverage;
-		const globalThresholds = cov.thresholds.global;
-		if (cov.scoped) {
-			lines.push(formatScopedCoverageNote(cov.scopedFiles?.length ?? 0, cov.totalFiles));
-			lines.push("");
-		}
-		const filesToShow = cov.lowCoverage.slice(0, coverageConsoleLimit);
-		if (filesToShow.length > 0) {
-			lines.push(`### Coverage gaps`);
-			lines.push("");
-			for (const f of filesToShow) {
-				const file = relativePath(f.file, cwd);
-				const worst = getWorstMetric(f);
-				const thresholdValue = globalThresholds[worst.label === "Stmts" ? "statements" : worst.label === "Branch" ? "branches" : worst.label === "Funcs" ? "functions" : "lines"];
-				const thresholdSuffix = thresholdValue != null ? ` (threshold: ${thresholdValue}%)` : "";
-				lines.push(`- \`${file}\` \u2014 ${worst.label}: ${worst.pct}%${thresholdSuffix} \u2014 uncovered: ${f.uncoveredLines}`);
-			}
-			lines.push("");
-		}
-		if (cov.targets && cov.belowTarget && cov.belowTarget.length > 0) {
-			lines.push(`### Coverage improvements needed`);
-			lines.push("");
-			for (const f of cov.belowTarget.slice(0, coverageConsoleLimit)) {
-				const file = relativePath(f.file, cwd);
-				const worst = getWorstMetric(f);
-				const metricKey = worst.label === "Stmts" ? "statements" : worst.label === "Branch" ? "branches" : worst.label === "Funcs" ? "functions" : "lines";
-				const targetValue = cov.targets.global[metricKey];
-				const targetSuffix = targetValue != null ? ` (target: ${targetValue}%)` : "";
-				lines.push(`- \`${file}\` \u2014 ${worst.label}: ${worst.pct}%${targetSuffix} \u2014 uncovered: ${f.uncoveredLines}`);
-			}
-			lines.push("");
-		}
-	}
-	if (hasFailures || report.coverage && report.coverage.lowCoverage.length > 0) {
-		lines.push("### Next steps");
-		lines.push("");
-		if (hasFailures) {
-			const allFailedTests = report.failed.flatMap((m) => m.tests.filter((t) => t.state === "failed"));
-			const newFailures = allFailedTests.filter((t) => t.classification === "new-failure");
-			const persistent = allFailedTests.filter((t) => t.classification === "persistent");
-			const flaky = allFailedTests.filter((t) => t.classification === "flaky");
-			if (newFailures.length > 0) {
-				const files = [...new Set(report.failed.filter((m) => m.tests.some((t) => t.classification === "new-failure")).map((m) => relativePath(m.file, cwd)))];
-				lines.push(`- Fix ${newFailures.length} new failure${newFailures.length > 1 ? "s" : ""} in ${files.map((f) => `\`${f}\``).join(", ")} (likely caused by recent changes)`);
-			}
-			if (persistent.length > 0) lines.push(`- ${persistent.length} persistent failure${persistent.length > 1 ? "s" : ""} (pre-existing, may not be yours)`);
-			if (flaky.length > 0) lines.push(`- ${flaky.length} flaky test${flaky.length > 1 ? "s" : ""} (may pass on retry)`);
-			for (const file of report.failedFiles) lines.push(`- Re-run: \`vitest run ${relativePath(file, cwd)}\``);
-			if (options.mcp) {
-				lines.push("- Use `test_history` for failure trends");
-				lines.push("- Use `test_errors` to search errors by type");
-				lines.push("- Use `test_coverage` for coverage gap analysis");
-				lines.push("- Use `note({ action: \"create\" })` to record debugging findings");
-			}
-		}
-		lines.push("");
-	}
-	return lines.join("\n");
-}
-
-export { determineTier, formatConsoleMarkdown, getWorstMetric, relativePath };

package/utils/format-fatal-error.js

@@ -1,46 +0,0 @@
-import { Cause } from "effect";
-
-// src/utils/format-fatal-error.ts
-const ISSUE_URL = "https://github.com/spencerbeggs/vitest-agent/issues";
-const FIBER_FAILURE_CAUSE_KEY = Symbol.for("effect/Runtime/FiberFailure/Cause");
-/**
-* Format an unknown error into a human-readable string with issue URL.
-*
-* Extraction order:
-* 1. Effect Cause — use `Cause.pretty()` for full formatting
-* 2. Effect FiberFailure — extract Cause and use `Cause.pretty()`
-* 3. Plain Error — extract `.message` and `.stack`
-* 4. Unknown — `String(err)`
-*
-* @public
-*/
-function formatFatalError(err) {
-	let detail;
-	if (Cause.isCause(err)) detail = Cause.pretty(err);
-	else if (err != null && typeof err === "object" && FIBER_FAILURE_CAUSE_KEY in err) {
-		const cause = err[FIBER_FAILURE_CAUSE_KEY];
-		if (Cause.isCause(cause)) detail = Cause.pretty(cause);
-		else detail = String(err);
-	} else if (err instanceof Error) try {
-		detail = err.stack ?? err.message;
-	} catch {
-		let ctorName = "Error";
-		try {
-			ctorName = err.constructor?.name ?? "Error";
-		} catch {}
-		detail = `<unserializable ${ctorName}>`;
-	}
-	else if (err !== null && typeof err === "object") try {
-		detail = JSON.stringify(err, null, 2);
-	} catch {
-		try {
-			detail = String(err);
-		} catch {
-			detail = "<unserializable error>";
-		}
-	}
-	else detail = String(err);
-	return `${detail}\nPlease report at ${ISSUE_URL}`;
-}
-
-export { formatFatalError };

package/utils/format-gfm.js

@@ -1,160 +0,0 @@
-// src/utils/format-gfm.ts
-/**
-* Format a number as a percentage string.
-*
-* @internal
-*/
-function pct(n) {
-	return `${n}%`;
-}
-/**
-* Find the worst (lowest) coverage metric for a file.
-*
-* @internal
-*/
-function worstCoverage(f) {
-	return [
-		{
-			label: "Stmts",
-			pct: f.summary.statements
-		},
-		{
-			label: "Branch",
-			pct: f.summary.branches
-		},
-		{
-			label: "Funcs",
-			pct: f.summary.functions
-		},
-		{
-			label: "Lines",
-			pct: f.summary.lines
-		}
-	].reduce((worst, m) => m.pct < worst.pct ? m : worst);
-}
-/**
-* Format the body of a single project's GFM output.
-*
-* @internal
-*/
-function formatProjectBody(report) {
-	const lines = [];
-	if (report.failed.length > 0) {
-		lines.push("## Failed Tests");
-		lines.push("");
-		for (const mod of report.failed) {
-			lines.push(`### \`${mod.file}\``);
-			lines.push("");
-			if (mod.errors && mod.errors.length > 0) for (const err of mod.errors) {
-				lines.push(`> ${err.message}`);
-				if (err.diff) {
-					lines.push("");
-					lines.push("```diff");
-					lines.push(err.diff);
-					lines.push("```");
-				}
-				lines.push("");
-			}
-			const failedTests = mod.tests.filter((t) => t.state === "failed");
-			for (const test of failedTests) {
-				lines.push(`**${test.fullName}**`);
-				lines.push("");
-				if (test.errors && test.errors.length > 0) for (const err of test.errors) {
-					lines.push(`> ${err.message}`);
-					if (err.diff) {
-						lines.push("");
-						lines.push("```diff");
-						lines.push(err.diff);
-						lines.push("```");
-					}
-				}
-				lines.push("");
-			}
-		}
-	}
-	if (report.coverage) {
-		const cov = report.coverage;
-		lines.push("## Coverage");
-		lines.push("");
-		lines.push("| Metric | Coverage |");
-		lines.push("| --- | --- |");
-		lines.push(`| Statements | ${pct(cov.totals.statements)} |`);
-		lines.push(`| Branches | ${pct(cov.totals.branches)} |`);
-		lines.push(`| Functions | ${pct(cov.totals.functions)} |`);
-		lines.push(`| Lines | ${pct(cov.totals.lines)} |`);
-		lines.push("");
-		if (cov.lowCoverage.length > 0) {
-			const thresholdParts = [];
-			const g = cov.thresholds.global;
-			if (g.lines !== void 0) thresholdParts.push(`lines: ${g.lines}%`);
-			if (g.functions !== void 0) thresholdParts.push(`functions: ${g.functions}%`);
-			if (g.branches !== void 0) thresholdParts.push(`branches: ${g.branches}%`);
-			if (g.statements !== void 0) thresholdParts.push(`statements: ${g.statements}%`);
-			const thresholdDisplay = thresholdParts.length > 0 ? thresholdParts.join(", ") : "configured thresholds";
-			lines.push("> [!WARNING]");
-			lines.push(`> ${cov.lowCoverage.length} file(s) below coverage threshold (${thresholdDisplay}):`);
-			lines.push(">");
-			for (const f of cov.lowCoverage) {
-				const worst = worstCoverage(f);
-				lines.push(`> - \`${f.file}\` — ${worst.label} ${pct(worst.pct)}`);
-			}
-			lines.push("");
-		}
-	}
-	return lines;
-}
-/**
-* Format one or more {@link (AgentReport:variable) | AgentReports} as a GitHub-Flavored
-* Markdown string for writing to `GITHUB_STEP_SUMMARY`.
-*
-* @remarks
-* GFM-specific features used in the output:
-*
-* - **Summary table** with pass/fail counts across all projects
-* - **Collapsible `<details>` blocks** for per-project results in monorepo setups
-* - **Tables** for coverage metrics
-* - **Diff-fenced code blocks** for expected/received comparison output
-* - **GitHub Alert callouts** (`[!WARNING]`) for coverage threshold violations
-*
-* For a single report, the project body is rendered directly without
-* a `<details>` wrapper. For multiple reports (monorepo), each project
-* gets its own collapsible section with a status icon in the summary line.
-*
-* @param reports - One or more agent reports to format
-* @returns GFM-formatted string ready for appending to `GITHUB_STEP_SUMMARY`
-*
-* @public
-*/
-function formatGfm(reports) {
-	const lines = [];
-	const headerIcon = reports.some((r) => r.summary.failed > 0) ? "❌" : "✅";
-	lines.push(`# ${headerIcon} Vitest Results`);
-	lines.push("");
-	const totalPassed = reports.reduce((acc, r) => acc + r.summary.passed, 0);
-	const totalFailed = reports.reduce((acc, r) => acc + r.summary.failed, 0);
-	const totalTests = reports.reduce((acc, r) => acc + r.summary.total, 0);
-	lines.push("| | Count |");
-	lines.push("| --- | --- |");
-	lines.push(`| Passed | **${totalPassed}** |`);
-	lines.push(`| Failed | **${totalFailed}** |`);
-	lines.push(`| Total | **${totalTests}** |`);
-	lines.push("");
-	if (reports.length > 1) for (const report of reports) {
-		const projectLabel = report.project ?? "default";
-		const statusIcon = report.summary.failed > 0 ? "❌" : "✅";
-		lines.push(`<details>`);
-		lines.push(`<summary>${statusIcon} ${projectLabel}</summary>`);
-		lines.push("");
-		const bodyLines = formatProjectBody(report);
-		lines.push(...bodyLines);
-		lines.push("</details>");
-		lines.push("");
-	}
-	else if (reports.length === 1) {
-		const bodyLines = formatProjectBody(reports[0]);
-		lines.push(...bodyLines);
-	}
-	return lines.join("\n");
-}
-
-export { formatGfm };

package/utils/hyperlink.js

@@ -1,10 +0,0 @@
-// src/utils/hyperlink.ts
-const ESC = "\x1B";
-const BEL = "\x07";
-/** @public */
-const osc8 = (url, label, options) => {
-	if (!options.enabled) return label;
-	return `${ESC}]8;;${url}${BEL}${label}${ESC}]8;;${BEL}`;
-};
-
-export { osc8 };

package/utils/normalize-workspace-key.js

@@ -1,33 +0,0 @@
-// src/utils/normalize-workspace-key.ts
-/**
-* Normalize a workspace name into a filesystem-safe directory segment.
-*
-* The workspace key drives the per-project subdirectory under the XDG data
-* directory (e.g. `$XDG_DATA_HOME/vitest-agent/<key>/data.db`). The
-* key must be deterministic for a given input and safe to use as a single
-* path segment on macOS, Linux, and Windows.
-*
-* Rules (applied in order):
-*
-* 1. Replace `/` with `__` so scoped names like `@org/pkg` collapse to
-*    `@org__pkg` rather than introducing a subdirectory boundary. Scoped
-*    npm names contain at most one `/` (between scope and name), and
-*    leading-`@` requires the scope/name form, so `@org__pkg` is not a
-*    valid unscoped npm name -- the `__` token is unambiguous in
-*    practice.
-* 2. Replace any character outside `[A-Za-z0-9._@-]` with `_`. This catches
-*    Windows-reserved characters (`\`, `:`, `*`, `?`, `"`, `<`, `>`, `|`),
-*    control characters, whitespace, and anything else that varies in
-*    interpretation across filesystems.
-* 3. Collapse runs of underscores produced by the substitution above into a
-*    single `_` so the output stays compact.
-*
-* @param name - The raw `name` field from a workspace's `package.json`.
-* @returns A filesystem-safe single path segment.
-* @public
-*/
-function normalizeWorkspaceKey(name) {
-	return name.replaceAll("/", "__").replace(/[^A-Za-z0-9._@-]/g, "_").replace(/_{3,}/g, "__");
-}
-
-export { normalizeWorkspaceKey };

package/utils/probe-host-metadata.js

@@ -1,98 +0,0 @@
-// src/utils/probe-host-metadata.ts
-const isUseful = (value) => value !== void 0 && value.length > 0;
-/**
-* Walk the priority chain of env-var probes. Returns the first match
-* along with any decorating metadata (`term_program`, `ci_provider`,
-* etc.) for that source. When no probe matches, `source`/`value`/
-* `metadata` are all `null`.
-*
-* The probe order matches the plan's table exactly:
-*
-* 1. `TMUX_PANE` (tmux reattach-stable)
-* 2. `WT_SESSION` (Windows Terminal pane)
-* 3. `WEZTERM_PANE` (WezTerm pane)
-* 4. `KITTY_WINDOW_ID` (kitty window)
-* 5. `TERM_SESSION_ID` (iTerm2, Terminal.app)
-* 6. `VSCODE_INJECTION` + `process.ppid` (handled by the Live layer
-*    since it needs `process.ppid`, not env)
-* 7. `GITHUB_RUN_ID` + `GITHUB_RUN_ATTEMPT`
-* 8. `BUILDKITE_JOB_ID` / `CIRCLE_BUILD_NUM` / `GITLAB_CI_JOB_ID`
-* 9. `process.ppid` walk (handled by the Live layer)
-* @public
-*/
-const probeHostMetadataFromEnv = (env) => {
-	const decoration = (extra) => {
-		const baseDecoration = {};
-		if (isUseful(env.TERM_PROGRAM)) baseDecoration.term_program = env.TERM_PROGRAM;
-		if (isUseful(env.TERM_PROGRAM_VERSION)) baseDecoration.term_program_version = env.TERM_PROGRAM_VERSION;
-		return {
-			...baseDecoration,
-			...extra
-		};
-	};
-	if (isUseful(env.TMUX_PANE)) return {
-		source: "TMUX_PANE",
-		value: env.TMUX_PANE,
-		metadata: decoration(isUseful(env.TMUX) ? { tmux_socket: env.TMUX } : {})
-	};
-	if (isUseful(env.WT_SESSION)) return {
-		source: "WT_SESSION",
-		value: env.WT_SESSION,
-		metadata: decoration({})
-	};
-	if (isUseful(env.WEZTERM_PANE)) return {
-		source: "WEZTERM_PANE",
-		value: env.WEZTERM_PANE,
-		metadata: decoration({})
-	};
-	if (isUseful(env.KITTY_WINDOW_ID)) return {
-		source: "KITTY_WINDOW_ID",
-		value: env.KITTY_WINDOW_ID,
-		metadata: decoration({})
-	};
-	if (isUseful(env.TERM_SESSION_ID)) return {
-		source: "TERM_SESSION_ID",
-		value: env.TERM_SESSION_ID,
-		metadata: decoration({})
-	};
-	if (isUseful(env.GITHUB_RUN_ID)) return {
-		source: "GITHUB_RUN_ID",
-		value: env.GITHUB_RUN_ID,
-		metadata: decoration({
-			ci: true,
-			ci_provider: "github",
-			...isUseful(env.GITHUB_RUN_ATTEMPT) ? { github_run_attempt: env.GITHUB_RUN_ATTEMPT } : {}
-		})
-	};
-	if (isUseful(env.BUILDKITE_JOB_ID)) return {
-		source: "BUILDKITE_JOB_ID",
-		value: env.BUILDKITE_JOB_ID,
-		metadata: decoration({
-			ci: true,
-			ci_provider: "buildkite"
-		})
-	};
-	if (isUseful(env.CIRCLE_BUILD_NUM)) return {
-		source: "CIRCLE_BUILD_NUM",
-		value: env.CIRCLE_BUILD_NUM,
-		metadata: decoration({
-			ci: true,
-			ci_provider: "circle"
-		})
-	};
-	if (isUseful(env.GITLAB_CI_JOB_ID)) return {
-		source: "GITLAB_CI_JOB_ID",
-		value: env.GITLAB_CI_JOB_ID,
-		metadata: decoration({
-			ci: true,
-			ci_provider: "gitlab"
-		})
-	};
-	return {
-		source: null,
-		value: null,
-		metadata: null
-	};
-};
-
-export { probeHostMetadataFromEnv };

package/utils/safe-filename.js

@@ -1,33 +0,0 @@
-// src/utils/safe-filename.ts
-/**
-* Convert a project name to a filesystem-safe filename.
-*
-* Replaces `/` and `:` characters with `__` (double underscore).
-* Returns `"default"` for empty strings, which is used as the
-* fallback project name for single-repo configurations.
-*
-* @param name - Project name to sanitize
-* @returns Filesystem-safe filename string
-*
-* @example
-* ```typescript
-* import { safeFilename } from "@vitest-agent/sdk/utils";
-*
-* safeFilename("\@savvy-web/my-lib:unit");
-* // Returns: "\@savvy-web__my-lib__unit"
-*
-* safeFilename("core");
-* // Returns: "core"
-*
-* safeFilename("");
-* // Returns: "default"
-* ```
-*
-* @public
-*/
-function safeFilename(name) {
-	if (!name) return "default";
-	return name.replace(/[/:]/g, "__");
-}
-
-export { safeFilename };