@visulima/vis 1.0.0-alpha.7 → 1.0.0-alpha.9

package/dist/commands/ignore-helpers.d.ts

@@ -1,157 +0,0 @@
-/**
- * Pure helpers for `vis ignore`. Split from `ignore.ts` so tests can
- * exercise them without pulling in `@visulima/task-runner`, which
- * otherwise drags the whole run-graph module through ESM evaluation.
- */
-/** Commit-message tokens that unconditionally skip the build. */
-declare const SKIP_TOKENS: readonly ["[skip ci]", "[ci skip]", "[no ci]", "[vis skip]", "[nx skip]"];
-/** Commit-message tokens that unconditionally force the build. */
-declare const FORCE_TOKENS: readonly ["[vis deploy]", "[nx deploy]"];
-/**
- * Token prefixes accepted for per-project commit-message gating. `vis` is
- * the canonical form; `nx` is kept so teams migrating from `nx-ignore`
- * don't have to rewrite their commit automation.
- */
-declare const PER_PROJECT_TOKEN_PREFIXES: readonly ["vis", "nx"];
-/**
- * CI-provider environment variables carrying the previously deployed SHA,
- * probed in priority order. Only providers that *actually* invoke a custom
- * ignore script (Vercel, Netlify) or that we commonly wrap manually in a
- * preflight CI step (GitHub Actions, GitLab CI) are listed here.
- *
- * Cloudflare Pages / Render / Amplify are intentionally absent: they have
- * no custom-command hook, so shipping env detection for them would only
- * create the illusion of support.
- */
-declare const CI_BASE_SHA_ENV_VARS: readonly ["CACHED_COMMIT_REF", "VERCEL_GIT_PREVIOUS_SHA", "GITHUB_BASE_REF", "CI_COMMIT_BEFORE_SHA"];
-/** Machine-readable reason codes for the ignore decision. */
-type IgnoreReason = "commit-force-deploy" | "commit-skip" | "missing-project-argument" | "no-changes" | "project-affected" | "project-not-affected" | "project-unknown" | "workspace-error";
-/**
- * Structured decision record emitted on stdout in `--json` mode and
- * rendered as human text otherwise.
- */
-interface IgnoreDecision {
-    /** "build" continues the deployment, "skip" cancels it. */
-    action: "build" | "skip";
-    /** The affected-project list, when the comparison actually ran. */
-    affectedProjects?: string[];
-    /** Base ref used for the affected comparison, if any. */
-    base?: string;
-    /** Head ref used for the affected comparison, if any. */
-    head?: string;
-    /** Human-readable reason message. */
-    message: string;
-    /** The project the decision applies to. */
-    project: string;
-    /** Stable reason code for scripting / analytics. */
-    reason: IgnoreReason;
-}
-/** Extra fields that decisions from the affected-detection path carry. */
-type DecisionExtras = Partial<Pick<IgnoreDecision, "affectedProjects" | "base" | "head">>;
-/**
- * Returns the first non-empty value from the CI env var priority list,
- * or `undefined` if nothing is set. Reads from `env` (defaults to
- * `process.env`) so tests can inject fixtures without clobbering globals.
- * @param env Environment dictionary to probe. Defaults to `process.env`.
- * @returns The resolved base SHA (trimmed) or `undefined` if no known CI env var is set.
- */
-declare const resolveCiBaseSha: (env?: NodeJS.ProcessEnv) => string | undefined;
-/**
- * Throws if the given string contains characters outside the safe git-ref
- * alphabet or begins with a dash. Mirrors the validation used by
- * task-runner's affected logic and additionally rejects leading dashes to
- * prevent `git` option injection when the ref is passed as a positional
- * argument to `execFile("git", [...])`.
- * @param ref The git ref to validate (e.g. `"HEAD"`, `"main"`, `"abc123"`).
- * @throws {Error} If `ref` does not match `GIT_REF_RE`. Returns `void` on success.
- */
-declare const validateGitRef: (ref: string) => void;
-/**
- * Returns `true` if `ref` resolves to a commit object in the given repo.
- * Used to detect unreachable base refs (e.g. Vercel's shallow clone) so
- * we can silently fall back to `HEAD~1`.
- * @param cwd Absolute path to the git repository's working directory.
- * @param ref The git ref to probe. Should already be validated by `validateGitRef` to avoid `git` option injection.
- * @returns `true` if the ref resolves to a commit, `false` otherwise (including when `git` itself fails or is unavailable).
- */
-declare const isRefReachable: (cwd: string, ref: string) => Promise<boolean>;
-/**
- * Reads the subject+body of the most recent commit. Returns an empty
- * string on any failure — the caller treats missing messages as "no
- * keywords present" rather than erroring out.
- * @param cwd Absolute path to the git repository's working directory.
- * @returns The raw commit message (subject + body), or `""` on failure.
- */
-declare const readLastCommitMessage: (cwd: string) => Promise<string>;
-/**
- * Returns `true` if the commit message contains a per-project token of
- * the form `[&lt;prefix> &lt;verb> &lt;project>]` for any of the supported
- * prefixes (`vis` or the legacy `nx`).
- * @param message Raw commit message to scan.
- * @param verb The action verb embedded in the token (`"skip"` or `"deploy"`).
- * @param project The project name the token is scoped to.
- * @returns `true` on the first matching token, `false` otherwise.
- */
-declare const matchesPerProjectToken: (message: string, verb: "deploy" | "skip", project: string) => boolean;
-/**
- * Returns `true` if the commit message contains any skip token,
- * including the per-project form `[vis skip &lt;project>]`. Accepts both
- * `vis` and legacy `nx` tokens so users migrating from nx-ignore don't
- * need to rewrite their commit automation.
- * @param message Raw commit message to scan.
- * @param project The project whose per-project tokens should also match.
- * @returns `true` if any skip token is present, `false` otherwise.
- */
-declare const commitHasSkipMessage: (message: string, project: string) => boolean;
-/**
- * Returns `true` if the commit message contains any force-deploy token,
- * including the per-project form `[vis deploy &lt;project>]`.
- * @param message Raw commit message to scan.
- * @param project The project whose per-project tokens should also match.
- * @returns `true` if any force-deploy token is present, `false` otherwise.
- */
-declare const commitHasForceDeployMessage: (message: string, project: string) => boolean;
-/**
- * Builds a `"build"` decision record. Factory helper that collapses the
- * otherwise-repetitive object literals in `ignore.ts`.
- * @param project The project the decision applies to.
- * @param reason Stable reason code.
- * @param message Human-readable message.
- * @param extra Optional base/head/affectedProjects when available.
- * @returns A fully-populated `IgnoreDecision` with `action: "build"`.
- */
-declare const decideBuild: (project: string, reason: IgnoreReason, message: string, extra?: DecisionExtras) => IgnoreDecision;
-/**
- * Builds a `"skip"` decision record. Companion to `decideBuild`.
- * @param project The project the decision applies to.
- * @param reason Stable reason code.
- * @param message Human-readable message.
- * @param extra Optional base/head/affectedProjects when available.
- * @returns A fully-populated `IgnoreDecision` with `action: "skip"`.
- */
-declare const decideSkip: (project: string, reason: IgnoreReason, message: string, extra?: DecisionExtras) => IgnoreDecision;
-/**
- * Renders a decision as a single human-readable line. Pure formatter;
- * doesn't print anything itself.
- * @param decision The decision to format.
- * @returns A one-line string with an emoji prefix and the message.
- */
-declare const formatDecisionLine: (decision: IgnoreDecision) => string;
-/**
- * Maps a decision to its process exit code, honoring
- * `--exit-zero-on-build` for users who want normal exit semantics.
- *
- *   Default:
- *     skip  → 0 (platform cancels)
- *     build → 1 (platform continues)
- *
- *   With --exit-zero-on-build:
- *     skip  → 0
- *     build → 0
- * @param decision The decision to map.
- * @param exitZeroOnBuild If `true`, builds exit with `0` instead of `1`.
- * @returns The literal exit code (`0` or `1`).
- */
-declare const exitCodeFor: (decision: IgnoreDecision, exitZeroOnBuild: boolean) => 0 | 1;
-export type { IgnoreDecision, IgnoreReason };
-export { CI_BASE_SHA_ENV_VARS, commitHasForceDeployMessage, commitHasSkipMessage, decideBuild, decideSkip, exitCodeFor, FORCE_TOKENS, formatDecisionLine, isRefReachable, matchesPerProjectToken, PER_PROJECT_TOKEN_PREFIXES, readLastCommitMessage, resolveCiBaseSha, SKIP_TOKENS, validateGitRef, };

