ditox 1.4.1 → 2.2.0

package/dist/cjs/utils.js.map

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

package/dist/esm/ditox.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @ignore
+ * Binding token for mandatory value
+ */
+export declare type RequiredToken<T> = {
+    symbol: symbol;
+    type?: T;
+    isOptional?: false;
+};
+/**
+ * @ignore
+ * Binding token for optional value
+ */
+export declare type OptionalToken<T> = {
+    symbol: symbol;
+    type?: T;
+    isOptional: true;
+    optionalValue: T;
+};
+/**
+ * Binding token.
+ */
+export declare type Token<T> = RequiredToken<T> | OptionalToken<T>;
+/**
+ * Creates a new binding token.
+ * @param description - Token description for better error messages.
+ */
+export declare function token<T>(description?: string): Token<T>;
+/**
+ * Decorate a token with an optional value.
+ * This value is be used as default value in case a container does not have registered token.
+ * @param token - Existed token.
+ * @param optionalValue - Default value for the resolver.
+ */
+export declare function optional<T>(token: Token<T>, optionalValue: T): OptionalToken<T>;
+export declare function optional<T>(token: Token<T>): OptionalToken<T | undefined>;
+/**
+ * ResolverError is thrown by the resolver when a token is not found in a container.
+ */
+export declare class ResolverError extends Error {
+    constructor(message: string);
+}
+/**
+ * @see https://github.com/mnasyrov/ditox#factory-lifetimes
+ */
+export declare type FactoryScope = 'scoped' | 'singleton' | 'transient';
+/**
+ * Options for factory binding.
+ *
+ * `scope` types:
+ *   - `singleton` - **This is the default**. The value is created and cached by the container which registered the factory.
+ *   - `scoped` - The value is created and cached by the container which starts resolving.
+ *   - `transient` - The value is created every time it is resolved.
+ *
+ * `scoped` and `singleton` scopes can have `onRemoved` callback. It is called when a token is removed from the container.
+ */
+export declare type FactoryOptions<T> = {
+    scope?: 'scoped' | 'singleton';
+    onRemoved?: (value: T) => void;
+} | {
+    scope: 'transient';
+};
+/**
+ * Dependency container.
+ */
+export declare type Container = {
+    /**
+     * Binds a value for the token
+     */
+    bindValue<T>(token: Token<T>, value: T): void;
+    /**
+     * Binds a factory for the token.
+     */
+    bindFactory<T>(token: Token<T>, factory: (container: Container) => T, options?: FactoryOptions<T>): void;
+    /**
+     * Checks if the token is registered in the container hierarchy.
+     */
+    hasToken(token: Token<unknown>): boolean;
+    /**
+     * Returns a resolved value by the token, or returns `undefined` in case the token is not found.
+     */
+    get<T>(token: Token<T>): T | undefined;
+    /**
+     * Returns a resolved value by the token, or throws `ResolverError` in case the token is not found.
+     */
+    resolve<T>(token: Token<T>): T;
+    /**
+     * Removes a binding for the token.
+     */
+    remove<T>(token: Token<T>): void;
+    /**
+     * Removes all bindings in the container.
+     */
+    removeAll(): void;
+};
+/** @internal */
+export declare const CONTAINER: Token<Container>;
+/** @internal */
+export declare const PARENT_CONTAINER: Token<Container>;
+/** @internal */
+export declare const RESOLVER: Token<Resolver>;
+/** @internal */
+declare const NOT_FOUND: unique symbol;
+/** @internal */
+export declare const FAKE_FACTORY: () => never;
+/** @internal */
+declare type FactoryContext<T> = {
+    factory: (container: Container) => T;
+    options?: FactoryOptions<T>;
+};
+/** @internal */
+export declare type FactoriesMap = Map<symbol, FactoryContext<any>>;
+/** @internal */
+export declare const FACTORIES_MAP: Token<FactoriesMap>;
+/** @internal */
+declare type Resolver = <T>(token: Token<T>, origin: Container) => T | typeof NOT_FOUND;
+/**
+ * Creates a new dependency container.
+ *
+ * Container can have an optional parent to chain token resolution. The parent is used in case the current container does not have a registered token.
+ *
+ * @param parentContainer - Optional parent container.
+ */
+export declare function createContainer(parentContainer?: Container): Container;
+export {};

