gagen 0.0.4

package/esm/matrix.d.ts

@@ -0,0 +1,15 @@
+import { ExpressionValue } from "./expression.js";
+type ExtractMatrixKeys<T> = Exclude<keyof T & string, "include" | "exclude"> | (T extends {
+    include: readonly (infer I)[];
+} ? keyof I & string : never);
+export declare class Matrix<_K extends string> {
+    #private;
+    constructor(def: Record<string, unknown>, keys: string[]);
+    toYaml(): Record<string, unknown>;
+}
+type MatrixWithExprs<K extends string> = Matrix<K> & {
+    readonly [P in K]: ExpressionValue;
+};
+export declare function defineMatrix<const T extends Record<string, unknown>>(def: T): MatrixWithExprs<ExtractMatrixKeys<T>>;
+export {};
+//# sourceMappingURL=matrix.d.ts.map

package/esm/matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../src/matrix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,KAAK,iBAAiB,CAAC,CAAC,IACpB,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,GAChD,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAA;CAAE,GAAG,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;AAE7E,qBAAa,MAAM,CAAC,EAAE,SAAS,MAAM;;gBAGvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;IASxD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGlC;AAED,KAAK,eAAe,CAAC,CAAC,SAAS,MAAM,IACjC,MAAM,CAAC,CAAC,CAAC,GACT;IACA,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,eAAe;CACnC,CAAC;AAEJ,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,GAAG,EAAE,CAAC,GACL,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAkBvC"}

package/esm/matrix.js

@@ -0,0 +1,44 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Matrix_def;
+import { ExpressionValue } from "./expression.js";
+export class Matrix {
+    constructor(def, keys) {
+        _Matrix_def.set(this, void 0);
+        __classPrivateFieldSet(this, _Matrix_def, def, "f");
+        for (const key of keys) {
+            this[key] = new ExpressionValue(`matrix.${key}`);
+        }
+    }
+    toYaml() {
+        return __classPrivateFieldGet(this, _Matrix_def, "f");
+    }
+}
+_Matrix_def = new WeakMap();
+export function defineMatrix(def) {
+    const keys = new Set();
+    for (const [key, value] of Object.entries(def)) {
+        if (key !== "include" && key !== "exclude") {
+            keys.add(key);
+        }
+        if (key === "include" && Array.isArray(value)) {
+            for (const item of value) {
+                if (typeof item === "object" && item !== null) {
+                    for (const k of Object.keys(item)) {
+                        keys.add(k);
+                    }
+                }
+            }
+        }
+    }
+    return new Matrix(def, [...keys]);
+}

package/esm/mod.d.ts

@@ -0,0 +1,14 @@
+import "./_dnt.polyfills.js";
+export { Step, step, StepGroup, steps } from "./step.js";
+export type { ConditionLike, ConfigValue, StepConfig, StepLike, } from "./step.js";
+export { Job, job } from "./job.js";
+export type { JobConfig, JobDef, ReusableJobConfig, ReusableJobDef, ServiceContainer, StepsJobConfig, StepsJobDef, } from "./job.js";
+export { createWorkflow, Workflow } from "./workflow.js";
+export type { isLinting, WorkflowCallInput, WorkflowCallOutput, WorkflowCallSecret, WorkflowCallTrigger, WorkflowConfig, WorkflowTriggers, } from "./workflow.js";
+export { Condition, conditions, ElseIfBuilder, expr, ExpressionValue, ThenBuilder, } from "./expression.js";
+export type { ExpressionSource, TernaryValue } from "./expression.js";
+export { defineMatrix, Matrix } from "./matrix.js";
+export type { PermissionLevel, Permissions, PermissionScope, } from "./permissions.js";
+export { Artifact, defineArtifact } from "./artifact.js";
+export type { ArtifactOptions, DownloadConfig, UploadConfig, } from "./artifact.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,YAAY,EACV,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,SAAS,EACT,UAAU,EACV,aAAa,EACb,IAAI,EACJ,eAAe,EACf,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EACV,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,eAAe,CAAC"}

package/esm/mod.js

@@ -0,0 +1,7 @@
+import "./_dnt.polyfills.js";
+export { Step, step, StepGroup, steps } from "./step.js";
+export { Job, job } from "./job.js";
+export { createWorkflow, Workflow } from "./workflow.js";
+export { Condition, conditions, ElseIfBuilder, expr, ExpressionValue, ThenBuilder, } from "./expression.js";
+export { defineMatrix, Matrix } from "./matrix.js";
+export { Artifact, defineArtifact } from "./artifact.js";

