@workglow/task-graph 0.0.124 → 0.0.126

package/dist/task-graph/Conversions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Conversions.d.ts","sourceRoot":"","sources":["../../src/task-graph/Conversions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,GAAG,GAAG,EAAE,CAAC,SAAS,SAAS,GAAG,GAAG,IAAI,CAC/E,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,eAAe,KACrB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpB,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,SAAS,GAAG,SAAS,IAChF,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAClB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GACX,UAAU,GACV,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AA8GpB,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,EACjE,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,MAAM,GAAE,GAAQ,GACf,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAuBtB"}
+{"version":3,"file":"Conversions.d.ts","sourceRoot":"","sources":["../../src/task-graph/Conversions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,GAAG,GAAG,EAAE,CAAC,SAAS,SAAS,GAAG,GAAG,IAAI,CAC/E,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,eAAe,KACrB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpB,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,SAAS,GAAG,SAAS,IAChF,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAClB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GACX,UAAU,GACV,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AA2GpB,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,SAAS,EACjE,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,MAAM,GAAE,GAAQ,GACf,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAuBtB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@workglow/task-graph",
   "type": "module",
-  "version": "0.0.124",
+  "version": "0.0.126",
   "description": "Task graph management for Workglow, providing DAG construction, execution planning, and workflow orchestration.",
   "scripts": {
     "watch": "concurrently -c 'auto' 'bun:watch-*'",
@@ -22,10 +22,19 @@
   },
   "exports": {
     ".": {
-      "react-native": "./dist/browser.js",
-      "browser": "./dist/browser.js",
-      "bun": "./dist/bun.js",
-      "types": "./dist/types.d.ts",
+      "react-native": {
+        "types": "./dist/browser.d.ts",
+        "import": "./dist/browser.js"
+      },
+      "browser": {
+        "types": "./dist/browser.d.ts",
+        "import": "./dist/browser.js"
+      },
+      "bun": {
+        "types": "./dist/bun.d.ts",
+        "import": "./dist/bun.js"
+      },
+      "types": "./dist/node.d.ts",
       "import": "./dist/node.js"
     }
   },
@@ -37,9 +46,9 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@workglow/job-queue": "0.0.124",
-    "@workglow/storage": "0.0.124",
-    "@workglow/util": "0.0.124"
+    "@workglow/job-queue": "0.0.126",
+    "@workglow/storage": "0.0.126",
+    "@workglow/util": "0.0.126"
   },
   "peerDependenciesMeta": {
     "@workglow/job-queue": {
@@ -53,8 +62,8 @@
     }
   },
   "devDependencies": {
-    "@workglow/job-queue": "0.0.124",
-    "@workglow/storage": "0.0.124",
-    "@workglow/util": "0.0.124"
+    "@workglow/job-queue": "0.0.126",
+    "@workglow/storage": "0.0.126",
+    "@workglow/util": "0.0.126"
   }
 }

package/src/debug/README.md

