@dryvcode/author 0.0.1

package/dist/interfaces/representation.js

@@ -0,0 +1,25 @@
+import { requireText } from "../foundation/metadata.js";
+export class Representation {
+    #state;
+    constructor(kind, mediaType) {
+        this.#state = {
+            kind,
+            ...(mediaType === undefined
+                ? {}
+                : { mediaType: requireText(mediaType, "media type") }),
+        };
+    }
+    toState() {
+        return { ...this.#state };
+    }
+}
+export function representation(kind, mediaType) {
+    return new Representation(kind, mediaType);
+}
+export const json = (mediaType) => representation("json", mediaType);
+export const xml = (mediaType) => representation("xml", mediaType);
+export const csv = (mediaType) => representation("csv", mediaType);
+export const text = (mediaType) => representation("text", mediaType);
+export const bytes = (mediaType) => representation("bytes", mediaType);
+export const eventStream = (mediaType) => representation("event-stream", mediaType);
+//# sourceMappingURL=representation.js.map

package/dist/interfaces/representation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"representation.js","sourceRoot":"","sources":["../../src/interfaces/representation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,OAAO,cAAc;IAChB,MAAM,CAAsB;IAErC,YAAY,IAAwB,EAAE,SAAkB;QACtD,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI;YACJ,GAAG,CAAC,SAAS,KAAK,SAAS;gBACzB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAC5B,IAAwB,EACxB,SAAkB;IAElB,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,SAAkB,EAAkB,EAAE,CACzD,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,SAAkB,EAAkB,EAAE,CACxD,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,SAAkB,EAAkB,EAAE,CACxD,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,SAAkB,EAAkB,EAAE,CACzD,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,SAAkB,EAAkB,EAAE,CAC1D,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAkB,EAAkB,EAAE,CAChE,cAAc,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC"}

package/dist/interfaces/schedule.d.ts

@@ -0,0 +1,14 @@
+import type { ScheduleFacetState, ScheduleState } from "../contracts/index.js";
+import { type DurationInput } from "../behavior/duration.js";
+import type { FacetDeclaration } from "./facet.js";
+export declare function interval(every: DurationInput): ScheduleState;
+export declare function daily(hour: number, minute?: number, timezone?: string): ScheduleState;
+export declare class ScheduleFacetDeclaration implements FacetDeclaration {
+    #private;
+    private _description?;
+    constructor(scheduleValue: ScheduleState);
+    description(value: string): this;
+    toState(): ScheduleFacetState;
+}
+export declare function schedule(scheduleValue: ScheduleState): ScheduleFacetDeclaration;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/interfaces/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/interfaces/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,qBAAqB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAK5D;AAED,wBAAgB,KAAK,CACnB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAI,EACV,QAAQ,SAAQ,GACf,aAAa,CAaf;AAED,qBAAa,wBAAyB,YAAW,gBAAgB;;IAE/D,OAAO,CAAC,YAAY,CAAC,CAAS;IAE9B,YAAY,aAAa,EAAE,aAAa,EAEvC;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/B;IAED,OAAO,IAAI,kBAAkB,CAQ5B;CACF;AAED,wBAAgB,QAAQ,CACtB,aAAa,EAAE,aAAa,GAC3B,wBAAwB,CAE1B"}

package/dist/interfaces/schedule.js

@@ -0,0 +1,46 @@
+import { seconds } from "../behavior/duration.js";
+import { requireText } from "../foundation/metadata.js";
+export function interval(every) {
+    return {
+        kind: "interval",
+        every: typeof every === "number" ? seconds(every) : every,
+    };
+}
+export function daily(hour, minute = 0, timezone = "UTC") {
+    if (!Number.isInteger(hour) || hour < 0 || hour > 23) {
+        throw new TypeError("daily schedule hour must be 0-23");
+    }
+    if (!Number.isInteger(minute) || minute < 0 || minute > 59) {
+        throw new TypeError("daily schedule minute must be 0-59");
+    }
+    return {
+        kind: "daily",
+        hour,
+        minute,
+        timezone: requireText(timezone, "schedule timezone"),
+    };
+}
+export class ScheduleFacetDeclaration {
+    #schedule;
+    _description;
+    constructor(scheduleValue) {
+        this.#schedule = scheduleValue;
+    }
+    description(value) {
+        this._description = requireText(value, "schedule facet description");
+        return this;
+    }
+    toState() {
+        return {
+            kind: "schedule",
+            ...(this._description === undefined
+                ? {}
+                : { description: this._description }),
+            schedule: this.#schedule,
+        };
+    }
+}
+export function schedule(scheduleValue) {
+    return new ScheduleFacetDeclaration(scheduleValue);
+}
+//# sourceMappingURL=schedule.js.map

