@context-action/core 1.1.1 → 1.2.0
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/CHANGELOG.md +24 -0
- package/README.md +5 -1
- package/dist/index.cjs +89 -21
- package/dist/index.d.cts +38 -16
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.ts +38 -16
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +89 -20
- package/dist/index.js.map +1 -1
- package/package.json +5 -5
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,30 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
## [1.2.0] (2026-10-01)
|
|
7
|
+
|
|
8
|
+
### Features
|
|
9
|
+
|
|
10
|
+
- Add dispatch lifecycle traces and explicit transaction metadata for framework-neutral state bridges.
|
|
11
|
+
|
|
12
|
+
### Reliability fixes
|
|
13
|
+
|
|
14
|
+
- Keep action trace settlement aligned with observer outcomes and lifecycle shutdown.
|
|
15
|
+
|
|
16
|
+
## [1.1.3] (2026-08-31)
|
|
17
|
+
|
|
18
|
+
### Reliability fixes
|
|
19
|
+
|
|
20
|
+
- Make the package-root ActionRegister type-export correction available on the
|
|
21
|
+
stable channel after safely recovering the unarmed 1.1.1 maintenance journal.
|
|
22
|
+
|
|
23
|
+
## [1.1.2] (2026-08-31)
|
|
24
|
+
|
|
25
|
+
### Reliability fixes
|
|
26
|
+
|
|
27
|
+
- Make the package-root ActionRegister type-export correction available on the
|
|
28
|
+
stable channel after the 1.1.1 maintenance candidate remained unpromoted.
|
|
29
|
+
|
|
6
30
|
## [1.1.1] (2026-08-31)
|
|
7
31
|
|
|
8
32
|
### Reliability fixes
|
package/README.md
CHANGED
|
@@ -66,6 +66,10 @@ Install the protocol package separately when an integration needs it:
|
|
|
66
66
|
npm install @context-action/tool-protocol zod
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
+
The action execution and state-management boundaries are documented in
|
|
70
|
+
[Action contracts](docs/action-contracts.md). Core owns dispatch control flow;
|
|
71
|
+
Store snapshots and time-travel history belong to the React store layer.
|
|
72
|
+
|
|
69
73
|
The React-facing registry remains in `@context-action/react`; protocol symbols
|
|
70
74
|
such as `defineAction`, `listAllTools`, and `ToolManagementInterface` must be
|
|
71
75
|
imported from `@context-action/tool-protocol`.
|
|
@@ -173,7 +177,7 @@ const actions = new ActionRegister<MyActions>({
|
|
|
173
177
|
// should be treated as a programming error.
|
|
174
178
|
```
|
|
175
179
|
|
|
176
|
-
## v1.
|
|
180
|
+
## v1.2 Pipeline Contract
|
|
177
181
|
|
|
178
182
|
### Phase-specific registration
|
|
179
183
|
|
package/dist/index.cjs
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
-
|
|
3
2
|
//#region src/action-guard.ts
|
|
4
3
|
/**
|
|
5
4
|
* Action Guard system for managing action execution timing
|
|
@@ -1140,6 +1139,8 @@ var ActionRegister = class {
|
|
|
1140
1139
|
this.activeDispatches = /* @__PURE__ */ new Set();
|
|
1141
1140
|
this.activeHandlerPromises = /* @__PURE__ */ new Set();
|
|
1142
1141
|
this.dispatchConstructionDepth = 0;
|
|
1142
|
+
this.dispatchTraceSequence = 0;
|
|
1143
|
+
this.dispatchTraceListeners = /* @__PURE__ */ new Set();
|
|
1143
1144
|
this.actionDispatchers = /* @__PURE__ */ new Map();
|
|
1144
1145
|
this.actionResultDispatchers = /* @__PURE__ */ new Map();
|
|
1145
1146
|
this.name = config.name || "ActionRegister";
|
|
@@ -1303,6 +1304,61 @@ var ActionRegister = class {
|
|
|
1303
1304
|
console[level](`🎯 [${timestamp}] [${this.name}] ${message}`, data || "");
|
|
1304
1305
|
}
|
|
1305
1306
|
}
|
|
1307
|
+
beginDispatchTrace(action, options) {
|
|
1308
|
+
const dispatchId = `${this.name}:${++this.dispatchTraceSequence}`;
|
|
1309
|
+
const startedAt = Date.now();
|
|
1310
|
+
const metadata = options?.trace;
|
|
1311
|
+
let settled = false;
|
|
1312
|
+
const emit = (event) => {
|
|
1313
|
+
for (const listener of this.dispatchTraceListeners) try {
|
|
1314
|
+
listener(event);
|
|
1315
|
+
} catch (error) {
|
|
1316
|
+
this.log("Dispatch trace listener failed", error, "warn");
|
|
1317
|
+
}
|
|
1318
|
+
};
|
|
1319
|
+
emit({
|
|
1320
|
+
dispatchId,
|
|
1321
|
+
action,
|
|
1322
|
+
phase: "started",
|
|
1323
|
+
transactionId: metadata?.transactionId,
|
|
1324
|
+
origin: metadata?.origin,
|
|
1325
|
+
label: metadata?.label,
|
|
1326
|
+
startedAt
|
|
1327
|
+
});
|
|
1328
|
+
return {
|
|
1329
|
+
dispatchId,
|
|
1330
|
+
startedAt,
|
|
1331
|
+
settle: (status) => {
|
|
1332
|
+
if (settled) return;
|
|
1333
|
+
settled = true;
|
|
1334
|
+
emit({
|
|
1335
|
+
dispatchId,
|
|
1336
|
+
action,
|
|
1337
|
+
phase: "settled",
|
|
1338
|
+
status,
|
|
1339
|
+
transactionId: metadata?.transactionId,
|
|
1340
|
+
origin: metadata?.origin,
|
|
1341
|
+
label: metadata?.label,
|
|
1342
|
+
startedAt,
|
|
1343
|
+
endedAt: Date.now()
|
|
1344
|
+
});
|
|
1345
|
+
}
|
|
1346
|
+
};
|
|
1347
|
+
}
|
|
1348
|
+
withDispatchTrace(promise, trace, status) {
|
|
1349
|
+
return promise.then((result) => {
|
|
1350
|
+
trace.settle(status(result));
|
|
1351
|
+
return result;
|
|
1352
|
+
}, (error) => {
|
|
1353
|
+
trace.settle("failed");
|
|
1354
|
+
throw error;
|
|
1355
|
+
});
|
|
1356
|
+
}
|
|
1357
|
+
/** Subscribe to start/settled dispatch lifecycle events. */
|
|
1358
|
+
subscribeDispatchTrace(listener) {
|
|
1359
|
+
this.dispatchTraceListeners.add(listener);
|
|
1360
|
+
return () => this.dispatchTraceListeners.delete(listener);
|
|
1361
|
+
}
|
|
1306
1362
|
assertAcceptingWork() {
|
|
1307
1363
|
if (this.lifecycleState !== "active") throw new ActionRegisterDestroyedError(this.name, this.lifecycleState);
|
|
1308
1364
|
}
|
|
@@ -1442,7 +1498,8 @@ var ActionRegister = class {
|
|
|
1442
1498
|
dispatch(action, ...args) {
|
|
1443
1499
|
this.assertStringActionKey(action);
|
|
1444
1500
|
const [payload, options] = args;
|
|
1445
|
-
|
|
1501
|
+
const trace = this.beginDispatchTrace(String(action), options);
|
|
1502
|
+
if (this.lifecycleState !== "active") return this.withDispatchTrace(this.rejectedLifecyclePromise(), trace, () => "failed");
|
|
1446
1503
|
const timeoutScope = this.createTimeoutScope(action, options);
|
|
1447
1504
|
const dispatchHandlerPromises = /* @__PURE__ */ new Set();
|
|
1448
1505
|
const attemptState = { count: 0 };
|
|
@@ -1450,6 +1507,7 @@ var ActionRegister = class {
|
|
|
1450
1507
|
const hasTimingGuard = plan.debounceMs !== void 0 || plan.throttleMs !== void 0;
|
|
1451
1508
|
const notifiedObservers = /* @__PURE__ */ new Set();
|
|
1452
1509
|
const notifiedObserverOutcomes = /* @__PURE__ */ new Set();
|
|
1510
|
+
let dispatchTraceStatus = "completed";
|
|
1453
1511
|
let terminalErrorReported = false;
|
|
1454
1512
|
const reportTerminalError = (error) => {
|
|
1455
1513
|
if (terminalErrorReported) return;
|
|
@@ -1459,6 +1517,10 @@ var ActionRegister = class {
|
|
|
1459
1517
|
const notifyObservers = async (event) => {
|
|
1460
1518
|
if (notifiedObserverOutcomes.has(event.outcome)) return;
|
|
1461
1519
|
notifiedObserverOutcomes.add(event.outcome);
|
|
1520
|
+
if (event.outcome === "failed") dispatchTraceStatus = "failed";
|
|
1521
|
+
else if (event.outcome === "cancelled") dispatchTraceStatus = "cancelled";
|
|
1522
|
+
else if (event.outcome === "debounced") dispatchTraceStatus = "debounced";
|
|
1523
|
+
else if (event.outcome === "throttled") dispatchTraceStatus = "throttled";
|
|
1462
1524
|
await this.executeObservers(action, plan, event, notifiedObservers);
|
|
1463
1525
|
};
|
|
1464
1526
|
const pipelineOperation = async () => {
|
|
@@ -1622,8 +1684,9 @@ var ActionRegister = class {
|
|
|
1622
1684
|
});
|
|
1623
1685
|
throw error;
|
|
1624
1686
|
});
|
|
1625
|
-
|
|
1626
|
-
|
|
1687
|
+
const tracedPromise = this.withDispatchTrace(observedPromise, trace, () => dispatchTraceStatus);
|
|
1688
|
+
tracedPromise.catch(() => {});
|
|
1689
|
+
return tracedPromise;
|
|
1627
1690
|
}
|
|
1628
1691
|
/** Execute a dispatch operation with an optional whole-action retry policy. */
|
|
1629
1692
|
async executeWithRetry(operation, options, attemptState, shouldRetryResult, canRetry = () => true, telemetry, beforeRetry) {
|
|
@@ -1771,22 +1834,24 @@ var ActionRegister = class {
|
|
|
1771
1834
|
timeoutController?.signal
|
|
1772
1835
|
].filter((candidate) => Boolean(candidate));
|
|
1773
1836
|
let signal = signals[0];
|
|
1774
|
-
if (signals.length > 1)
|
|
1775
|
-
|
|
1776
|
-
|
|
1777
|
-
|
|
1778
|
-
|
|
1779
|
-
|
|
1780
|
-
|
|
1781
|
-
|
|
1782
|
-
|
|
1783
|
-
|
|
1837
|
+
if (signals.length > 1) {
|
|
1838
|
+
if (typeof AbortSignal.any === "function") signal = AbortSignal.any(signals);
|
|
1839
|
+
else {
|
|
1840
|
+
const mergedController = new AbortController();
|
|
1841
|
+
const forwardAbort = (source) => {
|
|
1842
|
+
if (!mergedController.signal.aborted) mergedController.abort(source.reason);
|
|
1843
|
+
};
|
|
1844
|
+
for (const source of signals) {
|
|
1845
|
+
if (source.aborted) {
|
|
1846
|
+
forwardAbort(source);
|
|
1847
|
+
break;
|
|
1848
|
+
}
|
|
1849
|
+
const listener = () => forwardAbort(source);
|
|
1850
|
+
source.addEventListener("abort", listener, { once: true });
|
|
1851
|
+
signalCleanups.push(() => source.removeEventListener("abort", listener));
|
|
1784
1852
|
}
|
|
1785
|
-
|
|
1786
|
-
source.addEventListener("abort", listener, { once: true });
|
|
1787
|
-
signalCleanups.push(() => source.removeEventListener("abort", listener));
|
|
1853
|
+
signal = mergedController.signal;
|
|
1788
1854
|
}
|
|
1789
|
-
signal = mergedController.signal;
|
|
1790
1855
|
}
|
|
1791
1856
|
let timer;
|
|
1792
1857
|
const timeoutPromise = timeoutController && timeout !== void 0 ? new Promise((_, reject) => {
|
|
@@ -2205,7 +2270,8 @@ var ActionRegister = class {
|
|
|
2205
2270
|
dispatchWithResult(action, ...args) {
|
|
2206
2271
|
this.assertStringActionKey(action);
|
|
2207
2272
|
const [payload, options] = args;
|
|
2208
|
-
|
|
2273
|
+
const trace = this.beginDispatchTrace(String(action), options);
|
|
2274
|
+
if (this.lifecycleState !== "active") return this.withDispatchTrace(this.rejectedLifecyclePromise(), trace, () => "failed");
|
|
2209
2275
|
const timeoutScope = this.createTimeoutScope(action, options);
|
|
2210
2276
|
const dispatchStartTime = Date.now();
|
|
2211
2277
|
const dispatchHandlerPromises = /* @__PURE__ */ new Set();
|
|
@@ -2401,8 +2467,9 @@ var ActionRegister = class {
|
|
|
2401
2467
|
});
|
|
2402
2468
|
throw error;
|
|
2403
2469
|
});
|
|
2404
|
-
|
|
2405
|
-
|
|
2470
|
+
const tracedPromise = this.withDispatchTrace(observedPromise, trace, (result) => result.success ? "completed" : result.outcome === "cancelled" ? "cancelled" : "failed");
|
|
2471
|
+
tracedPromise.catch(() => {});
|
|
2472
|
+
return tracedPromise;
|
|
2406
2473
|
}
|
|
2407
2474
|
async _performDispatchWithResult(action, payload, options, validation, plan, executedHandlers, dispatchHandlerPromises) {
|
|
2408
2475
|
const _startTime = Date.now();
|
|
@@ -3050,6 +3117,7 @@ var ActionRegister = class {
|
|
|
3050
3117
|
finalizeDestroy() {
|
|
3051
3118
|
if (this.lifecycleState === "destroyed") return;
|
|
3052
3119
|
this.clearAll();
|
|
3120
|
+
this.dispatchTraceListeners.clear();
|
|
3053
3121
|
this.actionExecutionModes.clear();
|
|
3054
3122
|
this.lifecycleState = "destroyed";
|
|
3055
3123
|
this.log("ActionRegister destroyed");
|
package/dist/index.d.cts
CHANGED
|
@@ -96,7 +96,7 @@ interface ResolvedHandlerConfig<T = unknown> {
|
|
|
96
96
|
condition?: (payload: T) => boolean;
|
|
97
97
|
metadata?: Record<string, unknown>;
|
|
98
98
|
}
|
|
99
|
-
declare function resolveHandlerConfig<T = unknown>(config: HandlerConfig<T> | undefined, handlerId: string): ResolvedHandlerConfig<T>;
|
|
99
|
+
export declare function resolveHandlerConfig<T = unknown>(config: HandlerConfig<T> | undefined, handlerId: string): ResolvedHandlerConfig<T>;
|
|
100
100
|
interface HandlerRegistration<T = unknown, R = void> {
|
|
101
101
|
handler: ActionHandler<T, R>;
|
|
102
102
|
config: ResolvedHandlerConfig<T>;
|
|
@@ -165,6 +165,11 @@ interface ActionRegisterConfig {
|
|
|
165
165
|
};
|
|
166
166
|
}
|
|
167
167
|
interface DispatchOptions {
|
|
168
|
+
trace?: {
|
|
169
|
+
transactionId?: string;
|
|
170
|
+
origin?: 'user' | 'system' | 'network' | 'undo' | 'redo' | 'reset';
|
|
171
|
+
label?: string;
|
|
172
|
+
};
|
|
168
173
|
debounce?: number;
|
|
169
174
|
throttle?: number;
|
|
170
175
|
executionMode?: ExecutionMode;
|
|
@@ -199,6 +204,18 @@ interface DispatchOptions {
|
|
|
199
204
|
includeErrors?: boolean;
|
|
200
205
|
};
|
|
201
206
|
}
|
|
207
|
+
interface ActionDispatchTrace {
|
|
208
|
+
readonly dispatchId: string;
|
|
209
|
+
readonly action: string;
|
|
210
|
+
readonly phase: 'started' | 'settled';
|
|
211
|
+
readonly status?: 'completed' | 'failed' | 'cancelled' | 'debounced' | 'throttled';
|
|
212
|
+
readonly transactionId?: string;
|
|
213
|
+
readonly origin?: 'user' | 'system' | 'network' | 'undo' | 'redo' | 'reset';
|
|
214
|
+
readonly label?: string;
|
|
215
|
+
readonly startedAt: number;
|
|
216
|
+
readonly endedAt?: number;
|
|
217
|
+
}
|
|
218
|
+
type ActionDispatchTraceListener = (event: ActionDispatchTrace) => void;
|
|
202
219
|
interface ExecutionResult<R = void> {
|
|
203
220
|
success: boolean;
|
|
204
221
|
aborted: boolean;
|
|
@@ -289,7 +306,7 @@ interface ActionHandlerStats<T extends ActionPayloadMap> {
|
|
|
289
306
|
}
|
|
290
307
|
//#endregion
|
|
291
308
|
//#region src/ActionRegister.d.ts
|
|
292
|
-
declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown>, TResultMap extends ActionResultMap<T> = {}> {
|
|
309
|
+
export declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown>, TResultMap extends ActionResultMap<T> = {}> {
|
|
293
310
|
private pipelines;
|
|
294
311
|
private readonly observerHandlers;
|
|
295
312
|
private readonly claimedOnceHandlers;
|
|
@@ -311,6 +328,8 @@ declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown
|
|
|
311
328
|
private readonly activeHandlerPromises;
|
|
312
329
|
private destroyAsyncPromise;
|
|
313
330
|
private dispatchConstructionDepth;
|
|
331
|
+
private dispatchTraceSequence;
|
|
332
|
+
private readonly dispatchTraceListeners;
|
|
314
333
|
private _actionsProxy?;
|
|
315
334
|
private _actionsWithResultProxy?;
|
|
316
335
|
private readonly actionDispatchers;
|
|
@@ -331,6 +350,9 @@ declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown
|
|
|
331
350
|
registerResult<K extends ActionNames<T> & keyof TResultMap>(action: K, handler: ActionResultHandler<T[K], ActionResult<TResultMap, K>>, config?: HandlerConfig<T[K]>): UnregisterFunction;
|
|
332
351
|
private registerWithRole;
|
|
333
352
|
private log;
|
|
353
|
+
private beginDispatchTrace;
|
|
354
|
+
private withDispatchTrace;
|
|
355
|
+
subscribeDispatchTrace(listener: ActionDispatchTraceListener): UnregisterFunction;
|
|
334
356
|
private assertAcceptingWork;
|
|
335
357
|
private assertStringActionKey;
|
|
336
358
|
private rejectedLifecyclePromise;
|
|
@@ -414,7 +436,7 @@ interface GuardState {
|
|
|
414
436
|
debounceAbortCleanup: (() => void) | undefined;
|
|
415
437
|
debounceRequestId: number;
|
|
416
438
|
}
|
|
417
|
-
declare class ActionGuard {
|
|
439
|
+
export declare class ActionGuard {
|
|
418
440
|
private guards;
|
|
419
441
|
private cleanupInterval;
|
|
420
442
|
private readonly autoCleanupEnabled;
|
|
@@ -444,17 +466,17 @@ interface ZodIssueLike {
|
|
|
444
466
|
path: readonly (string | number | symbol)[];
|
|
445
467
|
code: string;
|
|
446
468
|
}
|
|
447
|
-
declare class ActionResultProcessingError extends Error {
|
|
469
|
+
export declare class ActionResultProcessingError extends Error {
|
|
448
470
|
name: string;
|
|
449
471
|
constructor(message: string);
|
|
450
472
|
}
|
|
451
|
-
declare class ActionAttemptSupersededError extends Error {
|
|
473
|
+
export declare class ActionAttemptSupersededError extends Error {
|
|
452
474
|
readonly attempt: number;
|
|
453
475
|
name: string;
|
|
454
476
|
constructor(attempt: number);
|
|
455
477
|
}
|
|
456
|
-
declare function isActionResultProcessingError(error: unknown): error is ActionResultProcessingError;
|
|
457
|
-
declare class ActionValidationError extends Error {
|
|
478
|
+
export declare function isActionResultProcessingError(error: unknown): error is ActionResultProcessingError;
|
|
479
|
+
export declare class ActionValidationError extends Error {
|
|
458
480
|
name: string;
|
|
459
481
|
readonly zodError: unknown;
|
|
460
482
|
constructor(action: string, zodError: unknown);
|
|
@@ -471,26 +493,26 @@ declare class ActionValidationError extends Error {
|
|
|
471
493
|
issues: readonly ZodIssueLike[];
|
|
472
494
|
};
|
|
473
495
|
}
|
|
474
|
-
declare class ActionTimeoutError extends Error {
|
|
496
|
+
export declare class ActionTimeoutError extends Error {
|
|
475
497
|
readonly action: string;
|
|
476
498
|
readonly timeout: number;
|
|
477
499
|
name: string;
|
|
478
500
|
constructor(action: string, timeout: number);
|
|
479
501
|
}
|
|
480
|
-
declare class ActionRegisterDestroyedError extends Error {
|
|
502
|
+
export declare class ActionRegisterDestroyedError extends Error {
|
|
481
503
|
readonly registerName: string;
|
|
482
504
|
readonly state: 'closing' | 'destroyed';
|
|
483
505
|
name: string;
|
|
484
506
|
constructor(registerName: string, state: 'closing' | 'destroyed');
|
|
485
507
|
}
|
|
486
|
-
declare function isActionValidationError(error: unknown): error is ActionValidationError;
|
|
487
|
-
declare function isActionTimeoutError(error: unknown): error is ActionTimeoutError;
|
|
488
|
-
declare function isActionRegisterDestroyedError(error: unknown): error is ActionRegisterDestroyedError;
|
|
508
|
+
export declare function isActionValidationError(error: unknown): error is ActionValidationError;
|
|
509
|
+
export declare function isActionTimeoutError(error: unknown): error is ActionTimeoutError;
|
|
510
|
+
export declare function isActionRegisterDestroyedError(error: unknown): error is ActionRegisterDestroyedError;
|
|
489
511
|
//#endregion
|
|
490
512
|
//#region src/execution-modes.d.ts
|
|
491
|
-
declare function executeSequential<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number) => PipelineController<T, R>): Promise<void>;
|
|
492
|
-
declare function executeParallel<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
|
|
493
|
-
declare function executeRace<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
|
|
513
|
+
export declare function executeSequential<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number) => PipelineController<T, R>): Promise<void>;
|
|
514
|
+
export declare function executeParallel<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
|
|
515
|
+
export declare function executeRace<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
|
|
494
516
|
//#endregion
|
|
495
|
-
export {
|
|
517
|
+
export type { ActionDispatchTrace, ActionDispatchTraceListener, ActionDispatcher, ActionDispatcherWithResult, ActionEffectController, ActionEffectHandler, ActionGuardController, ActionGuardHandler, ActionHandler, ActionHandlerStats, ActionNames, ActionObserverEvent, ActionObserverHandler, ActionPayload, ActionPayloadMap, ActionRegisterConfig, ActionRegistryInfo, ActionResult, ActionResultController, ActionResultHandler, ActionResultMap, ActionSchemaLike, DispatchArgs, DispatchOptions, EffectConfig, ExecutionMode, ExecutionResult, GuardConfig, HandlerConfig, HandlerError, HandlerErrorPolicy, HandlerExecutionOutcome, HandlerExecutionStatus, HandlerRegistration, HandlerRole, HandlerScheduling, ObserverConfig, PipelineContext, PipelineController, ProxyActionKey, ReservedActionKey, ResolvedHandlerConfig, UnregisterFunction };
|
|
496
518
|
//# sourceMappingURL=index.d.cts.map
|
package/dist/index.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/ActionRegister.ts","../src/action-guard.ts","../src/errors.ts","../src/execution-modes.ts"],"mappings":";KAmBY;UASK;EACf,UAAU;IACJ;IAAe;;IAEf;IACA;MACE;MACA;QAAmB;;;;;KAsKjB,YAAY,UAAU,oBAAoB,cAAc;KAaxD,cAAc,UAAU,kBAAkB,gBAAgB,KAAK,EAAE;KASjE,gBAAgB,UAAU,oBAAoB,QACxD,OAAO,YAAY;KAIT,aACV,mBAAmB,kBACnB,UAAU,eACR,gBAAgB,aAAa,WAAW;UAgE3B,mBAAmB,aAAa;WAQtC,SAAS;EAGlB,MAAM;EAGN,cAAc,WAAW,SAAS,MAAM;EAGxC,cAAc;EA+Bd,eAAe;EAIf,OAAO,QAAQ,IAAI;EAGnB,UAAU,QAAQ;EAGlB,cAAc;EAGd,YAAY,SAAS,iBAAiB,KAAK,eAAe,MAAM;;UAIjD,uBAAuB;WAC7B,SAAS;EAClB,cAAc;;UAKC,sBAAsB,qBAAqB,uBAAuB;EACjF,MAAM;EACN,cAAc,WAAW,SAAS,MAAM;;UAKzB,uBAAuB,aAAa,kBAC3C,uBAAuB;EAC/B,MAAM;EACN,OAAO,QAAQ,IAAI;EACnB,UAAU,QAAQ;EAClB,uBAAuB;EACvB,YAAY,SAAS,0BAA0B,KAAK,eAAe,MAAM;;KAI/D;UAGK,oBAAoB,aAAa;WACvC;WACA,SAAS,SAAS;WAClB,SAAS,gBAAgB;WACzB,QAAQ,aAAa;WACrB,iBAAiB;WACjB,SAAS;;KAIR,sBAAsB,aAAa,aAC7C,OAAO,oBAAoB,GAAG,cACpB;UAGK,eAAe,qBAAqB,KAAK,cAAc;EAEtE;;UAMe,YAAY,qBAAqB,KAAK,cAAc;UAMpD,aAAa,qBAAqB,cAAc;EAE/D;;KAoEU,cAAc,aAAa,aACrC,SAAS,GACT,YAAY,mBAAmB,GAAG,OAC/B,IAAI,QAAQ,YAAY;KAGjB,oBAAoB,gBAC9B,SAAS,GACT,YAAY,uBAAuB,cACzB;KAGA,mBAAmB,gBAC7B,SAAS,GACT,YAAY,sBAAsB,cACxB;KAOA,oBAAoB,aAAa,aAC3C,SAAS,GACT,YAAY,uBAAuB,GAAG,OACnC,IAAI,QAAQ;KAGL;KAGA;UA6BK,cAAc;EAE7B;EAGA;EAOA;EAGA,aAAa;EAGb,cAAc;EAGd;EAGA;EAGA;EAGA;EAGA;EAGA,aAAa,SAAS;EAGtB,WAAW;EAGX;;UASe,sBAAsB;EACrC;EACA;EACA;EACA,YAAY;EACZ,aAAa;EACb;EACA;EACA;EACA;EACA;EACA,aAAa,SAAS;EACtB,WAAW;;
|
|
1
|
+
{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/ActionRegister.ts","../src/action-guard.ts","../src/errors.ts","../src/execution-modes.ts"],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -96,7 +96,7 @@ interface ResolvedHandlerConfig<T = unknown> {
|
|
|
96
96
|
condition?: (payload: T) => boolean;
|
|
97
97
|
metadata?: Record<string, unknown>;
|
|
98
98
|
}
|
|
99
|
-
declare function resolveHandlerConfig<T = unknown>(config: HandlerConfig<T> | undefined, handlerId: string): ResolvedHandlerConfig<T>;
|
|
99
|
+
export declare function resolveHandlerConfig<T = unknown>(config: HandlerConfig<T> | undefined, handlerId: string): ResolvedHandlerConfig<T>;
|
|
100
100
|
interface HandlerRegistration<T = unknown, R = void> {
|
|
101
101
|
handler: ActionHandler<T, R>;
|
|
102
102
|
config: ResolvedHandlerConfig<T>;
|
|
@@ -165,6 +165,11 @@ interface ActionRegisterConfig {
|
|
|
165
165
|
};
|
|
166
166
|
}
|
|
167
167
|
interface DispatchOptions {
|
|
168
|
+
trace?: {
|
|
169
|
+
transactionId?: string;
|
|
170
|
+
origin?: 'user' | 'system' | 'network' | 'undo' | 'redo' | 'reset';
|
|
171
|
+
label?: string;
|
|
172
|
+
};
|
|
168
173
|
debounce?: number;
|
|
169
174
|
throttle?: number;
|
|
170
175
|
executionMode?: ExecutionMode;
|
|
@@ -199,6 +204,18 @@ interface DispatchOptions {
|
|
|
199
204
|
includeErrors?: boolean;
|
|
200
205
|
};
|
|
201
206
|
}
|
|
207
|
+
interface ActionDispatchTrace {
|
|
208
|
+
readonly dispatchId: string;
|
|
209
|
+
readonly action: string;
|
|
210
|
+
readonly phase: 'started' | 'settled';
|
|
211
|
+
readonly status?: 'completed' | 'failed' | 'cancelled' | 'debounced' | 'throttled';
|
|
212
|
+
readonly transactionId?: string;
|
|
213
|
+
readonly origin?: 'user' | 'system' | 'network' | 'undo' | 'redo' | 'reset';
|
|
214
|
+
readonly label?: string;
|
|
215
|
+
readonly startedAt: number;
|
|
216
|
+
readonly endedAt?: number;
|
|
217
|
+
}
|
|
218
|
+
type ActionDispatchTraceListener = (event: ActionDispatchTrace) => void;
|
|
202
219
|
interface ExecutionResult<R = void> {
|
|
203
220
|
success: boolean;
|
|
204
221
|
aborted: boolean;
|
|
@@ -289,7 +306,7 @@ interface ActionHandlerStats<T extends ActionPayloadMap> {
|
|
|
289
306
|
}
|
|
290
307
|
//#endregion
|
|
291
308
|
//#region src/ActionRegister.d.ts
|
|
292
|
-
declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown>, TResultMap extends ActionResultMap<T> = {}> {
|
|
309
|
+
export declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown>, TResultMap extends ActionResultMap<T> = {}> {
|
|
293
310
|
private pipelines;
|
|
294
311
|
private readonly observerHandlers;
|
|
295
312
|
private readonly claimedOnceHandlers;
|
|
@@ -311,6 +328,8 @@ declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown
|
|
|
311
328
|
private readonly activeHandlerPromises;
|
|
312
329
|
private destroyAsyncPromise;
|
|
313
330
|
private dispatchConstructionDepth;
|
|
331
|
+
private dispatchTraceSequence;
|
|
332
|
+
private readonly dispatchTraceListeners;
|
|
314
333
|
private _actionsProxy?;
|
|
315
334
|
private _actionsWithResultProxy?;
|
|
316
335
|
private readonly actionDispatchers;
|
|
@@ -331,6 +350,9 @@ declare class ActionRegister<T extends ActionPayloadMap = Record<string, unknown
|
|
|
331
350
|
registerResult<K extends ActionNames<T> & keyof TResultMap>(action: K, handler: ActionResultHandler<T[K], ActionResult<TResultMap, K>>, config?: HandlerConfig<T[K]>): UnregisterFunction;
|
|
332
351
|
private registerWithRole;
|
|
333
352
|
private log;
|
|
353
|
+
private beginDispatchTrace;
|
|
354
|
+
private withDispatchTrace;
|
|
355
|
+
subscribeDispatchTrace(listener: ActionDispatchTraceListener): UnregisterFunction;
|
|
334
356
|
private assertAcceptingWork;
|
|
335
357
|
private assertStringActionKey;
|
|
336
358
|
private rejectedLifecyclePromise;
|
|
@@ -414,7 +436,7 @@ interface GuardState {
|
|
|
414
436
|
debounceAbortCleanup: (() => void) | undefined;
|
|
415
437
|
debounceRequestId: number;
|
|
416
438
|
}
|
|
417
|
-
declare class ActionGuard {
|
|
439
|
+
export declare class ActionGuard {
|
|
418
440
|
private guards;
|
|
419
441
|
private cleanupInterval;
|
|
420
442
|
private readonly autoCleanupEnabled;
|
|
@@ -444,17 +466,17 @@ interface ZodIssueLike {
|
|
|
444
466
|
path: readonly (string | number | symbol)[];
|
|
445
467
|
code: string;
|
|
446
468
|
}
|
|
447
|
-
declare class ActionResultProcessingError extends Error {
|
|
469
|
+
export declare class ActionResultProcessingError extends Error {
|
|
448
470
|
name: string;
|
|
449
471
|
constructor(message: string);
|
|
450
472
|
}
|
|
451
|
-
declare class ActionAttemptSupersededError extends Error {
|
|
473
|
+
export declare class ActionAttemptSupersededError extends Error {
|
|
452
474
|
readonly attempt: number;
|
|
453
475
|
name: string;
|
|
454
476
|
constructor(attempt: number);
|
|
455
477
|
}
|
|
456
|
-
declare function isActionResultProcessingError(error: unknown): error is ActionResultProcessingError;
|
|
457
|
-
declare class ActionValidationError extends Error {
|
|
478
|
+
export declare function isActionResultProcessingError(error: unknown): error is ActionResultProcessingError;
|
|
479
|
+
export declare class ActionValidationError extends Error {
|
|
458
480
|
name: string;
|
|
459
481
|
readonly zodError: unknown;
|
|
460
482
|
constructor(action: string, zodError: unknown);
|
|
@@ -471,26 +493,26 @@ declare class ActionValidationError extends Error {
|
|
|
471
493
|
issues: readonly ZodIssueLike[];
|
|
472
494
|
};
|
|
473
495
|
}
|
|
474
|
-
declare class ActionTimeoutError extends Error {
|
|
496
|
+
export declare class ActionTimeoutError extends Error {
|
|
475
497
|
readonly action: string;
|
|
476
498
|
readonly timeout: number;
|
|
477
499
|
name: string;
|
|
478
500
|
constructor(action: string, timeout: number);
|
|
479
501
|
}
|
|
480
|
-
declare class ActionRegisterDestroyedError extends Error {
|
|
502
|
+
export declare class ActionRegisterDestroyedError extends Error {
|
|
481
503
|
readonly registerName: string;
|
|
482
504
|
readonly state: 'closing' | 'destroyed';
|
|
483
505
|
name: string;
|
|
484
506
|
constructor(registerName: string, state: 'closing' | 'destroyed');
|
|
485
507
|
}
|
|
486
|
-
declare function isActionValidationError(error: unknown): error is ActionValidationError;
|
|
487
|
-
declare function isActionTimeoutError(error: unknown): error is ActionTimeoutError;
|
|
488
|
-
declare function isActionRegisterDestroyedError(error: unknown): error is ActionRegisterDestroyedError;
|
|
508
|
+
export declare function isActionValidationError(error: unknown): error is ActionValidationError;
|
|
509
|
+
export declare function isActionTimeoutError(error: unknown): error is ActionTimeoutError;
|
|
510
|
+
export declare function isActionRegisterDestroyedError(error: unknown): error is ActionRegisterDestroyedError;
|
|
489
511
|
//#endregion
|
|
490
512
|
//#region src/execution-modes.d.ts
|
|
491
|
-
declare function executeSequential<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number) => PipelineController<T, R>): Promise<void>;
|
|
492
|
-
declare function executeParallel<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
|
|
493
|
-
declare function executeRace<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
|
|
513
|
+
export declare function executeSequential<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number) => PipelineController<T, R>): Promise<void>;
|
|
514
|
+
export declare function executeParallel<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
|
|
515
|
+
export declare function executeRace<T, R = void>(context: PipelineContext<T, R>, createController: (registration: HandlerRegistration<T, R>, index: number, state: PipelineControllerState<T, R>) => PipelineController<T, R>): Promise<void>;
|
|
494
516
|
//#endregion
|
|
495
|
-
export {
|
|
517
|
+
export type { ActionDispatchTrace, ActionDispatchTraceListener, ActionDispatcher, ActionDispatcherWithResult, ActionEffectController, ActionEffectHandler, ActionGuardController, ActionGuardHandler, ActionHandler, ActionHandlerStats, ActionNames, ActionObserverEvent, ActionObserverHandler, ActionPayload, ActionPayloadMap, ActionRegisterConfig, ActionRegistryInfo, ActionResult, ActionResultController, ActionResultHandler, ActionResultMap, ActionSchemaLike, DispatchArgs, DispatchOptions, EffectConfig, ExecutionMode, ExecutionResult, GuardConfig, HandlerConfig, HandlerError, HandlerErrorPolicy, HandlerExecutionOutcome, HandlerExecutionStatus, HandlerRegistration, HandlerRole, HandlerScheduling, ObserverConfig, PipelineContext, PipelineController, ProxyActionKey, ReservedActionKey, ResolvedHandlerConfig, UnregisterFunction };
|
|
496
518
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/ActionRegister.ts","../src/action-guard.ts","../src/errors.ts","../src/execution-modes.ts"],"mappings":";KAmBY;UASK;EACf,UAAU;IACJ;IAAe;;IAEf;IACA;MACE;MACA;QAAmB;;;;;KAsKjB,YAAY,UAAU,oBAAoB,cAAc;KAaxD,cAAc,UAAU,kBAAkB,gBAAgB,KAAK,EAAE;KASjE,gBAAgB,UAAU,oBAAoB,QACxD,OAAO,YAAY;KAIT,aACV,mBAAmB,kBACnB,UAAU,eACR,gBAAgB,aAAa,WAAW;UAgE3B,mBAAmB,aAAa;WAQtC,SAAS;EAGlB,MAAM;EAGN,cAAc,WAAW,SAAS,MAAM;EAGxC,cAAc;EA+Bd,eAAe;EAIf,OAAO,QAAQ,IAAI;EAGnB,UAAU,QAAQ;EAGlB,cAAc;EAGd,YAAY,SAAS,iBAAiB,KAAK,eAAe,MAAM;;UAIjD,uBAAuB;WAC7B,SAAS;EAClB,cAAc;;UAKC,sBAAsB,qBAAqB,uBAAuB;EACjF,MAAM;EACN,cAAc,WAAW,SAAS,MAAM;;UAKzB,uBAAuB,aAAa,kBAC3C,uBAAuB;EAC/B,MAAM;EACN,OAAO,QAAQ,IAAI;EACnB,UAAU,QAAQ;EAClB,uBAAuB;EACvB,YAAY,SAAS,0BAA0B,KAAK,eAAe,MAAM;;KAI/D;UAGK,oBAAoB,aAAa;WACvC;WACA,SAAS,SAAS;WAClB,SAAS,gBAAgB;WACzB,QAAQ,aAAa;WACrB,iBAAiB;WACjB,SAAS;;KAIR,sBAAsB,aAAa,aAC7C,OAAO,oBAAoB,GAAG,cACpB;UAGK,eAAe,qBAAqB,KAAK,cAAc;EAEtE;;UAMe,YAAY,qBAAqB,KAAK,cAAc;UAMpD,aAAa,qBAAqB,cAAc;EAE/D;;KAoEU,cAAc,aAAa,aACrC,SAAS,GACT,YAAY,mBAAmB,GAAG,OAC/B,IAAI,QAAQ,YAAY;KAGjB,oBAAoB,gBAC9B,SAAS,GACT,YAAY,uBAAuB,cACzB;KAGA,mBAAmB,gBAC7B,SAAS,GACT,YAAY,sBAAsB,cACxB;KAOA,oBAAoB,aAAa,aAC3C,SAAS,GACT,YAAY,uBAAuB,GAAG,OACnC,IAAI,QAAQ;KAGL;KAGA;UA6BK,cAAc;EAE7B;EAGA;EAOA;EAGA,aAAa;EAGb,cAAc;EAGd;EAGA;EAGA;EAGA;EAGA;EAGA,aAAa,SAAS;EAGtB,WAAW;EAGX;;UASe,sBAAsB;EACrC;EACA;EACA;EACA,YAAY;EACZ,aAAa;EACb;EACA;EACA;EACA;EACA;EACA,aAAa,SAAS;EACtB,WAAW;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/ActionRegister.ts","../src/action-guard.ts","../src/errors.ts","../src/execution-modes.ts"],"mappings":";KAmBY;UASK;EACf,UAAU;IACJ;IAAe;;IAEf;IACA;MACE;MACA;QAAmB;;;;;KAsKjB,YAAY,UAAU,oBAAoB,cAAc;KAaxD,cAAc,UAAU,kBAAkB,gBAAgB,KAAK,EAAE;KASjE,gBAAgB,UAAU,oBAAoB,QACxD,OAAO,YAAY;KAIT,aACV,mBAAmB,kBACnB,UAAU,eACR,gBAAgB,aAAa,WAAW;UAgE3B,mBAAmB,aAAa;WAQtC,SAAS;EAGlB,MAAM;EAGN,cAAc,WAAW,SAAS,MAAM;EAGxC,cAAc;EA+Bd,eAAe;EAIf,OAAO,QAAQ,IAAI;EAGnB,UAAU,QAAQ;EAGlB,cAAc;EAGd,YAAY,SAAS,iBAAiB,KAAK,eAAe,MAAM;;UAIjD,uBAAuB;WAC7B,SAAS;EAClB,cAAc;;UAKC,sBAAsB,qBAAqB,uBAAuB;EACjF,MAAM;EACN,cAAc,WAAW,SAAS,MAAM;;UAKzB,uBAAuB,aAAa,kBAC3C,uBAAuB;EAC/B,MAAM;EACN,OAAO,QAAQ,IAAI;EACnB,UAAU,QAAQ;EAClB,uBAAuB;EACvB,YAAY,SAAS,0BAA0B,KAAK,eAAe,MAAM;;KAI/D;UAGK,oBAAoB,aAAa;WACvC;WACA,SAAS,SAAS;WAClB,SAAS,gBAAgB;WACzB,QAAQ,aAAa;WACrB,iBAAiB;WACjB,SAAS;;KAIR,sBAAsB,aAAa,aAC7C,OAAO,oBAAoB,GAAG,cACpB;UAGK,eAAe,qBAAqB,KAAK,cAAc;EAEtE;;UAMe,YAAY,qBAAqB,KAAK,cAAc;UAMpD,aAAa,qBAAqB,cAAc;EAE/D;;KAoEU,cAAc,aAAa,aACrC,SAAS,GACT,YAAY,mBAAmB,GAAG,OAC/B,IAAI,QAAQ,YAAY;KAGjB,oBAAoB,gBAC9B,SAAS,GACT,YAAY,uBAAuB,cACzB;KAGA,mBAAmB,gBAC7B,SAAS,GACT,YAAY,sBAAsB,cACxB;KAOA,oBAAoB,aAAa,aAC3C,SAAS,GACT,YAAY,uBAAuB,GAAG,OACnC,IAAI,QAAQ;KAGL;KAGA;UA6BK,cAAc;EAE7B;EAGA;EAOA;EAGA,aAAa;EAGb,cAAc;EAGd;EAGA;EAGA;EAGA;EAGA;EAGA,aAAa,SAAS;EAGtB,WAAW;EAGX;;UASe,sBAAsB;EACrC;EACA;EACA;EACA,YAAY;EACZ,aAAa;EACb;EACA;EACA;EACA;EACA;EACA,aAAa,SAAS;EACtB,WAAW;;wBAQG,qBAAqB,aACnC,QAAQ,cAAc,gBACtB,oBACC,sBAAsB;UAgCR,oBAAoB,aAAa;EAEhD,SAAS,cAAc,GAAG;EAG1B,QAAQ,sBAAsB;EAG9B;EAMA,OAAO;;KAIG;UAWK,wBAAwB;EACvC;EACA,QAAQ;EACR;EACA;EACA,QAAQ;EACR,OAAO;EACP,UAAU;EACV;EACA,oBAAoB;;UAIL,wBAAwB,aAAa;EACpD,SAAS;EACT;EACA;EACA;EACA;EACA,mBAAmB;EACnB,SAAS;;KA0BC;UAcK,gBAAgB,aAAa;EAE5C;EAGA,SAAS;EAGT,UAAU,oBAAoB,GAAG;EAGjC,mBAAmB,oBAAoB,GAAG;EAG1C,kBAAkB,wBAAwB;EAG1C;EACA,oBAAoB,wBAAwB;EAG5C;EAQA,WAAW,cAAc,oBAAoB,GAAG;EAGhD,SAAS;EAGT,qBAAqB,GAAG,SAAS,QAAQ,KAAK,QAAQ;EAGtD,kBAAkB;EAGlB;EAGA;EAGA;EAGA;EAGA;EAGA;EAGA,eAAe;EAGf,SAAS;EAGT;EAGA,mBAAmB;;UAkCJ;EAEf;EAGA;IAEE;IAGA;IAGA,uBAAuB;IAGvB;IAOA;IAMA;IAGA,gBAAgB,OAAO,OAAO,4BAA4B;IAS1D,SAAS,eAAe;IAMxB;IAQA;;;UA4Da;EAEf;IACE;IACA;IACA;;EAGF;EAGA;EAGA,gBAAgB;EAGhB,SAAS;EAGT;EAGA;EAOA;EAOA;IAEE;IAEA;IAOA;;EAIF;IAEE;IAGA,uBAAuB,YAAY;IAGnC;;EAIF;IAEE;IAGA;IAGA;MAEE;MAEA;;IAIF,UAAU,QAAQ,SAAS;;EAI7B;IAEE;IAGA,UAAU,GAAG,SAAS,MAAM,mBAAmB;IAG/C;IAGA;IAGA;;;UAKa;WACN;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;KAGC,+BAA+B,OAAO;UA2CjC,gBAAgB;EAE/B;EAGA;EAGA;EAGA;EAGA;EAGA;IACE;IACA;;EAIF,QAAQ,IAAI;EAIZ,gBAAgB;EAGhB,SAAS,MAAM;EAGf,eAAe;IACb;IACA,OAAO;IAEP;;EAIF;IAIE;IAGA;IAGA;IAGA;IAGA;IAGA;IAGA,WAAW;MACT;MACA;MACA;MACA;;IAIF;IAGA;IAGA;IAGA;IAGA;;EAIF,UAAU;IAER;IAGA;IAGA,QAAQ;IAGR;IAGA,QAAQ;IAGR,OAAO;IAGP,UAAU;;EAIZ;IACE;IAEA,SAAS,wBAAwB;IACjC,gBAAgB,MAAM,wBAAwB;IAE9C;IAEA;;EAIF,QAAQ;;UAQO;EACf;EACA,OAAO;EACP;EACA;;KAmBU;KAoBA,aAAa,MAAM,qBAC1B,qBAAqB,UAAU,oBAC/B,SAAS,GAAG,UAAU;KAGf;KAUA,eAAe,UAAU,oBAAoB,QAAQ,YAAY,IAAI;KAWrE,2BACV,UAAU,kBACV,mBAAmB,gBAAgB,YAEnC,UAAU,YAAY,IACtB,IAAI,aAAa,YAAY,IAC7B,QAAQ,MAAM,MAAM,aAAa,EAAE,QAAQ,QAAQ,gBAAgB;KA8BzD,iBAAiB,UAAU,qBAAqB,UAAU,YAAY,IAChF,QAAQ,MACL,MAAM,aAAa,EAAE,QACrB;UAuBY,mBAAmB,UAAU;EAE5C;EAGA;EAGA;EAGA,mBAAmB,YAAY;EAG/B,sBAAsB,UAAU,GAAG;EAGnC,sBAAsB;;UAgCP,mBAAmB,UAAU;EAE5C,cAAc;EAGd;EAGA;EAGA,iBAAiB;EAGjB,oBAAoB;IAClB;IACA,UAAU;MACR;;;EAKJ;;;;qBChyCW,eACX,UAAU,mBAAmB,yBAC7B,mBAAmB,gBAAgB;UAE3B;mBAGS;mBAMA;mBACA;UACT;UACA;UAGA;UAGA;WAEQ;mBACC;mBAGA;mBACA;mBACA;UAGT;UAGA;UAIA;mBACS;mBACA;mBACA;UACT;UACA;UACA;mBACS;UAGT;UAGA;mBAGS;mBAIA;EAKL,YAAA,SAAQ;MA0DhB,cACD,KAAK,eAAe,SAAS,MAAM,aAAa,EAAE,QAAQ;MAqDzD,wBACD,KAAK,eAAe,SAAS,MAAM,aAAa,EAAE,QAAQ,QAAQ,gBAAgB,aAAa,YAAY;EA6C9G,SAAS,UAAU,YAAY,WAAW,YACxC,QAAQ,GACR,SAAS,oBAAoB,EAAE,IAAI,aAAa,YAAY,KAC5D,SAAS,cAAc,EAAE,MACxB;EACH,SAAS,UAAU,QAAQ,YAAY,UAAU,aAAa,UAC5D,QAAQ,GACR,SAAS,cAAc,EAAE,IAAI,IAC7B,SAAS,cAAc,EAAE,MACxB;EAmBH,eAAe,UAAU,YAAY,IACnC,QAAQ,GACR,SAAS,mBAAmB,EAAE,KAC9B,QAAQ,aAAa,EAAE;IAAQ;MAC9B;EACH,eAAe,UAAU,YAAY,IACnC,QAAQ,GACR,SAAS,oBAAoB,EAAE,KAC/B,QAAQ,aAAa,EAAE;IAAQ;MAC9B;EAiBH,cAAc,UAAU,YAAY,IAClC,QAAQ,GACR,SAAS,mBAAmB,EAAE,KAC9B,SAAQ,YAAY,EAAE,MACrB;EAYH,iBACE,UAAU,YAAY,IACtB,IAAI,aAAa,YAAY,IAC7B,WAAW,OAAO,oBAAoB,EAAE,IAAI,iBAAiB,sBAAsB,EAAE,IAAI,IAEzF,QAAQ,GACR,SAAS,KAAK,WAAW,kBAAkB,kCAC3C,SAAQ,eAAe,EAAE,MACxB;EAsCH,eAAe,UAAU,YAAY,WAAW,YAC9C,QAAQ,GACR,SAAS,oBAAoB,EAAE,IAAI,aAAa,YAAY,KAC5D,SAAS,cAAc,EAAE,MACxB;UASK;UAeA;UAOA;UA8CA;EAYR,uBAAuB,UAAU,8BAA8B;UAKvD;UAMA;UAMA;UAaA;UAYA;UAoEA;EA6IR,SAAS,UAAU,YAAY,IAAI,QAAQ,MAAM,MAAM,aAAa,EAAE,MAAM;UAkO9D;UAsFN;UAOA;UAcA;UAwBA;UAWM;UAON;UAQA;UAmBA;UAgFA;UAyBA;UAiBA;UAqCA;UAgDA;UA2CA;UAiCM;UA0BN;UAUA;UAwBM;UA+DN;UAoBA;UAqBM;UAsFN;UA0CA;EAwDR,mBAAmB,UAAU,YAAY,WAAW,YAClD,QAAQ,MACL,MAAM,aAAa,EAAE,MACvB,QAAQ,gBAAgB,aAAa,YAAY;EACpD,mBAAmB,UAAU,QAAQ,YAAY,UAAU,aAAa,UACtE,QAAQ,MACL,MAAM,aAAa,EAAE,MACvB,QAAQ,gBAAgB;UAsSb;UAsPN;UAqEA;UA+DA;UAiBA;UAmEM;UAkFN;UA0CA;EAuBR,gBAAgB,UAAU,YAAY,IAAI,QAAQ;EAgBlD,YAAY,UAAU,YAAY,IAAI,QAAQ;EAa9C,+BAA+B;EAa/B,YAAY,UAAU,YAAY,IAAI,QAAQ;EAoB9C;EAsBA;EASA,mBAAmB,mBAAmB;EAsBtC,eAAe,UAAU,YAAY,IAAI,QAAQ,IAAI,mBAAmB;EA0CxE,qBAAqB,MAAM,mBAAmB;EAY9C,iBAAiB,MAAM;EAcvB,uBAAuB,UAAU,YAAY,IAAI,QAAQ,GAAG,MAAM;EAclE,uBAAuB,UAAU,YAAY,IAAI,QAAQ,IAAI;EAS7D,0BAA0B,UAAU,YAAY,IAAI,QAAQ;EAc5D,qBAAqB;EASrB;UAaQ;UAgBA;UAUA;UA6BA;EAmBR;EAeA,sBAAsB;EAQtB;UAIQ;UAqEA;EAmBR;EAkBA,aAAa;IAAW;MAAgC;;;;KCvnGrD,cAAc,kBAAkB;UAE3B;EAER;EAGA;EAGA,eAAe;EAGf,eAAe;EAGf;EAGA,mBAAmB;EAGnB;EAGA;;qBA+BW;UACH;UACA;mBACS;mBACA;mBACA;EAEL,YAAA;UAKJ;UAWA;UAWA;UAYA;EA6CF,SACJ,mBACA,oBACA,SAAS,cACR;EA2FH,SAAS,mBAAmB,oBAAoB,SAAS;EAoEzD,YAAY;EAsCZ;EAoCA,cAAc,oBAAoB;EAclC,qBAAqB,YAAY;EAYjC;EAYA;IAAc;IAAsB;;;;;UC9arB;EACf;EACA;EACA;;qBAeW,oCAAoC;EACtC;EAEG,YAAA;;qBAOD,qCAAqC;WAGpB;EAFnB;EAEmB,YAAA;;wBAMd,8BACd,iBACC,SAAS;qBA2BC,8BAA8B;EAEhC;WAGO;EAMJ,YAAA,gBAAgB;WAiBZ;MAKZ,mBAAmB;MAenB;MAeA;MAeA;MAOA;EASJ;;;;;;;qBAgBW,2BAA2B;WAIpB;WACA;EAJT;EAGS,YAAA,gBACA;;qBAQP,qCAAqC;WAI9B;WACA;EAJT;EAGS,YAAA,sBACA;;wBAcJ,wBACd,iBACC,SAAS;wBAKI,qBACd,iBACC,SAAS;wBAKI,+BACd,iBACC,SAAS;;;wBChHU,kBAAkB,GAAG,UACzC,SAAS,gBAAgB,GAAG,IAC5B,mBAAmB,cAAc,oBAAoB,GAAG,IAAI,kBAAkB,mBAAmB,GAAG,KACnG;wBA2NmB,gBAAgB,GAAG,UACvC,SAAS,gBAAgB,GAAG,IAC5B,mBACE,cAAc,oBAAoB,GAAG,IACrC,eACA,OAAO,wBAAwB,GAAG,OAC/B,mBAAmB,GAAG,KAC1B;wBAuJmB,YAAY,GAAG,UACnC,SAAS,gBAAgB,GAAG,IAC5B,mBACE,cAAc,oBAAoB,GAAG,IACrC,eACA,OAAO,wBAAwB,GAAG,OAC/B,mBAAmB,GAAG,KAC1B"}
|