@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.
@@ -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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"}
@@ -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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"}