@c9up/helix 0.1.3 → 0.1.5

package/dist/runtime/vi/fake-timers.js.map

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

package/dist/runtime/vi/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * `vi` — Vitest-compatible facade wiring together `vi.fn`, `vi.spyOn`,
+ * fake timers, and system-time overrides.
+ *
+ * State isolation via `AsyncLocalStorage`: each `runTestFile` enters a
+ * fresh `ViState`. Concurrent runs never share spies, timer queues, or
+ * system-clock pins. A forgotten `useRealTimers()` / `useRealSystemTime()`
+ * is cleaned up by `withViContext`'s finally block.
+ */
+import { type AnyFn, isSpy, type Spy } from "./spy.js";
+import { type SpyOnOptions } from "./spyOn.js";
+/** Minimal surface helix's container facade depends on. Lives here
+ *  rather than under `container/` so the runtime stays peer-dep-light
+ *  (no import of `@c9up/ream`'s Container type). */
+export interface ContainerLike {
+    restore(token: ContainerToken): void;
+}
+export type ContainerToken = (new (...args: never[]) => unknown) | string | symbol;
+/**
+ * Exposed for unit tests that run outside `withViContext`: reset the
+ * module-level fallback state so a forgotten `vi.fn()` or pinned clock
+ * from a prior test doesn't bleed into the next.
+ */
+export declare function resetFallbackState(): void;
+/**
+ * Run `body` under its own `vi` state. `runTestFile` in `worker.ts` wraps
+ * each file in this scope so fake timers and spy registrations don't leak
+ * between concurrent runs.
+ */
+export declare function withViContext<T>(body: () => Promise<T>): Promise<T>;
+declare function fn<Fn extends AnyFn>(implementation?: Fn): Spy<Fn>;
+declare function viSpyOn<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key, options?: SpyOnOptions): Spy;
+declare function useFakeTimers(options?: {
+    now?: number | Date;
+}): typeof vi;
+declare function useRealTimers(): typeof vi;
+declare function advanceTimersByTime(ms: number): typeof vi;
+declare function runAllTimers(): typeof vi;
+declare function runOnlyPendingTimers(): typeof vi;
+declare function getTimerCount(): number;
+declare function clearAllMocks(): typeof vi;
+declare function resetAllMocks(): typeof vi;
+/**
+ * Restore every `spyOn`-created spy in the current context to its
+ * original. `vi.fn()`-created spies are left as-is (they have nothing to
+ * restore — spec AC 5).
+ */
+declare function restoreAllMocks(): typeof vi;
+export declare const vi: {
+    fn: typeof fn;
+    spyOn: typeof viSpyOn;
+    isMockFunction: typeof isSpy;
+    useFakeTimers: typeof useFakeTimers;
+    useRealTimers: typeof useRealTimers;
+    advanceTimersByTime: typeof advanceTimersByTime;
+    runAllTimers: typeof runAllTimers;
+    runOnlyPendingTimers: typeof runOnlyPendingTimers;
+    getTimerCount: typeof getTimerCount;
+    setSystemTime: (time: Date | number) => /*elided*/ any;
+    getMockedSystemTime: () => number | null;
+    clearAllTimers: () => /*elided*/ any;
+    clearAllMocks: typeof clearAllMocks;
+    resetAllMocks: typeof resetAllMocks;
+    restoreAllMocks: typeof restoreAllMocks;
+    /** Escape hatch: clear the pinned system time. */
+    useRealSystemTime: () => /*elided*/ any;
+};
+export type Vi = typeof vi;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/vi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/vi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,EAAE,KAAK,KAAK,EAAa,KAAK,EAAE,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,YAAY,CAAC;AAStD;;oDAEoD;AACpD,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CACrC;AACD,MAAM,MAAM,cAAc,GACvB,CAAC,KACD,GAAG,IAAI,EAAE,KAAK,EAAE,KACX,OAAO,CAAC,GACb,MAAM,GACN,MAAM,CAAC;AA4BV;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAWzC;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBzE;AAED,iBAAS,EAAE,CAAC,EAAE,SAAS,KAAK,EAAE,cAAc,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,CAO1D;AAKD,iBAAS,OAAO,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,GAAG,EACzD,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,YAAiB,GACxB,GAAG,CAIL;AAED,iBAAS,aAAa,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAAG,OAAO,EAAE,CAcvE;AAED,iBAAS,aAAa,IAAI,OAAO,EAAE,CAKlC;AAQD,iBAAS,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,EAAE,CASlD;AAED,iBAAS,YAAY,IAAI,OAAO,EAAE,CAQjC;AAED,iBAAS,oBAAoB,IAAI,OAAO,EAAE,CAQzC;AAED,iBAAS,aAAa,IAAI,MAAM,CAE/B;AAED,iBAAS,aAAa,IAAI,OAAO,EAAE,CAGlC;AAED,iBAAS,aAAa,IAAI,OAAO,EAAE,CAGlC;AAED;;;;GAIG;AACH,iBAAS,eAAe,IAAI,OAAO,EAAE,CAWpC;AAED,eAAO,MAAM,EAAE;;;;;;;;;;0BAUQ,IAAI,GAAG,MAAM;;;;;;IAYnC,kDAAkD;;CAKlD,CAAC;AAEF,MAAM,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC"}

