gagen 0.1.0 → 0.1.1

package/README.md

@@ -1,10 +1,15 @@
-# `jsr:@david/gagen`
+# `gagen`
 
 [![JSR](https://jsr.io/badges/@david/gagen)](https://jsr.io/@david/gagen)
 [![npm Version](https://img.shields.io/npm/v/gagen.svg?style=flat)](http://www.npmjs.com/package/gagen)
 
 Generate complex GitHub Actions YAML files using a declarative API.
 
+Gagen lets you define workflows in TypeScript with a fluent, declarative API
+that automatically resolves step ordering and propagates conditions. The
+condition propagation helps skip unnecessary setup steps and eliminates needing
+to repeat condition text over and over again.
+
 ## Basic usage
 
 ```ts
@@ -14,7 +19,7 @@ import {
   createWorkflow,
   step,
   steps,
-} from "jsr:@david/gagen@<version>";
+} from "gagen";
 
 const checkout = step({
   uses: "actions/checkout@v6",
@@ -38,7 +43,10 @@ const lint = steps(
     name: "Deno Lint",
     run: "deno lint",
   }).dependsOn(installDeno),
-).if(conditions.isBranch("main").not()).dependsOn(checkout);
+)
+  .dependsOn(checkout)
+  // this condition gets propagated to installDeno, but not checkout
+  .if(conditions.isBranch("main").not());
 
 // only specify the leaf steps — the other steps are pulled in automatically
 createWorkflow({
@@ -63,9 +71,11 @@ existing file and compares the parsed YAML — exiting with a non-zero code if
 they differ. This lets you add a CI step to verify the generated file is up to
 date:
 
-```yaml
-- name: Lint CI generation
-  run: ./.github/workflows/ci.generate.ts --lint
+```ts
+const lintStep = step({
+  name: "Lint CI generation",
+  run: "./.github/workflows/ci.generate.ts --lint",
+});
 ```
 
 ## Conditions
@@ -73,7 +83,7 @@ date:
 Build type-safe GitHub Actions expressions with a fluent API:
 
 ```ts
-import { expr } from "jsr:@david/gagen@<version>";
+import { expr } from "gagen";
 
 const ref = expr("github.ref");
 const os = expr("matrix.os");
@@ -103,7 +113,7 @@ The `conditions` object provides composable helpers for common GitHub Actions
 patterns:
 
 ```ts
-import { conditions } from "jsr:@david/gagen@<version>";
+import { conditions } from "gagen";
 
 const { status, isTag, isBranch, isEvent } = conditions;
 
@@ -235,7 +245,7 @@ Steps can declare outputs. When a job references another job's outputs, the
 `needs` dependency is inferred automatically.
 
 ```ts
-import { createWorkflow, job, step } from "jsr:@david/gagen@<version>";
+import { createWorkflow, job, step } from "gagen";
 
 const checkStep = step({
   id: "check",
@@ -331,7 +341,7 @@ Error: Cycle detected in step ordering: A → B → A
 `defineMatrix()` gives you typed access to matrix values:
 
 ```ts
-import { defineMatrix } from "jsr:@david/gagen@<version>";
+import { defineMatrix } from "gagen";
 
 const matrix = defineMatrix({
   include: [
@@ -387,7 +397,7 @@ const matrix = defineMatrix({
 Type-safe workflow and job permissions:
 
 ```ts
-import { createWorkflow } from "jsr:@david/gagen@<version>";
+import { createWorkflow } from "gagen";
 
 const wf = createWorkflow({
   name: "ci",
@@ -425,7 +435,7 @@ Define reusable workflows with `workflow_call` triggers and call them from other
 jobs:
 
 ```ts
-import { createWorkflow } from "jsr:@david/gagen@<version>";
+import { createWorkflow } from "gagen";
 
 // define a reusable workflow
 const wf = createWorkflow({
@@ -480,7 +490,7 @@ import {
   createWorkflow,
   defineArtifact,
   step,
-} from "jsr:@david/gagen@<version>";
+} from "gagen";
 
 const artifact = defineArtifact("build-output");
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gagen",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Generate complex GitHub Actions YAML files using a declarative API.",
   "repository": {
     "type": "git",