@app-compose/core 3.0.0-beta.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +98 -0
- package/dist/index.cjs +587 -0
- package/dist/index.d.cts +192 -0
- package/dist/index.d.cts.map +1 -0
- package/dist/index.d.ts +192 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +581 -0
- package/dist/index.js.map +1 -0
- package/package.json +69 -0
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
//#region src/computable/definition.d.ts
|
|
2
|
+
declare const Spot$: unique symbol;
|
|
3
|
+
declare const Phantom$: unique symbol;
|
|
4
|
+
type Spot<T> = {
|
|
5
|
+
[Spot$]: true;
|
|
6
|
+
[Phantom$]?: T;
|
|
7
|
+
};
|
|
8
|
+
type SpotValue<T extends Spot<any>> = T extends Spot<infer V> ? V : never;
|
|
9
|
+
//#endregion
|
|
10
|
+
//#region src/shared.d.ts
|
|
11
|
+
type AnyShape = Record<string, unknown>;
|
|
12
|
+
type Eventual<T> = Promise<T> | T;
|
|
13
|
+
type BuiltInObject = null | undefined | boolean | string | number | Error | Date | RegExp | Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | ReadonlyMap<unknown, unknown> | ReadonlySet<unknown> | WeakMap<object, unknown> | WeakSet<object> | ArrayBuffer | DataView | Function | Promise<unknown> | Generator | {
|
|
14
|
+
readonly [Symbol.toStringTag]: string;
|
|
15
|
+
};
|
|
16
|
+
//#endregion
|
|
17
|
+
//#region src/computable/context.d.ts
|
|
18
|
+
type ContextToSpot<T> = [T] extends [BuiltInObject] ? Spot<T> : Spot<T> | ContextShapeToSpot<T>;
|
|
19
|
+
type ContextShapeToSpot<T> = { readonly [K in keyof T]: ContextToSpot<T[K]> };
|
|
20
|
+
type KeyValue = Record<string, unknown> | readonly unknown[];
|
|
21
|
+
type SpotToContext<T> = T extends Spot<infer Value> ? Value : T extends KeyValue ? { [Key in keyof T]: SpotToContext<T[Key]> } : never;
|
|
22
|
+
type IsSpot<T> = T extends Spot<unknown> ? true : T extends readonly unknown[] ? { [Key in keyof T & number]: IsSpot<T[Key]> }[number] extends true ? true : false : T extends Record<string, unknown> ? { [Key in keyof T]: IsSpot<T[Key]> }[keyof T] extends true ? true : false : false;
|
|
23
|
+
//#endregion
|
|
24
|
+
//#region src/computable/literal.d.ts
|
|
25
|
+
declare const literal: <const T>(value: T) => Spot<T>;
|
|
26
|
+
//#endregion
|
|
27
|
+
//#region src/computable/optional.d.ts
|
|
28
|
+
/**
|
|
29
|
+
* Mark a `Spot` as optional.
|
|
30
|
+
*/
|
|
31
|
+
declare const optional: <T>(spot: Spot<T>) => Spot<T | undefined>;
|
|
32
|
+
//#endregion
|
|
33
|
+
//#region src/computable/reference.d.ts
|
|
34
|
+
type SpotProvider<T> = [T] extends [AnyShape] ? { readonly [Key in keyof T]: SpotProvider<T[Key]> } & Spot<T> : Spot<T>;
|
|
35
|
+
//#endregion
|
|
36
|
+
//#region src/computable/shape.d.ts
|
|
37
|
+
declare function shape<S, T>(spot: Spot<S>, fn: (from: S) => T): Spot<T>;
|
|
38
|
+
declare function shape<T>(ctx: ContextToSpot<T>): Spot<T>;
|
|
39
|
+
declare function shape<S, T>(ctx: ContextToSpot<S>, fn: (from: NoInfer<S>) => T): Spot<T>;
|
|
40
|
+
//#endregion
|
|
41
|
+
//#region src/runnable/definition.d.ts
|
|
42
|
+
declare const Execute$: unique symbol;
|
|
43
|
+
type Runnable = {
|
|
44
|
+
[Execute$]: unknown;
|
|
45
|
+
};
|
|
46
|
+
type RunnableKind<T extends string> = {
|
|
47
|
+
readonly kind: T;
|
|
48
|
+
};
|
|
49
|
+
//#endregion
|
|
50
|
+
//#region src/runnable/task.d.ts
|
|
51
|
+
type WithContext<Context, Return> = Context extends void ? {
|
|
52
|
+
fn: () => Eventual<Return>;
|
|
53
|
+
context?: never;
|
|
54
|
+
} : IsSpot<Context> extends true ? {
|
|
55
|
+
fn: (ctx: NoInfer<SpotToContext<Context>>) => Eventual<Return>;
|
|
56
|
+
context: Context;
|
|
57
|
+
} : {
|
|
58
|
+
fn: (ctx: unknown) => Eventual<Return>;
|
|
59
|
+
context: never;
|
|
60
|
+
};
|
|
61
|
+
type TaskConfig<Result, RunContext, EnabledContext> = {
|
|
62
|
+
name: string;
|
|
63
|
+
run: WithContext<RunContext, Result>;
|
|
64
|
+
enabled?: WithContext<EnabledContext, boolean>;
|
|
65
|
+
};
|
|
66
|
+
type Task<R> = {
|
|
67
|
+
readonly name: string;
|
|
68
|
+
readonly result: SpotProvider<R>;
|
|
69
|
+
readonly status: Spot<TaskStatus>;
|
|
70
|
+
readonly error: Spot<unknown>;
|
|
71
|
+
} & Runnable & RunnableKind<"task">;
|
|
72
|
+
type TaskResult<T> = T extends Task<infer R> ? R : never;
|
|
73
|
+
type TaskStatus = "done" | "fail" | "skip";
|
|
74
|
+
declare const createTask: <Result, RunContext = void, EnabledContext = void>(config: TaskConfig<Result, RunContext, EnabledContext>) => Task<Result>;
|
|
75
|
+
//#endregion
|
|
76
|
+
//#region src/runnable/wire.d.ts
|
|
77
|
+
declare const Tag$: unique symbol;
|
|
78
|
+
type Tag<T> = {
|
|
79
|
+
[Tag$]: symbol;
|
|
80
|
+
readonly name: string;
|
|
81
|
+
readonly value: SpotProvider<T>;
|
|
82
|
+
};
|
|
83
|
+
declare const tag: <T = never>(name: string) => Tag<T>;
|
|
84
|
+
type Wire = {
|
|
85
|
+
readonly name: string;
|
|
86
|
+
} & Runnable & RunnableKind<"wire">;
|
|
87
|
+
type TagShape<T> = T extends Tag<unknown> ? T : T extends readonly unknown[] ? { [K in keyof T & number]: TagShape<T[K]> } : T extends Record<string, unknown> ? { [K in keyof T & string]: TagShape<T[K]> } : Tag<unknown>;
|
|
88
|
+
type TagShapeToValue<S> = [S] extends [Tag<infer V>] ? V : S extends Record<string, unknown> | readonly unknown[] ? { [K in keyof S]: TagShapeToValue<S[K]> } : never;
|
|
89
|
+
type WireConfig<S> = {
|
|
90
|
+
from: NoInfer<ContextToSpot<TagShapeToValue<S>>>;
|
|
91
|
+
to: S & TagShape<S>;
|
|
92
|
+
};
|
|
93
|
+
declare const createWire: <const S>(config: WireConfig<S>) => Wire;
|
|
94
|
+
//#endregion
|
|
95
|
+
//#region src/compose/observer.d.ts
|
|
96
|
+
type ComposeHookMap = {
|
|
97
|
+
onStart: (event: {
|
|
98
|
+
meta?: ComposeMeta;
|
|
99
|
+
}) => void;
|
|
100
|
+
onComplete: (event: {
|
|
101
|
+
meta?: ComposeMeta;
|
|
102
|
+
}) => void;
|
|
103
|
+
onTaskFail: (event: {
|
|
104
|
+
task: Task<unknown>;
|
|
105
|
+
error: unknown;
|
|
106
|
+
}) => void;
|
|
107
|
+
};
|
|
108
|
+
//#endregion
|
|
109
|
+
//#region src/compose/definition.d.ts
|
|
110
|
+
type ComposeMeta = {
|
|
111
|
+
name?: string;
|
|
112
|
+
hooks?: Partial<ComposeHookMap>;
|
|
113
|
+
};
|
|
114
|
+
type ComposeNodeSeq = {
|
|
115
|
+
type: "seq";
|
|
116
|
+
meta?: ComposeMeta;
|
|
117
|
+
children: ComposeNode[];
|
|
118
|
+
};
|
|
119
|
+
type ComposeNodeCon = {
|
|
120
|
+
type: "con";
|
|
121
|
+
meta?: ComposeMeta;
|
|
122
|
+
children: ComposeNode[];
|
|
123
|
+
};
|
|
124
|
+
type ComposeNodeRun = {
|
|
125
|
+
type: "run";
|
|
126
|
+
value: Runnable;
|
|
127
|
+
};
|
|
128
|
+
type ComposeNode = ComposeNodeSeq | ComposeNodeCon | ComposeNodeRun;
|
|
129
|
+
type ComposeInner = ComposeNodeCon | ComposeNodeSeq;
|
|
130
|
+
type ComposableKind = "task" | "wire";
|
|
131
|
+
//#endregion
|
|
132
|
+
//#region src/compose/graph.d.ts
|
|
133
|
+
type EntryID = number;
|
|
134
|
+
type GraphExecutionMeta = {
|
|
135
|
+
name?: string;
|
|
136
|
+
};
|
|
137
|
+
type GraphRunMeta = {
|
|
138
|
+
name: string;
|
|
139
|
+
kind: ComposableKind;
|
|
140
|
+
};
|
|
141
|
+
type GraphRunDeps = {
|
|
142
|
+
required: EntryID[];
|
|
143
|
+
optional: EntryID[];
|
|
144
|
+
};
|
|
145
|
+
type GraphNode = {
|
|
146
|
+
type: "con";
|
|
147
|
+
meta: GraphExecutionMeta;
|
|
148
|
+
children: GraphNode[];
|
|
149
|
+
} | {
|
|
150
|
+
type: "seq";
|
|
151
|
+
meta: GraphExecutionMeta;
|
|
152
|
+
children: GraphNode[];
|
|
153
|
+
} | {
|
|
154
|
+
type: "run";
|
|
155
|
+
meta: GraphRunMeta;
|
|
156
|
+
id: EntryID;
|
|
157
|
+
dependencies: GraphRunDeps;
|
|
158
|
+
};
|
|
159
|
+
//#endregion
|
|
160
|
+
//#region src/compose/runner.d.ts
|
|
161
|
+
type Scope = {
|
|
162
|
+
get: <T>(spot: Spot<T>) => T | undefined;
|
|
163
|
+
};
|
|
164
|
+
//#endregion
|
|
165
|
+
//#region src/compose/compose.d.ts
|
|
166
|
+
declare const Node$: unique symbol;
|
|
167
|
+
type Composable = Composer | Runnable;
|
|
168
|
+
type Composer = {
|
|
169
|
+
/**
|
|
170
|
+
* Execution Graph Node
|
|
171
|
+
* @private
|
|
172
|
+
* @internal
|
|
173
|
+
*/
|
|
174
|
+
[Node$]: ComposeInner;
|
|
175
|
+
run: () => Promise<Scope>;
|
|
176
|
+
guard: () => void;
|
|
177
|
+
graph: () => GraphNode;
|
|
178
|
+
meta: (meta: Partial<ComposeMeta>) => Composer;
|
|
179
|
+
step: (compose: Composable | Composable[]) => Composer;
|
|
180
|
+
};
|
|
181
|
+
declare const compose: () => Composer;
|
|
182
|
+
//#endregion
|
|
183
|
+
//#region src/is.d.ts
|
|
184
|
+
declare const is: {
|
|
185
|
+
tag: (x: unknown) => x is Tag<unknown>;
|
|
186
|
+
runnable: (x: unknown) => x is Runnable & RunnableKind<string>;
|
|
187
|
+
task: (x: unknown) => x is Task<unknown>;
|
|
188
|
+
wire: (x: unknown) => x is Wire;
|
|
189
|
+
};
|
|
190
|
+
//#endregion
|
|
191
|
+
export { type ComposeHookMap, type Composer, type Spot, type SpotValue, type Tag, type Task, type TaskResult, type TaskStatus, type Wire, compose, createTask, createWire, is, literal, optional, shape, tag };
|
|
192
|
+
//# sourceMappingURL=index.d.cts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.cts","names":[],"sources":["../src/computable/definition.ts","../src/shared.ts","../src/computable/context.ts","../src/computable/literal.ts","../src/computable/optional.ts","../src/computable/reference.ts","../src/computable/shape.ts","../src/runnable/definition.ts","../src/runnable/task.ts","../src/runnable/wire.ts","../src/compose/observer.ts","../src/compose/definition.ts","../src/compose/graph.ts","../src/compose/runner.ts","../src/compose/compose.ts","../src/is.ts"],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
//#region src/computable/definition.d.ts
|
|
2
|
+
declare const Spot$: unique symbol;
|
|
3
|
+
declare const Phantom$: unique symbol;
|
|
4
|
+
type Spot<T> = {
|
|
5
|
+
[Spot$]: true;
|
|
6
|
+
[Phantom$]?: T;
|
|
7
|
+
};
|
|
8
|
+
type SpotValue<T extends Spot<any>> = T extends Spot<infer V> ? V : never;
|
|
9
|
+
//#endregion
|
|
10
|
+
//#region src/shared.d.ts
|
|
11
|
+
type AnyShape = Record<string, unknown>;
|
|
12
|
+
type Eventual<T> = Promise<T> | T;
|
|
13
|
+
type BuiltInObject = null | undefined | boolean | string | number | Error | Date | RegExp | Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | ReadonlyMap<unknown, unknown> | ReadonlySet<unknown> | WeakMap<object, unknown> | WeakSet<object> | ArrayBuffer | DataView | Function | Promise<unknown> | Generator | {
|
|
14
|
+
readonly [Symbol.toStringTag]: string;
|
|
15
|
+
};
|
|
16
|
+
//#endregion
|
|
17
|
+
//#region src/computable/context.d.ts
|
|
18
|
+
type ContextToSpot<T> = [T] extends [BuiltInObject] ? Spot<T> : Spot<T> | ContextShapeToSpot<T>;
|
|
19
|
+
type ContextShapeToSpot<T> = { readonly [K in keyof T]: ContextToSpot<T[K]> };
|
|
20
|
+
type KeyValue = Record<string, unknown> | readonly unknown[];
|
|
21
|
+
type SpotToContext<T> = T extends Spot<infer Value> ? Value : T extends KeyValue ? { [Key in keyof T]: SpotToContext<T[Key]> } : never;
|
|
22
|
+
type IsSpot<T> = T extends Spot<unknown> ? true : T extends readonly unknown[] ? { [Key in keyof T & number]: IsSpot<T[Key]> }[number] extends true ? true : false : T extends Record<string, unknown> ? { [Key in keyof T]: IsSpot<T[Key]> }[keyof T] extends true ? true : false : false;
|
|
23
|
+
//#endregion
|
|
24
|
+
//#region src/computable/literal.d.ts
|
|
25
|
+
declare const literal: <const T>(value: T) => Spot<T>;
|
|
26
|
+
//#endregion
|
|
27
|
+
//#region src/computable/optional.d.ts
|
|
28
|
+
/**
|
|
29
|
+
* Mark a `Spot` as optional.
|
|
30
|
+
*/
|
|
31
|
+
declare const optional: <T>(spot: Spot<T>) => Spot<T | undefined>;
|
|
32
|
+
//#endregion
|
|
33
|
+
//#region src/computable/reference.d.ts
|
|
34
|
+
type SpotProvider<T> = [T] extends [AnyShape] ? { readonly [Key in keyof T]: SpotProvider<T[Key]> } & Spot<T> : Spot<T>;
|
|
35
|
+
//#endregion
|
|
36
|
+
//#region src/computable/shape.d.ts
|
|
37
|
+
declare function shape<S, T>(spot: Spot<S>, fn: (from: S) => T): Spot<T>;
|
|
38
|
+
declare function shape<T>(ctx: ContextToSpot<T>): Spot<T>;
|
|
39
|
+
declare function shape<S, T>(ctx: ContextToSpot<S>, fn: (from: NoInfer<S>) => T): Spot<T>;
|
|
40
|
+
//#endregion
|
|
41
|
+
//#region src/runnable/definition.d.ts
|
|
42
|
+
declare const Execute$: unique symbol;
|
|
43
|
+
type Runnable = {
|
|
44
|
+
[Execute$]: unknown;
|
|
45
|
+
};
|
|
46
|
+
type RunnableKind<T extends string> = {
|
|
47
|
+
readonly kind: T;
|
|
48
|
+
};
|
|
49
|
+
//#endregion
|
|
50
|
+
//#region src/runnable/task.d.ts
|
|
51
|
+
type WithContext<Context, Return> = Context extends void ? {
|
|
52
|
+
fn: () => Eventual<Return>;
|
|
53
|
+
context?: never;
|
|
54
|
+
} : IsSpot<Context> extends true ? {
|
|
55
|
+
fn: (ctx: NoInfer<SpotToContext<Context>>) => Eventual<Return>;
|
|
56
|
+
context: Context;
|
|
57
|
+
} : {
|
|
58
|
+
fn: (ctx: unknown) => Eventual<Return>;
|
|
59
|
+
context: never;
|
|
60
|
+
};
|
|
61
|
+
type TaskConfig<Result, RunContext, EnabledContext> = {
|
|
62
|
+
name: string;
|
|
63
|
+
run: WithContext<RunContext, Result>;
|
|
64
|
+
enabled?: WithContext<EnabledContext, boolean>;
|
|
65
|
+
};
|
|
66
|
+
type Task<R> = {
|
|
67
|
+
readonly name: string;
|
|
68
|
+
readonly result: SpotProvider<R>;
|
|
69
|
+
readonly status: Spot<TaskStatus>;
|
|
70
|
+
readonly error: Spot<unknown>;
|
|
71
|
+
} & Runnable & RunnableKind<"task">;
|
|
72
|
+
type TaskResult<T> = T extends Task<infer R> ? R : never;
|
|
73
|
+
type TaskStatus = "done" | "fail" | "skip";
|
|
74
|
+
declare const createTask: <Result, RunContext = void, EnabledContext = void>(config: TaskConfig<Result, RunContext, EnabledContext>) => Task<Result>;
|
|
75
|
+
//#endregion
|
|
76
|
+
//#region src/runnable/wire.d.ts
|
|
77
|
+
declare const Tag$: unique symbol;
|
|
78
|
+
type Tag<T> = {
|
|
79
|
+
[Tag$]: symbol;
|
|
80
|
+
readonly name: string;
|
|
81
|
+
readonly value: SpotProvider<T>;
|
|
82
|
+
};
|
|
83
|
+
declare const tag: <T = never>(name: string) => Tag<T>;
|
|
84
|
+
type Wire = {
|
|
85
|
+
readonly name: string;
|
|
86
|
+
} & Runnable & RunnableKind<"wire">;
|
|
87
|
+
type TagShape<T> = T extends Tag<unknown> ? T : T extends readonly unknown[] ? { [K in keyof T & number]: TagShape<T[K]> } : T extends Record<string, unknown> ? { [K in keyof T & string]: TagShape<T[K]> } : Tag<unknown>;
|
|
88
|
+
type TagShapeToValue<S> = [S] extends [Tag<infer V>] ? V : S extends Record<string, unknown> | readonly unknown[] ? { [K in keyof S]: TagShapeToValue<S[K]> } : never;
|
|
89
|
+
type WireConfig<S> = {
|
|
90
|
+
from: NoInfer<ContextToSpot<TagShapeToValue<S>>>;
|
|
91
|
+
to: S & TagShape<S>;
|
|
92
|
+
};
|
|
93
|
+
declare const createWire: <const S>(config: WireConfig<S>) => Wire;
|
|
94
|
+
//#endregion
|
|
95
|
+
//#region src/compose/observer.d.ts
|
|
96
|
+
type ComposeHookMap = {
|
|
97
|
+
onStart: (event: {
|
|
98
|
+
meta?: ComposeMeta;
|
|
99
|
+
}) => void;
|
|
100
|
+
onComplete: (event: {
|
|
101
|
+
meta?: ComposeMeta;
|
|
102
|
+
}) => void;
|
|
103
|
+
onTaskFail: (event: {
|
|
104
|
+
task: Task<unknown>;
|
|
105
|
+
error: unknown;
|
|
106
|
+
}) => void;
|
|
107
|
+
};
|
|
108
|
+
//#endregion
|
|
109
|
+
//#region src/compose/definition.d.ts
|
|
110
|
+
type ComposeMeta = {
|
|
111
|
+
name?: string;
|
|
112
|
+
hooks?: Partial<ComposeHookMap>;
|
|
113
|
+
};
|
|
114
|
+
type ComposeNodeSeq = {
|
|
115
|
+
type: "seq";
|
|
116
|
+
meta?: ComposeMeta;
|
|
117
|
+
children: ComposeNode[];
|
|
118
|
+
};
|
|
119
|
+
type ComposeNodeCon = {
|
|
120
|
+
type: "con";
|
|
121
|
+
meta?: ComposeMeta;
|
|
122
|
+
children: ComposeNode[];
|
|
123
|
+
};
|
|
124
|
+
type ComposeNodeRun = {
|
|
125
|
+
type: "run";
|
|
126
|
+
value: Runnable;
|
|
127
|
+
};
|
|
128
|
+
type ComposeNode = ComposeNodeSeq | ComposeNodeCon | ComposeNodeRun;
|
|
129
|
+
type ComposeInner = ComposeNodeCon | ComposeNodeSeq;
|
|
130
|
+
type ComposableKind = "task" | "wire";
|
|
131
|
+
//#endregion
|
|
132
|
+
//#region src/compose/graph.d.ts
|
|
133
|
+
type EntryID = number;
|
|
134
|
+
type GraphExecutionMeta = {
|
|
135
|
+
name?: string;
|
|
136
|
+
};
|
|
137
|
+
type GraphRunMeta = {
|
|
138
|
+
name: string;
|
|
139
|
+
kind: ComposableKind;
|
|
140
|
+
};
|
|
141
|
+
type GraphRunDeps = {
|
|
142
|
+
required: EntryID[];
|
|
143
|
+
optional: EntryID[];
|
|
144
|
+
};
|
|
145
|
+
type GraphNode = {
|
|
146
|
+
type: "con";
|
|
147
|
+
meta: GraphExecutionMeta;
|
|
148
|
+
children: GraphNode[];
|
|
149
|
+
} | {
|
|
150
|
+
type: "seq";
|
|
151
|
+
meta: GraphExecutionMeta;
|
|
152
|
+
children: GraphNode[];
|
|
153
|
+
} | {
|
|
154
|
+
type: "run";
|
|
155
|
+
meta: GraphRunMeta;
|
|
156
|
+
id: EntryID;
|
|
157
|
+
dependencies: GraphRunDeps;
|
|
158
|
+
};
|
|
159
|
+
//#endregion
|
|
160
|
+
//#region src/compose/runner.d.ts
|
|
161
|
+
type Scope = {
|
|
162
|
+
get: <T>(spot: Spot<T>) => T | undefined;
|
|
163
|
+
};
|
|
164
|
+
//#endregion
|
|
165
|
+
//#region src/compose/compose.d.ts
|
|
166
|
+
declare const Node$: unique symbol;
|
|
167
|
+
type Composable = Composer | Runnable;
|
|
168
|
+
type Composer = {
|
|
169
|
+
/**
|
|
170
|
+
* Execution Graph Node
|
|
171
|
+
* @private
|
|
172
|
+
* @internal
|
|
173
|
+
*/
|
|
174
|
+
[Node$]: ComposeInner;
|
|
175
|
+
run: () => Promise<Scope>;
|
|
176
|
+
guard: () => void;
|
|
177
|
+
graph: () => GraphNode;
|
|
178
|
+
meta: (meta: Partial<ComposeMeta>) => Composer;
|
|
179
|
+
step: (compose: Composable | Composable[]) => Composer;
|
|
180
|
+
};
|
|
181
|
+
declare const compose: () => Composer;
|
|
182
|
+
//#endregion
|
|
183
|
+
//#region src/is.d.ts
|
|
184
|
+
declare const is: {
|
|
185
|
+
tag: (x: unknown) => x is Tag<unknown>;
|
|
186
|
+
runnable: (x: unknown) => x is Runnable & RunnableKind<string>;
|
|
187
|
+
task: (x: unknown) => x is Task<unknown>;
|
|
188
|
+
wire: (x: unknown) => x is Wire;
|
|
189
|
+
};
|
|
190
|
+
//#endregion
|
|
191
|
+
export { type ComposeHookMap, type Composer, type Spot, type SpotValue, type Tag, type Task, type TaskResult, type TaskStatus, type Wire, compose, createTask, createWire, is, literal, optional, shape, tag };
|
|
192
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/computable/definition.ts","../src/shared.ts","../src/computable/context.ts","../src/computable/literal.ts","../src/computable/optional.ts","../src/computable/reference.ts","../src/computable/shape.ts","../src/runnable/definition.ts","../src/runnable/task.ts","../src/runnable/wire.ts","../src/compose/observer.ts","../src/compose/definition.ts","../src/compose/graph.ts","../src/compose/runner.ts","../src/compose/compose.ts","../src/is.ts"],"mappings":"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"}
|