package/dist/commands/ignore.d.ts

@@ -1,17 +0,0 @@
-/**
- * `vis ignore <project>` — CI build gating for deployment platforms.
- *
- * Exits with inverted codes so it can be wired directly into Vercel's
- * "Ignored Build Step" field or Netlify's `ignore` command:
- *
- *   exit 0 → platform cancels the build (project is NOT affected)
- *   exit 1 → platform continues the build (project IS affected)
- *
- * Inspired by `nx-ignore` from nrwl/nx-labs, but reuses vis's own
- * `getAffectedProjects` so it doesn't need to bootstrap a parallel
- * Nx installation on the deploy runner. Pure helpers live in
- * `./ignore-helpers` for test isolation.
- */
-import type { Command } from "@visulima/cerebro";
-declare const ignore: Command;
-export default ignore;

package/dist/commands/implode.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const implode: Command;
-export default implode;

package/dist/commands/info.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const info: Command;
-export default info;

package/dist/commands/init.d.ts

@@ -1,14 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-/**
- * `vis init` — initialize vis configuration with secure defaults.
- *
- * In interactive mode (`--interactive` or TTY default), guides the user through:
- * 1. Socket.dev security scanning (opt-in)
- * 2. Build script approval (scans node_modules)
- * 3. Git hooks / lint-staged setup
- * 4. Native PM config sync
- *
- * In non-interactive mode (CI, piped), creates a minimal config with secure defaults.
- */
-declare const init: Command;
-export default init;