package/dist/interfaces/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../src/interfaces/schedule.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,IAAY,EACZ,MAAM,GAAG,CAAC,EACV,QAAQ,GAAG,KAAK;IAEhB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI;QACJ,MAAM;QACN,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,mBAAmB,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,wBAAwB;IAC1B,SAAS,CAAgB;IAC1B,YAAY,CAAU;IAE9B,YAAY,aAA4B;QACtC,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC;IACjC,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;gBACjC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;YACvC,QAAQ,EAAE,IAAI,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,QAAQ,CACtB,aAA4B;IAE5B,OAAO,IAAI,wBAAwB,CAAC,aAAa,CAAC,CAAC;AACrD,CAAC"}

package/dist/interfaces/surface.d.ts

@@ -0,0 +1,22 @@
+import type { ExplanationKindState } from "../contracts/index.js";
+import type { SurfaceKind, SurfaceState } from "../contracts/index.js";
+import { Declaration } from "../foundation/declaration.js";
+export declare class SurfaceDeclaration extends Declaration<"surface"> {
+    #private;
+    private _description?;
+    private _tags;
+    private _explanations;
+    constructor(kind: SurfaceKind);
+    description(value: string): this;
+    tags(...values: readonly string[]): this;
+    explain(kind: ExplanationKindState, text: string): this;
+    toState(): SurfaceState;
+}
+export declare const surface: {
+    web: () => SurfaceDeclaration;
+    mobile: () => SurfaceDeclaration;
+    desktop: () => SurfaceDeclaration;
+    cli: () => SurfaceDeclaration;
+    embedded: () => SurfaceDeclaration;
+};
+//# sourceMappingURL=surface.d.ts.map

package/dist/interfaces/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/interfaces/surface.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAoB,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAQvD,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,SAAS,CAAC;;IAE5D,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,aAAa,CAA0B;IAE/C,YAAY,IAAI,EAAE,WAAW,EAG5B;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/B;IAED,IAAI,CAAC,GAAG,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAGvC;IAED,OAAO,CAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGtD;IAEQ,OAAO,IAAI,YAAY,CAU/B;CACF;AAED,eAAO,MAAM,OAAO;IAClB,GAAG,QAAM,kBAAkB;IAC3B,MAAM,QAAM,kBAAkB;IAC9B,OAAO,QAAM,kBAAkB;IAC/B,GAAG,QAAM,kBAAkB;IAC3B,QAAQ,QAAM,kBAAkB;CACjC,CAAC"}

package/dist/interfaces/surface.js

@@ -0,0 +1,44 @@
+import { explanation, normalizeTags, optionalSemanticMetadata, } from "../foundation/metadata.js";
+import { Declaration } from "../foundation/declaration.js";
+import { optionalDescription, optionalGroup, optionalOrigin, requireText, } from "../foundation/metadata.js";
+export class SurfaceDeclaration extends Declaration {
+    #surfaceKind;
+    _description;
+    _tags = [];
+    _explanations = [];
+    constructor(kind) {
+        super("surface");
+        this.#surfaceKind = kind;
+    }
+    description(value) {
+        this._description = requireText(value, "surface description");
+        return this;
+    }
+    tags(...values) {
+        this._tags = [...normalizeTags(values, "tags")];
+        return this;
+    }
+    explain(kind, text) {
+        this._explanations.push(explanation(kind, text, "explanation"));
+        return this;
+    }
+    toState() {
+        return {
+            identity: this.identity,
+            kind: "surface",
+            ...optionalSemanticMetadata(this._tags, this._explanations),
+            surfaceKind: this.#surfaceKind,
+            ...optionalDescription(this._description),
+            ...optionalGroup(this._group),
+            ...optionalOrigin(this._origin),
+        };
+    }
+}
+export const surface = {
+    web: () => new SurfaceDeclaration("web"),
+    mobile: () => new SurfaceDeclaration("mobile"),
+    desktop: () => new SurfaceDeclaration("desktop"),
+    cli: () => new SurfaceDeclaration("cli"),
+    embedded: () => new SurfaceDeclaration("embedded"),
+};
+//# sourceMappingURL=surface.js.map