package/dist/runtime/vi/index.js

@@ -0,0 +1,209 @@
+/**
+ * `vi` — Vitest-compatible facade wiring together `vi.fn`, `vi.spyOn`,
+ * fake timers, and system-time overrides.
+ *
+ * State isolation via `AsyncLocalStorage`: each `runTestFile` enters a
+ * fresh `ViState`. Concurrent runs never share spies, timer queues, or
+ * system-clock pins. A forgotten `useRealTimers()` / `useRealSystemTime()`
+ * is cleaned up by `withViContext`'s finally block.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createFakeTimerController, } from "./fake-timers.js";
+import { createSpy, isSpy } from "./spy.js";
+import { spyOn } from "./spyOn.js";
+import { clearFakeEpoch, createSystemClock, registerSystemClockContext, setFakeEpoch, } from "./system-time.js";
+function createViState() {
+    const clock = createSystemClock();
+    const unregisterClock = registerSystemClockContext(() => clock);
+    return {
+        spies: new Set(),
+        timers: createFakeTimerController(),
+        clock,
+        unregisterClock,
+    };
+}
+const storage = new AsyncLocalStorage();
+let fallbackState = createViState();
+function currentState() {
+    return storage.getStore() ?? fallbackState;
+}
+/**
+ * Exposed for unit tests that run outside `withViContext`: reset the
+ * module-level fallback state so a forgotten `vi.fn()` or pinned clock
+ * from a prior test doesn't bleed into the next.
+ */
+export function resetFallbackState() {
+    fallbackState.unregisterClock();
+    fallbackState.timers.uninstall();
+    for (const spy of fallbackState.spies) {
+        try {
+            spy.mockRestore();
+        }
+        catch {
+            /* best-effort cleanup — ignore failures */
+        }
+    }
+    fallbackState = createViState();
+}
+/**
+ * Run `body` under its own `vi` state. `runTestFile` in `worker.ts` wraps
+ * each file in this scope so fake timers and spy registrations don't leak
+ * between concurrent runs.
+ */
+export async function withViContext(body) {
+    const state = createViState();
+    try {
+        return await storage.run(state, body);
+    }
+    finally {
+        // Tear down in reverse: spies first (so restored methods work under
+        // real timers), then timers, then system clock.
+        // (Per-test container overrides drain in `withTestContext`'s
+        // finally — see `runtime/test-context.ts`.)
+        const spiesReversed = [...state.spies].reverse();
+        for (const spy of spiesReversed) {
+            try {
+                spy.mockRestore();
+            }
+            catch {
+                // One spy's restore failing must not block the others.
+            }
+        }
+        if (state.timers.isActive())
+            state.timers.uninstall();
+        clearFakeEpoch(state.clock);
+        state.unregisterClock();
+    }
+}
+function fn(implementation) {
+    const spy = createSpy({
+        name: "spy",
+        defaultImplementation: implementation,
+    });
+    currentState().spies.add(spy);
+    return spy;
+}
+/** Identical semantics to `matchers.isSpy` — re-exported so both surfaces agree. */
+const isMockFunction = isSpy;
+function viSpyOn(obj, key, options = {}) {
+    const spy = spyOn(obj, key, options);
+    currentState().spies.add(spy);
+    return spy;
+}
+function useFakeTimers(options = {}) {
+    const s = currentState();
+    const pin = options.now instanceof Date
+        ? options.now.getTime()
+        : typeof options.now === "number"
+            ? options.now
+            : Date.now();
+    s.timers.install(pin);
+    // Fake timers also pin `Date.now()` / `new Date()` (per spec AC 4) via
+    // the same epoch — writing to the context's system clock so the shim
+    // returns the pinned value.
+    setFakeEpoch(s.clock, pin);
+    return vi;
+}
+function useRealTimers() {
+    const s = currentState();
+    s.timers.uninstall();
+    clearFakeEpoch(s.clock);
+    return vi;
+}
+function syncClockFromTimers(s) {
+    if (s.clock.fakeEpoch !== null) {
+        setFakeEpoch(s.clock, s.timers.now());
+    }
+}
+function advanceTimersByTime(ms) {
+    const s = currentState();
+    try {
+        s.timers.advanceBy(ms);
+    }
+    finally {
+        // Sync even on throw so the clock reflects the attempted advance.
+        syncClockFromTimers(s);
+    }
+    return vi;
+}
+function runAllTimers() {
+    const s = currentState();
+    try {
+        s.timers.runAll();
+    }
+    finally {
+        syncClockFromTimers(s);
+    }
+    return vi;
+}
+function runOnlyPendingTimers() {
+    const s = currentState();
+    try {
+        s.timers.runOnlyPending();
+    }
+    finally {
+        syncClockFromTimers(s);
+    }
+    return vi;
+}
+function getTimerCount() {
+    return currentState().timers.pending();
+}
+function clearAllMocks() {
+    for (const spy of currentState().spies)
+        spy.mockClear();
+    return vi;
+}
+function resetAllMocks() {
+    for (const spy of currentState().spies)
+        spy.mockReset();
+    return vi;
+}
+/**
+ * Restore every `spyOn`-created spy in the current context to its
+ * original. `vi.fn()`-created spies are left as-is (they have nothing to
+ * restore — spec AC 5).
+ */
+function restoreAllMocks() {
+    const spies = [...currentState().spies].reverse();
+    for (const spy of spies) {
+        if (!spy.__isSpyOn)
+            continue;
+        try {
+            spy.mockRestore();
+        }
+        catch {
+            // Continue even if one restore throws so the rest still run.
+        }
+    }
+    return vi;
+}
+export const vi = {
+    fn,
+    spyOn: viSpyOn,
+    isMockFunction,
+    useFakeTimers,
+    useRealTimers,
+    advanceTimersByTime,
+    runAllTimers,
+    runOnlyPendingTimers,
+    getTimerCount,
+    setSystemTime: (time) => {
+        setFakeEpoch(currentState().clock, time);
+        return vi;
+    },
+    getMockedSystemTime: () => currentState().clock.fakeEpoch,
+    clearAllTimers: () => {
+        currentState().timers.clear();
+        return vi;
+    },
+    clearAllMocks,
+    resetAllMocks,
+    restoreAllMocks,
+    /** Escape hatch: clear the pinned system time. */
+    useRealSystemTime: () => {
+        clearFakeEpoch(currentState().clock);
+        return vi;
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/vi/index.js.map

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

package/dist/runtime/vi/spy.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Spy core — a callable function that records every call and exposes a
+ * Vitest-shape `.mock` surface. Wears the `__helixIsSpy` brand so the
+ * matchers in `matchers.ts` (`toHaveBeenCalled*`) recognise it.
+ */
+export interface MockCallResult<Return = unknown> {
+    /** `"incomplete"` is pushed synchronously at call entry and patched when the call resolves — matches Vitest so `mock.results.length === mock.calls.length` even for in-flight async. */
+    type: "return" | "throw" | "incomplete";
+    value: Return;
+}
+export interface MockInternals<Args extends readonly unknown[] = readonly unknown[], Return = unknown> {
+    calls: Args[];
+    results: MockCallResult<Return>[];
+    /** The most recent call's arguments. Mirrors Vitest. */
+    lastCall: Args | undefined;
+}
+export type AnyFn = (...args: unknown[]) => unknown;
+type CallSignature<Fn extends AnyFn> = (...args: Parameters<Fn>) => ReturnType<Fn>;
+interface SpyMethods<Fn extends AnyFn> {
+    readonly __helixIsSpy: true;
+    readonly mock: MockInternals<Parameters<Fn>, ReturnType<Fn>>;
+    readonly calls: Parameters<Fn>[];
+    readonly callCount: number;
+    mockImplementation(fn: Impl<Fn>): Spy<Fn>;
+    mockImplementationOnce(fn: Impl<Fn>): Spy<Fn>;
+    mockReturnValue(value: ReturnType<Fn>): Spy<Fn>;
+    mockReturnValueOnce(value: ReturnType<Fn>): Spy<Fn>;
+    mockResolvedValue(value: Awaited<ReturnType<Fn>>): Spy<Fn>;
+    mockResolvedValueOnce(value: Awaited<ReturnType<Fn>>): Spy<Fn>;
+    mockRejectedValue(reason: unknown): Spy<Fn>;
+    mockRejectedValueOnce(reason: unknown): Spy<Fn>;
+    mockClear(): Spy<Fn>;
+    mockReset(): Spy<Fn>;
+    mockRestore(): Spy<Fn>;
+    /** Internal: spyOn installs a restore callback here. Undefined for `vi.fn`. */
+    __setRestore(fn: () => void): void;
+    /** Internal: true iff `__setRestore` was called (= created by spyOn). */
+    readonly __isSpyOn: boolean;
+}
+export type Spy<Fn extends AnyFn = AnyFn> = CallSignature<Fn> & SpyMethods<Fn>;
+type Impl<Fn extends AnyFn> = (...args: Parameters<Fn>) => ReturnType<Fn>;
+export interface CreateSpyOptions<Fn extends AnyFn> {
+    name?: string;
+    defaultImplementation?: Fn;
+}
+/**
+ * Factory used by `vi.fn` and `vi.spyOn`. The returned function is both
+ * callable (executing the current implementation) and an object carrying
+ * `.mock`, the Helix brand, and the `mockFoo()` mutators.
+ */
+export declare function createSpy<Fn extends AnyFn = AnyFn>(options?: CreateSpyOptions<Fn>): Spy<Fn>;
+export declare function isSpy(value: unknown): value is Spy;
+export {};
+//# sourceMappingURL=spy.d.ts.map

package/dist/runtime/vi/spy.d.ts.map

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

package/dist/runtime/vi/spy.js

@@ -0,0 +1,159 @@
+/**
+ * Spy core — a callable function that records every call and exposes a
+ * Vitest-shape `.mock` surface. Wears the `__helixIsSpy` brand so the
+ * matchers in `matchers.ts` (`toHaveBeenCalled*`) recognise it.
+ */
+/**
+ * Factory used by `vi.fn` and `vi.spyOn`. The returned function is both
+ * callable (executing the current implementation) and an object carrying
+ * `.mock`, the Helix brand, and the `mockFoo()` mutators.
+ */
+export function createSpy(options = {}) {
+    const onceQueue = [];
+    let currentImpl = options.defaultImplementation;
+    let restoreFn;
+    const mock = {
+        calls: [],
+        results: [],
+        lastCall: undefined,
+    };
+    const call = function (...args) {
+        mock.calls.push(args);
+        mock.lastCall = args;
+        // Push an incomplete result synchronously so `mock.results.length`
+        // always matches `mock.calls.length` (Vitest parity).
+        const result = {
+            type: "incomplete",
+            value: undefined,
+        };
+        mock.results.push(result);
+        const impl = onceQueue.shift() ?? currentImpl;
+        if (!impl) {
+            result.type = "return";
+            return undefined;
+        }
+        try {
+            const value = impl.apply(this, args);
+            result.type = "return";
+            result.value = value;
+            return value;
+        }
+        catch (err) {
+            result.type = "throw";
+            result.value = err;
+            throw err;
+        }
+    };
+    // `calls` and `callCount` must be LIVE accessors. Defining them in an
+    // object literal and passing through `Object.assign` would snapshot the
+    // getter's current value (Object.assign invokes [[Get]] on the source).
+    const methods = {
+        __helixIsSpy: true,
+        mock,
+        mockImplementation(fn) {
+            currentImpl = fn;
+            return spy;
+        },
+        mockImplementationOnce(fn) {
+            onceQueue.push(fn);
+            return spy;
+        },
+        mockReturnValue(value) {
+            currentImpl = () => value;
+            return spy;
+        },
+        mockReturnValueOnce(value) {
+            onceQueue.push(() => value);
+            return spy;
+        },
+        mockResolvedValue(value) {
+            currentImpl = () => Promise.resolve(value);
+            return spy;
+        },
+        mockResolvedValueOnce(value) {
+            onceQueue.push(() => Promise.resolve(value));
+            return spy;
+        },
+        mockRejectedValue(reason) {
+            currentImpl = () => Promise.reject(reason);
+            return spy;
+        },
+        mockRejectedValueOnce(reason) {
+            onceQueue.push(() => Promise.reject(reason));
+            return spy;
+        },
+        mockClear() {
+            mock.calls.length = 0;
+            mock.results.length = 0;
+            mock.lastCall = undefined;
+            return spy;
+        },
+        mockReset() {
+            spy.mockClear();
+            onceQueue.length = 0;
+            // On a `vi.fn` (no `restoreFn`) Vitest clears the implementation
+            // entirely. On a `spyOn` spy, restoring to the call-through
+            // `defaultImplementation` is the right behaviour.
+            currentImpl = restoreFn ? options.defaultImplementation : undefined;
+            return spy;
+        },
+        mockRestore() {
+            // Atomic order: swap `restoreFn` out of the closure BEFORE calling
+            // it, so a re-entrant `mockRestore` during the user's restore hook
+            // doesn't double-fire. If the hook throws, the spy is considered
+            // restored (best we can do) and the error propagates.
+            const hook = restoreFn;
+            restoreFn = undefined;
+            spy.mockReset();
+            hook?.();
+            return spy;
+        },
+        __setRestore(fn) {
+            restoreFn = fn;
+            isSpyOn = true;
+        },
+    };
+    // Sticky flag: once a spy is created via spyOn (`__setRestore` called),
+    // it stays "spyOn-flavoured" even after `mockRestore()` clears
+    // `restoreFn`. This matters for `restoreAllMocks` which must distinguish
+    // pass-through spies from bare `vi.fn` spies independently of their
+    // restoration state.
+    let isSpyOn = false;
+    const withMethods = Object.assign(call, methods);
+    Object.defineProperties(withMethods, {
+        calls: {
+            configurable: true,
+            enumerable: false,
+            get() {
+                return mock.calls;
+            },
+        },
+        callCount: {
+            configurable: true,
+            enumerable: false,
+            get() {
+                return mock.calls.length;
+            },
+        },
+        __isSpyOn: {
+            configurable: true,
+            enumerable: false,
+            get() {
+                return isSpyOn;
+            },
+        },
+    });
+    const spy = withMethods;
+    Object.defineProperty(spy, "name", {
+        value: options.name ?? "spy",
+        configurable: true,
+    });
+    return spy;
+}
+export function isSpy(value) {
+    if (!value || (typeof value !== "function" && typeof value !== "object")) {
+        return false;
+    }
+    return value.__helixIsSpy === true;
+}
+//# sourceMappingURL=spy.js.map

package/dist/runtime/vi/spy.js.map

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

package/dist/runtime/vi/spyOn.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `vi.spyOn(obj, key)` — replaces `obj[key]` with a spy that calls through
+ * to the original. `spy.mockRestore()` puts the original back.
+ *
+ * Supports:
+ *   - data properties whose value is a function (most methods);
+ *   - accessor properties (`get` / `set`);
+ *   - methods inherited via the prototype chain (the spy is installed as an
+ *     own property on the target, and `mockRestore()` deletes the own
+ *     property so inheritance resumes).
+ *
+ * `this` binding: the spy's default implementation uses a `function` form
+ * (not arrow) so the caller's receiver is forwarded to the original. This
+ * is essential when spying on a prototype method that depends on `this`.
+ *
+ * Double-spy detection: throws if the property is already a Helix spy, to
+ * avoid the subtle double-counting bug where the inner spy's `calls` is
+ * incremented by pass-through from the outer one.
+ */
+import { type Spy } from "./spy.js";
+type AccessorKind = "get" | "set";
+export interface SpyOnOptions {
+    /** For accessor properties, which side to spy on. Default: `"get"`. */
+    accessor?: AccessorKind;
+}
+export declare function spyOn<Obj extends object, Key extends keyof Obj>(obj: Obj, key: Key, options?: SpyOnOptions): Spy;
+export {};
+//# sourceMappingURL=spyOn.d.ts.map

package/dist/runtime/vi/spyOn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spyOn.d.ts","sourceRoot":"","sources":["../../../src/runtime/vi/spyOn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAgC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAElE,KAAK,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAElC,MAAM,WAAW,YAAY;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB;AAoCD,wBAAgB,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,GAAG,EAC9D,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,YAAiB,GACxB,GAAG,CAuFL"}