package/dist/commands/install.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const install: Command;
-export default install;

package/dist/commands/link.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const link: Command;
-export default link;

package/dist/commands/list.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const list: Command;
-export default list;

package/dist/commands/migrate/backup.d.ts

@@ -1,8 +0,0 @@
-import type { MigrationReport } from "./types.d.ts";
-/**
- * Create a `.bak` sibling alongside `path` before we mutate/delete it. We only
- * back up on first touch — subsequent writes to the same file in a single
- * migration run don't clobber the original snapshot. When `report` is provided
- * the backup path is recorded for the migration summary.
- */
-export declare const backupFile: (path: string, report?: MigrationReport) => void;

package/dist/commands/migrate/constants.d.ts

@@ -1,16 +0,0 @@
-declare const LINT_STAGED_JSON_CONFIG_FILES: readonly [".lintstagedrc.json", ".lintstagedrc"];
-declare const LINT_STAGED_OTHER_CONFIG_FILES: readonly [".lintstagedrc.yaml", ".lintstagedrc.yml", ".lintstagedrc.mjs", "lint-staged.config.mjs", ".lintstagedrc.cjs", "lint-staged.config.cjs", ".lintstagedrc.js", "lint-staged.config.js", ".lintstagedrc.ts", "lint-staged.config.ts", ".lintstagedrc.mts", "lint-staged.config.mts", ".lintstagedrc.cts", "lint-staged.config.cts"];
-declare const LINT_STAGED_ALL_CONFIG_FILES: ReadonlyArray<string>;
-declare const STALE_LINT_STAGED_PATTERNS: ReadonlyArray<RegExp>;
-declare const NANO_STAGED_JSON_CONFIG_FILES: readonly [".nano-staged.json", ".nanostagedrc"];
-declare const NANO_STAGED_OTHER_CONFIG_FILES: readonly [".nano-staged.mjs", ".nano-staged.cjs", ".nano-staged.js", "nano-staged.config.mjs", "nano-staged.config.cjs", "nano-staged.config.js", "nano-staged.config.mts", "nano-staged.config.cts", "nano-staged.config.ts"];
-declare const NANO_STAGED_ALL_CONFIG_FILES: ReadonlyArray<string>;
-declare const STALE_NANO_STAGED_PATTERNS: ReadonlyArray<RegExp>;
-declare const REPLACED_PACKAGES: readonly ["husky", "lint-staged", "nano-staged"];
-declare const HUSKY_SCRIPT_PATTERNS: ReadonlyArray<RegExp>;
-/**
- * Remove husky references from a single script value.
- * Returns the cleaned script, or undefined if the entire script should be removed.
- */
-declare const cleanHuskyFromScript: (scriptValue: string) => string | undefined;
-export { cleanHuskyFromScript, HUSKY_SCRIPT_PATTERNS, LINT_STAGED_ALL_CONFIG_FILES, LINT_STAGED_JSON_CONFIG_FILES, LINT_STAGED_OTHER_CONFIG_FILES, NANO_STAGED_ALL_CONFIG_FILES, NANO_STAGED_JSON_CONFIG_FILES, NANO_STAGED_OTHER_CONFIG_FILES, REPLACED_PACKAGES, STALE_LINT_STAGED_PATTERNS, STALE_NANO_STAGED_PATTERNS, };

