@visulima/vis 1.0.0-alpha.32 → 1.0.0-alpha.34

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## @visulima/vis [1.0.0-alpha.34](https://github.com/visulima/visulima/compare/@visulima/vis@1.0.0-alpha.33...@visulima/vis@1.0.0-alpha.34) (2026-06-08)
+
+### Features
+
+* **vis:** clean --empty-packages and staged per-package/cwd tasks ([cdba002](https://github.com/visulima/visulima/commit/cdba002af4714e3e74c1f832919855d0dd7f3a72)), closes [package.json#workspaces](https://github.com/visulima/package.json/issues/workspaces)
+
+### Documentation
+
+* **vis:** correct and complete command reference ([b8c6c11](https://github.com/visulima/visulima/commit/b8c6c11e289c509a7d479e2371d8df63b710ce9b))
+
+### Miscellaneous Chores
+
+* **vis:** merge clean/staged/hooks/docs feature branch ([f61821d](https://github.com/visulima/visulima/commit/f61821d9fb0e7f36769025edaa1d73993bf91c54))
+
+### Code Refactoring
+
+* **vis:** move git hooks dir from .vis-hooks to .vis/hooks ([b3cc45b](https://github.com/visulima/visulima/commit/b3cc45b9dd82bea9ab60fcd387a6c95833555a39))
+
+## @visulima/vis [1.0.0-alpha.33](https://github.com/visulima/visulima/compare/@visulima/vis@1.0.0-alpha.32...@visulima/vis@1.0.0-alpha.33) (2026-06-07)
+
+### Features
+
+* **task-runner:** warn when a cacheable task's inputs resolve to zero files ([3a4ecbb](https://github.com/visulima/visulima/commit/3a4ecbbef46b49afa4cb8b3e0b741fae0de42b3c))
+
+
+### Dependencies
+
+* **@visulima/task-runner:** upgraded to 1.0.0-alpha.21
+
 ## @visulima/vis [1.0.0-alpha.32](https://github.com/visulima/visulima/compare/@visulima/vis@1.0.0-alpha.31...@visulima/vis@1.0.0-alpha.32) (2026-06-07)
 
 ### Bug Fixes

package/dist/bin.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import"./packem_shared/index-K8aQuMvx.js";import"./packem_chunks/bin.js";import"./packem_chunks/config.js";import"./packem_shared/readFileSync-DseCu8sg-DEq4Fn3a.js";
+import"./packem_shared/index-di3jpyZS.js";import"./packem_chunks/bin.js";import"./packem_chunks/config.js";import"./packem_shared/readFileSync-DseCu8sg-DEq4Fn3a.js";

package/dist/binx.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import{$ as r,m as o,a as c,I as i,p as a,i as n}from"./packem_shared/index-K8aQuMvx.js";r();process.argv.includes("--no-color")&&(process.env.NO_COLOR="1",process.env.FORCE_COLOR="0");process.argv.slice(2).some(s=>s==="--version"||s==="-v"||s==="-V")&&(process.stdout.write(`${o.version}
+import{$ as r,m as o,a as c,I as i,p as a,i as n}from"./packem_shared/index-di3jpyZS.js";r();process.argv.includes("--no-color")&&(process.env.NO_COLOR="1",process.env.FORCE_COLOR="0");process.argv.slice(2).some(s=>s==="--version"||s==="-v"||s==="-V")&&(process.stdout.write(`${o.version}
 `),process.exit(0));process.argv.splice(2,0,"dlx");c();const e=i("visx",{packageName:"visx",packageVersion:o.version}),p=process.argv.includes("--debug")||!!process.env.DEBUG;e.addPlugin(a({detailed:p,exitOnError:!1}));e.addCommand(n);(async()=>{try{await e.run({shouldExitProcess:!1})}catch{process.exitCode=process.exitCode||1}finally{process.exit(process.exitCode??0)}})();

package/dist/config/index.d.ts

@@ -52,15 +52,39 @@ interface CustomTask {
   readonly title: string;
 }
 /**
+* Object form of a command task. Unlike a bare command string it carries
+* execution options:
+*
+* - `perPackage` runs the command once per workspace package that owns the
+*   matched files, with `cwd` set to that package's directory and file paths
+*   made relative to it. Use it for tools that resolve their config or
+*   plugins from the nearest `package.json` — e.g. eslint with a
+*   cwd-sensitive shareable config. Files that sit under no workspace
+*   package fall back to a single run from the workspace root.
+* - `cwd` pins the command to a fixed directory (relative to the workspace
+*   root, or absolute) and passes the matched files as absolute paths so
+*   they resolve regardless of where the command runs. Ignored when
+*   `perPackage` is set — that derives the cwd per package instead.
+*
+* A command task is distinguished from {@link CustomTask} by carrying a
+* `command` string and no `task` function.
+*/
+interface CommandTask {
+  readonly command: string;
+  readonly cwd?: string;
+  readonly perPackage?: boolean;
+}
+/**
 * A task value as authored by the user. Command strings are split into
-* argv and invoked with the matched file paths appended. Arrays run
-* serially. Functions receive the matched paths and return further
-* task values (possibly async). `{ title, task }` objects run `task`
-* directly with no argv construction.
+* argv and invoked with the matched file paths appended. `{ command, … }`
+* objects do the same with per-task execution options (cwd / perPackage).
+* Arrays run serially. Functions receive the matched paths and return
+* further task values (possibly async). `{ title, task }` objects run
+* `task` directly with no argv construction.
 */
-type StagedTask = CustomTask | StagedTaskFunction | ReadonlyArray<CustomTask | StagedTaskFunction | string> | string | ReadonlyArray<string>;
+type StagedTask = CommandTask | CustomTask | StagedTaskFunction | string | ReadonlyArray<CommandTask | CustomTask | StagedTaskFunction | string>;
 type StagedTaskFunction = (files: string[]) => Promise<StagedTaskResult> | StagedTaskResult;
-type StagedTaskResult = CustomTask | ReadonlyArray<CustomTask | string> | string | ReadonlyArray<string>;
+type StagedTaskResult = CommandTask | CustomTask | string | ReadonlyArray<CommandTask | CustomTask | string>;
 /**
 * Config object mapping glob patterns (basename or path-style) to tasks.
 * A top-level function form lets the user generate the entire config
@@ -2328,6 +2352,7 @@ interface VisConfig {
   * - `string` or `string[]` commands
   * - Sync/async functions returning `string | string[]`
   * - `{ title, task }` objects for named side-effect tasks
+  * - `{ command, perPackage }` to run a command once per owning workspace package (cwd = that package dir), and `{ command, cwd }` to pin a command to a fixed directory
   * - Mixed arrays of strings and functions
   * - A top-level generate-task function
   */