@adaas/a-concept 0.1.23 → 0.1.25

package/dist/src/global/A-Feature/A-Feature-Extend.decorator.js

@@ -1,119 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_Feature_Extend = A_Feature_Extend;
-exports.buildTargetRegexp = buildTargetRegexp;
-const A_Context_class_1 = require("../A-Context/A-Context.class");
-const A_Meta_class_1 = require("../A-Meta/A-Meta.class");
-const A_TypeGuards_helper_1 = require("../../helpers/A_TypeGuards.helper");
-const A_Component_constants_1 = require("../A-Component/A-Component.constants");
-const A_Feature_error_1 = require("./A-Feature.error");
-function A_Feature_Extend(param1) {
-    return function (target, propertyKey, descriptor) {
-        var _a, _b, _c;
-        // for error messages
-        const componentName = ((_a = target === null || target === void 0 ? void 0 : target.constructor) === null || _a === void 0 ? void 0 : _a.name) || String(target) || 'Unknown';
-        if (!A_TypeGuards_helper_1.A_TypeGuards.isAllowedForFeatureExtension(target))
-            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureExtensionError, `A-Feature-Extend cannot be applied on the ${componentName} level`);
-        let targetRegexp;
-        let behavior = 'sync';
-        let before = [];
-        let after = [];
-        let include = [];
-        let exclude = [];
-        let throwOnError = true;
-        switch (true) {
-            case A_TypeGuards_helper_1.A_TypeGuards.isRegExp(param1):
-                targetRegexp = param1;
-                break;
-            case !!param1 && typeof param1 === 'object':
-                if (Array.isArray(param1.scope))
-                    include = param1.scope;
-                else if (!!param1.scope && typeof param1.scope === 'object') {
-                    if (Array.isArray(param1.scope.include))
-                        include = param1.scope.include;
-                    if (Array.isArray(param1.scope.exclude))
-                        exclude = param1.scope.exclude;
-                }
-                targetRegexp = buildTargetRegexp(param1, include, exclude, propertyKey);
-                behavior = param1.behavior || behavior;
-                throwOnError = param1.throwOnError !== undefined ? param1.throwOnError : throwOnError;
-                before = ((_b = param1.before) === null || _b === void 0 ? void 0 : _b.map(e => e instanceof RegExp
-                    ? e.source
-                    : new RegExp(`^.*${e.replace(/\./g, '\\.')}$`).source))
-                    || before;
-                after = ((_c = param1.after) === null || _c === void 0 ? void 0 : _c.map(e => e instanceof RegExp
-                    ? e.source
-                    : new RegExp(`^.*${e.replace(/\./g, '\\.')}$`).source))
-                    || after;
-                break;
-            default:
-                targetRegexp = new RegExp(`^.*${propertyKey.replace(/\./g, '\\.')}$`);
-                break;
-        }
-        const existedDefinitions = A_Context_class_1.A_Context
-            .meta(target)
-            .get(A_Component_constants_1.A_TYPES__ComponentMetaKey.FEATURES);
-        // Get the existed metadata or create a new one
-        const meta = A_Context_class_1.A_Context
-            .meta(target);
-        const existedMeta = meta.get(A_Component_constants_1.A_TYPES__ComponentMetaKey.EXTENSIONS)
-            ? new A_Meta_class_1.A_Meta().from(meta.get(A_Component_constants_1.A_TYPES__ComponentMetaKey.EXTENSIONS))
-            : new A_Meta_class_1.A_Meta();
-        if (existedDefinitions
-            && existedDefinitions.size()
-            && existedDefinitions.has(propertyKey)
-            && existedDefinitions.get(propertyKey).invoke) {
-            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureExtensionError, `A-Feature-Extend cannot be used on the method "${propertyKey}" because it is already defined as a Feature with "invoke" set to true. Please remove the A-Feature-Extend decorator or set "invoke" to false in the A-Feature decorator.`);
-        }
-        const existedMetaValue = [
-            ...(existedMeta.get(targetRegexp.source) || [])
-        ];
-        const existedIndex = existedMetaValue.findIndex(item => item.handler === propertyKey);
-        const extension = {
-            name: targetRegexp.source,
-            handler: propertyKey,
-            behavior,
-            before,
-            after,
-            throwOnError
-        };
-        if (existedIndex !== -1) {
-            // Update the existing method in the metadata
-            existedMetaValue[existedIndex] = extension;
-        }
-        else {
-            // Add the new method to the metadata
-            existedMetaValue.push(extension);
-        }
-        // Add the new method to the metadata
-        existedMetaValue.push();
-        // Set the metadata of the method to define a custom Feature with name
-        existedMeta.set(targetRegexp.source, existedMetaValue);
-        //  Update the metadata of the container with the new Feature definition
-        A_Context_class_1.A_Context
-            .meta(target)
-            .set(A_Component_constants_1.A_TYPES__ComponentMetaKey.EXTENSIONS, existedMeta);
-    };
-}
-/**
- * Builds a target regular expression based on the provided parameters.
- *
- * @param param1 - The first parameter, which can be a string or an object.
- * @param include - An array of items to include in the regular expression.
- * @param exclude - An array of items to exclude from the regular expression.
- * @param propertyKey - The property key to use in the regular expression.
- * @returns A regular expression object.
- */
-function buildTargetRegexp(param1, include, exclude, propertyKey) {
-    const includePart = include.length
-        ? `(${include.map(el => el.name).join('|')})`
-        : `.*`;
-    const excludePart = exclude.length
-        ? `(?!${exclude.map(el => el.name).join('|')})`
-        : ``;
-    const pattern = param1.scope
-        ? `^${excludePart}${includePart}\\.${param1.name || propertyKey}$`
-        : `.*\\.${param1.name || propertyKey}$`;
-    return new RegExp(pattern);
-}
-//# sourceMappingURL=A-Feature-Extend.decorator.js.map