package/dist/commands/migrate/deps.d.ts

@@ -1,32 +0,0 @@
-import type { VisConfig } from "../../workspace.d.ts";
-import type { MigrationReport, PackageManagerType } from "./types.d.ts";
-interface MigrateLogger {
-    info: (message: string) => void;
-    warn: (message: string) => void;
-}
-/**
- * Rewrite scripts in package.json to replace husky/lint-staged references.
- */
-declare const rewriteScripts: (scripts: Record<string, string>, report: MigrationReport) => {
-    modified: boolean;
-    scripts: Record<string, string>;
-};
-/**
- * Rewrite a single package.json: remove replaced packages, add overrides, rewrite scripts.
- */
-declare const rewritePackageJson: (root: string, packageManager: PackageManagerType, overrides: Record<string, string>, report: MigrationReport) => void;
-/**
- * Iterate over all workspace packages and rewrite their package.json files.
- */
-declare const migrateMonorepoPackages: (root: string, packageManager: PackageManagerType, overrides: Record<string, string>, report: MigrationReport) => void;
-/**
- * Update pnpm-workspace.yaml catalog with override entries.
- */
-declare const updatePnpmWorkspaceCatalog: (root: string, overrides: Record<string, string>) => void;
-/**
- * Top-level orchestrator for dependency migration.
- */
-declare const migrateDeps: (root: string, packageManager: PackageManagerType, visConfig: VisConfig, options: {
-    dryRun: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => void;
-export { migrateDeps, migrateMonorepoPackages, rewritePackageJson, rewriteScripts, updatePnpmWorkspaceCatalog };

package/dist/commands/migrate/gitleaks.d.ts

@@ -1,29 +0,0 @@
-import type { MigrateLogger, MigrationReport } from "./types.d.ts";
-interface GitleaksUpstreamFinding {
-    Author?: string;
-    Commit?: string;
-    Date?: string;
-    Description?: string;
-    Email?: string;
-    EndColumn?: number;
-    EndLine?: number;
-    Entropy?: number;
-    File?: string;
-    Fingerprint?: string;
-    Match?: string;
-    Message?: string;
-    RuleID?: string;
-    Secret?: string;
-    StartColumn?: number;
-    StartLine?: number;
-    Tags?: string[];
-}
-declare const detectGitleaksConfig: (root: string) => string | undefined;
-declare const detectGitleaksIgnore: (root: string) => string | undefined;
-declare const detectGitleaksBaseline: (root: string) => string | undefined;
-declare const convertBaseline: (upstream: GitleaksUpstreamFinding[]) => unknown[];
-declare const migrateGitleaks: (root: string, options: {
-    dryRun: boolean;
-    silent?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => boolean;
-export { convertBaseline, detectGitleaksBaseline, detectGitleaksConfig, detectGitleaksIgnore, migrateGitleaks };

package/dist/commands/migrate/index.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const migrate: Command;
-export default migrate;

package/dist/commands/migrate/json.d.ts

@@ -1,22 +0,0 @@
-import type { MigrationReport } from "./types.d.ts";
-/**
- * Reads and parses a JSON file. Returns undefined if the file doesn't exist or isn't valid JSON.
- */
-declare const readJsonFile: <T>(filePath: string) => T | undefined;
-/**
- * Checks if a file exists and contains valid JSON.
- */
-declare const isJsonFile: (filePath: string) => boolean;
-/**
- * Detect the indentation used in a JSON file by looking at the first indented line.
- */
-declare const detectJsonIndent: (content: string) => number;
-/**
- * Edits a JSON file in place using a mutator function.
- * The mutator receives the parsed data and should return the modified data,
- * or undefined to skip writing. Returns true if the file was modified.
- * Preserves the original indentation style. When `report` is provided, a
- * `.bak` snapshot is taken before the write.
- */
-declare const editJsonFile: <T>(filePath: string, mutator: (data: T) => T | undefined, report?: MigrationReport) => boolean;
-export { detectJsonIndent, editJsonFile, isJsonFile, readJsonFile };

package/dist/commands/migrate/kingfisher.d.ts

@@ -1,14 +0,0 @@
-import type { MigrateLogger, MigrationReport } from "./types.d.ts";
-interface KingfisherBaselineRecord {
-    filepath: string;
-    fingerprint: string;
-    linenum: number;
-}
-declare const detectKingfisherBaseline: (root: string) => string | undefined;
-declare const detectKingfisherRules: (root: string) => string | undefined;
-declare const parseKingfisherBaseline: (text: string) => KingfisherBaselineRecord[];
-declare const migrateKingfisher: (root: string, options: {
-    dryRun: boolean;
-    silent?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => boolean;
-export { detectKingfisherBaseline, detectKingfisherRules, migrateKingfisher, parseKingfisherBaseline };

package/dist/commands/migrate/lint-staged.d.ts

@@ -1,62 +0,0 @@
-import type { MigrationReport } from "./types.d.ts";
-interface MigrateLogger {
-    info: (message: string) => void;
-    warn: (message: string) => void;
-}
-/**
- * Check if a standalone lint-staged config file exists.
- */
-declare const hasStandaloneLintStagedConfig: (root: string) => boolean;
-/**
- * Check if a standalone lint-staged config exists in a format that can't be
- * auto-migrated (non-JSON files like .yaml, .mjs, .cjs, .js, or a non-JSON .lintstagedrc).
- */
-declare const hasUnsupportedLintStagedConfig: (root: string) => boolean;
-/**
- * Check if vis.config.ts already has a `staged` config key.
- */
-declare const hasStagedConfigInVisConfig: (root: string) => boolean;
-/**
- * Detect lint-staged config: returns the source ("package.json", a filename, or undefined).
- */
-declare const detectLintStagedConfig: (root: string) => string | undefined;
-/**
- * Extract lint-staged config from package.json.
- */
-declare const extractLintStagedFromPackageJson: (root: string) => Record<string, string | string[]> | undefined;
-/**
- * Parse a JSON lint-staged config file.
- */
-declare const parseLintStagedJsonFile: (filePath: string) => Record<string, string | string[]> | undefined;
-/**
- * Generate a TypeScript snippet for the staged block.
- */
-declare const generateStagedConfigSnippet: (config: Record<string, string | string[]>) => string;
-/**
- * Insert staged config into vis.config.ts. Creates the file if it doesn't exist.
- */
-declare const insertStagedIntoVisConfig: (root: string, config: Record<string, string | string[]>, logger: MigrateLogger) => boolean;
-/**
- * Remove `lint-staged` key, config, and dependency from package.json in a single read/write.
- * Returns which removals were performed.
- */
-declare const removeLintStagedFromPackageJson: (root: string) => {
-    configRemoved: boolean;
-    dependencyRemoved: boolean;
-};
-/**
- * Remove standalone lint-staged config files.
- */
-declare const removeLintStagedConfigFiles: (root: string, report: MigrationReport) => void;
-/**
- * Rewrite pre-commit hook to replace lint-staged invocations with `vis staged`.
- */
-declare const rewritePreCommitHook: (root: string, hooksDirectory: string) => boolean;
-/**
- * Migrates lint-staged configuration to vis.config.ts staged block.
- */
-declare const migrateLintStaged: (root: string, options: {
-    dryRun: boolean;
-    silent?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => boolean;
-export { detectLintStagedConfig, extractLintStagedFromPackageJson, generateStagedConfigSnippet, hasStagedConfigInVisConfig, hasStandaloneLintStagedConfig, hasUnsupportedLintStagedConfig, insertStagedIntoVisConfig, migrateLintStaged, parseLintStagedJsonFile, removeLintStagedConfigFiles, removeLintStagedFromPackageJson, rewritePreCommitHook, };

package/dist/commands/migrate/moon.d.ts

@@ -1,5 +0,0 @@
-import type { MigrateLogger, MigrationReport } from "./types.d.ts";
-export declare const migrateMoon: (workspaceRoot: string, options: {
-    copyTemplates?: boolean;
-    dryRun?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => void;

package/dist/commands/migrate/nano-staged.d.ts

@@ -1,30 +0,0 @@
-import type { MigrationReport } from "./types.d.ts";
-interface MigrateLogger {
-    info: (message: string) => void;
-    warn: (message: string) => void;
-}
-declare const hasStandaloneNanoStagedConfig: (root: string) => boolean;
-declare const hasUnsupportedNanoStagedConfig: (root: string) => boolean;
-declare const hasStagedConfigInVisConfig: (root: string) => boolean;
-declare const detectNanoStagedConfig: (root: string) => string | undefined;
-declare const extractNanoStagedFromPackageJson: (root: string) => Record<string, string | string[]> | undefined;
-declare const parseNanoStagedJsonFile: (filePath: string) => Record<string, string | string[]> | undefined;
-declare const generateStagedConfigSnippet: (config: Record<string, string | string[]>) => string;
-declare const insertStagedIntoVisConfig: (root: string, config: Record<string, string | string[]>, logger: MigrateLogger) => boolean;
-declare const removeNanoStagedFromPackageJson: (root: string) => {
-    configRemoved: boolean;
-    dependencyRemoved: boolean;
-};
-declare const removeNanoStagedConfigFiles: (root: string, report: MigrationReport) => void;
-declare const rewritePreCommitHook: (root: string, hooksDirectory: string) => boolean;
-/**
- * Migrates nano-staged configuration to the `staged` block in `vis.config.ts`.
- * Mirrors the lint-staged migrator: detects configs from package.json or
- * standalone `.nano-staged.*` files, inlines the mapping, then cleans up
- * the source, dev-dependency entry, and pre-commit hook invocations.
- */
-declare const migrateNanoStaged: (root: string, options: {
-    dryRun: boolean;
-    silent?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => boolean;
-export { detectNanoStagedConfig, extractNanoStagedFromPackageJson, generateStagedConfigSnippet, hasStagedConfigInVisConfig, hasStandaloneNanoStagedConfig, hasUnsupportedNanoStagedConfig, insertStagedIntoVisConfig, migrateNanoStaged, parseNanoStagedJsonFile, removeNanoStagedConfigFiles, removeNanoStagedFromPackageJson, rewritePreCommitHook, };

package/dist/commands/migrate/nx.d.ts

@@ -1,12 +0,0 @@
-import type { MigrateLogger, MigrationReport } from "./types.d.ts";
-/**
- * Translates an `nx.json` into a `vis.config.ts`. Per-project
- * `project.json` files are left untouched — vis reads them natively.
- * @param workspaceRoot Absolute workspace root path.
- * @param options Migration options.
- * @param logger Logger for user feedback.
- * @param report Migration report to append manual steps and warnings.
- */
-export declare const migrateNx: (workspaceRoot: string, options: {
-    dryRun?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => void;

package/dist/commands/migrate/prompt.d.ts

@@ -1,2 +0,0 @@
-/** Prompt the user on stdin; returns true on y/yes (empty defaults to yes). */
-export declare const confirm: (question: string) => Promise<boolean>;

package/dist/commands/migrate/secretlint.d.ts

@@ -1,14 +0,0 @@
-import type { MigrateLogger, MigrationReport } from "./types.d.ts";
-declare const detectSecretlintConfig: (root: string) => string | undefined;
-declare const detectSecretlintIgnore: (root: string) => string | undefined;
-/**
- * Extract the set of rule / preset IDs from a secretlint config. Only parses
- * JSON-style configs confidently; for .js/.mjs/.cjs we warn and leave the file
- * for the user to inspect.
- */
-declare const extractRuleIds: (root: string, file: string, report: MigrationReport) => string[];
-declare const migrateSecretlint: (root: string, options: {
-    dryRun: boolean;
-    silent?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => boolean;
-export { detectSecretlintConfig, detectSecretlintIgnore, extractRuleIds, migrateSecretlint };

package/dist/commands/migrate/shared.d.ts

@@ -1,29 +0,0 @@
-import type { MigrateLogger, MigrationReport } from "./types.d.ts";
-/**
- * Serialises a config object to a pretty-printed TypeScript string with
- * unquoted keys (idiomatic TS style).
- * @param obj The configuration object to serialise.
- * @returns A JSON string with keys unquoted for TS readability.
- */
-export declare const serializeConfigObject: (obj: Record<string, unknown>) => string;
-/**
- * Writes (or previews) a rendered `vis.config.ts`. Guards against
- * overwriting an existing file and logs the outcome.
- * @param workspaceRoot Absolute workspace root path.
- * @param rendered The full file content to write.
- * @param options Migration options (`dryRun` controls preview mode).
- * @param logger Logger for user feedback.
- * @param report Migration report to append warnings to.
- * @returns `true` if written (or previewed in dry-run), `false` if skipped.
- */
-export declare const writeVisConfig: (workspaceRoot: string, rendered: string, options: {
-    dryRun?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => boolean;
-/**
- * Reads and parses a JSON config file from the workspace root.
- * @param workspaceRoot Absolute workspace root path.
- * @param fileName File name relative to the workspace root.
- * @returns The parsed object, or `undefined` if the file doesn't exist.
- * @throws On JSON parse errors.
- */
-export declare const readJsonConfig: <T>(workspaceRoot: string, fileName: string) => T | undefined;

package/dist/commands/migrate/turborepo.d.ts

@@ -1,11 +0,0 @@
-import type { MigrateLogger, MigrationReport } from "./types.d.ts";
-/**
- * Translates a `turbo.json` into a `vis.config.ts`.
- * @param workspaceRoot Absolute workspace root path.
- * @param options Migration options.
- * @param logger Logger for user feedback.
- * @param report Migration report to append manual steps and warnings.
- */
-export declare const migrateTurborepo: (workspaceRoot: string, options: {
-    dryRun?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => void;

package/dist/commands/migrate/types.d.ts

@@ -1,27 +0,0 @@
-interface MigrateLogger {
-    info: (message: string) => void;
-    warn: (message: string) => void;
-}
-interface MigrationReport {
-    backupsCreated: string[];
-    gitHooksConfigured: boolean;
-    inlinedLintStagedConfigCount: number;
-    manualSteps: string[];
-    mergedStagedConfigCount: number;
-    perMigration: Record<string, {
-        removedConfigCount: number;
-        removedPackageCount: number;
-        rewrittenScriptCount: number;
-    }>;
-    removedConfigCount: number;
-    removedPackageCount: number;
-    rewrittenScriptCount: number;
-    warnings: string[];
-}
-declare const createMigrationReport: () => MigrationReport;
-declare const addMigrationWarning: (report: MigrationReport | undefined, warning: string) => void;
-declare const addManualStep: (report: MigrationReport | undefined, step: string) => void;
-declare const bumpPerMigration: (report: MigrationReport, migration: string, field: "removedConfigCount" | "removedPackageCount" | "rewrittenScriptCount", delta?: number) => void;
-type PackageManagerType = "bun" | "npm" | "pnpm" | "yarn";
-export type { MigrateLogger, MigrationReport, PackageManagerType };
-export { addManualStep, addMigrationWarning, bumpPerMigration, createMigrationReport };

package/dist/commands/migrate/verify.d.ts

@@ -1,12 +0,0 @@
-import type { MigrateLogger } from "./types.d.ts";
-export interface VerificationIssue {
-    detail: string;
-    kind: "config" | "script" | "hook" | "devDep";
-    location: string;
-}
-/**
- * Check that a prior `vis migrate gitleaks` / `secretlint` run was complete:
- * no stray scripts, devDependencies, hooks, or configs referencing the old
- * tools. Safe to run repeatedly — purely read-only.
- */
-export declare const verifyMigration: (root: string, logger: MigrateLogger) => VerificationIssue[];

package/dist/commands/optimize.d.ts

@@ -1,38 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-import type { PmInfo } from "../overrides.d.ts";
-import type { OptimizeEntry } from "../tui/components/optimize/OptimizeStore.d.ts";
-/** Collects dependency names from a `package.json`. */
-declare const collectDepsFromPkgJson: (pkgJsonPath: string, productionOnly: boolean) => Set<string>;
-/** Discovers workspace package directories. */
-declare const discoverWorkspacePackages: (workspaceRoot: string) => string[];
-/** Scans deps against e18e module-replacements manifests. */
-declare const buildE18eEntries: (allDeps: Set<string>) => OptimizeEntry[];
-/** Scans deps against @socketregistry manifest. */
-declare const buildSocketEntries: (allDeps: Set<string>, lockText: string, pm: PmInfo, pin: boolean) => OptimizeEntry[];
-/** Marks e18e entries that have codemods available. */
-declare const markCodemodAvailability: (entries: OptimizeEntry[]) => Promise<void>;
-interface CodemodResult {
-    filesChanged: number;
-    packageName: string;
-}
-/**
- * Runs a codemod for a single package across all source files in the project.
- * Returns the number of files modified.
- */
-declare const runCodemod: (workspaceRoot: string, packageName: string) => Promise<CodemodResult>;
-/**
- * `vis optimize` — two-phase dependency optimization with interactive TUI.
- *
- * **Phase 1 (e18e):** Identifies packages replaceable with native builtins or lighter
- * alternatives using `module-replacements` manifests. Runs source code codemods via
- * `module-replacements-codemods` for selected entries.
- *
- * **Phase 2 (Socket.dev):** Writes override/resolution entries for packages that have
- * security-hardened `@socketregistry` alternatives.
- *
- * In TTY mode, presents an interactive TUI (like `vis update`) where users select
- * which optimizations to apply. In non-TTY/CI mode, outputs a static report.
- */
-declare const optimize: Command;
-export default optimize;
-export { buildE18eEntries, buildSocketEntries, collectDepsFromPkgJson, discoverWorkspacePackages, markCodemodAvailability, runCodemod };

package/dist/commands/pm.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const pm: Command;
-export default pm;

package/dist/commands/remove.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const remove: Command;
-export default remove;

package/dist/commands/run.d.ts

@@ -1,16 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-/**
- * Shared counter for the global `--retry-budget` flag. Tasks consult
- * `claim(requested)` at launch to grab up to `requested` retries; the
- * budget is decremented conservatively by the claim (not by actual
- * retries consumed) to keep the bound simple to reason about. Once
- * the budget is exhausted, subsequent tasks run with no retries —
- * surfacing flakiness instead of silently burning CI time.
- */
-export interface RetryBudget {
-    claim: (requested: number) => number;
-    readonly remaining: number;
-}
-export declare const createRetryBudget: (limit: number) => RetryBudget;
-declare const run: Command;
-export default run;