package/esm/mod_test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod_test.d.ts","sourceRoot":"","sources":["../src/mod_test.ts"],"names":[],"mappings":""}

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/esm/permissions.d.ts

@@ -0,0 +1,4 @@
+export type PermissionLevel = "read" | "write" | "none";
+export type PermissionScope = "actions" | "attestations" | "checks" | "contents" | "deployments" | "discussions" | "id-token" | "issues" | "packages" | "pages" | "pull-requests" | "repository-projects" | "security-events" | "statuses";
+export type Permissions = Partial<Record<PermissionScope, PermissionLevel>> | "read-all" | "write-all";
+//# sourceMappingURL=permissions.d.ts.map

package/esm/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,cAAc,GACd,QAAQ,GACR,UAAU,GACV,aAAa,GACb,aAAa,GACb,UAAU,GACV,QAAQ,GACR,UAAU,GACV,OAAO,GACP,eAAe,GACf,qBAAqB,GACrB,iBAAiB,GACjB,UAAU,CAAC;AAEf,MAAM,MAAM,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,GACjD,UAAU,GACV,WAAW,CAAC"}

package/esm/permissions.js

@@ -0,0 +1 @@
+export {};

package/esm/step.d.ts

@@ -0,0 +1,48 @@
+import { Condition, type ExpressionSource, ExpressionValue } from "./expression.js";
+export type ConditionLike = Condition | ExpressionValue | string;
+export type ConfigValue = string | number | boolean | ExpressionValue;
+export interface StepConfig<O extends string = never> {
+    name?: string;
+    id?: string;
+    uses?: string;
+    run?: string | string[];
+    with?: Record<string, ConfigValue>;
+    env?: Record<string, ConfigValue>;
+    if?: ConditionLike;
+    shell?: string;
+    workingDirectory?: string;
+    continueOnError?: boolean | string;
+    timeoutMinutes?: number;
+    outputs?: readonly O[];
+}
+export declare function resetStepCounter(): void;
+export type StepLike = Step<string> | StepGroup;
+export declare class Step<O extends string = never> implements ExpressionSource {
+    #private;
+    readonly config: StepConfig<O>;
+    readonly dependencies: Step<string>[];
+    readonly comesAfterDeps: Step<string>[];
+    readonly outputs: {
+        [K in O]: ExpressionValue;
+    };
+    readonly _crossJobDeps: Step<string>[];
+    _job?: ExpressionSource;
+    constructor(config: StepConfig<O>);
+    get id(): string;
+    dependsOn(...deps: StepLike[]): this;
+    comesAfter(...deps: StepLike[]): this;
+    toYaml(effectiveIf?: Condition): Record<string, unknown>;
+}
+export declare function step<const O extends string = never>(config: StepConfig<O>): Step<O>;
+export declare function serializeConditionLike(c: ConditionLike): string;
+export declare function toCondition(c: ConditionLike): Condition;
+export declare function serializeConfigValues(record: Record<string, ConfigValue>): Record<string, string | number | boolean>;
+export declare class StepGroup {
+    readonly all: Step<string>[];
+    constructor(steps: Step<string>[]);
+    if(condition: ConditionLike): this;
+    dependsOn(...deps: StepLike[]): this;
+    comesAfter(...deps: StepLike[]): this;
+}
+export declare function steps(...items: (Step<string> | StepGroup | StepConfig)[]): StepGroup;
+//# sourceMappingURL=step.d.ts.map

package/esm/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"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"}

package/esm/step.js