package/dist/src/global/A-Feature/A-Feature-Extend.decorator.js.map

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

package/dist/src/global/A-Feature/A-Feature.class.d.ts

@@ -1,175 +0,0 @@
-import { A_TYPES__Feature_Init, A_TYPES__Feature_InitWithComponent, A_TYPES__Feature_InitWithTemplate, A_TYPES__FeatureAvailableComponents, A_TYPES__FeatureState } from "./A-Feature.types";
-import { A_Feature_Define } from "./A-Feature-Define.decorator";
-import { A_Feature_Extend } from "./A-Feature-Extend.decorator";
-import { A_Stage } from "../A-Stage/A-Stage.class";
-import { A_StepsManager } from "../A-StepManager/A-StepManager.class";
-import { A_StageError } from "../A-Stage/A-Stage.error";
-import { A_FeatureError } from "./A-Feature.error";
-import { A_Caller } from "../A-Caller/A_Caller.class";
-import { A_Scope } from "../A-Scope/A-Scope.class";
-/**
- * A_Feature is representing a feature that can be executed across multiple components
- * This class stores the steps of the feature and executes them in order of appearance
- *
- * Using A_Feature.Define and A_Feature.Extend decorators to define and extend the feature methods
- * across the different, distributed components
- *
- */
-export declare class A_Feature<T extends A_TYPES__FeatureAvailableComponents = A_TYPES__FeatureAvailableComponents> {
-    /**
-     * Define a new A-Feature
-     */
-    static get Define(): typeof A_Feature_Define;
-    /**
-     * Extend an existing A-Feature
-     */
-    static get Extend(): typeof A_Feature_Extend;
-    /**
-     * The name of the Feature
-     */
-    protected _name: string;
-    /**
-     * List of stages that are part of this Feature
-     */
-    protected _stages: Array<A_Stage>;
-    /**
-     * The Stage currently being processed
-     */
-    protected _current?: A_Stage;
-    /**
-     * Actual Index of the current Stage being processed
-     */
-    protected _index: number;
-    /**
-     * Steps Manager to organize the steps into stages
-     */
-    protected _SM: A_StepsManager;
-    /**
-     * The Caller that initiated the Feature call
-     */
-    protected _caller: A_Caller<T>;
-    /**
-     * The current state of the Feature
-     */
-    protected _state: A_TYPES__FeatureState;
-    /**
-     * The error that caused the Feature to be interrupted
-     */
-    protected _error?: A_FeatureError;
-    /**
-     * A-Feature is a pipeline distributed by multiple components that can be easily attached or detached from the scope.
-     * Feature itself does not have scope, but attached to the caller who dictates how feature should be processed.
-     *
-     * Comparing to A-Command Feature does not store any state except statuses for better analysis.
-     *
-     * [!] Note: If A-Feature should have result use A-Fragment
-     *
-     * @param params
-     */
-    constructor(
-    /**
-     * Feature Initialization parameters
-     */
-    params: A_TYPES__Feature_Init<T>);
-    /**
-     * The name of the Feature
-     */
-    get name(): string;
-    /**
-     * The error that caused the Feature to be interrupted
-     */
-    get error(): A_FeatureError | undefined;
-    /**
-     * The current state of the Feature
-     */
-    get state(): A_TYPES__FeatureState;
-    /**
-     * Sets the current state of the Feature
-     */
-    get index(): number;
-    /**
-     * Returns the current A-Feature Stage
-     */
-    get stage(): A_Stage | undefined;
-    /**
-     * The Caller that initiated the Feature call
-     */
-    get caller(): A_Caller<T>;
-    /**
-     * The Scope allocated for the Feature Execution
-     */
-    get scope(): A_Scope;
-    /**
-     * This method checks if the A-Feature is done
-     *
-     * @returns
-     */
-    get isDone(): boolean;
-    /**
-     * Iterator to iterate over the steps of the feature
-     *
-     * @returns
-     */
-    [Symbol.iterator](): Iterator<A_Stage, any>;
-    /**
-     * Validates the provided parameters for A-Feature initialization
-     *
-     * @param params
-     */
-    protected validateParams(params: A_TYPES__Feature_Init<T>): void;
-    /**
-     * Returns the appropriate initializer method based on the provided parameters
-     *
-     * @param params
-     * @returns
-     */
-    protected getInitializer(params: A_TYPES__Feature_Init<T>): (param1: any) => void | (() => void);
-    /**
-     * Initializes the A-Feature from the provided template
-     *
-     * @param params
-     */
-    protected fromTemplate(params: A_TYPES__Feature_InitWithTemplate<T>): void;
-    /**
-     * Initializes the A-Feature from the provided component
-     *
-     * @param params
-     */
-    protected fromComponent(params: A_TYPES__Feature_InitWithComponent<T>): void;
-    /**
-     * This method processes the feature by executing all the stages
-     *
-     */
-    process(
-    /**
-     * Optional scope to be used to resolve the steps dependencies
-     * If not provided, the scope of the caller component will be used
-     */
-    scope?: A_Scope): Promise<void>;
-    /**
-     * This method moves the feature to the next stage
-     *
-     * @param stage
-     */
-    next(stage: any): void;
-    /**
-     * This method marks the feature as completed and returns the result
-     * Uses to interrupt or end the feature processing
-     *
-     * @param result
-     * @returns
-     */
-    completed(): Promise<void>;
-    /**
-     * This method marks the feature as failed and throws an error
-     * Uses to interrupt or end the feature processing
-     *
-     * @param error
-     */
-    interrupt(
-    /**
-     * The reason of feature interruption
-     */
-    reason?: string | A_StageError | Error): Promise<void>;
-    toString(): string;
-}