package/{lib/index.js → dist/esm/ditox.js}

@@ -2,10 +2,10 @@
  * Creates a new binding token.
  * @param description - Token description for better error messages.
  */
-function token(description) {
+export function token(description) {
     return { symbol: Symbol(description) };
 }
-function optional(token, optionalValue) {
+export function optional(token, optionalValue) {
     return {
         symbol: token.symbol,
         isOptional: true,
@@ -15,7 +15,7 @@ function optional(token, optionalValue) {
 /**
  * ResolverError is thrown by the resolver when a token is not found in a container.
  */
-class ResolverError extends Error {
+export class ResolverError extends Error {
     constructor(message) {
         super(message);
         Object.setPrototypeOf(this, new.target.prototype);
@@ -23,21 +23,21 @@ class ResolverError extends Error {
     }
 }
 /** @internal */
-const CONTAINER = token('ditox.Container');
+export const CONTAINER = token('ditox.Container');
 /** @internal */
-const PARENT_CONTAINER = token('ditox.ParentContainer');
+export const PARENT_CONTAINER = token('ditox.ParentContainer');
 /** @internal */
-const RESOLVER = token('ditox.Resolver');
+export const RESOLVER = token('ditox.Resolver');
 /** @internal */
 const NOT_FOUND = Symbol();
 /** @internal */
-const FAKE_FACTORY = () => {
+export const FAKE_FACTORY = () => {
     throw new Error('FAKE_FACTORY');
 };
 /** @internal */
 const DEFAULT_SCOPE = 'singleton';
 /** @internal */
-const FACTORIES_MAP = token('ditox.FactoriesMap');
+export const FACTORIES_MAP = token('ditox.FactoriesMap');
 /** @internal */
 function getScope(options) {
     var _a;
@@ -64,7 +64,7 @@ function isInternalToken(token) {
  *
  * @param parentContainer - Optional parent container.
  */
-function createContainer(parentContainer) {
+export function createContainer(parentContainer) {
     const values = new Map();
     const factories = new Map();
     const container = {
@@ -199,195 +199,4 @@ function createContainer(parentContainer) {
     bindInternalTokens();
     return container;
 }
-
-/**
- * Rebinds the array by the token with added new value.
- * @param container - Dependency container.
- * @param token - Token for an array of values.
- * @param value - New value which is added to the end of the array.
- */
-function bindMultiValue(container, token, value) {
-    var _a;
-    const prevValues = (_a = container.get(token)) !== null && _a !== void 0 ? _a : [];
-    const nextValues = [...prevValues, value];
-    container.bindValue(token, nextValues);
-}
-/**
- * Returns an array of resolved values by the specified token.
- * If a token is not found, then `undefined` value is used.
- */
-function getValues(container, ...tokens) {
-    return tokens.map(container.get);
-}
-/**
- * Returns an array of resolved values by the specified token.
- * If a token is not found, then `ResolverError` is thrown.
- */
-function resolveValues(container, ...tokens) {
-    return tokens.map(container.resolve);
-}
-/**
- * Decorates a factory by passing resolved tokens as factory arguments.
- * @param factory - A factory.
- * @param tokens - Tokens which correspond to factory arguments.
- * @return Decorated factory which takes a dependency container as a single argument.
- */
-function injectable(factory, ...tokens) {
-    return (container) => {
-        const values = resolveValues(container, ...tokens);
-        return factory.apply(this, values);
-    };
-}
-/**
- * Returns an object with resolved properties which are specified by token properties.
- * If a token is not found, then `undefined` value is used.
- *
- * @example
- * ```ts
- * const props = getProps(container, {a: tokenA, b: tokenB});
- * console.log(props); // {a: 1, b: 2}
- * ```
- */
-function getProps(container, tokens) {
-    const obj = { ...tokens };
-    Object.keys(obj).forEach((key) => (obj[key] = container.get(obj[key])));
-    return obj;
-}
-/**
- * Returns an object with resolved properties which are specified by token properties.
- * If a token is not found, then `ResolverError` is thrown.
- *
- * @example
- * ```ts
- * const props = resolveProps(container, {a: tokenA, b: tokenB});
- * console.log(props); // {a: 1, b: 2}
- * ```
- */
-function resolveProps(container, tokens) {
-    const obj = { ...tokens };
-    Object.keys(obj).forEach((key) => (obj[key] = container.resolve(obj[key])));
-    return obj;
-}
-/**
- * Decorates a factory by passing a resolved object with tokens as the first argument.
- * @param factory - A factory.
- * @param tokens - Object with tokens.
- * @return Decorated factory which takes a dependency container as a single argument.
- *
- * @example
- * ```ts
- * const factory = ({a, b}: {a: number, b: number}) => a + b;
- * const decoratedFactory = injectableProps(factory, {a: tokenA, b: tokenB});
- * const result = decoratedFactory(container);
- * ```
- */
-function injectableProps(factory, tokens) {
-    return (container) => {
-        const values = resolveProps(container, tokens);
-        return factory(values);
-    };
-}
-
-/**
- * Binds the dependency module to the container
- * @param container - Dependency container.
- * @param moduleDeclaration - Declaration of the dependency module.
- * @param options - Options for module binding.
- *
- * @example
- * ```ts
- * bindModule(container, LOGGER_MODULE);
- * ```
- */
-function bindModule(container, moduleDeclaration, options) {
-    var _a;
-    const { token, imports, factory, beforeBinding, afterBinding } = moduleDeclaration;
-    const exports = (_a = moduleDeclaration.exports) !== null && _a !== void 0 ? _a : moduleDeclaration.exportedProps;
-    const scope = options === null || options === void 0 ? void 0 : options.scope;
-    if (beforeBinding) {
-        beforeBinding(container);
-    }
-    if (imports) {
-        bindModules(container, imports);
-    }
-    const exportedValueTokens = new Set();
-    if (exports) {
-        const keys = Object.keys(exports);
-        keys.forEach((valueKey) => {
-            const valueToken = exports[valueKey];
-            if (valueToken) {
-                exportedValueTokens.add(valueToken);
-                container.bindFactory(valueToken, injectable((module) => module[valueKey], token), { scope });
-            }
-        });
-    }
-    container.bindFactory(token, factory, {
-        scope,
-        onRemoved: (module) => {
-            if (module.destroy) {
-                module.destroy();
-            }
-            exportedValueTokens.forEach((valueToken) => container.remove(valueToken));
-            exportedValueTokens.clear();
-        },
-    });
-    if (afterBinding) {
-        afterBinding(container);
-    }
-}
-/**
- * Binds dependency modules to the container
- *
- * @param container - Dependency container for binding
- * @param modules - Array of module binding entries: module declaration or `{module: ModuleDeclaration, options: BindModuleOptions}` objects.
- */
-function bindModules(container, modules) {
-    modules.forEach((entry) => {
-        if ('module' in entry) {
-            bindModule(container, entry.module, entry.options);
-        }
-        else {
-            bindModule(container, entry);
-        }
-    });
-}
-/**
- * Declares a module binding
- *
- * @param declaration - a module declaration
- * @param declaration.token - optional field
- *
- *  @example
- * ```ts
- * const LOGGER_MODULE = declareModule<LoggerModule>({
- *   factory: (container) => {
- *     const transport = container.resolve(TRANSPORT_TOKEN).open();
- *     return {
- *       logger: { log: (message) => transport.write(message) },
- *       destroy: () => transport.close(),
- *     }
- *   },
- *   exports: {
- *     logger: LOGGER_TOKEN,
- *   },
- * });
- * ```
- */
-function declareModule(declaration) {
-    var _a;
-    return { ...declaration, token: (_a = declaration.token) !== null && _a !== void 0 ? _a : token() };
-}
-/**
- * Declares bindings of several modules
- *
- * @param modules - module declaration entries
- */
-function declareModuleBindings(modules) {
-    return declareModule({
-        factory: () => ({}),
-        imports: modules,
-    });
-}
-
-export { ResolverError, bindModule, bindModules, bindMultiValue, createContainer, declareModule, declareModuleBindings, getProps, getValues, injectable, injectableProps, optional, resolveProps, resolveValues, token };
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=ditox.js.map

package/dist/esm/ditox.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+export { token, optional, ResolverError, createContainer } from './ditox';
+export type { RequiredToken, OptionalToken, Token, FactoryScope, FactoryOptions, Container, } from './ditox';
+export { isToken, bindMultiValue, tryResolveValue, tryResolveValues, resolveValue, resolveValues, injectable, injectableClass, } from './utils';
+export { bindModule, bindModules, declareModule, declareModuleBindings, } from './modules';
+export type { Module, ModuleDeclaration, BindModuleOptions, ModuleBindingEntry, } from './modules';

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export { token, optional, ResolverError, createContainer } from './ditox';
+export { isToken, bindMultiValue, tryResolveValue, tryResolveValues, resolveValue, resolveValues, injectable, injectableClass, } from './utils';
+export { bindModule, bindModules, declareModule, declareModuleBindings, } from './modules';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAC,MAAM,SAAS,CAAC;AAUxE,OAAO,EACL,OAAO,EACP,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,qBAAqB,GACtB,MAAM,WAAW,CAAC"}

package/dist/esm/modules.d.ts

@@ -0,0 +1,118 @@
+import { Container, Token } from './ditox';
+declare type AnyObject = Record<string, any>;
+declare type EmptyObject = Record<string, never>;
+declare type ModuleController = {
+    /** Dispose the module and clean its resources */
+    destroy?: () => void;
+};
+/**
+ * Dependency module
+ *
+ * @example
+ * ```ts
+ * type LoggerModule = Module<{
+ *   logger: Logger;
+ * }>;
+ * ```
+ */
+export declare type Module<ModuleProps extends AnyObject = EmptyObject> = ModuleController & ModuleProps;
+declare type GetModuleProps<T> = T extends Module<infer Props> ? Props : never;
+/**
+ * Description how to bind the module in declarative way.
+ *
+ * @example
+ * ```ts
+ * const LOGGER_MODULE: ModuleDeclaration<LoggerModule> = {
+ *   token: LOGGER_MODULE_TOKEN,
+ *   factory: (container) => {
+ *     const transport = container.resolve(TRANSPORT_TOKEN).open();
+ *     return {
+ *       logger: { log: (message) => transport.write(message) },
+ *       destroy: () => transport.close(),
+ *     }
+ *   },
+ *   exports: {
+ *     logger: LOGGER_TOKEN,
+ *   },
+ * };
+ * ```
+ */
+export declare type ModuleDeclaration<T extends Module<AnyObject>> = {
+    /** Token for the module */
+    token: Token<T>;
+    /** Modules for binding  */
+    imports?: ReadonlyArray<ModuleBindingEntry>;
+    /** Factory of the module */
+    factory: (container: Container) => T;
+    /** Dictionary of module properties which are bound to tokens. */
+    exports?: {
+        [K in keyof GetModuleProps<T>]?: Token<GetModuleProps<T>[K]>;
+    };
+    /** Callback could be used to prepare an environment. It is called before binding the module. */
+    beforeBinding?: (container: Container) => void;
+    /** Callback could be used to export complex dependencies from the module. It is called after binding the module.  */
+    afterBinding?: (container: Container) => void;
+};
+/**
+ * Options for module binding.
+ *
+ * `scope` types:
+ *   - `singleton` - **This is the default**. The module is created and cached by the container which registered the factory.
+ *   - `scoped` - The module is created and cached by the container which starts resolving.
+ */
+export declare type BindModuleOptions = {
+    scope?: 'scoped' | 'singleton';
+};
+export declare type ModuleBindingEntry = ModuleDeclaration<AnyObject> | {
+    module: ModuleDeclaration<AnyObject>;
+    options: BindModuleOptions;
+};
+/**
+ * Binds the dependency module to the container
+ * @param container - Dependency container.
+ * @param moduleDeclaration - Declaration of the dependency module.
+ * @param options - Options for module binding.
+ *
+ * @example
+ * ```ts
+ * bindModule(container, LOGGER_MODULE);
+ * ```
+ */
+export declare function bindModule<T extends Module<AnyObject>>(container: Container, moduleDeclaration: ModuleDeclaration<T>, options?: BindModuleOptions): void;
+/**
+ * Binds dependency modules to the container
+ *
+ * @param container - Dependency container for binding
+ * @param modules - Array of module binding entries: module declaration or `{module: ModuleDeclaration, options: BindModuleOptions}` objects.
+ */
+export declare function bindModules(container: Container, modules: ReadonlyArray<ModuleBindingEntry>): void;
+/**
+ * Declares a module binding
+ *
+ * @param declaration - a module declaration
+ * @param declaration.token - optional field
+ *
+ *  @example
+ * ```ts
+ * const LOGGER_MODULE = declareModule<LoggerModule>({
+ *   factory: (container) => {
+ *     const transport = container.resolve(TRANSPORT_TOKEN).open();
+ *     return {
+ *       logger: { log: (message) => transport.write(message) },
+ *       destroy: () => transport.close(),
+ *     }
+ *   },
+ *   exports: {
+ *     logger: LOGGER_TOKEN,
+ *   },
+ * });
+ * ```
+ */
+export declare function declareModule<T>(declaration: Omit<ModuleDeclaration<T>, 'token'> & Partial<Pick<ModuleDeclaration<T>, 'token'>>): ModuleDeclaration<T>;
+/**
+ * Declares bindings of several modules
+ *
+ * @param modules - module declaration entries
+ */
+export declare function declareModuleBindings(modules: ReadonlyArray<ModuleBindingEntry>): ModuleDeclaration<Module>;
+export {};

package/dist/esm/modules.js

@@ -0,0 +1,102 @@
+import { token } from './ditox';
+import { injectable } from './utils';
+/**
+ * Binds the dependency module to the container
+ * @param container - Dependency container.
+ * @param moduleDeclaration - Declaration of the dependency module.
+ * @param options - Options for module binding.
+ *
+ * @example
+ * ```ts
+ * bindModule(container, LOGGER_MODULE);
+ * ```
+ */
+export function bindModule(container, moduleDeclaration, options) {
+    const { token, imports, factory, beforeBinding, afterBinding } = moduleDeclaration;
+    const exports = moduleDeclaration.exports;
+    const scope = options === null || options === void 0 ? void 0 : options.scope;
+    if (beforeBinding) {
+        beforeBinding(container);
+    }
+    if (imports) {
+        bindModules(container, imports);
+    }
+    const exportedValueTokens = new Set();
+    if (exports) {
+        const keys = Object.keys(exports);
+        keys.forEach((valueKey) => {
+            const valueToken = exports[valueKey];
+            if (valueToken) {
+                exportedValueTokens.add(valueToken);
+                container.bindFactory(valueToken, injectable((module) => module[valueKey], token), { scope });
+            }
+        });
+    }
+    container.bindFactory(token, factory, {
+        scope,
+        onRemoved: (module) => {
+            if (module.destroy) {
+                module.destroy();
+            }
+            exportedValueTokens.forEach((valueToken) => container.remove(valueToken));
+            exportedValueTokens.clear();
+        },
+    });
+    if (afterBinding) {
+        afterBinding(container);
+    }
+}
+/**
+ * Binds dependency modules to the container
+ *
+ * @param container - Dependency container for binding
+ * @param modules - Array of module binding entries: module declaration or `{module: ModuleDeclaration, options: BindModuleOptions}` objects.
+ */
+export function bindModules(container, modules) {
+    modules.forEach((entry) => {
+        if ('module' in entry) {
+            bindModule(container, entry.module, entry.options);
+        }
+        else {
+            bindModule(container, entry);
+        }
+    });
+}
+/**
+ * Declares a module binding
+ *
+ * @param declaration - a module declaration
+ * @param declaration.token - optional field
+ *
+ *  @example
+ * ```ts
+ * const LOGGER_MODULE = declareModule<LoggerModule>({
+ *   factory: (container) => {
+ *     const transport = container.resolve(TRANSPORT_TOKEN).open();
+ *     return {
+ *       logger: { log: (message) => transport.write(message) },
+ *       destroy: () => transport.close(),
+ *     }
+ *   },
+ *   exports: {
+ *     logger: LOGGER_TOKEN,
+ *   },
+ * });
+ * ```
+ */
+export function declareModule(declaration) {
+    var _a;
+    return { ...declaration, token: (_a = declaration.token) !== null && _a !== void 0 ? _a : token() };
+}
+/**
+ * Declares bindings of several modules
+ *
+ * @param modules - module declaration entries
+ */
+export function declareModuleBindings(modules) {
+    return declareModule({
+        factory: () => ({}),
+        imports: modules,
+    });
+}
+//# sourceMappingURL=modules.js.map

package/dist/esm/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,EAAQ,MAAM,SAAS,CAAC;AAChD,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AAqFnC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACxB,SAAoB,EACpB,iBAAuC,EACvC,OAA2B;IAE3B,MAAM,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAC,GAC1D,iBAAiB,CAAC;IACpB,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC;IAE1C,MAAM,KAAK,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,CAAC;IAE7B,IAAI,aAAa,EAAE;QACjB,aAAa,CAAC,SAAS,CAAC,CAAC;KAC1B;IAED,IAAI,OAAO,EAAE;QACX,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;KACjC;IAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,IAAI,OAAO,EAAE;QACX,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAElC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YACxB,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,UAAU,EAAE;gBACd,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAEpC,SAAS,CAAC,WAAW,CACnB,UAAU,EACV,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,EAC/C,EAAC,KAAK,EAAC,CACR,CAAC;aACH;QACH,CAAC,CAAC,CAAC;KACJ;IAED,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE;QACpC,KAAK;QACL,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YACpB,IAAI,MAAM,CAAC,OAAO,EAAE;gBAClB,MAAM,CAAC,OAAO,EAAE,CAAC;aAClB;YAED,mBAAmB,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YAC1E,mBAAmB,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,YAAY,EAAE;QAChB,YAAY,CAAC,SAAS,CAAC,CAAC;KACzB;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,SAAoB,EACpB,OAA0C;IAE1C,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,IAAI,QAAQ,IAAI,KAAK,EAAE;YACrB,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;SACpD;aAAM;YACL,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;SAC9B;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAC3B,WAC8C;;IAE9C,OAAO,EAAC,GAAG,WAAW,EAAE,KAAK,EAAE,MAAA,WAAW,CAAC,KAAK,mCAAI,KAAK,EAAE,EAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA0C;IAE1C,OAAO,aAAa,CAAC;QACnB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;AACL,CAAC"}