@exactjs/core 0.5.0

package/dist/client/tasks/resources.js

@@ -0,0 +1,349 @@
+import { batch, mutateReactiveCollection, unwrap, scheduleEffectScopeResume } from '@exactjs/reactive/framework/runtime';
+import { createDisposableAbortSignal, isAbortSignal } from './signals.js';
+import { isPromiseLike } from '../component/async-value.js';
+import { createErrorReport, handleComponentError } from '../component/errors.js';
+import { TaskCancellation } from './cancellation.js';
+import { resumeTaskFrame } from './frame-runtime.js';
+import { logFrameworkEvent } from '../component/log.js';
+const taskOwners = new WeakMap();
+/** Associates a task generation signal with its component owner. */
+export function trackTaskOwner(signal, owner) {
+    taskOwners.set(signal, owner);
+}
+const taskCleanupPromises = new WeakMap();
+const taskMutations = new WeakMap();
+const taskCollectionMutations = new WeakMap();
+/** Stages a compiler-generated mutation until its blocking task generation commits. */
+export function stageTaskMutation(signal, mutation) {
+    if (signal.aborted)
+        return;
+    let staged = taskMutations.get(signal);
+    if (!staged) {
+        staged = [];
+        taskMutations.set(signal, staged);
+        signal.addEventListener('abort', () => discardTaskMutations(signal), { once: true });
+    }
+    staged.push(mutation);
+}
+/** Publishes staged mutations for a successful task generation as one reactive batch. */
+export function publishTaskMutations(signal) {
+    const staged = taskMutations.get(signal);
+    if (!staged)
+        return;
+    taskMutations.delete(signal);
+    batch(() => {
+        for (const mutation of staged)
+            mutation();
+    });
+}
+/** Discards every unpublished mutation owned by a task generation. */
+export function discardTaskMutations(signal) {
+    taskMutations.delete(signal);
+    taskCollectionMutations.delete(signal);
+}
+/**
+ * Applies a server-task collection mutation and records the smallest ordered
+ * response delta that can reproduce the successful change in the browser.
+ */
+export function mutateTaskCollection(signal, target, path, kind, method, args) {
+    if (signal.aborted)
+        return undefined;
+    const input = typeof args === 'function' ? args() : args;
+    const collection = readTaskCollection(target, path);
+    const raw = unwrap(collection);
+    const changed = collectionMutationChanges(raw, kind, method, input);
+    const result = mutateReactiveCollection(target, path, kind, method, input);
+    if (changed) {
+        let mutations = taskCollectionMutations.get(signal);
+        if (!mutations) {
+            mutations = [];
+            taskCollectionMutations.set(signal, mutations);
+            signal.addEventListener('abort', () => discardTaskMutations(signal), { once: true });
+        }
+        mutations.push(collectionMutation(path, kind, method, input));
+    }
+    return result;
+}
+/** Takes the ordered collection deltas produced by one successful task generation. */
+export function takeTaskCollectionMutations(signal) {
+    const mutations = taskCollectionMutations.get(signal);
+    taskCollectionMutations.delete(signal);
+    return mutations?.length ? mutations : undefined;
+}
+function readTaskCollection(target, path) {
+    let value = target;
+    for (const segment of path)
+        value = Reflect.get(value, segment);
+    return value;
+}
+function collectionMutationChanges(value, kind, method, args) {
+    if (kind === 'map' && value instanceof Map) {
+        if (method === 'clear')
+            return value.size > 0;
+        if (method === 'delete')
+            return value.has(unwrap(args[0]));
+        const key = unwrap(args[0]);
+        return !value.has(key) || !Object.is(value.get(key), unwrap(args[1]));
+    }
+    if (kind === 'set' && value instanceof Set) {
+        if (method === 'clear')
+            return value.size > 0;
+        if (method === 'delete')
+            return value.has(unwrap(args[0]));
+        return !value.has(unwrap(args[0]));
+    }
+    return true;
+}
+function collectionMutation(path, kind, method, args) {
+    const location = path.map(String).join('.');
+    if (kind === 'map') {
+        if (method === 'set')
+            return { path: location, operation: 'map-set', key: unwrap(args[0]), value: unwrap(args[1]) };
+        if (method === 'delete')
+            return { path: location, operation: 'map-delete', key: unwrap(args[0]) };
+        return { path: location, operation: 'map-clear' };
+    }
+    if (method === 'add')
+        return { path: location, operation: 'set-add', value: unwrap(args[0]) };
+    if (method === 'delete')
+        return { path: location, operation: 'set-delete', value: unwrap(args[0]) };
+    return { path: location, operation: 'set-clear' };
+}
+/** Registers once-only task cleanup and reports asynchronous disposal failures. */
+export function registerTaskCleanup(signal, cleanup) {
+    let active = true;
+    const run = () => {
+        if (!active)
+            return;
+        active = false;
+        signal.removeEventListener('abort', run);
+        try {
+            const result = cleanup(signal.reason);
+            if (isPromiseLike(result)) {
+                trackTaskCleanupPromise(signal, Promise.resolve(result).catch((error) => {
+                    reportTaskResourceError(signal, error);
+                }));
+            }
+        }
+        catch (error) {
+            reportTaskResourceError(signal, error);
+        }
+    };
+    if (signal.aborted)
+        run();
+    else
+        signal.addEventListener('abort', run, { once: true });
+}
+function trackTaskCleanupPromise(signal, promise) {
+    let pending = taskCleanupPromises.get(signal);
+    if (!pending) {
+        pending = new Set();
+        taskCleanupPromises.set(signal, pending);
+    }
+    pending.add(promise);
+    void promise.finally(() => {
+        pending.delete(promise);
+        if (!pending.size)
+            taskCleanupPromises.delete(signal);
+    });
+}
+/** Waits for registered task cleanup promises and preserves failures for aggregate reporting. */
+export function drainTaskCleanupPromises(signal) {
+    if (!signal)
+        return undefined;
+    const pending = taskCleanupPromises.get(signal);
+    if (!pending?.size)
+        return undefined;
+    return Promise.all([...pending]).then(() => undefined);
+}
+/** Owns a disposable value while preserving the value and expression result. */
+export function ownTaskResource(signal, resource, disposal) {
+    registerTaskCleanup(signal, (reason) => disposeTaskResource(resource, disposal, reason));
+    return resource;
+}
+/** Compiler helper for idle callbacks owned by one task generation. */
+export function taskIdleCallback(signal, callback, options) {
+    const platform = globalThis;
+    let handle = 0;
+    const cancel = () => platform.cancelIdleCallback(handle);
+    handle = platform.requestIdleCallback((deadline) => {
+        signal.removeEventListener('abort', cancel);
+        if (!signal.aborted)
+            runTaskCallback(signal, 'idle-callback', () => callback(deadline));
+    }, options);
+    if (signal.aborted)
+        cancel();
+    else
+        signal.addEventListener('abort', cancel, { once: true });
+    return handle;
+}
+function disposeTaskResource(resource, disposal, reason) {
+    if (typeof disposal === 'function')
+        return disposal(resource, reason);
+    if (disposal === 'call') {
+        if (typeof resource === 'function')
+            return resource();
+        return;
+    }
+    if (!resource || (typeof resource !== 'object' && typeof resource !== 'function'))
+        return;
+    if (disposal === 'cancel')
+        return invokeResourceMethod(resource, 'cancel', reason);
+    if (disposal)
+        return invokeResourceMethod(resource, disposal);
+    const symbols = Symbol;
+    if (symbols.asyncDispose) {
+        const result = invokeResourceMethod(resource, symbols.asyncDispose);
+        if (result !== undefined)
+            return result;
+    }
+    if (symbols.dispose)
+        return invokeResourceMethod(resource, symbols.dispose);
+}
+function invokeResourceMethod(resource, key, ...args) {
+    const method = Reflect.get(resource, key);
+    if (typeof method === 'function')
+        return method.apply(resource, args);
+}
+function reportTaskResourceError(signal, error) {
+    const instance = taskOwners.get(signal);
+    if (instance) {
+        handleComponentError(instance, createErrorReport(error, 'task', instance, 'resource-cleanup'));
+        return;
+    }
+    logFrameworkEvent('error', 'core', 'task', 'task resource cleanup failed', error);
+}
+/** Compiler helpers for resources whose lifetime is owned by a task generation. */
+export function taskTimeout(signal, handler, delay, ...args) {
+    const abort = () => clearTimeout(timeout);
+    const timeout = setTimeout((...values) => {
+        signal.removeEventListener('abort', abort);
+        if (!signal.aborted)
+            runTaskCallback(signal, 'timeout', () => handler(...values));
+    }, delay, ...args);
+    if (signal.aborted)
+        abort();
+    else
+        signal.addEventListener('abort', abort, { once: true });
+    return timeout;
+}
+/** Starts an interval whose timer is cleared automatically when the task signal aborts. */
+export function taskInterval(signal, handler, delay, ...args) {
+    const interval = setInterval((...values) => {
+        if (!signal.aborted)
+            runTaskCallback(signal, 'interval', () => handler(...values));
+    }, delay, ...args);
+    if (signal.aborted)
+        clearInterval(interval);
+    else
+        signal.addEventListener('abort', () => clearInterval(interval), { once: true });
+    return interval;
+}
+/** Requests an animation frame that is cancelled automatically with the owning task. */
+export function taskAnimationFrame(signal, handler) {
+    const platform = globalThis;
+    let frame = 0;
+    const cancel = () => platform.cancelAnimationFrame(frame);
+    frame = platform.requestAnimationFrame((time) => {
+        signal.removeEventListener('abort', cancel);
+        if (!signal.aborted)
+            runTaskCallback(signal, 'animation-frame', () => handler(time));
+    });
+    if (signal.aborted)
+        cancel();
+    else
+        signal.addEventListener('abort', cancel, { once: true });
+    return frame;
+}
+/** Owns an observer instance and disconnects it when the task is cancelled. */
+export function taskObserver(signal, observer) {
+    registerTaskCleanup(signal, () => observer.disconnect());
+    return observer;
+}
+function runTaskCallback(signal, phase, callback) {
+    try {
+        callback();
+    }
+    catch (error) {
+        const instance = taskOwners.get(signal);
+        if (instance)
+            handleComponentError(instance, createErrorReport(error, 'task', instance, phase));
+        else
+            reportTaskResourceError(signal, error);
+    }
+}
+/** Runs fetch with the task signal combined with any caller-provided cancellation signal. */
+export function taskFetch(signal, fetcher, input, init) {
+    const options = init ? { ...init } : {};
+    const existing = options.signal;
+    const combined = isAbortSignal(existing)
+        ? createDisposableAbortSignal(existing, signal)
+        : undefined;
+    options.signal = combined?.signal ?? signal;
+    try {
+        const result = fetcher(input, options);
+        if (combined && isPromiseLike(result)) {
+            void Promise.resolve(result).finally(combined.dispose).catch(ignoreSettlement);
+        }
+        else
+            combined?.dispose();
+        return result;
+    }
+    catch (error) {
+        combined?.dispose();
+        throw error;
+    }
+}
+function ignoreSettlement() { }
+/**
+ * Awaits a value while retaining task cancellation and Activity parking semantics.
+ *
+ * The source promise continues while its component scope is paused. Its authored continuation
+ * remains parked until the scope resumes, and cancellation can still reject during that wait.
+ */
+export function taskAwait(signal, value) {
+    if (signal.aborted)
+        return Promise.reject(new TaskCancellation(signal.reason));
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let releaseWaiter;
+        const abort = () => {
+            if (settled)
+                return;
+            settled = true;
+            releaseWaiter?.();
+            releaseWaiter = undefined;
+            resumeTaskFrame(signal, () => reject(new TaskCancellation(signal.reason)));
+        };
+        signal.addEventListener('abort', abort, { once: true });
+        const finish = (result, failed) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', abort);
+            resumeTaskFrame(signal, () => {
+                if (failed)
+                    reject(result);
+                else if (signal.aborted)
+                    reject(new TaskCancellation(signal.reason));
+                else
+                    resolve(result);
+            });
+        };
+        const continueTask = (result, failed) => {
+            if (settled)
+                return;
+            const owner = taskOwners.get(signal);
+            if (owner?.scope.paused) {
+                releaseWaiter = scheduleEffectScopeResume(owner.scope, () => {
+                    releaseWaiter = undefined;
+                    finish(result, failed);
+                });
+                return;
+            }
+            finish(result, failed);
+        };
+        Promise.resolve(value).then((result) => continueTask(result, false), (error) => continueTask(error, true));
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/client/tasks/resources.js.map

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

