@hackwaly/task 0.3.0 → 0.3.2

package/README.md

@@ -24,9 +24,9 @@ yarn add @hackwaly/task
 
 ## Quick Start
 
-1. Create a `taskfile.ts` in your project root:
+1. Create a `taskfile.js` in your project root:
 
-```typescript
+```javascript
 import { configInit } from "@hackwaly/task";
 
 const { defineTask } = configInit(import.meta);
@@ -92,7 +92,7 @@ interface TaskConfig {
 
 Commands can be specified in multiple formats:
 
-```typescript
+```javascript
 // String (parsed with shell-like parsing)
 command: "tsc --build --verbose"
 
@@ -110,7 +110,7 @@ command: {
 
 Tasks can depend on other tasks. Dependencies are resolved automatically:
 
-```typescript
+```javascript
 export const generateTypes = defineTask({
   name: "generate-types",
   command: "generate-types src/schema.json",
@@ -129,7 +129,7 @@ export const build = defineTask({
 
 For long-running processes like development servers:
 
-```typescript
+```javascript
 export const server = defineTask({
   name: "server",
   command: "node server.js",
@@ -183,7 +183,7 @@ Shows task names and descriptions in a formatted table.
 
 ### Basic Build Pipeline
 
-```typescript
+```javascript
 import { configInit } from "@hackwaly/task";
 
 const { defineTask } = configInit(import.meta);
@@ -221,7 +221,7 @@ export const test = defineTask({
 
 ### Development Workflow
 
-```typescript
+```javascript
 export const generateSchema = defineTask({
   name: "generate-schema",
   command: "generate-schema api.yaml",
@@ -251,10 +251,10 @@ export const buildWatch = defineTask({
 
 ### Monorepo Support
 
-Each package can have its own `taskfile.ts`:
+Each package can have its own `taskfile.js`:
 
-```typescript
-// packages/ui/taskfile.ts
+```javascript
+// packages/ui/taskfile.js
 import { configInit } from "@hackwaly/task";
 
 const { defineTask } = configInit(import.meta);
@@ -266,8 +266,8 @@ export const build = defineTask({
   outputs: ["dist/**/*"],
 });
 
-// packages/app/taskfile.ts
-import { build as buildUI } from "../ui/taskfile.ts";
+// packages/app/taskfile.js
+import { build as buildUI } from "../ui/taskfile.js";
 
 export const build = defineTask({
   name: "build:app",
@@ -280,7 +280,7 @@ export const build = defineTask({
 
 For complex tasks, you can provide custom logic:
 
-```typescript
+```javascript
 export const customTask = defineTask({
   name: "custom",
   async run(ctx) {
@@ -301,7 +301,6 @@ export const customTask = defineTask({
 ## Requirements
 
 - Node.js 18+ with `--experimental-strip-types` support
-- TypeScript 5.0+
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hackwaly/task",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "license": "MIT",
   "repository": "github:hackwaly/task",

package/src/cli.d.ts

@@ -0,0 +1 @@
+export declare function cliMain(): Promise<void>;

package/src/config.d.ts

@@ -0,0 +1,21 @@
+import type { TaskDef, TaskRunContext } from "./types.js";
+export interface TaskConfig {
+    name: string;
+    description?: string;
+    run?: (ctx: TaskRunContext) => Promise<void>;
+    command?: string | string[] | {
+        program: string;
+        args?: string[];
+    };
+    env?: Record<string, string>;
+    cwd?: string;
+    inputs?: string[];
+    outputs?: string[];
+    persistent?: boolean;
+    interruptible?: boolean;
+    dependsOn?: [TaskDef];
+}
+export interface ConfigAPI {
+    defineTask(config: TaskConfig): TaskDef;
+}
+export declare function configInit(importMeta: ImportMeta): ConfigAPI;

package/src/config.js

@@ -2,6 +2,8 @@ import NodePath from "node:path";
 import { fileURLToPath } from "node:url";
 import { runCommand } from "./run.js";
 import { parseArgsStringToArgv } from "string-argv";
+import process from "node:process";
+import styles from "ansi-styles";
 function normalizeCommand(command) {
     if (typeof command === "string") {
         const argv = parseArgsStringToArgv(command);
@@ -31,12 +33,19 @@ export function configInit(importMeta) {
                 interruptible: config.interruptible ?? false,
             };
             const def = {
-                run: config.run ??
-                    (async (ctx) => {
-                        if (command !== undefined) {
+                run: config.run
+                    ? async (ctx) => {
+                        process.stdout.write(`▪▪▪▪ ${styles.bold.open}${meta.name}${styles.bold.close}\n`);
+                        await config.run(ctx);
+                    }
+                    : command !== undefined
+                        ? async (ctx) => {
+                            process.stdout.write(`▪▪▪▪ ${styles.bold.open}${meta.name}${styles.bold.close}\n`);
                             await runCommand(command, meta, ctx);
                         }
-                    }),
+                        : async () => {
+                            process.stdout.write(`▪▪▪▪ ${styles.bold.open}${meta.name}${styles.bold.close}\n`);
+                        },
                 meta: meta,
                 deps: new Set(),
                 invDeps: new Set(),

package/src/errors.d.ts

@@ -0,0 +1,3 @@
+export declare class InvariantViolation extends Error {
+    get name(): string;
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export { cliMain } from "./cli.js";
+export { configInit } from "./config.js";

package/src/run.d.ts

@@ -0,0 +1,2 @@
+import type { Command, TaskMeta, TaskRunContext } from "./types.js";
+export declare function runCommand(command: Command, meta: TaskMeta, ctx: TaskRunContext): Promise<void>;

package/src/run.js

@@ -1,6 +1,4 @@
 import { execa } from "execa";
-import process from "node:process";
-import styles from "ansi-styles";
 import supportsColor from "supports-color";
 const colorSupport = supportsColor.stdout;
 export async function runCommand(command, meta, ctx) {
@@ -12,7 +10,6 @@ export async function runCommand(command, meta, ctx) {
         const line3 = line2.replace(/\x1bc|\x1b\[2J(?:\x1b\[H)?/g, "");
         yield `\r${name} | ${line3}`;
     };
-    process.stdout.write(`▪▪▪▪ ${styles.bold.open}${name}${styles.bold.close}\n`);
     await execa({
         // @ts-expect-error
         cwd: cwd,

package/src/scheduler.d.ts

@@ -0,0 +1,5 @@
+import type { TaskDef } from "./types.js";
+import { type Observable } from "rxjs";
+export declare function start(taskChan: Observable<Set<TaskDef>>, options: {
+    abort: AbortSignal;
+}): Promise<void>;

package/src/scheduler.js

@@ -13,9 +13,6 @@ export async function start(taskChan, options) {
     const isReady = (task) => {
         if (!dirtySet.has(task))
             throw new InvariantViolation();
-        if (pendingSet.has(task)) {
-            return false;
-        }
         for (const dep of task.deps) {
             if (!upToDateSet.has(dep)) {
                 return false;
@@ -26,6 +23,7 @@ export async function start(taskChan, options) {
     const checkReady = (task) => {
         if (isReady(task)) {
             dirtySet.delete(task);
+            pendingSet.delete(task);
             readySet.add(task);
             readySignal.next();
             // Mark inverse dependencies as pending, so they won't become ready
@@ -73,7 +71,6 @@ export async function start(taskChan, options) {
         upToDateSet.add(task);
         for (const invDep of task.invDeps) {
             if (pendingSet.has(invDep)) {
-                pendingSet.delete(invDep);
                 checkReady(invDep);
             }
         }

package/src/types.d.ts

@@ -0,0 +1,23 @@
+export interface Command {
+    program: string;
+    args: string[];
+}
+export interface TaskRunContext {
+    abort: AbortSignal;
+}
+export interface TaskMeta {
+    name: string;
+    description: string | undefined;
+    cwd: string;
+    env: Record<string, string>;
+    inputs: string[];
+    outputs: string[];
+    persistent: boolean;
+    interruptible: boolean;
+}
+export interface TaskDef {
+    run: (ctx: TaskRunContext) => Promise<void>;
+    meta: TaskMeta;
+    deps: Set<TaskDef>;
+    invDeps: Set<TaskDef>;
+}