@@ -0,0 +1,226 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Step_id;
+import { Condition, ExpressionValue, RawCondition, sourcesFrom, } from "./expression.js";
+let stepCounter = 0;
+// exported for testing only
+export function resetStepCounter() {
+    stepCounter = 0;
+}
+export class Step {
+    constructor(config) {
+        _Step_id.set(this, void 0);
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "dependencies", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "comesAfterDeps", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "outputs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        // cross-job step references for needs inference (e.g., artifact download → upload)
+        Object.defineProperty(this, "_crossJobDeps", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        // set by Job.resolveSteps() — the job that owns this step
+        Object.defineProperty(this, "_job", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        if (config.outputs?.length && !config.id) {
+            throw new Error("Step with outputs must have an explicit id");
+        }
+        __classPrivateFieldSet(this, _Step_id, config.id ?? `_step_${stepCounter++}`, "f");
+        this.config = config;
+        // build typed outputs
+        const outputs = {};
+        if (config.outputs) {
+            for (const name of config.outputs) {
+                outputs[name] =
+                    new ExpressionValue(`steps.${__classPrivateFieldGet(this, _Step_id, "f")}.outputs.${name}`, this);
+            }
+        }
+        this.outputs = outputs;
+    }
+    get id() {
+        return __classPrivateFieldGet(this, _Step_id, "f");
+    }
+    dependsOn(...deps) {
+        for (const d of deps) {
+            if (d instanceof StepGroup) {
+                this.dependencies.push(...d.all);
+            }
+            else {
+                this.dependencies.push(d);
+            }
+        }
+        return this;
+    }
+    comesAfter(...deps) {
+        for (const d of deps) {
+            if (d instanceof StepGroup) {
+                this.comesAfterDeps.push(...d.all);
+            }
+            else {
+                this.comesAfterDeps.push(d);
+            }
+        }
+        return this;
+    }
+    toYaml(effectiveIf) {
+        const result = {};
+        if (this.config.name != null) {
+            result.name = this.config.name;
+        }
+        // only include user-provided id
+        if (this.config.id) {
+            result.id = this.config.id;
+        }
+        if (this.config.uses != null) {
+            result.uses = this.config.uses;
+        }
+        const ifCondition = effectiveIf ?? this.config.if;
+        if (ifCondition != null) {
+            result.if = serializeConditionLike(ifCondition);
+        }
+        if (this.config.shell != null) {
+            result.shell = this.config.shell;
+        }
+        if (this.config.workingDirectory != null) {
+            result["working-directory"] = this.config.workingDirectory;
+        }
+        if (this.config.env != null) {
+            result.env = serializeConfigValues(this.config.env);
+        }
+        if (this.config.continueOnError != null) {
+            result["continue-on-error"] = this.config.continueOnError;
+        }
+        if (this.config.timeoutMinutes != null) {
+            result["timeout-minutes"] = this.config.timeoutMinutes;
+        }
+        if (this.config.with != null) {
+            result.with = serializeConfigValues(this.config.with);
+        }
+        if (this.config.run != null) {
+            result.run = Array.isArray(this.config.run)
+                ? this.config.run.join("\n")
+                : this.config.run;
+        }
+        return result;
+    }
+}
+_Step_id = new WeakMap();
+export function step(config) {
+    return new Step(config);
+}
+// --- serialization helpers ---
+export function serializeConditionLike(c) {
+    if (c instanceof Condition) {
+        return c.toExpression();
+    }
+    else if (c instanceof ExpressionValue) {
+        return c.expression;
+    }
+    else {
+        return c;
+    }
+}
+export function toCondition(c) {
+    if (c instanceof Condition)
+        return c;
+    if (c instanceof ExpressionValue) {
+        return new RawCondition(c.expression, sourcesFrom(c));
+    }
+    return new RawCondition(c, new Set());
+}
+export function serializeConfigValues(record) {
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        result[key] = value instanceof ExpressionValue ? value.toString() : value;
+    }
+    return result;
+}
+// --- step group ---
+export class StepGroup {
+    constructor(steps) {
+        Object.defineProperty(this, "all", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.all = steps;
+    }
+    if(condition) {
+        const cond = toCondition(condition);
+        for (const s of this.all) {
+            if (s.config.if != null) {
+                s.config.if = cond.and(toCondition(s.config.if));
+            }
+            else {
+                s.config.if = cond;
+            }
+        }
+        return this;
+    }
+    dependsOn(...deps) {
+        for (const s of this.all) {
+            s.dependsOn(...deps);
+        }
+        return this;
+    }
+    comesAfter(...deps) {
+        for (const s of this.all) {
+            s.comesAfter(...deps);
+        }
+        return this;
+    }
+}
+export function steps(...items) {
+    if (items.length === 0) {
+        throw new Error("steps() requires at least one step");
+    }
+    const created = [];
+    for (const item of items) {
+        if (item instanceof StepGroup) {
+            created.push(...item.all);
+        }
+        else if (item instanceof Step) {
+            created.push(item);
+        }
+        else {
+            created.push(new Step(item));
+        }
+    }
+    return new StepGroup(created);
+}

package/esm/workflow.d.ts

@@ -0,0 +1,71 @@
+import { Job, type JobDef } from "./job.js";
+import type { Permissions } from "./permissions.js";
+import type { ConfigValue } from "./step.js";
+export interface WorkflowCallInput {
+    type: "string" | "boolean" | "number";
+    description?: string;
+    required?: boolean;
+    default?: string | boolean | number;
+}
+export interface WorkflowCallOutput {
+    description?: string;
+    value: string;
+}
+export interface WorkflowCallSecret {
+    description?: string;
+    required?: boolean;
+}
+export interface WorkflowCallTrigger {
+    inputs?: Record<string, WorkflowCallInput>;
+    outputs?: Record<string, WorkflowCallOutput>;
+    secrets?: Record<string, WorkflowCallSecret>;
+}
+export interface WorkflowTriggers {
+    push?: {
+        branches?: string[];
+        tags?: string[];
+        paths?: string[];
+        pathsIgnore?: string[];
+    };
+    pull_request?: {
+        branches?: string[];
+        types?: string[];
+        paths?: string[];
+        pathsIgnore?: string[];
+    };
+    workflow_dispatch?: Record<string, unknown>;
+    workflow_call?: WorkflowCallTrigger;
+    schedule?: {
+        cron: string;
+    }[];
+    [key: string]: unknown;
+}
+export interface WorkflowConfig {
+    name: string;
+    on: WorkflowTriggers;
+    permissions?: Permissions;
+    concurrency?: {
+        group: string;
+        cancelInProgress?: boolean | string;
+    };
+    env?: Record<string, ConfigValue>;
+    jobs?: (JobDef | Job)[];
+}
+export declare class Workflow {
+    #private;
+    constructor(config: WorkflowConfig);
+    toYamlString(options?: {
+        header?: string;
+    }): string;
+    writeToFile(path: string | URL, options?: {
+        header?: string;
+    }): void;
+    writeOrLint(options: {
+        filePath: URL;
+        header?: string;
+    }): void;
+}
+/** Gets if linting would occur when using `writeOrLint` on a workflow. */
+export declare const isLinting: boolean;
+export declare function createWorkflow(config: WorkflowConfig): Workflow;
+//# sourceMappingURL=workflow.d.ts.map

package/esm/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAgB,KAAK,MAAM,EAAgB,MAAM,UAAU,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,gBAAgB,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;KAAE,CAAC;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC;CACzB;AAED,qBAAa,QAAQ;;gBAIP,MAAM,EAAE,cAAc;IAqBlC,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAmDnD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAIpE,WAAW,CACT,OAAO,EAAE;QAAE,QAAQ,EAAE,GAAG,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,IAAI;CAoBR;AAED,0EAA0E;AAC1E,eAAO,MAAM,SAAS,EAAE,OAAyC,CAAC;AAElE,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAE/D"}

package/esm/workflow.js

@@ -0,0 +1,136 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Workflow_config, _Workflow_jobs;
+import process from "node:process";
+import { parse } from "./deps/jsr.io/@std/yaml/1.0.11/parse.js";
+import { stringify } from "./deps/jsr.io/@std/yaml/1.0.11/stringify.js";
+import { ExpressionValue } from "./expression.js";
+import { Job, job as jobFn, resolveJobId } from "./job.js";
+import fs from "node:fs";
+export class Workflow {
+    constructor(config) {
+        _Workflow_config.set(this, void 0);
+        _Workflow_jobs.set(this, new Map());
+        __classPrivateFieldSet(this, _Workflow_config, config, "f");
+        if (config.jobs != null) {
+            for (const jobOrDef of config.jobs) {
+                let id;
+                let resolved;
+                if (jobOrDef instanceof Job) {
+                    id = jobOrDef.id;
+                    resolved = jobOrDef;
+                }
+                else {
+                    id = resolveJobId(jobOrDef);
+                    resolved = jobFn(id, jobOrDef);
+                }
+                if (__classPrivateFieldGet(this, _Workflow_jobs, "f").has(id)) {
+                    throw new Error(`Duplicate job id: "${id}"`);
+                }
+                __classPrivateFieldGet(this, _Workflow_jobs, "f").set(id, resolved);
+            }
+        }
+    }
+    toYamlString(options) {
+        const obj = {};
+        obj.name = __classPrivateFieldGet(this, _Workflow_config, "f").name;
+        obj.on = serializeTriggers(__classPrivateFieldGet(this, _Workflow_config, "f").on);
+        if (__classPrivateFieldGet(this, _Workflow_config, "f").permissions != null) {
+            obj.permissions = __classPrivateFieldGet(this, _Workflow_config, "f").permissions;
+        }
+        if (__classPrivateFieldGet(this, _Workflow_config, "f").concurrency != null) {
+            const c = {
+                group: __classPrivateFieldGet(this, _Workflow_config, "f").concurrency.group,
+            };
+            if (__classPrivateFieldGet(this, _Workflow_config, "f").concurrency.cancelInProgress != null) {
+                c["cancel-in-progress"] = __classPrivateFieldGet(this, _Workflow_config, "f").concurrency.cancelInProgress;
+            }
+            obj.concurrency = c;
+        }
+        if (__classPrivateFieldGet(this, _Workflow_config, "f").env != null) {
+            const env = {};
+            for (const [key, value] of Object.entries(__classPrivateFieldGet(this, _Workflow_config, "f").env)) {
+                env[key] = value instanceof ExpressionValue ? value.toString() : value;
+            }
+            obj.env = env;
+        }
+        // pre-resolve all jobs to establish step→job mappings for cross-job deps
+        for (const job of __classPrivateFieldGet(this, _Workflow_jobs, "f").values()) {
+            job.resolveSteps();
+        }
+        // jobs
+        const jobs = {};
+        for (const [id, job] of __classPrivateFieldGet(this, _Workflow_jobs, "f")) {
+            jobs[id] = job.toYaml();
+        }
+        obj.jobs = jobs;
+        const yaml = stringify(obj, {
+            useAnchors: false,
+            lineWidth: 10_000,
+            compatMode: false,
+        });
+        const header = options?.header;
+        return header ? `${header}\n\n${yaml}` : yaml;
+    }
+    writeToFile(path, options) {
+        fs.writeFileSync(path, this.toYamlString(options));
+    }
+    writeOrLint(options) {
+        const expected = this.toYamlString(options);
+        if (isLinting) {
+            const existing = fs.readFileSync(options.filePath, { encoding: "utf8" });
+            const parsedExisting = parse(existing);
+            const parsedExpected = parse(expected);
+            if (JSON.stringify(parsedExisting) !== JSON.stringify(parsedExpected)) {
+                console.error(`Error: ${options.filePath} is out of date. Run without --lint to update.`);
+                process.exit(1);
+            }
+        }
+        else {
+            fs.writeFileSync(options.filePath, expected);
+        }
+    }
+}
+_Workflow_config = new WeakMap(), _Workflow_jobs = new WeakMap();
+/** Gets if linting would occur when using `writeOrLint` on a workflow. */
+export const isLinting = process.argv.includes("--lint");
+export function createWorkflow(config) {
+    return new Workflow(config);
+}
+// --- trigger serialization ---
+function serializeTriggers(triggers) {
+    const result = {};
+    for (const [key, value] of Object.entries(triggers)) {
+        if (value == null)
+            continue;
+        if (key === "pathsIgnore") {
+            result["paths-ignore"] = value;
+        }
+        else if (typeof value === "object" && !Array.isArray(value)) {
+            result[key] = serializeTriggerObject(value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+function serializeTriggerObject(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value == null)
+            continue;
+        const yamlKey = key === "pathsIgnore" ? "paths-ignore" : key;
+        result[yamlKey] = value;
+    }
+    return result;
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "gagen",
+  "description": "Generate complex GitHub Actions YAML files using a declarative API.",
+  "version": "0.0.4",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dsherret/gagen.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/dsherret/gagen/issues"
+  },
+  "module": "./esm/mod.js",
+  "exports": {
+    ".": {
+      "import": "./esm/mod.js"
+    }
+  },
+  "scripts": {
+    "test": "node test_runner.js"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0",
+    "picocolors": "^1.0.0",
+    "@deno/shim-deno": "~0.18.0"
+  },
+  "_generatedBy": "dnt@dev"
+}