package/dist/client/tasks/runtime-types.d.ts

@@ -0,0 +1,55 @@
+import type { ReactiveMutationJournal } from '@exactjs/reactive/framework/runtime';
+import type { AnyComponentInstance } from '../component/contracts.js';
+import type { ComponentTraceSpan } from '../component/performance-trace.js';
+import type { TaskActivation } from './contracts.js';
+import type { TaskFrameRecord } from './frame-runtime.js';
+/** Mutable execution record for one owner- and lane-scoped task generation. */
+export type InternalTaskGeneration<Result> = {
+    readonly generation: number;
+    readonly controller: AbortController;
+    readonly args: readonly unknown[];
+    readonly journals: ReactiveMutationJournal[];
+    readonly promise: Promise<Result>;
+    readonly resolve: (value: Result) => void;
+    readonly reject: (error: unknown) => void;
+    readonly parent: TaskFrameRecord | undefined;
+    readonly releaseReservation?: () => void;
+    readonly foreground: boolean;
+    readonly activation: TaskActivation;
+    /** Effective lane policy; dependency-driven activation always uses latest-wins. */
+    readonly concurrency: 'parallel' | 'latest' | 'queue';
+    readonly readiness: 'blocking' | 'nonblocking';
+    readinessRegistration?: {
+        cancel(): void;
+    };
+    priority: 'immediate' | 'normal' | 'deferred';
+    scheduledWork?: () => void;
+    observed: boolean;
+    started: boolean;
+    executing: boolean;
+    trace?: {
+        readonly owner: AnyComponentInstance;
+        readonly span: ComponentTraceSpan;
+    };
+};
+/** Concurrency lane state shared by generations with the same task key. */
+export type InternalTaskLane<Result> = {
+    readonly key: unknown;
+    readonly active: Set<InternalTaskGeneration<Result>>;
+    readonly queue: InternalTaskGeneration<Result>[];
+    pendingCount: number;
+    generation: number;
+    result: Result | undefined;
+    error: unknown;
+};
+/** Aggregate status and keyed lanes for one task definition under one owner. */
+export type InternalTaskOwnerState<Result> = {
+    nextGeneration: number;
+    generation: number;
+    pendingCount: number;
+    result: Result | undefined;
+    error: unknown;
+    readonly lanes: Map<unknown, InternalTaskLane<Result>>;
+    lanesVersion: number;
+};
+//# sourceMappingURL=runtime-types.d.ts.map

