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

package/dist/commands/cache.d.ts

@@ -81,6 +81,6 @@ declare const runPrune: (cacheDirectory: string, workspaceRoot: string, options:
  * @returns Resolves when output has been written.
  */
 declare const runSize: (cacheDirectory: string, format: string) => Promise<void>;
-declare const cache: Command;
-export default cache;
+declare const cacheCommands: Command[];
+export default cacheCommands;
 export { collectCacheEntries, formatAge, runClean, runList, runPrune, runSize };

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

@@ -1,8 +1,13 @@
 declare const HOOKS: readonly ["pre-commit", "pre-merge-commit", "prepare-commit-msg", "commit-msg", "post-commit", "applypatch-msg", "pre-applypatch", "post-applypatch", "pre-rebase", "post-rewrite", "post-checkout", "post-merge", "pre-push", "pre-auto-gc"];
 declare const DEFAULT_HOOKS_DIRECTORY = ".vis-hooks";
+declare const PREK_CONFIG_FILES: readonly [".pre-commit-config.yaml", ".pre-commit-config.yml", "prek.toml"];
+declare const PREK_STAGE_ALIASES: Readonly<Record<string, string>>;
+declare const PREK_SUPPORTED_STAGES: ReadonlySet<string>;
+declare const PREK_STAGES_WITH_GIT_ARGS: ReadonlySet<string>;
+declare const PREK_TRANSLATABLE_LANGUAGES: ReadonlySet<string>;
 interface InstallResult {
     isError: boolean;
     message: string;
 }
 export type { InstallResult };
-export { DEFAULT_HOOKS_DIRECTORY, HOOKS };
+export { DEFAULT_HOOKS_DIRECTORY, HOOKS, PREK_CONFIG_FILES, PREK_STAGE_ALIASES, PREK_STAGES_WITH_GIT_ARGS, PREK_SUPPORTED_STAGES, PREK_TRANSLATABLE_LANGUAGES };

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

@@ -1,3 +1,3 @@
 import type { Command } from "@visulima/cerebro";
-declare const hook: Command;
-export default hook;
+declare const hookCommands: Command[];
+export default hookCommands;

package/dist/commands/hook/list.d.ts

@@ -0,0 +1,28 @@
+interface HookBlock {
+    command: string;
+    id: string;
+    name?: string;
+}
+interface StageEntry {
+    blocks: HookBlock[];
+    rawLineCount: number;
+    stage: string;
+}
+interface ListResult {
+    hooksDirectory: string;
+    stages: StageEntry[];
+}
+/**
+ * Parse a `.vis-hooks/{stage}` script into `# id: name` headers emitted by the
+ * migrator. Scripts authored by hand (no headers) surface as a single
+ * "(custom)" block.
+ */
+declare const parseStageScript: (content: string) => HookBlock[];
+declare const listHooks: (root: string, hooksDirectory: string) => ListResult;
+declare const formatListResult: (result: ListResult) => string[];
+declare const runList: (hooksDirectory: string, logger: {
+    info: (message: string) => void;
+}) => void;
+export type { HookBlock, ListResult, StageEntry };
+export { formatListResult, listHooks, parseStageScript, runList };
+export { DEFAULT_HOOKS_DIRECTORY as LIST_DEFAULT_DIRECTORY } from "./constants.d.ts";

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

@@ -23,5 +23,8 @@ declare const cleanPackageJsonScripts: (root: string) => {
 /**
  * Migrates from husky to vis hooks.
  */
-declare const migrateFromHusky: (root: string, hooksDirectory: string, logger: Console) => InstallResult;
+interface HuskyMigrateOptions {
+    dryRun?: boolean;
+}
+declare const migrateFromHusky: (root: string, hooksDirectory: string, logger: Console, options?: HuskyMigrateOptions) => InstallResult;
 export { cleanPackageJsonScripts, detectHuskyDirectory, detectPackageManager, migrateFromHusky, transformHookScript };

package/dist/commands/hook/prek-builtins.d.ts

@@ -0,0 +1,8 @@
+declare const PREK_RUNNER_FILENAME = "prek-runner.mjs";
+declare const TYPES_EXTENSION_MAP: Readonly<Record<string, ReadonlyArray<string>>>;
+declare const METADATA_TYPE_TAGS: ReadonlyArray<string>;
+declare const SHEBANG_INTERPRETER_MAP: Readonly<Record<string, ReadonlyArray<string>>>;
+declare const BUILTIN_HOOK_IDS: ReadonlyArray<string>;
+declare const KNOWN_TYPE_TAGS: ReadonlyArray<string>;
+declare const PREK_RUNNER_SOURCE: string;
+export { BUILTIN_HOOK_IDS, KNOWN_TYPE_TAGS, METADATA_TYPE_TAGS, PREK_RUNNER_FILENAME, PREK_RUNNER_SOURCE, SHEBANG_INTERPRETER_MAP, TYPES_EXTENSION_MAP };

package/dist/commands/hook/prek.d.ts

@@ -0,0 +1,129 @@
+import type { InstallResult } from "./constants.d.ts";
+interface PrekHookEntry {
+    additional_dependencies?: string[];
+    alias?: string;
+    always_run?: boolean;
+    args?: string[];
+    description?: string;
+    entry?: string;
+    exclude?: string;
+    exclude_types?: string[];
+    files?: string;
+    id?: string;
+    language?: string;
+    language_version?: string;
+    name?: string;
+    pass_filenames?: boolean;
+    stages?: string[];
+    types?: string[];
+    types_or?: string[];
+    verbose?: boolean;
+}
+interface PrekRepoEntry {
+    hooks?: PrekHookEntry[];
+    repo?: string;
+    rev?: string;
+}
+interface PrekConfig {
+    default_language_version?: Record<string, string>;
+    default_stages?: string[];
+    exclude?: string;
+    fail_fast?: boolean;
+    files?: string;
+    repos?: PrekRepoEntry[];
+}
+interface SkippedHook {
+    hookId: string;
+    reason: string;
+    repo: string;
+}
+interface AdditionalDep {
+    hookId: string;
+    name: string;
+    raw: string;
+    version: string;
+}
+interface ConversionResult {
+    additionalDeps: AdditionalDep[];
+    droppedFilters: string[];
+    manualSteps: string[];
+    scripts: Map<string, string>;
+    skippedHooks: SkippedHook[];
+    usesRunner: boolean;
+}
+interface MigrateLogger {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+}
+declare const REMOTE_HOOK_BUILTIN_MAP: ReadonlyMap<string, string>;
+/**
+ * Locate a prek config file under `root`. Returns the first match.
+ */
+declare const detectPrekConfig: (root: string) => string | undefined;
+/**
+ * Normalize a stage name, translating legacy pre-commit.com aliases.
+ */
+declare const mapPrekStage: (stage: string) => string;
+/**
+ * Reduce a repo URL (https/git/ssh) to an `owner/repo` slug for builtin lookup.
+ */
+declare const normalizeRepoKey: (url: string) => string;
+/**
+ * Parse a prek additional_dependencies entry into a (name, version) pair. Pip
+ * specifiers (e.g. `black==24.1.0`) return undefined so the caller can warn.
+ */
+declare const parseAdditionalDep: (spec: string) => {
+    name: string;
+    version: string;
+} | undefined;
+/**
+ * Determine the target stages for a hook, falling back to config defaults then `[pre-commit]`.
+ */
+declare const resolveStages: (entry: PrekHookEntry, defaultStages: string[] | undefined) => string[];
+/**
+ * Build a shell command that routes through the prek-runner. All user strings
+ * pass via argv, so shell meta-characters in patterns/args can't escape the
+ * outer shell.
+ */
+declare const buildRunnerInvocation: (entry: PrekHookEntry, builtin?: string) => string;
+/**
+ * Build the shell command line for a single hook entry. Stages where git
+ * passes an argument (commit-msg, prepare-commit-msg, post-*) bypass the
+ * runner because pre-commit's filter semantics don't apply to them.
+ */
+declare const buildHookCommand: (entry: PrekHookEntry, stage: string, builtin?: string) => string;
+/**
+ * Convert a parsed prek config into a per-stage map of shell script bodies.
+ * Hooks we cannot translate (remote repos, language-specific toolchains) are
+ * reported back in `skippedHooks` for the caller to surface.
+ */
+declare const convertPrekConfig: (config: PrekConfig) => ConversionResult;
+/**
+ * Parse a prek YAML config. Returns undefined if the content is empty or malformed.
+ */
+declare const parsePrekConfig: (content: string) => PrekConfig | undefined;
+/**
+ * Load a prek config file from disk, dispatching to the YAML or TOML parser
+ * based on the extension. TOML parsing is delegated to `@visulima/fs/toml`
+ * (which wraps smol-toml), so we hit the same implementation the rest of the
+ * codebase uses for TOML.
+ */
+declare const loadPrekConfig: (configPath: string) => PrekConfig | undefined;
+/**
+ * Merge collected additional_dependencies into the project's package.json
+ * devDependencies. Doesn't run install — just updates the manifest and asks
+ * the caller to run their package manager.
+ */
+declare const mergeAdditionalDependencies: (root: string, deps: ReadonlyArray<AdditionalDep>) => {
+    added: string[];
+    skipped: string[];
+};
+interface MigrateOptions {
+    dryRun?: boolean;
+}
+/**
+ * Migrates a prek / pre-commit framework configuration to vis hooks.
+ */
+declare const migrateFromPrek: (root: string, hooksDirectory: string, logger: MigrateLogger, options?: MigrateOptions) => InstallResult;
+export type { AdditionalDep, ConversionResult, MigrateOptions, PrekConfig, PrekHookEntry, PrekRepoEntry, SkippedHook };
+export { buildHookCommand, buildRunnerInvocation, convertPrekConfig, detectPrekConfig, loadPrekConfig, mapPrekStage, mergeAdditionalDependencies, migrateFromPrek, normalizeRepoKey, parseAdditionalDep, parsePrekConfig, REMOTE_HOOK_BUILTIN_MAP, resolveStages, };

package/dist/commands/hook/run.d.ts

@@ -0,0 +1,21 @@
+interface RunOptions {
+    allFiles?: boolean;
+    fromRef?: string;
+    lastCommit?: boolean;
+    stage?: string;
+    toRef?: string;
+}
+interface RunLogger {
+    info: (message: string) => void;
+}
+declare const DEFAULT_STAGE = "pre-commit";
+/**
+ * Invoke a previously-installed `.vis-hooks/{stage}` script directly,
+ * forwarding --all-files / --from-ref / --to-ref through environment variables
+ * that the bundled prek-runner honours. This makes CI usage trivial: run the
+ * same hook logic that fires at commit time, but over an explicit file set.
+ */
+declare const runHookStage: (root: string, hooksDirectory: string, options: RunOptions, logger: RunLogger) => number;
+declare const runRun: (hooksDirectory: string, options: RunOptions, logger: RunLogger) => void;
+export type { RunLogger, RunOptions };
+export { DEFAULT_STAGE, runHookStage, runRun };

package/dist/commands/hook/validate.d.ts

@@ -0,0 +1,17 @@
+interface ValidationIssue {
+    kind: "error" | "warning";
+    message: string;
+    path?: string;
+}
+interface ValidationResult {
+    issues: ValidationIssue[];
+    ok: boolean;
+}
+declare const validateHooks: (root: string, hooksDirectory: string) => ValidationResult;
+declare const formatValidationResult: (result: ValidationResult, hooksDirectory: string) => string[];
+declare const runValidate: (hooksDirectory: string, logger: {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+}) => void;
+export type { ValidationIssue, ValidationResult };
+export { formatValidationResult, runValidate, validateHooks };

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/vis",
-  "version": "1.0.0-alpha.7",
+  "version": "1.0.0-alpha.8",
   "description": "A CLI task runner for monorepo workspaces, powered by @visulima/task-runner",
   "keywords": [
     "visulima",
@@ -79,7 +79,7 @@
     "@visulima/secret-scanner": "1.0.0-alpha.1",
     "@visulima/string": "3.0.0-alpha.11",
     "@visulima/task-runner": "1.0.0-alpha.7",
-    "@visulima/tui": "1.0.0-alpha.3",
+    "@visulima/tui": "1.0.0-alpha.4",
     "execa": "^9.6.1",
     "giget": "^3.2.0",
     "hookable": "^6.1.1",
@@ -88,20 +88,22 @@
     "module-replacements": "^2.11.0",
     "module-replacements-codemods": "^1.2.1",
     "react": "19.2.5",
+    "react-reconciler": ">=0.33.0",
     "semver": "^7.7.4",
+    "smol-toml": "^1.6.1",
     "validate-npm-package-name": "^7.0.2",
     "yaml": "2.8.3",
     "zeptomatch": "^2.1.0"
   },
   "optionalDependencies": {
-    "@visulima/vis-binding-darwin-arm64": "1.0.0-alpha.7",
-    "@visulima/vis-binding-darwin-x64": "1.0.0-alpha.7",
-    "@visulima/vis-binding-linux-arm64-gnu": "1.0.0-alpha.7",
-    "@visulima/vis-binding-linux-x64-gnu": "1.0.0-alpha.7",
-    "@visulima/vis-binding-linux-x64-musl": "1.0.0-alpha.7",
-    "@visulima/vis-binding-win32-arm64-msvc": "1.0.0-alpha.7",
-    "@visulima/vis-binding-linux-arm64-musl": "1.0.0-alpha.7",
-    "@visulima/vis-binding-win32-x64-msvc": "1.0.0-alpha.7"
+    "@visulima/vis-binding-darwin-arm64": "1.0.0-alpha.8",
+    "@visulima/vis-binding-darwin-x64": "1.0.0-alpha.8",
+    "@visulima/vis-binding-linux-x64-gnu": "1.0.0-alpha.8",
+    "@visulima/vis-binding-linux-arm64-gnu": "1.0.0-alpha.8",
+    "@visulima/vis-binding-linux-arm64-musl": "1.0.0-alpha.8",
+    "@visulima/vis-binding-linux-x64-musl": "1.0.0-alpha.8",
+    "@visulima/vis-binding-win32-x64-msvc": "1.0.0-alpha.8",
+    "@visulima/vis-binding-win32-arm64-msvc": "1.0.0-alpha.8"
   },
   "engines": {
     "node": "^22.14.0 || >=24.10.0"