package/dist/interfaces/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/interfaces/surface.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,MAAM,OAAO,kBAAmB,SAAQ,WAAsB;IACnD,YAAY,CAAc;IAC3B,YAAY,CAAU;IACtB,KAAK,GAAa,EAAE,CAAC;IACrB,aAAa,GAAuB,EAAE,CAAC;IAE/C,YAAY,IAAiB;QAC3B,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,GAAG,MAAyB;QAC/B,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,IAA0B,EAAE,IAAY;QAC9C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IAEQ,OAAO;QACd,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,SAAS;YACf,GAAG,wBAAwB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC;YAC3D,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,GAAG,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC;YACzC,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;YAC7B,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;SAChC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,EAAE,GAAuB,EAAE,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC;IAC5D,MAAM,EAAE,GAAuB,EAAE,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC;IAClE,OAAO,EAAE,GAAuB,EAAE,CAAC,IAAI,kBAAkB,CAAC,SAAS,CAAC;IACpE,GAAG,EAAE,GAAuB,EAAE,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC;IAC5D,QAAQ,EAAE,GAAuB,EAAE,CAAC,IAAI,kBAAkB,CAAC,UAAU,CAAC;CACvE,CAAC"}

package/dist/interfaces/websocket.d.ts

@@ -0,0 +1,11 @@
+import type { WebSocketFacetState } from "../contracts/index.js";
+import type { FacetDeclaration } from "./facet.js";
+export declare class WebSocketFacetDeclaration implements FacetDeclaration {
+    #private;
+    private _description?;
+    constructor(pathValue: string);
+    description(value: string): this;
+    toState(): WebSocketFacetState;
+}
+export declare function websocket(pathValue: string): WebSocketFacetDeclaration;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/interfaces/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/interfaces/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,qBAAa,yBAA0B,YAAW,gBAAgB;;IAEhE,OAAO,CAAC,YAAY,CAAC,CAAS;IAE9B,YAAY,SAAS,EAAE,MAAM,EAE5B;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/B;IAED,OAAO,IAAI,mBAAmB,CAQ7B;CACF;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,CAEtE"}

package/dist/interfaces/websocket.js

@@ -0,0 +1,25 @@
+import { requireText } from "../foundation/metadata.js";
+export class WebSocketFacetDeclaration {
+    #path;
+    _description;
+    constructor(pathValue) {
+        this.#path = requireText(pathValue, "websocket path");
+    }
+    description(value) {
+        this._description = requireText(value, "websocket facet description");
+        return this;
+    }
+    toState() {
+        return {
+            kind: "websocket",
+            ...(this._description === undefined
+                ? {}
+                : { description: this._description }),
+            path: this.#path,
+        };
+    }
+}
+export function websocket(pathValue) {
+    return new WebSocketFacetDeclaration(pathValue);
+}
+//# sourceMappingURL=websocket.js.map

package/dist/interfaces/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/interfaces/websocket.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,OAAO,yBAAyB;IAC3B,KAAK,CAAS;IACf,YAAY,CAAU;IAE9B,YAAY,SAAiB;QAC3B,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;gBACjC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,IAAI,yBAAyB,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC"}

package/dist/orchestration/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./value-source.js";
+export * from "./steps.js";
+export * from "./workflow.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/orchestration/index.js

@@ -0,0 +1,4 @@
+export * from "./value-source.js";
+export * from "./steps.js";
+export * from "./workflow.js";
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/dist/orchestration/steps.d.ts