package/dist/src/global/A-Feature/A-Feature.class.js

@@ -1,318 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_Feature = void 0;
-const A_Feature_types_1 = require("./A-Feature.types");
-const A_Feature_Define_decorator_1 = require("./A-Feature-Define.decorator");
-const A_Feature_Extend_decorator_1 = require("./A-Feature-Extend.decorator");
-const A_StepManager_class_1 = require("../A-StepManager/A-StepManager.class");
-const A_TypeGuards_helper_1 = require("../../helpers/A_TypeGuards.helper");
-const A_Feature_error_1 = require("./A-Feature.error");
-const A_Context_class_1 = require("../A-Context/A-Context.class");
-const A_Caller_class_1 = require("../A-Caller/A_Caller.class");
-const A_Scope_class_1 = require("../A-Scope/A-Scope.class");
-const A_Component_class_1 = require("../A-Component/A-Component.class");
-/**
- * A_Feature is representing a feature that can be executed across multiple components
- * This class stores the steps of the feature and executes them in order of appearance
- *
- * Using A_Feature.Define and A_Feature.Extend decorators to define and extend the feature methods
- * across the different, distributed components
- *
- */
-class A_Feature {
-    // =============================================================================
-    // --------------------------- Static Methods ---------------------------------
-    // =============================================================================
-    /**
-     * Define a new A-Feature
-     */
-    static get Define() {
-        return A_Feature_Define_decorator_1.A_Feature_Define;
-    }
-    /**
-     * Extend an existing A-Feature
-     */
-    static get Extend() {
-        return A_Feature_Extend_decorator_1.A_Feature_Extend;
-    }
-    /**
-     * A-Feature is a pipeline distributed by multiple components that can be easily attached or detached from the scope.
-     * Feature itself does not have scope, but attached to the caller who dictates how feature should be processed.
-     *
-     * Comparing to A-Command Feature does not store any state except statuses for better analysis.
-     *
-     * [!] Note: If A-Feature should have result use A-Fragment
-     *
-     * @param params
-     */
-    constructor(
-    /**
-     * Feature Initialization parameters
-     */
-    params) {
-        /**
-         * List of stages that are part of this Feature
-         */
-        this._stages = [];
-        /**
-         * Actual Index of the current Stage being processed
-         */
-        this._index = 0;
-        /**
-         * The current state of the Feature
-         */
-        this._state = A_Feature_types_1.A_TYPES__FeatureState.INITIALIZED;
-        this.validateParams(params);
-        const initializer = this.getInitializer(params);
-        // the returned initializer is already bound to `this` (we used .bind(this)),
-        // so calling it will run the appropriate logic on this instance:
-        initializer.call(this, params);
-    }
-    /**
-     * The name of the Feature
-     */
-    get name() { return this._name; }
-    /**
-     * The error that caused the Feature to be interrupted
-     */
-    get error() { return this._error; }
-    /**
-     * The current state of the Feature
-     */
-    get state() { return this._state; }
-    /**
-     * Sets the current state of the Feature
-     */
-    get index() { return this._index; }
-    /**
-     * Returns the current A-Feature Stage
-     */
-    get stage() { return this._current; }
-    /**
-     * The Caller that initiated the Feature call
-     */
-    get caller() { return this._caller; }
-    /**
-     * The Scope allocated for the Feature Execution
-     */
-    get scope() { return A_Context_class_1.A_Context.scope(this); }
-    /**
-     * This method checks if the A-Feature is done
-     *
-     * @returns
-     */
-    get isDone() {
-        return !this.stage
-            || this._index >= this._stages.length
-            || this.state === A_Feature_types_1.A_TYPES__FeatureState.COMPLETED
-            || this.state === A_Feature_types_1.A_TYPES__FeatureState.INTERRUPTED;
-    }
-    /**
-     * Iterator to iterate over the steps of the feature
-     *
-     * @returns
-     */
-    [Symbol.iterator]() {
-        return {
-            next: () => {
-                if (!this.isDone) {
-                    this._current = this._stages[this._index];
-                    this._index++;
-                    return {
-                        value: this._current,
-                        done: false
-                    };
-                }
-                else {
-                    this._current = undefined; // Reset current on end
-                    return {
-                        value: undefined,
-                        done: true
-                    };
-                }
-            }
-        };
-    }
-    // ============================================================================
-    // ------------------------ Initialization Methods ----------------------------
-    // ============================================================================
-    /**
-     * Validates the provided parameters for A-Feature initialization
-     *
-     * @param params
-     */
-    validateParams(params) {
-        if (!params || typeof params !== 'object') {
-            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureInitializationError, `Invalid A-Feature initialization parameters of type: ${typeof params} with value: ${JSON.stringify(params).slice(0, 100)}...`);
-        }
-    }
-    /**
-     * Returns the appropriate initializer method based on the provided parameters
-     *
-     * @param params
-     * @returns
-     */
-    getInitializer(params) {
-        switch (true) {
-            case !('template' in params):
-                return this.fromComponent;
-            case 'template' in params:
-                return this.fromTemplate;
-            default:
-                throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureInitializationError, `Invalid A-Feature initialization parameters of type: ${typeof params} with value: ${JSON.stringify(params).slice(0, 100)}...`);
-        }
-    }
-    /**
-     * Initializes the A-Feature from the provided template
-     *
-     * @param params
-     */
-    fromTemplate(params) {
-        if (!params.template || !Array.isArray(params.template)) {
-            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureInitializationError, `Invalid A-Feature template provided of type: ${typeof params.template} with value: ${JSON.stringify(params.template).slice(0, 100)}...`);
-        }
-        if (!params.component && (!params.scope || !(params.scope instanceof A_Scope_class_1.A_Scope))) {
-            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureInitializationError, `Invalid A-Feature scope provided of type: ${typeof params.scope} with value: ${JSON.stringify(params.scope).slice(0, 100)}...`);
-        }
-        // 1) save feature name
-        this._name = params.name;
-        // 2) get scope from where feature is called
-        const componentScope = params.component
-            ? A_Context_class_1.A_Context.scope(params.component)
-            : params.scope;
-        // 3) create caller wrapper for the simple injection of the caller component
-        //   - Just to prevent issues with undefined caller in features without component
-        //   - TODO: maybe would be better to allow passing caller in params?
-        this._caller = new A_Caller_class_1.A_Caller(params.component || new A_Component_class_1.A_Component());
-        // 4) allocate new scope for the feature
-        const scope = A_Context_class_1.A_Context.allocate(this);
-        // 5) ensure that the scope of the caller component is inherited by the feature scope
-        scope.inherit(componentScope);
-        // 6) create steps manager to organize steps into stages
-        this._SM = new A_StepManager_class_1.A_StepsManager(params.template);
-        // 7) create stages from the steps
-        this._stages = this._SM.toStages(this);
-        // 8) set the first stage as current
-        this._current = this._stages[0];
-    }
-    /**
-     * Initializes the A-Feature from the provided component
-     *
-     * @param params
-     */
-    fromComponent(params) {
-        if (!params.component || !A_TypeGuards_helper_1.A_TypeGuards.isAllowedForFeatureDefinition(params.component)) {
-            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureInitializationError, `Invalid A-Feature component provided of type: ${typeof params.component} with value: ${JSON.stringify(params.component).slice(0, 100)}...`);
-        }
-        // 1) save feature name
-        this._name = params.name;
-        // 2) get scope from where feature is called
-        const componentScope = A_Context_class_1.A_Context.scope(params.component);
-        // 3) create caller wrapper for the simple injection of the caller component
-        this._caller = new A_Caller_class_1.A_Caller(params.component);
-        // 4) allocate new scope for the feature
-        const scope = A_Context_class_1.A_Context.allocate(this);
-        // 5) ensure that the scope of the caller component is inherited by the feature scope
-        scope.inherit(componentScope);
-        // 6) retrieve the template from the context
-        const template = A_Context_class_1.A_Context.featureTemplate(this._name, this._caller.component, scope);
-        // 7) create steps manager to organize steps into stages
-        this._SM = new A_StepManager_class_1.A_StepsManager(template);
-        // 8) create stages from the steps
-        this._stages = this._SM.toStages(this);
-        // 9) set the first stage as current
-        this._current = this._stages[0];
-    }
-    // ============================================================================
-    // ----------------------- Main Processing Methods ----------------------------
-    // ============================================================================
-    /**
-     * This method processes the feature by executing all the stages
-     *
-     */
-    process(
-    /**
-     * Optional scope to be used to resolve the steps dependencies
-     * If not provided, the scope of the caller component will be used
-     */
-    scope) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (this.isDone)
-                return;
-            this._state = A_Feature_types_1.A_TYPES__FeatureState.PROCESSING;
-            for (const stage of this) {
-                yield stage.process(scope);
-            }
-            return yield this.completed();
-        });
-    }
-    /**
-     * This method moves the feature to the next stage
-     *
-     * @param stage
-     */
-    next(stage) {
-        const stageIndex = this._stages.indexOf(stage);
-        this._index = stageIndex + 1;
-        if (this._index >= this._stages.length) {
-            this.completed();
-        }
-    }
-    /**
-     * This method marks the feature as completed and returns the result
-     * Uses to interrupt or end the feature processing
-     *
-     * @param result
-     * @returns
-     */
-    completed() {
-        return __awaiter(this, void 0, void 0, function* () {
-            this._state = A_Feature_types_1.A_TYPES__FeatureState.COMPLETED;
-        });
-    }
-    /**
-     * This method marks the feature as failed and throws an error
-     * Uses to interrupt or end the feature processing
-     *
-     * @param error
-     */
-    interrupt(
-    /**
-     * The reason of feature interruption
-     */
-    reason) {
-        return __awaiter(this, void 0, void 0, function* () {
-            switch (true) {
-                case A_TypeGuards_helper_1.A_TypeGuards.isString(reason):
-                    this._error = new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.Interruption, reason);
-                    break;
-                case A_TypeGuards_helper_1.A_TypeGuards.isErrorInstance(reason):
-                    this._error = new A_Feature_error_1.A_FeatureError({
-                        code: A_Feature_error_1.A_FeatureError.Interruption,
-                        title: reason.title,
-                        description: reason.description,
-                        originalError: reason
-                    });
-                    break;
-                default:
-                    break;
-            }
-            this._state = A_Feature_types_1.A_TYPES__FeatureState.INTERRUPTED;
-        });
-    }
-    toString() {
-        var _a, _b;
-        return `A-Feature(${((_b = (_a = this.caller.component) === null || _a === void 0 ? void 0 : _a.constructor) === null || _b === void 0 ? void 0 : _b.name) || 'Unknown'}::${this.name})`;
-    }
-}
-exports.A_Feature = A_Feature;
-//# sourceMappingURL=A-Feature.class.js.map