@@ -0,0 +1,115 @@
+# Chrome DevTools formatters (`ConsoleFormatters`)
+
+Debug utilities for Workglow task graphs and workflows.
+
+## Overview
+
+`ConsoleFormatters.ts` is re-exported from the main **`@workglow/task-graph`** entry when using the **browser** build (`dist/browser.js`). It provides Chrome DevTools custom formatters for rich console output for task graphs, workflows, tasks, and dataflows.
+
+This code is **browser-oriented** (it uses `window` and the DevTools formatter API). Do not call it from Node-only bundles.
+
+## Features
+
+- **Chrome DevTools Custom Formatters**: Rich, colored console output for Workglow objects
+  - **Dark Mode Support**: Automatically adapts colors based on browser theme
+  - **DAG Visualization**: Visual graph rendering for directed acyclic graphs
+  - **React Element Formatting**: Pretty-print React elements in the console
+
+## Installation
+
+`@workglow/util` is a peer dependency of `@workglow/task-graph` (graph and schema types used by the formatters).
+
+```bash
+npm install @workglow/task-graph @workglow/util
+# or
+bun add @workglow/task-graph @workglow/util
+```
+
+## Usage
+
+### Installing DevTools Formatters
+
+Call `installDevToolsFormatters()` early in your application to enable rich console output:
+
+```typescript
+import { installDevToolsFormatters } from "@workglow/task-graph";
+
+// Call once during app initialization
+installDevToolsFormatters();
+```
+
+### Enabling Custom Formatters in Chrome DevTools
+
+1. Open Chrome DevTools (F12 or Cmd+Option+I)
+2. Go to Settings (gear icon or F1)
+3. Under "Console", check "Enable custom formatters"
+4. Refresh the page
+
+### Viewing Rich Output
+
+Once formatters are installed and enabled, simply `console.log` any Workglow object:
+
+```typescript
+import { Workflow } from "@workglow/task-graph";
+import { installDevToolsFormatters } from "@workglow/task-graph";
+
+installDevToolsFormatters();
+
+const workflow = new Workflow();
+// ... add tasks ...
+
+// Rich formatted output in DevTools
+console.log(workflow);
+```
+
+## Supported Objects
+
+The following Workglow objects will display with rich formatting:
+
+- **Workflow**: Shows task count, error state, and expandable task list
+- **TaskGraph**: Displays all tasks and dataflows with DAG visualization
+- **Task**: Shows input/output data, configuration, and status with color coding
+- **Dataflow**: Displays source and target connections with values
+- **DirectedAcyclicGraph**: Renders a visual canvas representation
+- **React Elements**: Pretty-prints React components with props
+
+## API
+
+### `installDevToolsFormatters()`
+
+Registers custom formatters with Chrome DevTools. Call once during application startup.
+
+```typescript
+import { installDevToolsFormatters } from "@workglow/task-graph";
+
+installDevToolsFormatters();
+```
+
+### `isDarkMode()`
+
+Returns whether the browser is currently in dark mode.
+
+```typescript
+import { isDarkMode } from "@workglow/task-graph";
+
+if (isDarkMode()) {
+  console.log("Using dark theme colors");
+}
+```
+
+## Color Coding
+
+The formatters use consistent color coding:
+
+| Color     | Meaning                        |
+| --------- | ------------------------------ |
+| Green     | Input parameters               |
+| Red/Brown | Output values                  |
+| Yellow    | Highlighted names/keywords     |
+| Grey      | Punctuation and secondary text |
+
+Colors automatically adjust for dark/light mode.
+
+## License
+
+Apache 2.0 - See [LICENSE](../../LICENSE) for details.

package/src/storage/README.md

@@ -14,8 +14,25 @@ TaskOutputRepository is a repository for task caching. If a task has the same in
 
 ```typescript
 // Example usage
-import { SqliteTaskOutputRepository } from "@workglow/test"; // pre-bound implementation for sqlite
-const outputRepo = new SqliteTaskOutputRepository(":memory:");
+import {
+  TaskOutputPrimaryKeyNames,
+  TaskOutputSchema,
+  TaskOutputTabularRepository,
+} from "@workglow/task-graph";
+import { SqliteTabularStorage } from "@workglow/storage";
+import { Sqlite } from "@workglow/storage/sqlite";
+
+await Sqlite.init();
+
+const outputRepo = new TaskOutputTabularRepository({
+  tabularRepository: new SqliteTabularStorage(
+    ":memory:",
+    "task_outputs",
+    TaskOutputSchema,
+    TaskOutputPrimaryKeyNames,
+    ["createdAt"]
+  ),
+});
 await outputRepo.saveOutput("MyTaskType", { param: "value" }, { result: "data" });
 ```
 
@@ -31,9 +48,38 @@ The `TaskGraphRepository` class provides:
 
 ```typescript
 // Example usage
-import { SqliteTaskGraphRepository } from "@workglow/test"; // pre-bound implementation for sqlite
-const fsRepo = new FsFolderTaskGraphRepository("./storage");
-const memoryRepo = new InMemoryTaskGraphRepository();
+import {
+  TaskGraphPrimaryKeyNames,
+  TaskGraphSchema,
+  TaskGraphTabularRepository,
+} from "@workglow/task-graph";
+import {
+  FsFolderTabularStorage,
+  InMemoryTabularStorage,
+  SqliteTabularStorage,
+} from "@workglow/storage";
+import { Sqlite } from "@workglow/storage/sqlite";
+
+const fsRepo = new TaskGraphTabularRepository({
+  tabularRepository: new FsFolderTabularStorage(
+    "./storage",
+    TaskGraphSchema,
+    TaskGraphPrimaryKeyNames
+  ),
+});
+const memoryRepo = new TaskGraphTabularRepository({
+  tabularRepository: new InMemoryTabularStorage(TaskGraphSchema, TaskGraphPrimaryKeyNames),
+});
+
+await Sqlite.init();
+const sqliteRepo = new TaskGraphTabularRepository({
+  tabularRepository: new SqliteTabularStorage(
+    ":memory:",
+    "task_graphs",
+    TaskGraphSchema,
+    TaskGraphPrimaryKeyNames
+  ),
+});
 ```
 
 ## Testing

package/dist/types.d.ts

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-export * from "./common";
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC"}