@visulima/vis 0.0.1 → 1.0.0-alpha.10

package/package.json

@@ -1,10 +1,127 @@
 {
   "name": "@visulima/vis",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @visulima/vis",
+  "version": "1.0.0-alpha.10",
+  "description": "A CLI task runner for monorepo workspaces, powered by @visulima/task-runner",
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "build",
+    "cache",
+    "cli",
+    "monorepo",
+    "task-runner",
+    "vis",
+    "visulima",
+    "workspace"
+  ],
+  "homepage": "https://visulima.com/packages/vis",
+  "bugs": {
+    "url": "https://github.com/visulima/visulima/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/visulima/visulima.git",
+    "directory": "packages/tooling/vis"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/prisis"
+    },
+    {
+      "type": "consulting",
+      "url": "https://anolilab.com/support"
+    }
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "imports": {
+    "#native": {
+      "default": "./index.js"
+    }
+  },
+  "exports": {
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./generate": {
+      "types": "./dist/generate/index.d.ts",
+      "default": "./dist/generate/index.js"
+    },
+    "./native": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./schemas/project.schema.json": "./schemas/project.schema.json",
+    "./schemas/vis-config.schema.json": "./schemas/vis-config.schema.json",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "v": "./dist/bin.js",
+    "vis": "./dist/bin.js"
+  },
+  "files": [
+    "dist/**",
+    "schemas/**",
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE.md"
+  ],
+  "dependencies": {
+    "@bomb.sh/tab": "^0.0.15",
+    "@socketsecurity/registry": "^2.0.2",
+    "@visulima/ansi": "4.0.0-alpha.13",
+    "@visulima/cerebro": "3.0.0-alpha.13",
+    "@visulima/colorize": "2.0.0-alpha.10",
+    "@visulima/find-ai-runner": "1.0.0-alpha.5",
+    "@visulima/find-cache-dir": "3.0.0-alpha.9",
+    "@visulima/fs": "5.0.0-alpha.12",
+    "@visulima/humanizer": "3.0.0-alpha.11",
+    "@visulima/interactive-manager": "1.0.0-alpha.2",
+    "@visulima/package": "5.0.0-alpha.11",
+    "@visulima/pail": "4.0.0-alpha.12",
+    "@visulima/path": "3.0.0-alpha.10",
+    "@visulima/redact": "3.0.0-alpha.10",
+    "@visulima/secret-scanner": "1.0.0-alpha.1",
+    "@visulima/spinner": "1.0.0-alpha.1",
+    "@visulima/string": "3.0.0-alpha.11",
+    "@visulima/task-runner": "1.0.0-alpha.8",
+    "@visulima/tui": "1.0.0-alpha.5",
+    "execa": "^9.6.1",
+    "giget": "^3.2.0",
+    "hookable": "^6.1.1",
+    "jiti": "^2.6.1",
+    "jstoxml": "^7.1.0",
+    "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",
+    "yaml": "2.8.3",
+    "zeptomatch": "^2.1.0"
+  },
+  "optionalDependencies": {
+    "@visulima/vis-binding-darwin-arm64": "1.0.0-alpha.10",
+    "@visulima/vis-binding-darwin-x64": "1.0.0-alpha.10",
+    "@visulima/vis-binding-linux-arm64-gnu": "1.0.0-alpha.10",
+    "@visulima/vis-binding-linux-x64-musl": "1.0.0-alpha.10",
+    "@visulima/vis-binding-linux-arm64-musl": "1.0.0-alpha.10",
+    "@visulima/vis-binding-linux-x64-gnu": "1.0.0-alpha.10",
+    "@visulima/vis-binding-win32-arm64-msvc": "1.0.0-alpha.10",
+    "@visulima/vis-binding-win32-x64-msvc": "1.0.0-alpha.10"
+  },
+  "engines": {
+    "node": "^22.14.0 || >=24.10.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/schemas/project.schema.json

@@ -0,0 +1,422 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://visulima.com/schemas/project.schema.json",
+    "title": "vis project.json",
+    "description": "Per-project configuration for @visulima/vis. Place a project.json in each workspace package root.",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+        "$schema": {
+            "type": "string",
+            "description": "JSON Schema reference for editor autocomplete."
+        },
+        "projectType": {
+            "type": "string",
+            "enum": ["library", "application"],
+            "description": "Whether this project is a library (consumed by others) or an application (deployment target)."
+        },
+        "sourceRoot": {
+            "type": "string",
+            "description": "Source root directory, relative to this project's root. Used for display and language inference.",
+            "default": "src"
+        },
+        "tags": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Filterable tags. Used by query language (--query \"tag=frontend\"), scoped task defaults, and tag-relationship constraints."
+        },
+        "layer": {
+            "type": "string",
+            "enum": ["configuration", "library", "scaffolding", "tool", "automation", "application"],
+            "description": "Project layer in the dependency hierarchy. When enforceLayerRelationships is enabled, projects may only depend on the same or lower layer: configuration < library < scaffolding < tool < automation < application."
+        },
+        "stack": {
+            "type": "string",
+            "enum": ["backend", "frontend", "data", "infrastructure", "systems"],
+            "description": "Technology stack classification. Used by query language and scoped task defaults."
+        },
+        "language": {
+            "type": "string",
+            "description": "Primary programming language (e.g. \"typescript\", \"rust\", \"go\"). Used by query language and scoped task defaults.",
+            "examples": ["typescript", "javascript", "rust", "go", "python"]
+        },
+        "implicitDependencies": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Workspace project names this project implicitly depends on (not expressed in package.json)."
+        },
+        "owners": {
+            "type": "array",
+            "description": "Code ownership declarations. Aggregated by `vis sync codeowners` to generate a CODEOWNERS file.",
+            "items": {
+                "type": "object",
+                "required": ["path", "owners"],
+                "additionalProperties": false,
+                "properties": {
+                    "path": {
+                        "type": "string",
+                        "description": "File or glob pattern relative to this project root (e.g. \"src/**\", \".\")."
+                    },
+                    "owners": {
+                        "type": "array",
+                        "items": { "type": "string" },
+                        "description": "Owner handles (e.g. \"@org/team\", \"user@example.com\")."
+                    },
+                    "channel": {
+                        "type": "string",
+                        "description": "Optional notification channel (e.g. Slack channel). Emitted as a trailing comment in CODEOWNERS."
+                    }
+                }
+            }
+        },
+        "project": {
+            "type": "object",
+            "description": "Human-readable project metadata.",
+            "additionalProperties": false,
+            "properties": {
+                "title": {
+                    "type": "string",
+                    "description": "Display name for the project."
+                },
+                "description": {
+                    "type": "string",
+                    "description": "Short description of the project's purpose."
+                },
+                "channel": {
+                    "type": "string",
+                    "description": "Primary support channel (e.g. Slack, Teams)."
+                },
+                "owner": {
+                    "type": "string",
+                    "description": "Primary owner or team handle."
+                },
+                "maintainers": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "List of maintainer handles."
+                }
+            }
+        },
+        "targets": {
+            "type": "object",
+            "description": "Named build/test/run targets. Merged on top of package.json scripts — the command from scripts is used as the default if no command is set here.",
+            "additionalProperties": {
+                "$ref": "#/$defs/targetConfiguration"
+            }
+        }
+    },
+    "$defs": {
+        "targetConfiguration": {
+            "type": "object",
+            "description": "Configuration for a single target.",
+            "additionalProperties": false,
+            "properties": {
+                "command": {
+                    "type": "string",
+                    "description": "The shell command to execute. Overrides the package.json script of the same name."
+                },
+                "executor": {
+                    "type": "string",
+                    "description": "Alternative to command — an executor identifier."
+                },
+                "cache": {
+                    "type": "boolean",
+                    "description": "Whether this target's results are cacheable. Defaults based on type: build=true, test=true, run=false."
+                },
+                "inputs": {
+                    "type": "array",
+                    "description": "Input patterns for cache invalidation. Supports file globs, @filegroup:<name> references, and structured input definitions.",
+                    "items": {
+                        "oneOf": [
+                            { "type": "string" },
+                            { "$ref": "#/$defs/fileSetInput" },
+                            { "$ref": "#/$defs/environmentInput" },
+                            { "$ref": "#/$defs/runtimeInput" },
+                            { "$ref": "#/$defs/externalDependencyInput" }
+                        ]
+                    }
+                },
+                "outputs": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "Output file/directory patterns produced by this target (e.g. \"dist/**\")."
+                },
+                "dependsOn": {
+                    "type": "array",
+                    "description": "Other targets this target depends on. Can be plain target names (same project) or dependency config objects.",
+                    "items": {
+                        "oneOf": [{ "type": "string" }, { "$ref": "#/$defs/targetDependencyConfig" }]
+                    }
+                },
+                "configurations": {
+                    "type": "object",
+                    "description": "Named configuration variants (e.g. \"production\", \"development\").",
+                    "additionalProperties": {
+                        "type": "object",
+                        "additionalProperties": true
+                    }
+                },
+                "parallelism": {
+                    "type": "boolean",
+                    "description": "Whether this target supports parallel execution.",
+                    "default": true
+                },
+                "type": {
+                    "type": "string",
+                    "enum": ["build", "test", "run"],
+                    "description": "Semantic task type. Affects caching defaults and CI filtering. build/test are cached by default; run is not.",
+                    "default": "test"
+                },
+                "preset": {
+                    "type": "string",
+                    "enum": ["server", "utility"],
+                    "description": "Preset that pre-fills a bundle of options. 'server': persistent, no cache, no CI. 'utility': no cache, no CI."
+                },
+                "options": {
+                    "$ref": "#/$defs/targetOptions"
+                },
+                "when": {
+                    "$ref": "#/$defs/whenCondition",
+                    "description": "Predicate gating execution. Tasks whose `when` does not match the current environment are marked skipped (not failed) by the orchestrator."
+                },
+                "always": {
+                    "type": "boolean",
+                    "description": "When true, this task runs after the main task graph completes — even if upstream tasks failed or the run was interrupted (except SIGINT). Used for cleanup / teardown / notifications. Always-tasks are pulled out of the dependency graph and never cached.",
+                    "default": false
+                }
+            }
+        },
+        "targetOptions": {
+            "type": "object",
+            "description": "Vis-specific target options controlling execution behavior.",
+            "additionalProperties": false,
+            "properties": {
+                "persistent": {
+                    "type": "boolean",
+                    "description": "Long-running/never-ending process. Scheduled last, never cached.",
+                    "default": false
+                },
+                "interactive": {
+                    "type": "boolean",
+                    "description": "Serialized with respect to parallel execution; claims stdin for terminal input.",
+                    "default": false
+                },
+                "internal": {
+                    "type": "boolean",
+                    "description": "Hidden from CLI listings. Can only be invoked as a dependency of another task.",
+                    "default": false
+                },
+                "runInCI": {
+                    "oneOf": [{ "type": "boolean" }, { "type": "string", "enum": ["affected", "always"] }],
+                    "description": "Controls whether this task runs in CI. true=always, false=never, 'affected'=only when project is affected, 'always'=even if unaffected.",
+                    "default": true
+                },
+                "retryCount": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "Number of times to retry on failure.",
+                    "default": 0
+                },
+                "retryDelay": {
+                    "oneOf": [
+                        { "type": "integer", "minimum": 0 },
+                        { "type": "string", "const": "exponential" }
+                    ],
+                    "description": "Delay between retries in ms, or \"exponential\" for 2^attempt * 1000ms.",
+                    "default": "exponential"
+                },
+                "affectedFiles": {
+                    "oneOf": [
+                        { "type": "boolean", "const": false },
+                        { "type": "string", "enum": ["args", "env", "both"] }
+                    ],
+                    "description": "How to forward affected files to the task. false=don't, 'args'=as command arguments, 'env'=via VIS_AFFECTED_FILES, 'both'=both.",
+                    "default": false
+                },
+                "envFile": {
+                    "type": "string",
+                    "description": "Dotenv file to load before running. Path relative to the project root.",
+                    "examples": [".env", ".env.local", ".env.production"]
+                },
+                "mutex": {
+                    "type": "string",
+                    "description": "Named mutex. All tasks sharing the same mutex name are serialized.",
+                    "examples": ["db-migration"]
+                },
+                "runFromWorkspaceRoot": {
+                    "type": "boolean",
+                    "description": "Execute from the workspace root instead of the project root.",
+                    "default": false
+                },
+                "shell": {
+                    "type": "string",
+                    "description": "Per-target shell override (cross-platform).",
+                    "examples": ["/bin/bash", "/bin/zsh"]
+                },
+                "unixShell": {
+                    "type": "string",
+                    "description": "Shell override for Linux and macOS. Takes precedence over 'shell'."
+                },
+                "windowsShell": {
+                    "type": "string",
+                    "description": "Shell override for Windows. Takes precedence over 'shell'.",
+                    "examples": ["powershell.exe", "cmd.exe"]
+                },
+                "preset": {
+                    "type": "string",
+                    "enum": ["server", "utility"],
+                    "description": "Preset applied before user options."
+                }
+            }
+        },
+        "targetDependencyConfig": {
+            "type": "object",
+            "description": "Structured dependency on another target.",
+            "required": ["target"],
+            "additionalProperties": false,
+            "properties": {
+                "target": {
+                    "type": "string",
+                    "description": "The target name to depend on."
+                },
+                "dependencies": {
+                    "type": "boolean",
+                    "description": "When true, run this target on all dependency projects first (equivalent to turbo's ^target)."
+                },
+                "projects": {
+                    "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }],
+                    "description": "Specific project name(s) to run this target on."
+                },
+                "params": {
+                    "type": "string",
+                    "enum": ["forward", "ignore"],
+                    "description": "Whether to forward or ignore parameters from the parent task."
+                }
+            }
+        },
+        "fileSetInput": {
+            "type": "object",
+            "required": ["fileset"],
+            "additionalProperties": false,
+            "properties": {
+                "fileset": {
+                    "type": "string",
+                    "description": "Glob pattern for input files (e.g. \"src/**/*.ts\")."
+                }
+            }
+        },
+        "environmentInput": {
+            "type": "object",
+            "required": ["env"],
+            "additionalProperties": false,
+            "properties": {
+                "env": {
+                    "type": "string",
+                    "description": "Environment variable name to include in cache key."
+                }
+            }
+        },
+        "runtimeInput": {
+            "type": "object",
+            "required": ["runtime"],
+            "additionalProperties": false,
+            "properties": {
+                "runtime": {
+                    "type": "string",
+                    "description": "Shell command whose output is included in cache key (e.g. \"node --version\")."
+                }
+            }
+        },
+        "externalDependencyInput": {
+            "type": "object",
+            "required": ["externalDependencies"],
+            "additionalProperties": false,
+            "properties": {
+                "externalDependencies": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "npm package names whose resolved versions are included in cache key."
+                }
+            }
+        },
+        "envMatcher": {
+            "oneOf": [
+                {
+                    "type": "string",
+                    "description": "Bare env-var name; task runs when set and non-empty."
+                },
+                {
+                    "type": "object",
+                    "required": ["name"],
+                    "additionalProperties": false,
+                    "properties": {
+                        "name": { "type": "string", "description": "Env var name." },
+                        "equals": { "type": "string", "description": "Match this exact value. Mutually exclusive with `exists`." },
+                        "exists": { "type": "boolean", "description": "true → must be set+non-empty; false → must be unset/empty." }
+                    }
+                }
+            ]
+        },
+        "envMatcherList": {
+            "oneOf": [
+                { "$ref": "#/$defs/envMatcher" },
+                { "type": "array", "items": { "$ref": "#/$defs/envMatcher" } }
+            ]
+        },
+        "platformList": {
+            "oneOf": [
+                {
+                    "type": "string",
+                    "enum": ["aix", "darwin", "freebsd", "linux", "openbsd", "sunos", "windows", "win32"]
+                },
+                {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "enum": ["aix", "darwin", "freebsd", "linux", "openbsd", "sunos", "windows", "win32"]
+                    }
+                }
+            ]
+        },
+        "branchList": {
+            "oneOf": [
+                { "type": "string" },
+                { "type": "array", "items": { "type": "string" } }
+            ]
+        },
+        "whenCondition": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Predicate that gates whether a task runs. All positive clauses must match (AND). Within a clause, an array means any-of (OR). `not.*` mirrors invert each positive clause.",
+            "properties": {
+                "os": {
+                    "$ref": "#/$defs/platformList",
+                    "description": "Match `process.platform`. Use \"windows\" as a friendly alias for \"win32\"."
+                },
+                "env": {
+                    "$ref": "#/$defs/envMatcherList",
+                    "description": "Match against environment variables. String form asserts set+non-empty; object form supports `equals` or `exists`."
+                },
+                "branch": {
+                    "$ref": "#/$defs/branchList",
+                    "description": "Match against the current git branch (HEAD)."
+                },
+                "ci": {
+                    "type": "boolean",
+                    "description": "true → run only inside CI; false → run only outside CI. CI is detected via the CI env var."
+                },
+                "not": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "description": "Negative mirrors. Task runs only when *all* `not.*` clauses fail.",
+                    "properties": {
+                        "os": { "$ref": "#/$defs/platformList" },
+                        "env": { "$ref": "#/$defs/envMatcherList" },
+                        "branch": { "$ref": "#/$defs/branchList" },
+                        "ci": { "type": "boolean" }
+                    }
+                }
+            }
+        }
+    }
+}