package/dist/src/global/A-Feature/A-Feature.class.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"A-Feature.class.js","sourceRoot":"","sources":["../../../../src/global/A-Feature/A-Feature.class.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,uDAM2B;AAC3B,6GAAgG;AAChG,6GAAgG;AAEhG,mGAA2F;AAE3F,sFAA4E;AAC5E,uDAAmD;AACnD,kEAAyD;AACzD,+DAAsD;AACtD,4DAAmD;AACnD,wEAA+D;AAG/D;;;;;;;GAOG;AACH,MAAa,SAAS;IAElB,gFAAgF;IAChF,+EAA+E;IAC/E,gFAAgF;IAChF;;OAEG;IACH,MAAM,KAAK,MAAM;QACb,OAAO,6CAAgB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,MAAM,KAAK,MAAM;QACb,OAAO,6CAAgB,CAAC;IAC5B,CAAC;IAuCD;;;;;;;;;OASG;IACH;IACI;;OAEG;IACH,MAAgC;QA7CpC;;WAEG;QACO,YAAO,GAAmB,EAAE,CAAC;QAKvC;;WAEG;QACO,WAAM,GAAW,CAAC,CAAC;QAS7B;;WAEG;QACO,WAAM,GAA0B,uCAAqB,CAAC,WAAW,CAAC;QAwBxE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAChD,6EAA6E;QAC7E,iEAAiE;QACjE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAGD;;OAEG;IACH,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC;;OAEG;IACH,IAAI,KAAK,KAAiC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D;;OAEG;IACH,IAAI,KAAK,KAA4B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D;;OAEG;IACH,IAAI,KAAK,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C;;OAEG;IACH,IAAI,KAAK,KAA0B,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1D;;OAEG;IACH,IAAI,MAAM,KAAkB,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD;;OAEG;IACH,IAAI,KAAK,KAAc,OAAO,2BAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEtD;;;;OAIG;IACH,IAAI,MAAM;QACN,OAAO,CAAC,IAAI,CAAC,KAAK;eACX,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;eAClC,IAAI,CAAC,KAAK,KAAK,uCAAqB,CAAC,SAAS;eAC9C,IAAI,CAAC,KAAK,KAAK,uCAAqB,CAAC,WAAW,CAAC;IAC5D,CAAC;IACD;;;;OAIG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC;QACb,OAAO;YACH,IAAI,EAAE,GAAiC,EAAE;gBACrC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACf,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;oBAEd,OAAO;wBACH,KAAK,EAAE,IAAI,CAAC,QAAQ;wBACpB,IAAI,EAAE,KAAK;qBACd,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,uBAAuB;oBAElD,OAAO;wBACH,KAAK,EAAE,SAAS;wBAChB,IAAI,EAAE,IAAI;qBACb,CAAC;gBACN,CAAC;YACL,CAAC;SACJ,CAAC;IACN,CAAC;IAED,+EAA+E;IAC/E,+EAA+E;IAC/E,+EAA+E;IAC/E;;;;OAIG;IACO,cAAc,CACpB,MAAgC;QAEhC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,gCAAc,CACpB,gCAAc,CAAC,0BAA0B,EACzC,wDAAwD,OAAO,MAAM,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CACjI,CAAC;QACN,CAAC;IACL,CAAC;IACD;;;;;OAKG;IACO,cAAc,CACpB,MAAgC;QAGhC,QAAQ,IAAI,EAAE,CAAC;YACX,KAAK,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC;gBACxB,OAAO,IAAI,CAAC,aAAa,CAAC;YAE9B,KAAK,UAAU,IAAI,MAAM;gBACrB,OAAO,IAAI,CAAC,YAAY,CAAC;YAC7B;gBACI,MAAM,IAAI,gCAAc,CACpB,gCAAc,CAAC,0BAA0B,EACzC,wDAAwD,OAAO,MAAM,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CACjI,CAAC;QACV,CAAC;IACL,CAAC;IACD;;;;OAIG;IACO,YAAY,CAClB,MAA4C;QAE5C,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,gCAAc,CACpB,gCAAc,CAAC,0BAA0B,EACzC,gDAAgD,OAAO,MAAM,CAAC,QAAQ,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAC3I,CAAC;QACN,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,YAAY,uBAAO,CAAC,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,gCAAc,CACpB,gCAAc,CAAC,0BAA0B,EACzC,6CAA6C,OAAO,MAAM,CAAC,KAAK,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAClI,CAAC;QACN,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QAEzB,4CAA4C;QAC5C,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS;YACnC,CAAC,CAAC,2BAAS,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;YACnC,CAAC,CAAC,MAAM,CAAC,KAAgB,CAAC;QAE9B,4EAA4E;QAC5E,iFAAiF;QACjF,qEAAqE;QACrE,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAQ,CAAI,MAAM,CAAC,SAAS,IAAI,IAAI,+BAAW,EAAO,CAAC,CAAC;QAE3E,wCAAwC;QACxC,MAAM,KAAK,GAAG,2BAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEvC,qFAAqF;QACrF,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAE9B,wDAAwD;QACxD,IAAI,CAAC,GAAG,GAAG,IAAI,oCAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE/C,kCAAkC;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEvC,oCAAoC;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IACD;;;;OAIG;IACO,aAAa,CACnB,MAA6C;QAE7C,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,kCAAY,CAAC,6BAA6B,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACrF,MAAM,IAAI,gCAAc,CACpB,gCAAc,CAAC,0BAA0B,EACzC,iDAAiD,OAAO,MAAM,CAAC,SAAS,gBAAgB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAC9I,CAAC;QACN,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QAEzB,4CAA4C;QAC5C,MAAM,cAAc,GAAG,2BAAS,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEzD,4EAA4E;QAC5E,IAAI,CAAC,OAAO,GAAG,IAAI,yBAAQ,CAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QAEjD,wCAAwC;QACxC,MAAM,KAAK,GAAG,2BAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEvC,qFAAqF;QACrF,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAE9B,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,2BAAS,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAEtF,wDAAwD;QACxD,IAAI,CAAC,GAAG,GAAG,IAAI,oCAAc,CAAC,QAAQ,CAAC,CAAC;QAExC,kCAAkC;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEvC,oCAAoC;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAGD,+EAA+E;IAC/E,+EAA+E;IAC/E,+EAA+E;IAC/E;;;OAGG;IACG,OAAO;IACT;;;OAGG;IACH,KAAe;;YAEf,IAAI,IAAI,CAAC,MAAM;gBACX,OAAO;YAEX,IAAI,CAAC,MAAM,GAAG,uCAAqB,CAAC,UAAU,CAAC;YAE/C,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YAED,OAAO,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,CAAC;KAAA;IACD;;;;OAIG;IACH,IAAI,CAAC,KAAK;QACN,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,CAAC,MAAM,GAAG,UAAU,GAAG,CAAC,CAAC;QAE7B,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QACrB,CAAC;IACL,CAAC;IACD;;;;;;OAMG;IACG,SAAS;;YACX,IAAI,CAAC,MAAM,GAAG,uCAAqB,CAAC,SAAS,CAAC;QAClD,CAAC;KAAA;IACD;;;;;OAKG;IACG,SAAS;IACX;;OAEG;IACH,MAAsC;;YAEtC,QAAQ,IAAI,EAAE,CAAC;gBACX,KAAK,kCAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,gCAAc,CAAC,gCAAc,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;oBACtE,MAAM;gBAEV,KAAK,kCAAY,CAAC,eAAe,CAAC,MAAM,CAAC;oBACrC,IAAI,CAAC,MAAM,GAAG,IAAI,gCAAc,CAAC;wBAC7B,IAAI,EAAE,gCAAc,CAAC,YAAY;wBACjC,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,aAAa,EAAE,MAAM;qBACxB,CAAC,CAAC;oBACH,MAAM;gBAEV;oBACI,MAAM;YACd,CAAC;YAED,IAAI,CAAC,MAAM,GAAG,uCAAqB,CAAC,WAAW,CAAC;QACpD,CAAC;KAAA;IAKD,QAAQ;;QACJ,OAAO,aAAa,CAAA,MAAA,MAAA,IAAI,CAAC,MAAM,CAAC,SAAS,0CAAE,WAAW,0CAAE,IAAI,KAAI,SAAS,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC;IAC/F,CAAC;CACJ;AApXD,8BAoXC"}

package/dist/src/global/A-Feature/A-Feature.error.d.ts

@@ -1,25 +0,0 @@
-import { A_Error } from "../A-Error/A_Error.class";
-export declare class A_FeatureError extends A_Error {
-    /**
-     * Indicates that the Feature has been interrupted
-     */
-    static readonly Interruption = "Feature Interrupted";
-    /**
-     * Indicates that there was an error initializing the Feature
-     *
-     * Failed during the A-Feature initialization process
-     */
-    static readonly FeatureInitializationError = "Unable to initialize A-Feature";
-    /**
-     * Indicates that there was an error defining the Feature
-     *
-     * Failed during the @A_Feature.Define() decorator execution
-     */
-    static readonly FeatureDefinitionError = "Unable to define A-Feature";
-    /**
-     * Indicates that there was an error extending the Feature
-     *
-     * Failed during the @A_Feature.Extend() decorator execution
-     */
-    static readonly FeatureExtensionError = "Unable to extend A-Feature";
-}