package/dist/client/tasks/runtime-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-types.d.ts","sourceRoot":"","sources":["../../../src/tasks/runtime-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAEnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,CAAC,MAAM,IAAI;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,mFAAmF;IACnF,QAAQ,CAAC,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,aAAa,CAAC;IAC/C,qBAAqB,CAAC,EAAE;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;IAC3C,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC9C,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE;QACP,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;QACrC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;KAClC,CAAC;CACF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,CAAC,MAAM,IAAI;IACtC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,CAAC,MAAM,IAAI;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/client/tasks/runtime-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-types.js.map

package/dist/client/tasks/runtime-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-types.js","sourceRoot":"","sources":["../../../src/tasks/runtime-types.ts"],"names":[],"mappings":""}

package/dist/client/tasks/runtime.d.ts

@@ -0,0 +1,28 @@
+import type { BoundTaskFunction, RuntimeTaskOptions, TaskContext, TaskFunction, TaskInvocation, TaskOwner, TaskStatus } from './contracts.js';
+import { type TaskOwnerRecord } from './frame-runtime.js';
+/**
+ * Defines one stable runtime task using the same owner, lane, generation,
+ * frame, cancellation, cleanup, and status runtime used by compiled tasks.
+ */
+export declare function defineTask<Args extends unknown[], Result>(options: RuntimeTaskOptions<Args>, implementation: (...args: [...Args, TaskContext]) => Result | Promise<Result>): TaskFunction<Args, Awaited<Result>>;
+/** Invokes a child task with an explicit retained parent after any await boundary. */
+export declare function invokeTask<Args extends unknown[], Result>(parent: TaskContext, child: TaskFunction<Args, Result>, ...args: Args): TaskInvocation<Result>;
+/** Creates an owner-bound callable facade with aggregate reactive status. */
+export declare function bindTask<Args extends unknown[], Result>(task: TaskFunction<Args, Result>, options?: {
+    readonly owner?: TaskOwner;
+}): BoundTaskFunction<Args, Result>;
+/**
+ * Binds compiler-generated task functions to an explicit durable host.
+ *
+ * Explicit host lookup preserves ownership across development module graphs
+ * that contain more than one physical copy of the core runtime.
+ */
+export declare function bindTaskForHost<Args extends unknown[], Result>(host: object, task: TaskFunction<Args, Result>): BoundTaskFunction<Args, Result>;
+/** Returns a non-callable owner-bound status view, optionally filtered to one key. */
+export declare function taskStatus<Args extends unknown[], Result>(task: TaskFunction<Args, Result> | ((...args: Args) => Result), options?: {
+    readonly owner?: TaskOwner;
+    readonly key?: unknown;
+}): TaskStatus<Awaited<Result>>;
+/** Internal setup activation entry used by the compiler-facing activation ABI. */
+export declare function invokeTaskForActivation<Args extends unknown[], Result>(task: TaskFunction<Args, Result>, owner: TaskOwnerRecord, activationSite: object, activation: 'initialization' | 'reactive', args: Args): TaskInvocation<Result>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/client/tasks/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/tasks/runtime.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACX,iBAAiB,EACjB,kBAAkB,EAElB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,SAAS,EACT,UAAU,EACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAQN,KAAK,eAAe,EACpB,MAAM,oBAAoB,CAAC;AAgB5B;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACxD,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACjC,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC3E,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAuBrC;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACxD,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EACjC,GAAG,IAAI,EAAE,IAAI,GACX,cAAc,CAAC,MAAM,CAAC,CAGxB;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACtD,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAChC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GACtC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAajC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAC7D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,GAC9B,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAIjC;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACxD,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,EAC9D,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAO7B;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACrE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAChC,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,gBAAgB,GAAG,UAAU,EACzC,IAAI,EAAE,IAAI,GACR,cAAc,CAAC,MAAM,CAAC,CAExB"}