@@ -0,0 +1,41 @@
+import type { DeclarationRef, StepInputBindingState, WorkflowStepRefState, WorkflowStepState } from "../contracts/index.js";
+import type { DurationInput } from "../behavior/duration.js";
+import type { EventRef, InferValueRef, OperationRef, TupleIndex, ValueRefTuple, WorkflowRef } from "../foundation/ref.js";
+import { WorkflowValueSource } from "./value-source.js";
+interface WorkflowOwner {
+    ref(): DeclarationRef<"workflow">;
+}
+export declare abstract class WorkflowStepDeclaration {
+    private _workflow?;
+    private _name?;
+    attach(workflow: WorkflowOwner, name: string): void;
+    refState(): WorkflowStepRefState;
+    abstract toState(): WorkflowStepState;
+}
+declare abstract class InvokingWorkflowStepDeclaration<TInputs extends ValueRefTuple, TOutputs extends ValueRefTuple> extends WorkflowStepDeclaration {
+    private _inputs;
+    input<I extends TupleIndex<TInputs>>(index: I, source: WorkflowValueSource<InferValueRef<TInputs[I]>>): this;
+    output<I extends TupleIndex<TOutputs>>(index: I): WorkflowValueSource<InferValueRef<TOutputs[I]>>;
+    protected inputStates(): readonly StepInputBindingState[];
+}
+export declare class OperationStepDeclaration<TInputs extends ValueRefTuple, TOutputs extends ValueRefTuple> extends InvokingWorkflowStepDeclaration<TInputs, TOutputs> {
+    #private;
+    constructor(operation: OperationRef<TInputs, TOutputs>);
+    toState(): WorkflowStepState;
+}
+export declare class NestedWorkflowStepDeclaration<TInputs extends ValueRefTuple, TOutputs extends ValueRefTuple> extends InvokingWorkflowStepDeclaration<TInputs, TOutputs> {
+    #private;
+    constructor(workflow: WorkflowRef<unknown, TInputs, TOutputs>);
+    toState(): WorkflowStepState;
+}
+export declare class WaitStepDeclaration<TPayload = never> extends WorkflowStepDeclaration {
+    #private;
+    constructor(event: EventRef<TPayload>, timeout?: DurationInput);
+    payload(): [TPayload] extends [never] ? never : WorkflowValueSource<TPayload>;
+    toState(): WorkflowStepState;
+}
+export declare function operationStep<TInputs extends ValueRefTuple, TOutputs extends ValueRefTuple>(operation: OperationRef<TInputs, TOutputs>): OperationStepDeclaration<TInputs, TOutputs>;
+export declare function workflowStep<TSteps, TInputs extends ValueRefTuple, TOutputs extends ValueRefTuple>(workflow: WorkflowRef<TSteps, TInputs, TOutputs>): NestedWorkflowStepDeclaration<TInputs, TOutputs>;
+export declare function waitFor<TPayload>(value: EventRef<TPayload>, timeout?: DurationInput): WaitStepDeclaration<TPayload>;
+export {};
+//# sourceMappingURL=steps.d.ts.map

package/dist/orchestration/steps.d.ts.map

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

package/dist/orchestration/steps.js

@@ -0,0 +1,105 @@
+import { seconds } from "../behavior/duration.js";
+import { WorkflowValueSource } from "./value-source.js";
+export class WorkflowStepDeclaration {
+    _workflow;
+    _name;
+    attach(workflow, name) {
+        if (this._workflow !== undefined) {
+            throw new TypeError("workflow step is already attached");
+        }
+        this._workflow = workflow;
+        this._name = name;
+    }
+    refState() {
+        if (this._workflow === undefined || this._name === undefined) {
+            throw new TypeError("workflow step must be attached before it can be referenced");
+        }
+        return { workflow: this._workflow.ref(), step: this._name };
+    }
+}
+class InvokingWorkflowStepDeclaration extends WorkflowStepDeclaration {
+    _inputs = [];
+    input(index, source) {
+        this._inputs.push({ target: index, source });
+        return this;
+    }
+    output(index) {
+        return new WorkflowValueSource(() => ({
+            kind: "step-output",
+            step: this.refState(),
+            index,
+        }));
+    }
+    inputStates() {
+        return this._inputs.map(({ target, source }) => ({
+            target,
+            source: source.toState(),
+        }));
+    }
+}
+export class OperationStepDeclaration extends InvokingWorkflowStepDeclaration {
+    #operation;
+    constructor(operation) {
+        super();
+        this.#operation = operation;
+    }
+    toState() {
+        return {
+            kind: "operation",
+            operation: this.#operation.ref(),
+            inputs: this.inputStates(),
+        };
+    }
+}
+export class NestedWorkflowStepDeclaration extends InvokingWorkflowStepDeclaration {
+    #workflow;
+    constructor(workflow) {
+        super();
+        this.#workflow = workflow;
+    }
+    toState() {
+        return {
+            kind: "workflow",
+            workflow: this.#workflow.ref(),
+            inputs: this.inputStates(),
+        };
+    }
+}
+export class WaitStepDeclaration extends WorkflowStepDeclaration {
+    #event;
+    #timeout;
+    constructor(event, timeout) {
+        super();
+        this.#event = event;
+        this.#timeout = timeout;
+    }
+    payload() {
+        return new WorkflowValueSource(() => ({
+            kind: "event-payload",
+            step: this.refState(),
+        }));
+    }
+    toState() {
+        return {
+            kind: "wait",
+            event: this.#event.ref(),
+            ...(this.#timeout === undefined
+                ? {}
+                : {
+                    timeout: typeof this.#timeout === "number"
+                        ? seconds(this.#timeout)
+                        : this.#timeout,
+                }),
+        };
+    }
+}
+export function operationStep(operation) {
+    return new OperationStepDeclaration(operation);
+}
+export function workflowStep(workflow) {
+    return new NestedWorkflowStepDeclaration(workflow);
+}
+export function waitFor(value, timeout) {
+    return new WaitStepDeclaration(value, timeout);
+}
+//# sourceMappingURL=steps.js.map

package/dist/orchestration/steps.js.map

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

package/dist/orchestration/value-source.d.ts

@@ -0,0 +1,8 @@
+import type { WorkflowValueSourceState } from "../contracts/index.js";
+export declare class WorkflowValueSource<T = unknown> {
+    #private;
+    readonly __value?: T;
+    constructor(resolve: () => WorkflowValueSourceState);
+    toState(): WorkflowValueSourceState;
+}
+//# sourceMappingURL=value-source.d.ts.map

package/dist/orchestration/value-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-source.d.ts","sourceRoot":"","sources":["../../src/orchestration/value-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,qBAAa,mBAAmB,CAAC,CAAC,GAAG,OAAO;;IAC1C,SAAiB,OAAO,CAAC,EAAE,CAAC,CAAC;IAG7B,YAAY,OAAO,EAAE,MAAM,wBAAwB,EAElD;IAED,OAAO,IAAI,wBAAwB,CAElC;CACF"}

package/dist/orchestration/value-source.js

@@ -0,0 +1,10 @@
+export class WorkflowValueSource {
+    #resolve;
+    constructor(resolve) {
+        this.#resolve = resolve;
+    }
+    toState() {
+        return this.#resolve();
+    }
+}
+//# sourceMappingURL=value-source.js.map

package/dist/orchestration/value-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-source.js","sourceRoot":"","sources":["../../src/orchestration/value-source.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,mBAAmB;IAErB,QAAQ,CAAiC;IAElD,YAAY,OAAuC;QACjD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/orchestration/workflow.d.ts

@@ -0,0 +1,38 @@
+import type { ExplanationKindState, WorkflowRoleState } from "../contracts/index.js";
+import type { WorkflowState } from "../contracts/index.js";
+import { Declaration } from "../foundation/declaration.js";
+import type { InferValueRef, PolicyRef, TupleIndex, ValueRefTuple } from "../foundation/ref.js";
+import type { WorkflowStepDeclaration } from "./steps.js";
+import { WorkflowValueSource } from "./value-source.js";
+export type WorkflowStepMap = Readonly<Record<string, WorkflowStepDeclaration>>;
+export declare class WorkflowDeclaration<TSteps extends WorkflowStepMap = {}, TInputs extends ValueRefTuple = readonly [], TOutputs extends ValueRefTuple = readonly []> extends Declaration<"workflow"> {
+    readonly __steps?: TSteps;
+    readonly __inputs?: TInputs;
+    readonly __outputs?: TOutputs;
+    private _description?;
+    private _tags;
+    private _explanations;
+    private _role?;
+    private _inputs;
+    private _outputs;
+    private _outputBindings;
+    private _steps;
+    private _start?;
+    private _transitions;
+    constructor();
+    description(value: string): this;
+    tags(...values: readonly string[]): this;
+    explain(kind: ExplanationKindState, text: string): this;
+    role(value: WorkflowRoleState): this;
+    inputs<const T extends ValueRefTuple>(...values: T): WorkflowDeclaration<TSteps, T, TOutputs>;
+    outputs<const T extends ValueRefTuple>(...values: T): WorkflowDeclaration<TSteps, TInputs, T>;
+    input<I extends TupleIndex<TInputs>>(index: I): WorkflowValueSource<InferValueRef<TInputs[I]>>;
+    bindOutput<I extends TupleIndex<TOutputs>>(index: I, source: WorkflowValueSource<InferValueRef<TOutputs[I]>>): this;
+    steps<const T extends WorkflowStepMap>(values: T): WorkflowDeclaration<T, TInputs, TOutputs>;
+    start<K extends Extract<keyof TSteps, string>>(value: K): this;
+    transition<F extends Extract<keyof TSteps, string>, T extends Extract<keyof TSteps, string>>(from: F, to: T, when?: PolicyRef): this;
+    private stepRef;
+    toState(): WorkflowState;
+}
+export declare function workflow(): WorkflowDeclaration;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/orchestration/workflow.d.ts.map

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

package/dist/orchestration/workflow.js

@@ -0,0 +1,116 @@
+import { explanation, normalizeTags, optionalSemanticMetadata, } from "../foundation/metadata.js";
+import { Declaration } from "../foundation/declaration.js";
+import { valuePortState } from "../foundation/ref.js";
+import { optionalDescription, optionalOwner, optionalOrigin, requireText, } from "../foundation/metadata.js";
+import { WorkflowValueSource } from "./value-source.js";
+export class WorkflowDeclaration extends Declaration {
+    _description;
+    _tags = [];
+    _explanations = [];
+    _role;
+    _inputs = [];
+    _outputs = [];
+    _outputBindings = [];
+    _steps = {};
+    _start;
+    _transitions = [];
+    constructor() {
+        super("workflow");
+    }
+    description(value) {
+        this._description = requireText(value, "workflow description");
+        return this;
+    }
+    tags(...values) {
+        this._tags = [...normalizeTags(values, "tags")];
+        return this;
+    }
+    explain(kind, text) {
+        this._explanations.push(explanation(kind, text, "explanation"));
+        return this;
+    }
+    role(value) {
+        this._role = value;
+        return this;
+    }
+    inputs(...values) {
+        this._inputs = [...values];
+        return this;
+    }
+    outputs(...values) {
+        this._outputs = [...values];
+        return this;
+    }
+    input(index) {
+        return new WorkflowValueSource(() => ({
+            kind: "workflow-input",
+            port: {
+                workflow: this.ref(),
+                direction: "input",
+                index,
+            },
+        }));
+    }
+    bindOutput(index, source) {
+        this._outputBindings.push({ target: index, source });
+        return this;
+    }
+    steps(values) {
+        for (const [name, step] of Object.entries(values)) {
+            step.attach(this, requireText(name, "workflow step name"));
+        }
+        this._steps = { ...values };
+        return this;
+    }
+    start(value) {
+        this._start = value;
+        return this;
+    }
+    transition(from, to, when) {
+        this._transitions.push({
+            from: this.stepRef(from),
+            to: this.stepRef(to),
+            ...(when === undefined ? {} : { when: when.ref() }),
+        });
+        return this;
+    }
+    stepRef(step) {
+        return { workflow: this.ref(), step };
+    }
+    toState() {
+        if (this._start === undefined) {
+            throw new TypeError("Workflow requires .start(...)");
+        }
+        const stepsState = {};
+        for (const key of Object.keys(this._steps).sort()) {
+            stepsState[key] = this._steps[key].toState();
+        }
+        const outputBindings = this._outputBindings.map(({ target, source }) => ({
+            target: {
+                workflow: this.ref(),
+                direction: "output",
+                index: target,
+            },
+            source: source.toState(),
+        }));
+        return {
+            identity: this.identity,
+            kind: "workflow",
+            ...optionalSemanticMetadata(this._tags, this._explanations),
+            ...(this._role === undefined ? {} : { role: this._role }),
+            inputs: this._inputs.map(valuePortState),
+            outputs: this._outputs.map(valuePortState),
+            outputBindings,
+            start: this.stepRef(this._start),
+            steps: stepsState,
+            transitions: this._transitions.map((item) => ({ ...item })),
+            ...optionalDescription(this._description),
+            ...optionalOwner(this._group, this._feature),
+            ...optionalOrigin(this._origin),
+        };
+    }
+}
+export function workflow() {
+    return new WorkflowDeclaration();
+}
+//# sourceMappingURL=workflow.js.map

package/dist/orchestration/workflow.js.map

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

package/dist/project/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./project.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/project/index.js

@@ -0,0 +1,2 @@
+export * from "./project.js";
+//# sourceMappingURL=index.js.map

package/dist/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}